#hermes #custom-skill #skills 
# 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*