cninfo-rss

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 精确过滤。

用法

# 手动（先 dry-run 看真实样本，不写归档、不动水位）
python3 skills/cninfo-rss/scripts/run.py --dry-run

# 全量执行：写 feeds + 归档 L3 到 knowledge-base + 推进 state.json
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        # 先生成 feeds/*.xml
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 早间流程（建议）

1. 晨间跑一遍 run.py --apply（或 LaunchAgent 自动跑）。
2. 人工扫 review-queue/cninfo-rss-*.json（hard_delta+high 候选）。
3. 对确认的条目走 disclosure-archive 的 apply_review_queue.py（Stage 8）或 entity-delta-ingest / hard-fact-review 入库。
4. 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。