diff --git a/Hermes/xingzhi/Hermes定制化Skills笔记.md b/Hermes/xingzhi/Hermes定制化Skills笔记.md new file mode 100644 index 00000000..b962dd73 --- /dev/null +++ b/Hermes/xingzhi/Hermes定制化Skills笔记.md @@ -0,0 +1,81 @@ +# 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*