# Firsthand Source Manager

> 维护 ai-frontier-daily 的一手信源清单 firsthand-sources.yaml。新增信源（探测订阅方式并写入）、列出信源健康状态。用户说"帮我监控这个网页 / 加个信源 / 看看信源健康度"时使用。

- Skill: `yinjialu/firsthand-source-manager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yinjialu/firsthand-source-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yinjialu/firsthand-source-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yinjialu (https://skillmd.com/u/yinjialu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yinjialu/firsthand-source-manager

---


# 一手信源管理

## add <url>

1. 调 firsthand-source-subscriber 探测订阅方式（rss / html-links）。
2. 生成 source 条目（id 用域名+路径推导的 kebab-case），追加到 `firsthand-sources.yaml`。
3. 提示用户：下一轮 launchd（每小时）或手动 `launchctl kickstart -k gui/$(id -u)/com.yinjialu.ai-frontier-daily.firsthand` 生效；该源**首刊静默**（只把当前文章标记已见，**不开 PR、不备份历史内容**）。

**首刊不自动备份历史内容**——这是刻意的默认行为。是否备份历史是**可选项**，仅当用户**显式要求**时才做（见下方 backup）。

## backup <id>（可选，仅用户显式要求时）

把某个源**当前列表的历史文章**全部抓取+摘要+写 OKF，开一个备份 PR 入库。做法：用一份临时 state（`{<id>: {"initialized": true}}`，无 open_pr_urls）跑 `run_once`，使该源当前文章全部当「新文章」走 OKF+PR 流程；OKF 写真实 `data/firsthand/<id>/`，再单独提 `firsthand/<date>` 分支 PR。**不要在 add 时自动触发。**

## list

读 `data/firsthand-state.json`，每个源输出：id、last_fetch_ok（失败显示 last_fetch_error）、last_new_article、已入库篇数（扫 `data/firsthand/<id>/` 的 .md 文件数）。
`last_checked`（上次运行时间，每小时变）在本地 `data/.firsthand-heartbeat.json`（gitignore，不提交），需要看「是否还在跑」时读它。

## 阶段二

- `health`：标记 last_fetch_ok=false 或异常沉默的源。
- `remove <id>`：从 yaml 移除并归档 state。