笔记更新

This commit is contained in:
2026-09-01 19:15:50 +08:00
parent 57c03c9f0c
commit 316e92945e
7 changed files with 581 additions and 382 deletions

View File

@@ -1,81 +0,0 @@
# Hermes 定制化 Skills 笔记
> 记录 Hermes Agent 的定制化 skills(位于 `~/.hermes/skills/custom/`),源码托管在 atlas 仓库(`/Users/weishen/Workspace/atlas`)。
## 目录
- [blogwatcher-daily — RSS 订阅监控与导出](#blogwatcher-daily)
- [llm-provider-billing — LLM 余额查询](#llm-provider-billing)
---
## blogwatcher-daily
**用途**:RSS 订阅监控自动化 —— 抓取 → 去重入库 → 按需导出/管理。
**一句话**:把 37+ 个 RSS/YouTube/Bilibili 订阅定时抓进 SQLite,支持按订阅增删查改,并可把文章导出成 txt / markdown / html 三种格式(常用于生成每日摘要并邮件发送)。
### 核心能力
| 功能 | 说明 |
|------|------|
| 全量/单源扫描 | 抓取订阅源新文章,按 link 去重入库 |
| 订阅管理 | `--add` 添加(自动识别 YouTube → RSSHub 转换)、`--list` 列表 |
| 文章管理 | `--articles` 查看、`--mark-read` 标记已读、`--delete` 删除 |
| 导出 | `--export {txt,markdown,html}`,按日期/数量/订阅过滤,HTML 为单文件内嵌 CSS |
### 架构要点
- **智能路由**:YouTube 频道 → RSSHub(`http://192.168.3.45:1200`);普通 RSS → 直接访问原始 URL(RSSHub 的 `/rss/{url}` 路由不稳定,已绕开)
- **存储**:SQLite(`blogwatcher.db`) + 订阅列表 `subscriptions.txt`
- **依赖**:`feedparser`(Mac mini 本地运行)
- **配套**:`references/agentmail-sending.md` 记录了与 AgentMail 配合发邮件的完整流程(代理、认证、常见错误)
### 常用命令速记
```bash
# 扫描全部订阅
python3 ~/.hermes/skills/custom/blogwatcher-daily/scripts/blogwatcher-daily.py
# 导出今日文章为 HTML
... --export html
# 查看某订阅文章
... --articles "Engadget"
```
### 已知限制
- wikiHow、How-To Geek 源不可用(反爬)
- 部分源依赖 RSSHub 的可用性(偶发 503)
---
## llm-provider-billing
**用途**:查询各家 LLM API 账户余额与可用性。
**一句话**:用户问"还剩多少钱 / 够不够跑"时,一键查询 DeepSeek 等提供商的账户余额,返回总额、赠送余额、充值余额及可用状态。
### 当前支持
| 提供商 | 端点 | 状态 |
|--------|------|------|
| DeepSeek | `GET https://api.deepseek.com/user/balance` | ✅ 已验证 |
### 用法
```bash
# 一键查询(脚本自动从 ~/.hermes/.env 读 key)
bash ~/.hermes/skills/custom/llm-provider-billing/scripts/deepseek-balance.sh
```
返回 JSON:`is_available`(是否可用)+ `balance_infos`(各币种 total/granted/topped_up)。
### 关键知识点
- **Key 位置**:`~/.hermes/.env` 的 `DEEPSEEK_API_KEY`(Hermes config.yaml 中 api_key 均为空)
- **402 vs 401**:余额归零 → 402(充值即恢复,key 仍有效);key 错误 → 401
- 其余提供商(OpenAI、Claude 等)待扩展,添加前需先验证官方文档并实测
---
*笔记创建时间:2026-09-01,来源:atlas 仓库中对应技能的 SKILL.md*

View File

@@ -1,114 +0,0 @@
# Hermes 自定义技能说明
> 创建日期:2026-04-20
> 更新日期:2026-04-20
---
## 技能总览
| 技能名 | 用途 | 调用方式 |
| --------------------------------- | --------------------------------------------- | ------------- |
| `blogwatcher-daily` | RSS 订阅监控 + 每日笔记生成 | cronjob |
| `claude-code-executor` | 用 TMUX 启动 Claude Code 并委托任务 | delegate_task |
| `claude-code-infographic-prompts` | 调用 Claude Code 的 baoyu-infographic 生成信息图提示词 | 手动调用 |
| `marker-pdf-to-markdown` | PDF 转 Markdown(marker_single 单文件 / marker 批量) | terminal |
| `whisper-audio-to-text` | 音频/视频转文字(Whisper) | terminal |
---
## 1. claude-code-executor
**路径**:`~/.hermes/skills/custom/claude-code-executor/SKILL.md`
**用途**:通过 TMUX 启动 Claude Code(bypassPermissions 模式),发送任务指令,监控完成状态。
**触发关键词**:用户说"请用 Claude Code 做 xxx"、"用 Claude Code 执行 xxx"
**核心流程**:
1. 启动 TMUX session `claude-task`
2. 等 8 秒后发送 Enter(bypassPermissions 确认)
3. 发送完整任务指令
4. 监控 `done:` 输出
5. 清理 tmux session
**SSH 到 ubuntu2 命令**:`ssh ubuntu2`
---
## 2. claude-code-infographic-build
**路径**:`~/.hermes/skills/custom/claude-code-infographic-build/SKILL.md`
**用途**:调用 Claude Code 的 `baoyu-infographic` 技能,为笔记内容生成信息图提示词,并进一步生成图片添加到原始笔记。
**完整三步流程**:
1. **步骤①**:baoyu-infographic 生成三部分提示词 → 保存到 Hermes/xingzhi/
2. **步骤②**:在同一 Claude Code session 中,baoyu-imagine 生成图片 → 保存到 Hermes/xingzhi/
3. **步骤③**:obsidian skill 将图片引用添加到原始笔记
**三部分提示词格式**:
1. **系统提示词** — Image Specifications + Core Principles
2. **风格锁定提示词** — Layout Guidelines + Style Guidelines
3. **内容结构提示词** — Text Requirements + 具体内容
**布局参考**(`~/.claude/skills/baoyu-infographic/references/layouts/`):
- `hub-spoke` — 适合 mind-map(标注了 "Best For: Mind maps")
- `circular-flow` — 适合循环流程
- `venn` — 适合交集关系
**风格参考**(`~/.claude/skills/baoyu-infographic/references/styles/`):
- `corporate-memphis` — 商务孟菲斯风格
- `chalkboard` — 粉笔黑板风格
- `cyberpunk-neon` — 赛博霓虹风格
- `warm` / `notion` / `minimal` / `blueprint` / `watercolor` / `elegant`
**文件命名**:`[主题]-infographic-prompts-YYYY-MM-DD.md`
---
## 3. blogwatcher-daily
**路径**:`~/.hermes/skills/custom/blogwatcher-daily/SKILL.md`
**用途**:RSS 订阅监控 + 每日笔记生成。使用 RSSHub + feedparser 抓取 31 个订阅,自动去重并存入 SQLite,新文章追加写入 Markdown 笔记。
---
## 4. marker-pdf-to-markdown
**路径**:`~/.hermes/skills/custom/marker-pdf-to-markdown/SKILL.md`
**用途**:PDF 转 Markdown/HTML/JSON 高精度工具,支持 OCR、表格、公式识别。
**安装位置**:ubuntu2 服务器(`ssh ubuntu2`)
| 命令 | 用途 | 输入 |
|------|------|------|
| `marker_single` | 单文件转换,默认输出到 PDF 同目录 | 单个 PDF 文件 |
| `marker` | 批量转换,需文件夹输入 | 文件夹路径 |
常用选项:`--output_dir`、`--output_format json/markdown/html`、`--no-images`、`--use_llm`、`--page_range`
---
## 5. whisper-audio-to-text
**路径**:`~/.hermes/skills/custom/whisper-audio-to-text/SKILL.md`
**用途**:使用 OpenAI Whisper 将音频/视频转换为文字(转录或翻译)。
**安装位置**:Mac mini(GPU 加速)、ubuntu1、ubuntu2(CPU 模式),均直接可用。
---
## 相关 Claude Code 技能(`~/.claude/skills/`)
| 技能名 | 用途 |
|--------|------|
| `baoyu-article-illustrator` | 文章配图(分析文章结构 + 生成配图) |
| `baoyu-infographic` | 信息图生成 |
| `baoyu-cover-image` | 封面图生成 |
| `fireworks-tech-graph` | 技术图生成 |
这些 Claude Code 技能通过 `claude-code-executor` 启动 Claude Code CLI 后调用。