Add notes: Hermes 定制化 Skills 笔记

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*