A股证据链事件雷达

把公告、监管披露、财经新闻与盘中异动融合成一张有来源、有反证、有推送理由的事件卡。它解决的不是“消息不够多”，而是重复转载、传闻混入、因果乱配和自选股噪声太多。自动去重只覆盖精确内容指纹和显式标注的共同来源；没有来源标注时，不声称能自动识别所有改写转载。

注册表验证的一手来源或双重独立印证 → 自选股相关 → 无可信冲突 → 时间有效 → 才有资格推送。

一眼看懂输出

一张事件卡同时回答五个问题：发生了什么、影响谁、证据来自哪里、为什么值得提醒、什么情况会推翻判断。默认只生成脱敏预览，不会因为标题命中就向外发送。

为什么值得用

常见股票机器人在标题命中关键词后立即转发。本项目多做了一层“证据工程”：

能力	关键词转发器	价格提醒器	A股证据链事件雷达
公告 / 新闻采集	✓	—	✓
同事件跨来源聚类	—	—	✓
转载不冒充独立信源	—	—	✓
确认 / 否认冲突拦截	—	—	✓
自选股、行业、关键词相关性门槛	部分	✓	✓
可审计评分拆解	—	—	✓
飞书 / 钉钉 / 企微 / Telegram / Bark / Webhook	部分	部分	✓
默认不发送、密钥脱敏	—	—	✓
公开回归评测	—	—	✓

30 秒离线体验

只需要 Python 3.10+，没有第三方运行时依赖，也不会发起网络请求。

Windows 若 python 打开 Microsoft Store，请安装 Python 3.10+ 并将下方命令中的 python 替换为 py -3.10；Linux/macOS 通常可替换为 python3。

# 1. 环境与离线冒烟检查
python skills/monitor-a-share-events/scripts/doctor.py

python skills/monitor-a-share-events/scripts/validate_config.py `
  --config skills/monitor-a-share-events/assets/examples/radar-config.json

# 2. 一条命令完成采集、映射、聚类与证据卡生成
python skills/monitor-a-share-events/scripts/run_radar.py `
  --config skills/monitor-a-share-events/assets/examples/radar-config.json

# 3. 运行公开行为基准
python skills/monitor-a-share-events/scripts/evaluate_radar.py

期望结果：自检显示 READY，当前公开回归套件显示 40/40 (100.0%)。这只表示 40 个公开虚构案例符合预期，不代表真实市场准确率。

已有标准 JSON/JSONL 事件时，可直接运行：

python skills/monitor-a-share-events/scripts/fuse_events.py `
  --events skills/monitor-a-share-events/assets/examples/events.jsonl `
  --watchlist skills/monitor-a-share-events/assets/examples/watchlist.json `
  --source-registry skills/monitor-a-share-events/assets/examples/source-registry.json `
  --now 2026-07-21T10:00:00+08:00 `
  --format markdown `
  --include-held

输出示例见 alert-preview.md。

安装为 Codex Skill

将 skills/monitor-a-share-events 复制或软链接到你的 Codex 配置所使用的仓库级或个人级 Skills 目录。OpenAI Skills 概览将 Skill 说明为可移植且受 Codex 支持的工作流；具体安装入口可能因账号和工作区而异。本仓库也包含 .codex-plugin/plugin.json，可作为插件分发。

# 仓库级安装示例
New-Item -ItemType Directory -Force .agents\skills | Out-Null
Copy-Item -Recurse skills\monitor-a-share-events .agents\skills\monitor-a-share-events

安装后可直接说：

使用 $monitor-a-share-events 监控我的 A 股自选股，把公告、新闻和行情反应合并成低噪声证据卡，先预览，不要发送。

也可以让 $skill-installer 从 GitHub 仓库安装。项目公开发布后，我们计划再打包为可安装插件，降低分发门槛。

工作流

flowchart LR
    A["公告 / RSS / Atom / JSON Feed"] --> B["字段归一化与股票映射"]
    B --> C["同事件聚类"]
    C --> D{"证据门"}
    D -->|"注册表验证的一手来源或双重独立印证"| E{"相关性门"}
    D -->|"证据不足"| H["Held 待核验队列"]
    E -->|"自选股 / 行业 / 关键词命中"| F{"冲突门"}
    E -->|"无关"| H
    F -->|"无可信确认-否认冲突"| K{"时效门"}
    F -->|"存在冲突"| H
    K -->|"时间有效"| G["证据卡与安全推送预览"]
    K -->|"旧闻或未来时间"| H
    G --> I["冷却去重"]
    I --> J["显式授权后发送"]

每张卡都会公开：score_breakdown、evidence_gate、relevance_gate、conflict_gate、freshness_gate、独立来源数、原始链接、观察到的行情反应和失效条件。

接入自己的来源

collect_feeds.py 支持本地文件和用户明确提供的 HTTPS RSS、Atom、JSON Feed；collect_sse_disclosures.py 与 collect_szse_disclosures.py 分别归一化上交所、深交所的一手披露元数据。两者均配有契约和失败 fixture，但不把公开端点可访问性等同于正确性保证。

远程采集统一启用 HTTPS、公网地址校验、响应体上限、有限跳转与重试、按主机限速，以及可选的 ETag/Last-Modified 缓存。它不登录、不绕过验证码、不抓取付费墙，也不会把“解析成功”当成“事实已证实”。

python skills/monitor-a-share-events/scripts/collect_feeds.py `
  --feed https://your-authorized-source.example/feed.xml `
  --watchlist my-watchlist.json `
  --source-tier 3 `
  --output events.jsonl

--source-tier 只是操作者声明；融合器不会信任事件文件中的 source_tier_verified，而会重新读取来源注册表并校验规范 https 链接或注册表认可的稳定 ID。采集器会用精确内容指纹合并完全相同的跨站转载，改写稿仍需设置相同 evidence_origin；旧闻重发应填写底层 event_at，避免刷新时效。事件契约见 event-schema.md，来源规则见 source-policy.md。

安全推送

默认模式只输出脱敏预览，不执行外部写入：

$env:FEISHU_WEBHOOK_URL = "https://example.invalid/webhook/secret"
python skills/monitor-a-share-events/scripts/push_alert.py `
  --channel feishu `
  --input skills/monitor-a-share-events/assets/examples/alert-preview.md

只有用户明确授权外部发送后才添加 --send。Webhook、Bot Token、Chat ID 等密钥必须放在环境变量中，禁止提交到仓库。

公开评测与质量承诺

公开套件由核心案例和边界案例组成，共 40 个虚构案例，覆盖权威来源、独立印证、共同来源计数、冲突、相关性、时间边界、伪造 Tier 1、旧闻重发、事件类型和精确内容指纹。

python -m unittest discover -s tests -v
python skills/monitor-a-share-events/scripts/evaluate_radar.py

“40/40”只代表当前公开案例全部符合预期，不代表真实市场准确率。欢迎提交匿名化失败案例，让评测集比宣传数字更有价值。

早期 Beta 试用

项目正在寻找 5 位真实试用者：Codex 工作流维护者、A 股公开信息研究者，或 Feed/事件数据集成开发者。测试约 15 分钟，默认离线、默认不发送，也不应提交真实持仓或任何密钥。请阅读 Beta 测试说明，并使用结构化的 Beta feedback Issue 模板提交反馈。

已核验的采用证据记录在 ADOPTERS.md，决策和发布责任记录在 GOVERNANCE.md。没有真实证据时保持为空，不用估算值补齐。

Codex 维护证据

codex-maintenance-preview 工作流可手工选择一个已审核的公开 Issue，生成回归建议。只有显式启用 call_api 才会调用 API；输出以 artifact 供人工复核，并记录 API 返回的 token 用量。人工接受率与节约时间按 docs/maintenance-metrics.md 口径记录，在真实运行前不作任何成效声明。

路线图

参与贡献

最有价值的贡献不是增加更多转发源，而是：来源适配器、失败样本、聚类反例、独立性标注和安全通知渠道。开始前请阅读 CONTRIBUTING.md 与 SECURITY.md。

如果这个方向对你有用，欢迎 Star、分享一个匿名化失败案例，或认领路线图中的小任务。真实使用反馈会直接进入公开评测，而不是只留在 Issue 里。

Codex 开源支持

项目适合用 Codex 持续维护来源适配器、回归样本、失败分类和安全审查。申请材料草稿见 docs/codex-sponsorship-application.md。申请时只提交可验证的公开数据，不虚构 Star、用户数或采用情况。

边界与免责声明

只处理用户有权访问的公开信息，不绕过登录、付费墙、验证码、robots 规则或访问限制。
免费公开数据可能延迟，不等同于交易所级实时行情。
行情异动是观察结果，不自动证明某条新闻导致价格变化。
不接触券商账户、不保管下单凭据、不执行交易，也不提供确定性买卖建议。

MIT License。详见 LICENSE。

FilesExpand file tree

README_ZH.md

Latest commit

History