Hermes 定制化 Skills 笔记

记录 Hermes Agent 的定制化 skills(位于 ~/.hermes/skills/custom/),源码托管在 atlas 仓库(/Users/weishen/Workspace/atlas)。

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 配合发邮件的完整流程(代理、认证、常见错误)

常用命令速记

# 扫描全部订阅
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`	✅ 已验证

用法

# 一键查询(脚本自动从 ~/.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

2.9 KiB Raw Blame History