笔记更新
This commit is contained in:
@@ -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*
|
||||
@@ -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 后调用。
|
||||
Reference in New Issue
Block a user