[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M734S7QKHTP0ZDSWY2B2SA5C":3,"skill-same:01M734S7QKHTP0ZDSWY2B2SA5C":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M734S7QKHTP0ZDSWY2B2SA5C","my-news",null,"拉取用户订阅的一手 RSS 源里的内容，按需整理成中文简报、列出全量条目、或返回某条原文。触发：用户提到\"简报\"、\"news digest\"、\"看看 RSS\"、\"my-news\"、\"今日新闻\"、\"有什么新的\"、\"刷一下源\"、\"列出文章\"、\"给我 X 的原文\"、\"总结 X 这一条\"等，或斜杠\u002Fat 形式如 `\u002Fmy-news`、`@my-news`。Agent 无关，Claude Code \u002F Hermes \u002F 其他 agent 都可用。","KaleLjl\u002FMy-news","KaleLjl","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F52370166?v=4","01M734S3C6ZWGN1FTJQ98YA7HH","Leilei","01M734S3CWDJH0EJP8T722G9M2",1,"MIT","https:\u002F\u002Fgithub.com\u002FKaleLjl\u002FMy-news\u002Fblob\u002Fmain\u002Fskills\u002Fmy-news\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: my-news\ndescription: 拉取用户订阅的一手 RSS 源里的内容，按需整理成中文简报、列出全量条目、或返回某条原文。触发：用户提到\"简报\"、\"news digest\"、\"看看 RSS\"、\"my-news\"、\"今日新闻\"、\"有什么新的\"、\"刷一下源\"、\"列出文章\"、\"给我 X 的原文\"、\"总结 X 这一条\"等，或斜杠\u002Fat 形式如 `\u002Fmy-news`、`@my-news`。Agent 无关，Claude Code \u002F Hermes \u002F 其他 agent 都可用。\n---\n\n# my-news — 一手 RSS 简报\n\n本 skill 是个壳，真正干活的是 PATH 上的 `my-news` CLI（基于 newsboat + trafilatura，状态走 XDG 用户目录）。**Agent 无关**：只要 CLI 在 PATH 上，Claude Code \u002F Hermes \u002F 其它能跑 shell 的 agent 都能用。根据用户意图分支为三种动作：**简报**（新内容深度整理）、**列表**（罗列已抓取的所有条目，不消耗 unread 状态）、**取单条**（按 id\u002FURL 拿完整原文）；外加一个 **诊断**（`doctor`，查源是否还活着）。\n\n## 0. 前置检查（每次会话首次触发时跑一次即可）\n\n```bash\ncommand -v my-news\n```\n\n- **有输出** → 直接进入后面的命令分支。\n- **没输出** → CLI 没装。**先停下来征求用户同意**，然后用一行装上：\n\n  ```bash\n  uv tool install git+https:\u002F\u002Fgithub.com\u002FKaleLjl\u002Fmy-news.git\n  ```\n\n  前置依赖（缺哪个补哪个）：\n  - `uv`：`brew install uv`（macOS）或 `curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh`（其它）\n  - `newsboat`：`brew install newsboat`（macOS \u002F Linuxbrew）\u002F `sudo apt install newsboat`（Debian \u002F Ubuntu ≤22.04）\u002F `sudo pacman -S newsboat`（Arch）\n  - **Ubuntu 24.04+ 注意**：apt 源里没有 newsboat。详细方案（Linuxbrew 推荐 \u002F snap + 环境变量 workaround \u002F 源码编译）见 `references\u002Finstall.md` §I.5。\n\n  装完再走下一步，不需要重开 shell（`~\u002F.local\u002Fbin` 已在 PATH 时 `my-news` 立即可用）。\n\n**老仓库数据迁移**：如果用户曾用过老版本（仓库里的 `data\u002Fcache.db`、`feeds\u002Furls` 等），且 `my-news paths` 显示的 `data_dir` 还是空的，问一下要不要把老数据搬过去：\n\n```bash\nmy-news migrate --from \u003C老仓库路径>\n```\n\n`migrate` 是幂等的，已存在的目标会跳过。\n\n**关键原则**：检查失败时**不要硬跑命令然后让用户看一屏 traceback**。先报清楚问题，再问要不要让你帮装。\n\n## 1. 三个 CLI 子命令\n\n所有命令直接调 `my-news ...`（已在 PATH 上）。不需要 `cd` 到任何目录，状态走 XDG 用户目录。\n\n### `fetch` — 新内容简报用\n\n```bash\nmy-news fetch [--no-reload] [--no-mark] [--since 24h]\n```\n\n- 默认：newsboat reload → 输出所有 unread 条目 JSON → **标记已读**\n- 用于\"看看今天有什么新的\" \u002F 定时简报\n- `content_text` 完整不截断（RSS 给多少就是多少）\n\n### `list` — 罗列已抓取的条目（不消耗 unread）\n\n```bash\nmy-news list [--no-reload] [--feed QUERY] [--limit N] [--since 24h] [--unread-only]\n```\n\n- 不过滤 unread，能看到所有还在缓存里的条目（包括已读历史）\n- `--feed simon` 按源标题或 URL 子串过滤（不区分大小写）\n- `--limit 50` 默认上限\n- **不会**标记任何条目已读\n- 用于\"列出 simonw 最近 30 条\" \u002F \"看看缓存里都有什么\"\n\n### `show` — 取单条完整原文\n\n```bash\nmy-news show \u003Cid|url> [--full] [--refresh]\n```\n\n- 参数可以是数字 id（来自 `fetch`\u002F`list` 的 `id` 字段），也可以是文章 URL\n- 默认返回 RSS 自带内容：单条 JSON，`content_text` 完整 + 多带 `content_html` 原始 HTML（fetch\u002Flist 不带 html）\n- `--full`：另外去抓**文章 URL** 用 trafilatura 抽正文（Markdown 格式），结果缓存在 `extracted_content` 表里，第二次秒回。返回结构里多一个 `extracted` 字段：\n  ```json\n  \"extracted\": {\n    \"status\": \"ok|fetch_failed|extract_failed|empty\",\n    \"source\": \"cache|fresh\",\n    \"fetched_at\": \"ISO\",\n    \"length\": \u003C数字>,\n    \"text\": \"\u003CMarkdown 正文>\"\n  }\n  ```\n- `--refresh`：强制重抓覆盖缓存\n- 找不到 id\u002Furl 时退出码 1 + `{\"error\": \"not_found\", ...}`\n- 用于\"把第 X 条的原文给我\" \u002F \"把 https:\u002F\u002F... 这篇展开\"\n\n### `feeds` — 已配置的源\n\n```bash\nmy-news feeds\n```\n\n### `add` — 加一个源\n\n```bash\nmy-news add \u003Curl> [--tag TAG]... [--force] [--timeout 10]\n```\n\n- 默认会先 HTTP 探测 URL，确认是有效 RSS\u002FAtom feed 才写入\n- `--tag` 可重复，等价于 newsboat urls 文件里的 `\"tag1\" \"tag2\"`\n- `--force`：跳过探测直接写入（返回里 `\"validated\": false`，标明是裸加）\n- 失败返回 JSON + exit 1，状态有 `duplicate` \u002F `no_feed_found`\n- 保留 feeds\u002Furls 里原有的注释和其他订阅，原子写\n\n### `remove` — 删一个源\n\n```bash\nmy-news remove \u003Curl>\n```\n\n- URL 匹配忽略大小写和尾部 `\u002F`\n- 找不到返回 `{\"status\": \"not_found\"}` + exit 1\n- 保留其他订阅和注释\n\n### `paths` — 查路径（供 skill 自己用）\n\n```bash\nmy-news paths\n```\n\n返回 JSON：`config_dir` \u002F `data_dir` \u002F `feeds_file` \u002F `newsboat_conf` \u002F `cache_db` \u002F `digests_dir`。Skill 在写简报时**先调一次它拿 `digests_dir`**，避免硬编码路径。\n\n## 2. 输出 JSON 形状\n\n`fetch` 和 `list`：\n\n```json\n{\n  \"fetched_at\": \"ISO 时间戳\",\n  \"count\": \u003C数字>,\n  \"feed_count\": \u003C数字>,\n  \"by_feed\": {\n    \"\u003C源标题>\": [\n      {\"id\": \u003C数字>, \"title\": \"...\", \"url\": \"...\", \"author\": \"...\",\n       \"pub_date\": \"ISO\", \"unread\": true|false,\n       \"content_text\": \"去 HTML 的正文（完整，不截断）\",\n       \"feed_url\": \"...\", \"tags\": [\"...\"]}\n    ]\n  }\n}\n```\n\n`show` 单条额外带 `\"content_html\": \"\u003C原始 HTML>\"`。`content_text` 在所有命令里都是完整不截断的。\n\n## 3. 分支决策：用户想要什么？\n\n| 用户意图 | 用哪个命令 |\n|---|---|\n| \"看看今天的新闻\" \u002F \"刷一下\" \u002F \"\u002Fmy-news\" | `fetch` |\n| \"看看最近 24 小时\" | `fetch --since 24h` |\n| \"预览一下，先别标已读\" | `fetch --no-mark` |\n| \"列一下 cloudflare 的所有文章\" \u002F \"罗列 simonw 最近 20 条\" | `list --feed \u003Cname> --limit 20` |\n| \"看看缓存里都有什么\" \u002F \"全部列出来\" | `list --limit 100` |\n| \"把第 N 条 \u002F 标题为 X 的原文给我\" | 从上次 fetch\u002Flist 找到对应 `id` → `show \u003Cid>`；若 `content_text` 太短（RSS 只给了 metadata）→ 自动追加 `show \u003Cid> --full` 抓网页正文 |\n| \"https:\u002F\u002Fxxx 这篇是什么\" | `show \u003Curl> --full` |\n| \"总结一下 [某条]\" | `show \u003Cid> --full` 拿完整 `extracted.text` → 用 LLM 总结 |\n| \"重新抓一下 X\" | `show \u003Cid> --full --refresh`（绕过缓存）|\n| \"我都订了什么源\" | `feeds` |\n| \"加一个源 \u002F 订阅 X \u002F 加上 https:\u002F\u002F...\" | `add \u003Curl> [--tag X]...`；探测失败时报清楚原因，可加 `--force` 裸加 |\n| \"取消订阅 X \u002F 删掉这个源\" | `remove \u003Curl>` |\n\n**关键点**：`fetch` 会\"消耗\" unread 状态。如果用户只是想浏览\u002F查询\u002F取原文，**优先用 `list` 和 `show`**，不要用 `fetch`。\n\n### 首次大 backlog 处理（防爆上下文）\n\n首次部署 \u002F 长时间没刷 \u002F 加了很多源时，`fetch` 可能一下子返回几百条，塞爆 LLM 窗口。**应当先侦察再决定**：\n\n1. **低成本侦察**（不消耗 unread、内容截断）：\n\n   ```bash\n   my-news fetch --no-mark --summary-only --limit 5\n   ```\n\n   只看返回 JSON 的 `count` 字段。\n\n2. **按 count 分级降级**：\n\n   | count | 怎么走 |\n   |---|---|\n   | `\u003C= 50` | 正常 `my-news fetch`，全量整理 |\n   | `50 \u003C count \u003C= 200` | `my-news fetch --since 24h`，告诉用户\"另有 N 条更老的，要不要追？\" |\n   | `> 200` | `my-news fetch --since 24h --limit 50 --summary-only`，明确告诉用户在分批；剩余下次会话再处理 |\n\n3. **`--limit N` 的语义**：只输出最近 N 条 unread，**只对这 N 条 mark_read**，剩余 unread 保留供下次。所以分批安全，不会丢条目。\n\n4. **`--summary-only` 的语义**：每条 `content_text` 截断到 2000 字符（可用 `MY_NEWS_SUMMARY_MAX_CHARS` 调），并在 item 上加 `\"content_text_truncated\": true` 标记。需要全文：`show \u003Cid> --full`（trafilatura 抓网页正文）。\n\n## 4. 简报输出格式（仅 `fetch` 路径）\n\n### 空检查\n\n`count == 0` 时输出：\n\n```\n📭 没有新内容（最近一次刷新：\u003Cfetched_at>）\n```\n\n**直接结束，不调 LLM 生成内容**。这让外部调度器（cron \u002F systemd \u002F Hermes 等）能靠是否包含\"没有新内容\"判断要不要推送。\n\n### 有内容时的简报结构\n\n```markdown\n# 📰 my-news 简报 · \u003CYYYY-MM-DD HH:MM>\n\n共 **\u003Ccount>** 条新条目，覆盖 **\u003Cfeed_count>** 个源。\n\n## 🎯 今日要点\n\n跨源提炼 3-5 条最重要的更新，每条 1 句话讲清楚是什么 + 为什么值得注意。\n\n- **\u003C要点标题>**：\u003C一句话本质>。([来源](URL))\n\n## 📚 分主题\n\n如果多条围绕同一话题，合并讲、对比异同。没有跨源主题就跳过。\n\n## 📰 按源全量\n\n每个源下按 pub_date 倒序列出所有新条目，给 1-2 句中文摘要 + 原文链接。\n\n### \u003C源标题> (\u003Cn> 条)\n\n- **\u003C标题>** · \u003Cpub_date 简化>  \n  \u003C中文摘要 1-2 句>  \n  [原文](URL) · `id: \u003Cid>`\n\n如果某条 `content_text_truncated: true`（用了 `--summary-only`），摘要只写一句话 + 链接，注明\"全文需 `show \u003Cid> --full`\"，不要假装看完了全文。\n\n## 🔖 推荐精读\n\n挑 2-3 条最值得点开看完的，说明\"为什么推荐\"。\n```\n\n**带上 `id`**：让用户后续可以说\"给我 id 1042 的原文\"，skill 直接调 `show 1042`。\n\n### 写到文件\n\n简报输出到聊天的同时，也写一份到 `my-news paths` 返回的 `digests_dir` 下：\n\n```\n\u003Cdigests_dir>\u002F\u003CYYYY-MM-DD-HHMM>.md\n```\n\n（默认是 `~\u002F.local\u002Fshare\u002Fmy-news\u002Fdigests\u002F\u003CYYYY-MM-DD-HHMM>.md`）\n\n`digests_dir` 不存在就 `mkdir -p` 一下。路径稳定可预测，方便调度器 `cat` 后推送。\n\n## 5. 列表输出格式（`list` 路径）\n\n```markdown\n# 📋 my-news 列表 · 共 \u003Ccount> 条\n\u003C过滤条件回显：feed=xxx limit=N since=24h>\n\n## \u003C源标题> (\u003Cn> 条)\n\n- `[id: 1042]` **\u003C标题>** · \u003Cpub_date> · \u003Cunread ? \"🆕\" : \"✓\">  \n  \u003C如果 content_text 够长，给一句话摘要；不够长就略>  \n  [原文](URL)\n```\n\n列表模式**不**写 digests 文件、**不**生成深度简报、**不**做跨源主题分析 — 这是\"目录索引\"，不是简报。\n\n## 6. 单条原文输出格式（`show` 路径）\n\n```markdown\n# 📄 \u003C标题>\n\n- **源**：\u003Cfeed_title>\n- **作者**：\u003Cauthor>\n- **发布**：\u003Cpub_date>\n- **URL**：\u003Curl>\n- **状态**：\u003Cunread ? \"未读\" : \"已读\">\n- **标签**：\u003Ctags>\n\n---\n\n\u003Ccontent_text 全文，原样保留分段>\n```\n\n如果 `content_text` 极短（\u003C 200 字符，像 HN 那种只有 metadata 的源）：**立即追加 `show \u003Cid> --full`** 调 trafilatura 抓网页正文，然后用 `extracted.text` 而不是 `content_text` 渲染。如果 `extracted.status != \"ok\"`（fetch_failed \u002F extract_failed \u002F empty），再告诉用户原文抓不到、给原 URL 让他自己点。\n\n## 7. 简报风格要求（仅 fetch 路径）\n\n- **中文输出**，标题可保留原文（特别是技术名词、产品名）\n- **信息密度高**：每句话都要有信息量，避免\"近期 X 公司发布了关于 Y 的内容\"这种空话\n- **可扫读**：bullet、加粗、清晰小节，30 秒能抓住重点\n- **不编造**：只依据 `content_text`。content_text 太短就照实说\"原文需点开看\"\n- **链接保留**：每条都带 `url` 链接\n- **去噪**：HN 这种源经常有杂项，可在\"按源全量\"列，但**别**进\"今日要点\"\n\n## 8. 错误处理\n\n- CLI 自身失败（非 0 退出）：先告诉用户错误，**不要**编造内容\n- `command not found: my-news` → 回到 §0 重新走前置检查\n- `command not found: newsboat`（CLI 跑得动但 `fetch` 时报错）→ 提示用户装 newsboat\n- `show` 返回 `not_found`：告诉用户没找到，建议先 `list` 看 id\n- stderr 有内容但 stdout 有有效 JSON：继续做简报\u002F列表，末尾加\"⚠️ 部分源刷新有问题，详见 `my-news paths` 返回的 `error_log`\"\n- JSON parse 失败：输出 stdout 头 20 行帮助排查；如果 payload 巨大（单条 content 上万字）可重试 `--summary-only`\n\n## 9. 环境变量覆盖（可选）\n\n`my-news` 默认 config 在 `~\u002F.config\u002Fmy-news\u002F`，data 在 `~\u002F.local\u002Fshare\u002Fmy-news\u002F`。如果用户想改：\n\n- `MY_NEWS_CONFIG=\u002Fsome\u002Fpath` 改 config 根（feeds\u002Furls + newsboat.conf 都在里头）\n- `MY_NEWS_DATA=\u002Fsome\u002Fpath` 改 data 根（cache.db + digests\u002F 都在里头）\n- `MY_NEWS_SUMMARY_MAX_CHARS=N` 改 `--summary-only` 的截断阈值（默认 2000）\n\n三个变量都是**可选**的；不设就用默认。设置时请用户自己写进 shell rc，skill 不应该替用户改 rc。\n\n## 10. 源健康检查（用户问\"哪个源没数据\"时）\n\n用户类似抱怨——\"为什么 X 一直没东西\"、\"机器之心好像挂了\"、\"加了新源但 fetch 不到\"——走 `doctor`：\n\n```bash\nmy-news doctor              # 人类可读表格\nmy-news doctor --json       # 机器可读 JSON\nmy-news doctor --timeout 20 # 慢源放宽超时\n```\n\n输出每条源的：HTTP 状态、Content-Type、能不能 parse 成 RSS\u002FAtom、item 数。状态分四种：\n\n| 状态 | 含义 | 给用户什么建议 |\n|---|---|---|\n| `ok` | 拉得到 + parse 成功 + 有 item | 没事 |\n| `feed_unreachable` | HTTP 4xx\u002F5xx 或网络错误 | 检查 URL 是不是改了；连续失败考虑删行 |\n| `not_a_feed` | HTTP 200 但响应不是 RSS\u002FAtom（多半是 HTML 落地页） | URL 错了，去站点重找 RSS 入口 |\n| `duplicate` | 与前面某行 URL 完全一致（仅规范化大小写 \u002F 末尾斜杠） | 删一行 |\n\nSkill 拿到 `--json` 输出后，把 `reports` 里 `status != \"ok\"` 的整理给用户，建议改 `feeds_file` 路径（来自 `my-news paths`）。\n\n**注意**：`doctor` 检测不到\"同站不同 URL 但内容雷同\"的伪重复（典型陷阱：`hnrss.org\u002Ffrontpage` 和 `news.ycombinator.com\u002Frss` 都会过 `doctor`，但后者只 metadata）。这种已知组合在 `references\u002Finstall.md` §III \"已知陷阱\" 里列了。\n","# my-news — 一手 RSS 简报\n\n本 skill 是个壳，真正干活的是 PATH 上的 `my-news` CLI（基于 newsboat + trafilatura，状态走 XDG 用户目录）。**Agent 无关**：只要 CLI 在 PATH 上，Claude Code \u002F Hermes \u002F 其它能跑 shell 的 agent 都能用。根据用户意图分支为三种动作：**简报**（新内容深度整理）、**列表**（罗列已抓取的所有条目，不消耗 unread 状态）、**取单条**（按 id\u002FURL 拿完整原文）；外加一个 **诊断**（`doctor`，查源是否还活着）。\n\n## 0. 前置检查（每次会话首次触发时跑一次即可）\n\n```bash\ncommand -v my-news\n```\n\n- **有输出** → 直接进入后面的命令分支。\n- **没输出** → CLI 没装。**先停下来征求用户同意**，然后用一行装上：\n\n  ```bash\n  uv tool install git+https:\u002F\u002Fgithub.com\u002FKaleLjl\u002Fmy-news.git\n  ```\n\n  前置依赖（缺哪个补哪个）：\n  - `uv`：`brew install uv`（macOS）或 `curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh`（其它）\n  - `newsboat`：`brew install newsboat`（macOS \u002F Linuxbrew）\u002F `sudo apt install newsboat`（Debian \u002F Ubuntu ≤22.04）\u002F `sudo pacman -S newsboat`（Arch）\n  - **Ubuntu 24.04+ 注意**：apt 源里没有 newsboat。详细方案（Linuxbrew 推荐 \u002F snap + 环境变量 workaround \u002F 源码编译）见 `references\u002Finstall.md` §I.5。\n\n  装完再走下一步，不需要重开 shell（`~\u002F.local\u002Fbin` 已在 PATH 时 `my-news` 立即可用）。\n\n**老仓库数据迁移**：如果用户曾用过老版本（仓库里的 `data\u002Fcache.db`、`feeds\u002Furls` 等），且 `my-news paths` 显示的 `data_dir` 还是空的，问一下要不要把老数据搬过去：\n\n```bash\nmy-news migrate --from \u003C老仓库路径>\n```\n\n`migrate` 是幂等的，已存在的目标会跳过。\n\n**关键原则**：检查失败时**不要硬跑命令然后让用户看一屏 traceback**。先报清楚问题，再问要不要让你帮装。\n\n## 1. 三个 CLI 子命令\n\n所有命令直接调 `my-news ...`（已在 PATH 上）。不需要 `cd` 到任何目录，状态走 XDG 用户目录。\n\n### `fetch` — 新内容简报用\n\n```bash\nmy-news fetch [--no-reload] [--no-mark] [--since 24h]\n```\n\n- 默认：newsboat reload → 输出所有 unread 条目 JSON → **标记已读**\n- 用于\"看看今天有什么新的\" \u002F 定时简报\n- `content_text` 完整不截断（RSS 给多少就是多少）\n\n### `list` — 罗列已抓取的条目（不消耗 unread）\n\n```bash\nmy-news list [--no-reload] [--feed QUERY] [--limit N] [--since 24h] [--unread-only]\n```\n\n- 不过滤 unread，能看到所有还在缓存里的条目（包括已读历史）\n- `--feed simon` 按源标题或 URL 子串过滤（不区分大小写）\n- `--limit 50` 默认上限\n- **不会**标记任何条目已读\n- 用于\"列出 simonw 最近 30 条\" \u002F \"看看缓存里都有什么\"\n\n### `show` — 取单条完整原文\n\n```bash\nmy-news show \u003Cid|url> [--full] [--refresh]\n```\n\n- 参数可以是数字 id（来自 `fetch`\u002F`list` 的 `id` 字段），也可以是文章 URL\n- 默认返回 RSS 自带内容：单条 JSON，`content_text` 完整 + 多带 `content_html` 原始 HTML（fetch\u002Flist 不带 html）\n- `--full`：另外去抓**文章 URL** 用 trafilatura 抽正文（Markdown 格式），结果缓存在 `extracted_content` 表里，第二次秒回。返回结构里多一个 `extracted` 字段：\n  ```json\n  \"extracted\": {\n    \"status\": \"ok|fetch_failed|extract_failed|empty\",\n    \"source\": \"cache|fresh\",\n    \"fetched_at\": \"ISO\",\n    \"length\": \u003C数字>,\n    \"text\": \"\u003CMarkdown 正文>\"\n  }\n  ```\n- `--refresh`：强制重抓覆盖缓存\n- 找不到 id\u002Furl 时退出码 1 + `{\"error\": \"not_found\", ...}`\n- 用于\"把第 X 条的原文给我\" \u002F \"把 https:\u002F\u002F... 这篇展开\"\n\n### `feeds` — 已配置的源\n\n```bash\nmy-news feeds\n```\n\n### `add` — 加一个源\n\n```bash\nmy-news add \u003Curl> [--tag TAG]... [--force] [--timeout 10]\n```\n\n- 默认会先 HTTP 探测 URL，确认是有效 RSS\u002FAtom feed 才写入\n- `--tag` 可重复，等价于 newsboat urls 文件里的 `\"tag1\" \"tag2\"`\n- `--force`：跳过探测直接写入（返回里 `\"validated\": false`，标明是裸加）\n- 失败返回 JSON + exit 1，状态有 `duplicate` \u002F `no_feed_found`\n- 保留 feeds\u002Furls 里原有的注释和其他订阅，原子写\n\n### `remove` — 删一个源\n\n```bash\nmy-news remove \u003Curl>\n```\n\n- URL 匹配忽略大小写和尾部 `\u002F`\n- 找不到返回 `{\"status\": \"not_found\"}` + exit 1\n- 保留其他订阅和注释\n\n### `paths` — 查路径（供 skill 自己用）\n\n```bash\nmy-news paths\n```\n\n返回 JSON：`config_dir` \u002F `data_dir` \u002F `feeds_file` \u002F `newsboat_conf` \u002F `cache_db` \u002F `digests_dir`。Skill 在写简报时**先调一次它拿 `digests_dir`**，避免硬编码路径。\n\n## 2. 输出 JSON 形状\n\n`fetch` 和 `list`：\n\n```json\n{\n  \"fetched_at\": \"ISO 时间戳\",\n  \"count\": \u003C数字>,\n  \"feed_count\": \u003C数字>,\n  \"by_feed\": {\n    \"\u003C源标题>\": [\n      {\"id\": \u003C数字>, \"title\": \"...\", \"url\": \"...\", \"author\": \"...\",\n       \"pub_date\": \"ISO\", \"unread\": true|false,\n       \"content_text\": \"去 HTML 的正文（完整，不截断）\",\n       \"feed_url\": \"...\", \"tags\": [\"...\"]}\n    ]\n  }\n}\n```\n\n`show` 单条额外带 `\"content_html\": \"\u003C原始 HTML>\"`。`content_text` 在所有命令里都是完整不截断的。\n\n## 3. 分支决策：用户想要什么？\n\n| 用户意图 | 用哪个命令 |\n|---|---|\n| \"看看今天的新闻\" \u002F \"刷一下\" \u002F \"\u002Fmy-news\" | `fetch` |\n| \"看看最近 24 小时\" | `fetch --since 24h` |\n| \"预览一下，先别标已读\" | `fetch --no-mark` |\n| \"列一下 cloudflare 的所有文章\" \u002F \"罗列 simonw 最近 20 条\" | `list --feed \u003Cname> --limit 20` |\n| \"看看缓存里都有什么\" \u002F \"全部列出来\" | `list --limit 100` |\n| \"把第 N 条 \u002F 标题为 X 的原文给我\" | 从上次 fetch\u002Flist 找到对应 `id` → `show \u003Cid>`；若 `content_text` 太短（RSS 只给了 metadata）→ 自动追加 `show \u003Cid> --full` 抓网页正文 |\n| \"https:\u002F\u002Fxxx 这篇是什么\" | `show \u003Curl> --full` |\n| \"总结一下 [某条]\" | `show \u003Cid> --full` 拿完整 `extracted.text` → 用 LLM 总结 |\n| \"重新抓一下 X\" | `show \u003Cid> --full --refresh`（绕过缓存）|\n| \"我都订了什么源\" | `feeds` |\n| \"加一个源 \u002F 订阅 X \u002F 加上 https:\u002F\u002F...\" | `add \u003Curl> [--tag X]...`；探测失败时报清楚原因，可加 `--force` 裸加 |\n| \"取消订阅 X \u002F 删掉这个源\" | `remove \u003Curl>` |\n\n**关键点**：`fetch` 会\"消耗\" unread 状态。如果用户只是想浏览\u002F查询\u002F取原文，**优先用 `list` 和 `show`**，不要用 `fetch`。\n\n### 首次大 backlog 处理（防爆上下文）\n\n首次部署 \u002F 长时间没刷 \u002F 加了很多源时，`fetch` 可能一下子返回几百条，塞爆 LLM 窗口。**应当先侦察再决定**：\n\n1. **低成本侦察**（不消耗 unread、内容截断）：\n\n   ```bash\n   my-news fetch --no-mark --summary-only --limit 5\n   ```\n\n   只看返回 JSON 的 `count` 字段。\n\n2. **按 count 分级降级**：\n\n   | count | 怎么走 |\n   |---|---|\n   | `\u003C= 50` | 正常 `my-news fetch`，全量整理 |\n   | `50 \u003C count \u003C= 200` | `my-news fetch --since 24h`，告诉用户\"另有 N 条更老的，要不要追？\" |\n   | `> 200` | `my-news fetch --since 24h --limit 50 --summary-only`，明确告诉用户在分批；剩余下次会话再处理 |\n\n3. **`--limit N` 的语义**：只输出最近 N 条 unread，**只对这 N 条 mark_read**，剩余 unread 保留供下次。所以分批安全，不会丢条目。\n\n4. **`--summary-only` 的语义**：每条 `content_text` 截断到 2000 字符（可用 `MY_NEWS_SUMMARY_MAX_CHARS` 调），并在 item 上加 `\"content_text_truncated\": true` 标记。需要全文：`show \u003Cid> --full`（trafilatura 抓网页正文）。\n\n## 4. 简报输出格式（仅 `fetch` 路径）\n\n### 空检查\n\n`count == 0` 时输出：\n\n```\n📭 没有新内容（最近一次刷新：\u003Cfetched_at>）\n```\n\n**直接结束，不调 LLM 生成内容**。这让外部调度器（cron \u002F systemd \u002F Hermes 等）能靠是否包含\"没有新内容\"判断要不要推送。\n\n### 有内容时的简报结构\n\n```markdown\n# 📰 my-news 简报 · \u003CYYYY-MM-DD HH:MM>\n\n共 **\u003Ccount>** 条新条目，覆盖 **\u003Cfeed_count>** 个源。\n\n## 🎯 今日要点\n\n跨源提炼 3-5 条最重要的更新，每条 1 句话讲清楚是什么 + 为什么值得注意。\n\n- **\u003C要点标题>**：\u003C一句话本质>。([来源](URL))\n\n## 📚 分主题\n\n如果多条围绕同一话题，合并讲、对比异同。没有跨源主题就跳过。\n\n## 📰 按源全量\n\n每个源下按 pub_date 倒序列出所有新条目，给 1-2 句中文摘要 + 原文链接。\n\n### \u003C源标题> (\u003Cn> 条)\n\n- **\u003C标题>** · \u003Cpub_date 简化>  \n  \u003C中文摘要 1-2 句>  \n  [原文](URL) · `id: \u003Cid>`\n\n如果某条 `content_text_truncated: true`（用了 `--summary-only`），摘要只写一句话 + 链接，注明\"全文需 `show \u003Cid> --full`\"，不要假装看完了全文。\n\n## 🔖 推荐精读\n\n挑 2-3 条最值得点开看完的，说明\"为什么推荐\"。\n```\n\n**带上 `id`**：让用户后续可以说\"给我 id 1042 的原文\"，skill 直接调 `show 1042`。\n\n### 写到文件\n\n简报输出到聊天的同时，也写一份到 `my-news paths` 返回的 `digests_dir` 下：\n\n```\n\u003Cdigests_dir>\u002F\u003CYYYY-MM-DD-HHMM>.md\n```\n\n（默认是 `~\u002F.local\u002Fshare\u002Fmy-news\u002Fdigests\u002F\u003CYYYY-MM-DD-HHMM>.md`）\n\n`digests_dir` 不存在就 `mkdir -p` 一下。路径稳定可预测，方便调度器 `cat` 后推送。\n\n## 5. 列表输出格式（`list` 路径）\n\n```markdown\n# 📋 my-news 列表 · 共 \u003Ccount> 条\n\u003C过滤条件回显：feed=xxx limit=N since=24h>\n\n## \u003C源标题> (\u003Cn> 条)\n\n- `[id: 1042]` **\u003C标题>** · \u003Cpub_date> · \u003Cunread ? \"🆕\" : \"✓\">  \n  \u003C如果 content_text 够长，给一句话摘要；不够长就略>  \n  [原文](URL)\n```\n\n列表模式**不**写 digests 文件、**不**生成深度简报、**不**做跨源主题分析 — 这是\"目录索引\"，不是简报。\n\n## 6. 单条原文输出格式（`show` 路径）\n\n```markdown\n# 📄 \u003C标题>\n\n- **源**：\u003Cfeed_title>\n- **作者**：\u003Cauthor>\n- **发布**：\u003Cpub_date>\n- **URL**：\u003Curl>\n- **状态**：\u003Cunread ? \"未读\" : \"已读\">\n- **标签**：\u003Ctags>\n\n---\n\n\u003Ccontent_text 全文，原样保留分段>\n```\n\n如果 `content_text` 极短（\u003C 200 字符，像 HN 那种只有 metadata 的源）：**立即追加 `show \u003Cid> --full`** 调 trafilatura 抓网页正文，然后用 `extracted.text` 而不是 `content_text` 渲染。如果 `extracted.status != \"ok\"`（fetch_failed \u002F extract_failed \u002F empty），再告诉用户原文抓不到、给原 URL 让他自己点。\n\n## 7. 简报风格要求（仅 fetch 路径）\n\n- **中文输出**，标题可保留原文（特别是技术名词、产品名）\n- **信息密度高**：每句话都要有信息量，避免\"近期 X 公司发布了关于 Y 的内容\"这种空话\n- **可扫读**：bullet、加粗、清晰小节，30 秒能抓住重点\n- **不编造**：只依据 `content_text`。content_text 太短就照实说\"原文需点开看\"\n- **链接保留**：每条都带 `url` 链接\n- **去噪**：HN 这种源经常有杂项，可在\"按源全量\"列，但**别**进\"今日要点\"\n\n## 8. 错误处理\n\n- CLI 自身失败（非 0 退出）：先告诉用户错误，**不要**编造内容\n- `command not found: my-news` → 回到 §0 重新走前置检查\n- `command not found: newsboat`（CLI 跑得动但 `fetch` 时报错）→ 提示用户装 newsboat\n- `show` 返回 `not_found`：告诉用户没找到，建议先 `list` 看 id\n- stderr 有内容但 stdout 有有效 JSON：继续做简报\u002F列表，末尾加\"⚠️ 部分源刷新有问题，详见 `my-news paths` 返回的 `error_log`\"\n- JSON parse 失败：输出 stdout 头 20 行帮助排查；如果 payload 巨大（单条 content 上万字）可重试 `--summary-only`\n\n## 9. 环境变量覆盖（可选）\n\n`my-news` 默认 config 在 `~\u002F.config\u002Fmy-news\u002F`，data 在 `~\u002F.local\u002Fshare\u002Fmy-news\u002F`。如果用户想改：\n\n- `MY_NEWS_CONFIG=\u002Fsome\u002Fpath` 改 config 根（feeds\u002Furls + newsboat.conf 都在里头）\n- `MY_NEWS_DATA=\u002Fsome\u002Fpath` 改 data 根（cache.db + digests\u002F 都在里头）\n- `MY_NEWS_SUMMARY_MAX_CHARS=N` 改 `--summary-only` 的截断阈值（默认 2000）\n\n三个变量都是**可选**的；不设就用默认。设置时请用户自己写进 shell rc，skill 不应该替用户改 rc。\n\n## 10. 源健康检查（用户问\"哪个源没数据\"时）\n\n用户类似抱怨——\"为什么 X 一直没东西\"、\"机器之心好像挂了\"、\"加了新源但 fetch 不到\"——走 `doctor`：\n\n```bash\nmy-news doctor              # 人类可读表格\nmy-news doctor --json       # 机器可读 JSON\nmy-news doctor --timeout 20 # 慢源放宽超时\n```\n\n输出每条源的：HTTP 状态、Content-Type、能不能 parse 成 RSS\u002FAtom、item 数。状态分四种：\n\n| 状态 | 含义 | 给用户什么建议 |\n|---|---|---|\n| `ok` | 拉得到 + parse 成功 + 有 item | 没事 |\n| `feed_unreachable` | HTTP 4xx\u002F5xx 或网络错误 | 检查 URL 是不是改了；连续失败考虑删行 |\n| `not_a_feed` | HTTP 200 但响应不是 RSS\u002FAtom（多半是 HTML 落地页） | URL 错了，去站点重找 RSS 入口 |\n| `duplicate` | 与前面某行 URL 完全一致（仅规范化大小写 \u002F 末尾斜杠） | 删一行 |\n\nSkill 拿到 `--json` 输出后，把 `reports` 里 `status != \"ok\"` 的整理给用户，建议改 `feeds_file` 路径（来自 `my-news paths`）。\n\n**注意**：`doctor` 检测不到\"同站不同 URL 但内容雷同\"的伪重复（典型陷阱：`hnrss.org\u002Ffrontpage` 和 `news.ycombinator.com\u002Frss` 都会过 `doctor`，但后者只 metadata）。这种已知组合在 `references\u002Finstall.md` §III \"已知陷阱\" 里列了。\n",{"name":5,"description":7},"main","3c673c5ab657d19e00520a31f6a3da0244503d7a","skills\u002Fmy-news",0,"https:\u002F\u002Fgithub.com\u002FKaleLjl\u002FMy-news","https:\u002F\u002Fgithub.com\u002FKaleLjl","2026-05-28 15:01:34",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add KaleLjl\u002FMy-news --skill my-news",{"tool":37,"command":38},"bunx","bunx skills add KaleLjl\u002FMy-news --skill my-news",{"tool":40,"command":41},"pnpm","pnpm dlx skills add KaleLjl\u002FMy-news --skill my-news","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FKaleLjl\u002FMy-news\u002Fblob\u002Fmain\u002Fskills\u002Fmy-news\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Finstall.md","REFERENCE","参考文档",10505,"https:\u002F\u002Fgithub.com\u002FKaleLjl\u002FMy-news\u002Fblob\u002Fmain\u002Fskills\u002Fmy-news\u002Freferences\u002Finstall.md",[52],{"skillNo":53,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M734S5DGGMPQ63RN26Q1570Y","https:\u002F\u002Fgithub.com\u002FKaleLjl\u002FMy-news\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmy-news\u002FSKILL.md",[],[]]