| name | cninfo-rss |
| description | 可配置的巨潮公告分类订阅器：按分类+关键词+自选股抓取全市场披露，输出标准 Atom RSS，并把命中的官方公告作为 L3 候选(L1_L3_candidate)归档到知识库 wiki/raw/disclosures 供 review。触发：巨潮RSS、公告订阅、cninfo rss、补L3公告。 |
cninfo-rss · 巨潮公告分类订阅 + L3 证据补库
按指定公告类别 + 标题关键词 + 自选股范围抓取全市场披露 →
输出标准 Atom RSS（任意阅读器可订阅）+ 把命中的官方公告作为 **L3 候选
（L1_L3_candidate）**归档到 knowledge-base-private/wiki/raw/disclosures/，供 review。
口径（重要）：本 skill 只读公告标题 + 元数据、不解析 PDF 正文，因此按 KB
skills/lib/INGEST_FIELD_STANDARDS.md 口径只能产出 候选线索
（evidence_layer=L1_L3_candidate + fact_hardness=review_candidate +
review_required=true），不得直接当 L3 hard_fact。升级为真 L3 需经
disclosure-archive：下 PDF → OCR/解析正文 → 抽可验证事实 → 映射
概念/chain_layer → review → 写入 ## 边际变化。
不是 FinHot 替代品；不默认写 entities/ 正文；不把未解析公告当 L3 硬事实。
触发词
巨潮RSS · 公告订阅 · cninfo rss · 补L3公告
L3 边界（硬规则）
| 层级 | 含义 | 本 skill |
|---|
| L2 | 公司画像 / 定期报告 baseline | 不处理 |
| L3 (hard_fact) | 已解析正文 + 抽取事实 + 概念映射的官方硬事实 | 不直接产出（需 disclosure-archive） |
| L1_L3_candidate | 命中分类/关键词、正文未解析的官方公告候选 | 处理（本 skill 产出） |
| L4 | 盘面/媒体弱信号 | 不处理 |
- 命中
exclude_any（董事会决议/核查意见/理财…）→ 直接丢弃（优先级最高）。
- 命中分类码后还要过分类内标题二次校验（
title_include_any /
title_exclude_any）才算准入——分类码只是「粗筛」，标题规则才是「准入门」。
- 命中分类（且过准入门）或
include_any 标题词 → 标候选：
evidence_layer=L1_L3_candidate + fact_hardness=review_candidate +
review_required=true（待 review）。
- 标题含低确定性词（拟/计划/预计/有望/框架协议…）→ 降级
update_type=review_candidate + confidence=low，不进 entity 正文。
- 组合规则收紧 hard_delta：「宽词」（签订/产能/亏损/增持/减持）单独命中只算
review_candidate；标题须含 hard_delta_combo_rules 同组伴随词（如 签订+合同/订单、
产能+投产/达产）才升级 hard_delta + confidence=high。
- 其余 →
update_type=hard_delta + confidence=high。
架构（三层，可独立运行）
cninfo 直连 API（hisAnnouncement/query，POST，不依赖公共 RSSHub）
↓ fetch_cninfo.py：分类码 + searchkey 关键词 + 自选股(stock) 抓取
↓ 归一化 + 去重(announcement_id) + 市场/关键词过滤 + L3 分类
┌────────────────────────┬──────────────────────────────┐
│ A. RSS 输出 │ B. 知识库 L3 归档 │
│ emit_rss.py → feeds/*.xml│ archive_l3.py → wiki/raw/... │
│ state.py 增量水位 │ manifest.jsonl + review-queue │
└────────────────────────┴──────────────────────────────┘
↓（可选）C. FinHot / 任意 RSS 阅读器订阅 feeds/*.xml
为什么直连 cninfo 而非 RSSHub：rsshub.app 常 403/503，本机 RSSHub 无 cninfo 路由；
直连 API 字段全（announcementId 做稳定去重键）、可按 category/searchkey 精确过滤。
用法
python3 skills/cninfo-rss/scripts/run.py --dry-run
python3 skills/cninfo-rss/scripts/run.py --apply
python3 skills/cninfo-rss/scripts/run.py --dry-run --limit 3 --lookback-days 3
python3 skills/cninfo-rss/scripts/run.py --apply --kb-dir /abs/path/disclosures
python3 -m unittest discover -s skills/cninfo-rss/tests
dry-run 与 apply 都会重写 feeds/*.xml（feed 每次按窗口全量重生成，幂等）；
区别：apply 才写知识库归档并推进增量水位。
配置（config.yaml）
| 键 | 说明 |
|---|
lookback_days | seDate 回看天数（默认 7） |
markets | 保留市场 szse/sse/bj，按 code 前缀判定 |
watchlist_codes | 空=全市场；非空=只保留这些代码（并走 stock 精确查询） |
max_pages_per_source | 每分类/关键词最多翻页数（控时长 + 防封） |
rate_limit_seconds | 串行请求间隔 |
output.rss_dir / output.kb_archive_dir | RSS / 归档落点（相对路径相对仓库根） |
l3_categories | 巨潮分类码 + fact_types + enabled + 分类内标题准入门 |
l3_categories[].title_include_any/exclude_any | 分类命中后的标题二次校验（粗筛 → 准入门） |
l3_title_keywords.include_any/exclude_any | 关键词命中/排除 |
low_confidence_keywords | 触发降级为 review_candidate |
fact_type_by_keyword | 关键词 → fact_type 映射 |
hard_delta_combo_rules | 宽词需配伴随词才升 hard_delta，否则降 review_candidate |
输出
feeds/l3-candidates-hard-delta.xml — 全市场 L3 候选 · 高确定性合集（update_type=hard_delta 的命中；旧名 l3-hard-delta.xml，重命名避免误读为已验证硬事实）feeds/by-category/{code}.xml — 每个订阅分类一份（hard + review）feeds/by-fact-type/{fact_type}.xml — 每个事实类型一份（细颗粒度订阅：订单合同/客户定点/注册获证/量产投产/增减持…各自独立 feed，hard + review 都进）feeds/watchlist.xml — 仅 watchlist_codes（为空时镜像全部）feeds/state.json — 增量去重水位（seen_ids + high_water_ms）- 知识库归档（仅 --apply）：
wiki/raw/disclosures/YYYY-MM-DD/cninfo_{code}_{id}_{slug}.md（仅 hard_delta+high）manifest.jsonl（全量；review_candidate 只进这里）review-queue/cninfo-rss-{batch_id}.json（仅 hard_delta+high，待人工审）
归档只写 disclosures，绝不碰 entities/ / concepts/ / relations/ / evidence_index。
定时（macOS LaunchAgent）
模板见 templates/com.kb.cninfo-rss.plist（每 30 分钟跑一次 --apply）。安装：
cp skills/cninfo-rss/templates/com.kb.cninfo-rss.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.kb.cninfo-rss.plist
在 FinHot 订阅
feed 是本地文件，FinHot 订阅的是 URL，所以先用任意静态服务把 feeds/ 暴露成 HTTP：
python3 skills/cninfo-rss/scripts/run.py --apply
python3 -m http.server 8787 --directory skills/cninfo-rss/feeds
然后在 FinHot 里「添加订阅」填：
http://localhost:8787/l3-candidates-hard-delta.xml（全市场 L3 候选 · 高确定性）http://localhost:8787/by-category/category_gqjl_szsh.xml（按分类，如股权激励）http://localhost:8787/by-fact-type/order_contract.xml（按事实类型，如重大合同/订单；另有 customer_validation / regulatory_approval / mass_production 等）http://localhost:8787/watchlist.xml（仅自选股）
本 skill 输出的就是合法 ISO8601 日期，FinHot 可直接解析；parseRssFeed
已加固为兼容毫秒时间戳（<published>1782748800000</published>，旧 PyRSSHub
巨潮源会这样输出），不再抛 Invalid time value。
关掉这些公告的 AI 富集（保持纯硬筛）
FinHot 本地订阅默认会对新条目触发 BYOK AI 富集（摘要/翻译/标签/质量评分）。
要让这些公告只展示、不走 AI，在 FinHot 设置 → Actions 里加一条规则：
- 条件（When）：
feed_url contains l3-candidates-hard-delta（或 :8787，按你的 feed 地址）
- 动作（Then）：勾选 Skip AI Enrichment（跳过 AI 富集）
命中后条目照常入库、照常显示（标题/摘要/PDF 链接都在，非黑盒），仅跳过 AI
富集；排序是本地启发式（不调用 AI），不受影响。
注意：FinHot 仅做订阅与展示，配合上面的规则即不对这些公告做 AI 打分/摘要
——本 skill 是纯硬性筛选，只产出知识库所缺的 L3 候选线索（待 review 升级为 L3）。
接入 daily-ops 早间流程（建议）
- 晨间跑一遍
run.py --apply（或 LaunchAgent 自动跑）。
- 人工扫
review-queue/cninfo-rss-*.json（hard_delta+high 候选）。
- 对确认的条目走
disclosure-archive 的 apply_review_queue.py（Stage 8）或
entity-delta-ingest / hard-fact-review 入库。
- review_candidate（low）仅留 manifest，供 theme-radar 排序与人工复核，不自动 apply。
非目标
- 不解析 PDF 全文（交给 disclosure-archive 人工/OCR）。
- 不做题材自动映射（
theme_term 留空）。
- 不自动写 entity 正文，不接入 FinHot watchlist auto-import（仅手动订阅 feed URL）。
- 不对公告做 AI 打分/摘要/翻译——纯硬性筛选，只补 L3 候选线索（正文交 disclosure-archive 解析）。
- 不依赖 akshare / requests（仅标准库 + PyYAML）。
经验与坑（按日期追加）
- 2026-06-30：初版。巨潮
column 参数实测不按市场过滤，市场过滤改用 code 前缀；
category 与 searchkey 服务端过滤有效；标题需去 <em> 高亮标签（已设 isHLtitle=false 兜底）。
「股权激励计划」类标题因含「计划」会被降级为 review_candidate，属预期（保守）。
- 2026-06-30（准入收紧）：dry-run 实测分类码命中即 hard_delta 太宽（近 3 天每源 1 页
抓 201 条、hard_delta 132，混入担保进展/H 股招股/问询回复/董事会决议/风险提示等）。修正：
category_yjkb_szsh（业绩快报）实测返回大量全量公告 → 关闭，业绩快报改走标题关键词；category_zj_szsh 巨潮官方含义是中介报告（非增减持）→ 改用 category_gqbd_szsh
（股权变动）并要求标题含 增持/减持/权益变动/持股变动/股份变动；- 分类命中后加标题二次校验（
title_include_any/exclude_any）；
- 扩充
exclude_any（担保/问询函/关注函/回复/股东会决议/风险提示/专项说明/承诺函…）；
- 新增
hard_delta_combo_rules：宽词（签订/产能/亏损/增持/减持）需配伴随词才升 hard_delta；
- feed 重命名
l3-hard-delta.xml → l3-candidates-hard-delta.xml（避免误读为已验证硬事实）；
FinHot 订阅 URL 需同步改为 …/l3-candidates-hard-delta.xml。
