# InvesResearch · 开发计划与记录 > **文档定位**：本文件是项目的**主开发计划文档**，同时承担开发记录职责。 > 每次开发会话结束后，在 [§5 开发记录](#5-开发记录) 顶部追加一节（倒序，最新在前）。 > 宏观路线图变更时同步更新 [§3 路线图](#3-路线图) 与 [§4 当前排期](#4-当前排期)。 > > **关联文档**：[`DEVLOG.md`](./DEVLOG.md)（历史流水账）· [`NEXT-STEPS.md`](./NEXT-STEPS.md)（历史规划档案）· > [`agent/reports/dev-roadmap-2026-06-15.md`](./agent/reports/dev-roadmap-2026-06-15.md)（Tier 1-3 详细拆解） --- ## 1. 系统现状快照（2026-06-29） ### 1.1 版本与质量指标 | 维度 | 当前值 | 说明 | |---|---|---| | 版本 | **v0.7.0** | wiki NER Direction-A/B/C/D + `/wiki` REST 端点 + 知识图谱概念热图面板 | | 测试 | **688 passed** | 0 回归，691 collected / 3 skipped；7 条 litellm(cffi/pyo3) 单测仅在缺 `.[dev]` 依赖的沙箱失败，CI 全绿 | | 分类质量（corpus） | **63.1%** | labeled_validation 203 条，含 Tier-1 B strategy +2pp | | 分类质量（盲测） | **0.68** | labeled_real 25 条独立盲测集 | | 合成集 | **1.00** | 始终守住 | | LLM 分类 | **opt-in** | `SATAGENT_LLM_EMPTY_FALLBACK` 门控，实测净 0.0pp，默认关 | ### 1.2 自动化运行状态（阶段 A · 全量在线） | 任务 | 频率 | 状态 | |---|---|---| | `data-refresh` | 每 6 小时 | ✅ 持续运行（761 条 events 归档，每日自动提交） | | `daily-feishu` | 每日 UTC 00:37 | ✅ 连续运行，中文日报（glm-4.6 翻译） | | `weekly-feishu` | 周一 01:37 | ✅ 每周正常推送 | | `failure-alert` | workflow 失败时 | ✅ 飞书红卡告警 | ### 1.3 当前数据活水 | 来源 | 条数 | 类型 | 说明 | |---|---|---|---| | wiki-timeline | 487 | 静态历史 | 商业航天 wiki 知识库，不更新 | | HarnessFarm | 125 | 静态种子 | 行业报告结构化事件 | | SpaceNews | 48 | RSS 英文 | 主力活水，每 6h 刷新 | | SatNews | 41 | RSS 英文 | 商业卫星新闻 | | Space Intel Report | 14 | RSS 英文 | 卫星运营商高密度 | | Spaceflight Now | 11 | RSS 英文 | 发射/飞行任务 | | European Spaceflight | 9 | RSS 英文 | 欧洲卫星 | | ShockEvents | 20 | 静态种子 | 历史冲击事件 | | 国家航天局（CNSA） | 6 | operator 桥 | 首批已入库，需 operator 定期维护 | | **X 推文** | **0（代码已建）** | operator 桥 | 待 operator 首次 commit | **已知架构约束**：GitHub Actions（美区 Azure IP）被 GFW 封锁，无法直接抓取中国 gov/SOE 站。中文信号进线只有两条路：① operator 桥（本机抓 + commit JSONL）；② 阶段 B 中国服务器常驻。 ### 1.4 已明确停止的方向 | 方向 | 停止原因 | |---|---| | LLM 覆盖分类（threads/impact） | v22/v23 净减分，v23 conditional -4.0pp，定论 rules-only | | threads 侧千帆组网修复 | 两份标注集口径冲突（hf_R003 vs n023），续 37/41 两次实证原则性停止 | | 进一步质量攻坚 | 63.1% 已到自然终点，剩余失败多为标注哲学不一致，非代码可解决 | --- ## 2. 架构概览 ``` 数据源层 处理层 输出层 ──────────────────── ────────────────────── ─────────────────────── RSS 英文源（4 个） ──┐ wiki-timeline ──┤ ingest_pipeline.py 飞书日报（中文） HarnessFarm ──┼──► classifier.py ─────► 飞书周报（CEO+投资双视角） ShockEvents ──┤ extract.py 实时看板 index.html InvestorManifest ──┤ decide() agent/docs/live.html CNSA operator 桥 ──┤ valuation.py X operator 桥 ──┘ market_model.py 调度层：EH-1 jobs（SQLite） + GitHub Actions cron（外部触发） 通知层：FeishuClient（webhook + 签名 + 重试 + 双通道） API 层：FastAPI /events /decision /alerts /thesis /valuation（Bearer 鉴权） 观测层：Prometheus /metrics + failure-alert workflow ``` **两条产品线**（不共享 schema）： - `agent/` → **Satellite Agent**：卫星互联网垂类，events/companies/threads schema，已在线迭代 - `web/` → **InvesResearch Agent**：通用调研系统，PRD 纸面，未开工 --- ## 3. 路线图 ### Tier 1 · 我可独立推进（无外部依赖） | 编号 | 项目 | 优先级 | 估时 | 状态 | |---|---|---|---|---| | T1-A | InvestorManifest 0 命中修复 | **P0** | 0.5 轮 | ✅ 续41 已完成 | | T1-B | daily-report 看板趋势视图 | P1 | 0.5 轮 | ✅ 续49 已完成 | | T1-C | FE Round 2 · D（公司 segments 维度） | P2 | 1 轮 | ✅ 续50 已完成 | | T1-D | FE Round 2 · E（3 层叙事/敏感度传导） | P2 | 1 轮 | ✅ 续51 已完成 | | T1-E | FE Round 2 · F（数据来源 Ledger）| P2 | 1 轮 | ✅ 续52 已完成 | | T1-F | wiki/people → extract.py NER 词表 | P3 长尾 | 0.5 轮 | ✅ 续53 已完成 | ### Tier 2 · 需 operator 一次性动作 | 编号 | 项目 | operator 动作 | 代码状态 | |---|---|---|---| | T2-A | X 轻量桥上线 | 跑 `export_x_events.py` + commit | ✅ 代码已建（续 40） | | T2-B | CNSA operator 桥维护 | 定期跑 `export_cnsa_events.py` + commit | ✅ 首批已入库（续 47） | | T2-C | 阶段 B 服务器（阿里云 2C2G） | 买机器 + 跑 `setup_server.sh` | ✅ 脚本+文档已就绪 | ### Tier 3 · 战略级（较大投入，有触发条件） | 编号 | 项目 | 触发条件 | 状态 | |---|---|---|---| | T3-A | SQLite → Postgres 迁移 | 多用户同时写入时 | 设计已完成（`postgres-migration-design-2026-06-17.md`） | | T3-B | expert wiki 双向闭环（X→wiki 回写） | X 信号主线跑通后 | 代码半建成（`wiki_index.py` + `x_to_wiki.py`） | | T3-C | debate → LangGraph checkpointer | 复杂任务拆解需求出现时 | 未启动 | | T3-D | agent CLI → FastMCP | web 端 M2/M3 共建时 | 未启动 | | T3-E | web 端 M1 数据层启动 | Tier 2 对齐完成后 | 纸面 PRD | | T3-F | agent 多市场延伸（低空/储能/人形） | 卫星主线稳定运营后 | 未启动 | --- ## 4. 当前排期（2026-06-28 更新） > **Tier-1 全部完成**（续41→续54）。Direction-B/C/D + /wiki API 均已上线。当前进入 Tier-2 等待阶段。 ### 4.1 待命 · T2-A/B · operator 桥（等 operator） | 任务 | 代码状态 | operator 动作 | |---|---|---| | T2-A X 轻量桥 | ✅ 已建（续40）| 本机跑 `export_x_events.py` + commit JSONL | | T2-B CNSA 桥维护 | ✅ 首批已入库（续47）| 定期跑 `export_cnsa_events.py` + commit | **X 桥操作**（约 2 分钟，详见 `agent/docs/x-bridge-operator-runbook.md`）： ```bash bash agent/scripts/run_x_scrape.sh python agent/scripts/export_x_events.py git add agent/data-live/x-events-archive.jsonl && git commit -m "data: X 事件刷新 $(date +%Y-%m-%d)" && git push ``` --- ### 4.2 ✅ 完成 · Direction-B · 人物 NER 集成 **背景**：`expert/wiki/people/` 有 64 位行业人物（Elon Musk / Gwynne Shotwell / 钟南山等），`wiki_ner.py` 已能 NER 人名；`wiki_index.py` 有 `load_index()` 同时覆盖 entities + people。 **目标**：事件文本出现已知人物时，在 DB 记录 `people` 字段（JSON 数组 → 显示名列表），看板卡片展示人名徽章。 **状态**：✅ 续55 已完成。`match_people()` 接入 ingest pipeline，`events.people` 已落盘，看板渲染 sage 绿 👤 徽章。 **工作量估算**： 1. DB migrate：`events` 表加 `people TEXT DEFAULT '[]'`（自动 `ALTER TABLE`，向后兼容） 2. `repository.py`：`insert_event()` + `match_people()` 新函数；`ingest_pipeline.py` 调用注入 3. `wiki_reader.py`：`_get_cached_people_index()` 类似 entity index，alias len≥4 + 词边界 4. 看板：人名小徽章渲染（纯前端，inline 到 index.html） 5. 测试：5-8 条新测试 **验收**：corpus baseline 0.631 不回归；至少 3 条真实事件能正确识别人名 --- ### 4.3 ✅ 完成 · Direction-C · wiki 概念标签 **背景**：`expert/wiki/concepts/` 有 392 个行业概念（NTN、ADR、低轨宽带等）。 **目标**：事件匹配到概念别名时，记录 `concept_tags`，供决策报告"背景概念"段引用。 **状态**：✅ 续56 已完成。`match_concepts()` 接入 ingest pipeline，`events.concept_tags` 已落盘，看板渲染 clay 橙色 chip。 --- ### 4.4 ✅ 完成 · Direction-D · 概念→主线证据注入 **背景**：Direction-C 的 `concept_tags` 仅作元数据，与 `classify()` 线索分类未联动。 **目标**：当 `match_concepts()` 命中某概念时，将其归属的主线注入分类证据，补充纯关键词匹配的盲区（如别名覆盖 `THREAD_KEYWORDS` 未收录的变体）。 **状态**：✅ 续57 已完成。`CONCEPT_THREAD_MAP`（21 条，覆盖 5 主线）+ `enrich_threads_from_concepts()` 纯加法注入，corpus baseline 0.631 无回归。 --- ### 4.5 ✅ 完成 · /wiki API 端点 **背景**：wiki 实体/人物/概念三个子目录缺少 REST 只读浏览接口。 **目标**：`GET /wiki/entities`, `/wiki/people`, `/wiki/concepts`, `/wiki/threads` — 结构化元数据列表，支持 type/category 过滤。 **状态**：✅ 续57 已完成。4 个端点上线，`/wiki/threads` 返回 Direction-D 映射表 JSON 视图，17 个新测试覆盖。 --- ### 4.6 ✅ 完成 · 概念热图面板（知识图谱看板） **背景**：`build_concept_freq()` + `/wiki/concept-stats` + 看板 `wk` 面板 — 让投研者一眼看出哪些行业概念在近期事件中高频出现。 **目标**：全链路交付：Python 函数 → REST 端点 → 静态快照 → 看板面板（含主线着色 + inline snapshot 零网络降级）。 **状态**：✅ 続58 已完成。`build_concept_freq()`（`report.py`）+ `GET /wiki/concept-stats`（`api.py`）+ `concept_stats.json` 快照 + `wk` 面板（`index.html` + `live.html`，概念 chip + 主线色 + inline snapshot 同步），11 个新测试覆盖。 --- ## 5. 开发记录 > **格式规范**：每次开发会话结束后，在本节**顶部**追加一节（倒序，最新在前）。 > 必填字段：日期 · 会话续号 · 主题标题 → commit 列表 → 关键指标变化 → 遗留/待办。 > 单次会话横跨多天时，每天末尾追加小节。 --- ### 2026-06-29 · 续 59 · v0.7.0 文档全量对齐 + 版本号统一 + 测试计数纠偏 **主题**：续 58 wk 面板交付后，把全仓文档/网页统一到 v0.7.0，并修正长期失真的测试计数。 **commits**： - `docs: 更新所有文档至 v0.7.0`（CHANGELOG / README / agent/README / api.md / portal.html） - `chore: 版本号统一至 v0.7.0`（`__init__.py` `__version__` 0.6.0→0.7.0；DEVELOPMENT-PLAN §1.1） - `docs: 测试计数纠偏 651→688`（本节） **关键修正**： - **`__version__` 0.6.0 → 0.7.0**：代码版本常量此前落后文档两个版本；`/health`、`/wiki` 端点均引用它，现与全部文档对齐。 - **测试计数 651 → 688**：实测 `pytest` 全量 collected **691 / passed 688 / skipped 3**；旧"651"为陈旧低估（差 37）。7 条 litellm(cffi/pyo3) 单测仅在缺 `pip install -e ".[dev]"` 的沙箱失败，CI（`agent-ci.yml` 装全 dev 依赖）全绿。已统一刷新 README/CHANGELOG/agent/README/portal/DEVELOPMENT-PLAN。 **关键指标**： - tests：**688 passed**（691 collected / 3 skipped） - corpus baseline：**0.631 ✓**（无分类变动） - 公网地址：`https://invesresearch.pages.dev`（Cloudflare Pages，`main` 分支 + `data-refresh.yml` 每 6h 触发部署） **遗留/待办**：Tier-1 全部完成，进入 Tier-2 等待（X 桥 / CNSA 桥 / 阶段 B 服务器，均 operator 一次性动作，代码已就绪）。当前分支 `claude/epic-wright-1ow2ti` 待合并 `main` 后上公网。 --- ### 2026-06-28 · 续 58 · 概念热图面板（知识图谱 · wk panel） **主题**：全链路交付"概念热度"看板面板 — `build_concept_freq()` → `GET /wiki/concept-stats` → `concept_stats.json` 快照 → `wk` 面板（index.html + live.html）。 **交付**： - `report.py`：`build_concept_freq(conn, *, window_days, limit, end_date)` — 从 `events.concept_tags` 聚合频率，按 `CONCEPT_THREAD_MAP` 映射 thread 字段 - `api.py`：`GET /wiki/concept-stats?window=90&limit=30` — 调用 `build_concept_freq`，支持 window/limit 参数 - `scripts/refresh_live_snapshot.py`：生成 `docs/sample/concept_stats.json` 快照 - `index.html` + `live.html`： - CSS：`.panel.wk` + `.wk-legend` + `.wk-chips` + `.wk-chip.t-{主线}` 5色方案 - HTML：`
` — 全宽，图例 + 概念 chip - DEMO_SNAPSHOTS：新增 `'/wiki/concept-stats?window=90&limit=30'` → `concept_stats.json` - INLINE_MAP：新增 `INLINE_SNAPSHOT.concept_stats` 映射 - inline snapshot：注入 `"concept_stats": [...]` 数据（零网络降级） - `renderConceptHeat(arr)`：渲染函数，thread→色，×N 次数 - `loadAll()`：新增 wk 任务行 **测试**： - `test_report.py`：`build_concept_freq` 7 个单测（空库、计数、主线标注、未知概念 null、时间窗口过滤、降序、limit） - `test_wiki_api.py`：`TestWikiConceptStats` 4 个测试（返回列表、空库、参数、字段结构） **关键指标**： - tests：**688 passed**（+11 新测试，691 collected / 3 skipped；7 条 litellm 单测仅缺 `.[dev]` 沙箱失败） - corpus baseline：**0.631 ✓**（无新分类变动） --- ### 2026-06-28 · 续 57 · Direction-D 概念→主线证据注入 + /wiki API 端点 **主题**：两个功能并行交付。Direction-D 将 wiki 概念 NER 结果反馈到线索分类证据层；/wiki API 提供三类 wiki 子目录的 REST 只读浏览接口。 **交付 A · Direction-D：** - `ontology.py`：`CONCEPT_THREAD_MAP: dict[str, list[Thread]]`（21 条，覆盖 5 主线），key = concept `display`（aliases[0]） - `classifier.py`：`enrich_threads_from_concepts(concept_tags, cls) -> dict`，纯加法：将命中概念对应的主线写入 `evidence["concept_threads"]` 并追加至 `cls["threads"]`（不重复），不修改已有分类结果 - `ingest_pipeline.py`：在 LLM 步骤之后调用 `enrich_threads_from_concepts(concept_tags, cls)` - `test_direction_d.py`：17 个测试（CONCEPT_THREAD_MAP 结构、enrich 单元行为、ingest 集成） **交付 B · /wiki API 端点（`api.py`）：** - `GET /wiki/entities`：wiki entities/ 实体列表，支持 `?type=公司` 过滤，按 slug 去重排序 - `GET /wiki/people`：wiki people/ 人物列表，含 role/affiliation/country/aliases - `GET /wiki/concepts`：wiki concepts/ 概念列表，支持 `?category=技术` 过滤，按 slug 排序 - `GET /wiki/threads`：CONCEPT_THREAD_MAP JSON 视图（concept → threads 列表），Direction-D 元信息 - `test_wiki_api.py`：17 个测试（/wiki/threads 无 wiki 依赖全量跑；entities/people/concepts 在 wiki 存在时跑） **关键指标**： - tests：606 passed（不含 test_jobs/test_llm 环境失败，新增 34 条）；3 skipped（wiki 可选路径） - corpus baseline：**0.631 ✓**（Direction-D 仅加法注入，classify() 本体不变） - CONCEPT_THREAD_MAP：21 条，覆盖全部 5 条主线 **设计决策**： - `enrich_threads_from_concepts` 放在 LLM 步骤之后（加法不覆盖 LLM 决策） - /wiki 端点纯读文件系统（进程级 lru_cache），不走 DB，无状态 - `api_wiki_concepts` 末尾补 `sorted(result, key=lambda x: x["slug"])` 保证一致排序（`-` < `.` 路径顺序 ≠ slug 字典序） **遗留**：Tier-2 等 operator 动作；wiki snapshot 可选注入到 `/wiki/threads` --- ### 2026-06-26 · 续 50-52 · T1-C/D/E 看板三面板实现 **主题**：连续三轮完成 FE Round 2 的 D/E/F 看板面板，均无新 API 调用（T1-E 除外新增 `/sources/ledger`）。 **交付**： - **续 50 · T1-C 公司矩阵**（`6a27815`）：5 主线 tab + composite 评分条 + 提及徽章 + 论点方向 + 点击公司过滤事件面板 - **续 51 · T1-D 叙事链**（`0b0af29`）：3 层认识论表格（FACT/CALC/JUDGMENT）+ quality flags 预警行 - **续 52 · T1-E 数据来源账本**（`3a9d010`）：`build_source_ledger()` + GET `/sources/ledger` API + 分类汇总 chips + 来源明细表 + `ledger.json` 快照；同步修复 `agent/.gitignore` 补 `data-live/*.db` **关键指标**： - tests：518 passed（+6 新测试，T1-C/E 各 3 条） - 零新 API 调用原则：T1-C/D 复用已有 decision 请求；T1-E 新增独立端点 - 内嵌 snapshot 每次同步刷新（两个 HTML 文件均更新） **遗留**： - T1-F wiki NER 词表：续 53 已完成（见下方） --- ### 2026-06-28 · 续 56 · Direction-C wiki 概念标签集成 **主题**：将 `expert/wiki/concepts/`（392 概念）的 frontmatter aliases 索引化，接入 ingest pipeline，每条事件自动打上领域概念标签并在看板渲染。 **交付**： - `wiki_reader.py`：`_parse_concept()` + `_get_cached_concept_index()`（1056 alias keys，len≥4 统一过滤）+ `match_concepts(text, max_tags=8)`（按 alias 长度降序优先，ASCII 词边界 / CJK 子串） - `db.py`：`events.concept_tags TEXT DEFAULT '[]'` 加入 SCHEMA + `_MIGRATIONS` - `repository.py`：`insert_event()` + `event_row_to_dict()` 新增 `concept_tags` - `ingest_pipeline.py` + `api.py`：自动调 `match_concepts()` 落盘/返回 - `index.html` + `live.html`：clay 橙色概念标签 chip（最多 3 个） - `test_concept_ner.py`：15 新测试 **关键指标**： - tests：572 passed（+16 新测试，schema 计数 15→16） - corpus baseline：**0.631 ✓**（无回归） - 概念索引：392 概念文件，1056 条 alias key（len≥4） **三条 wiki NER 管线全部上线**： | 管线 | 索引规模 | 事件字段 | 看板颜色 | |---|---|---|---| | Direction-A | 494 公司/星座 | → match_companies | sky 蓝主线 chip | | Direction-B | 64 人，~200 alias | `events.people` | sage 绿 👤 | | Direction-C | 392 概念，1056 alias | `events.concept_tags` | clay 橙 | **commits**：`742f555` people NER 渲染 · `045a4d5` concept NER 集成 **遗留**：概念标签目前仅作元数据，尚未与 thread 分类证据联动；可选 Direction-D --- ### 2026-06-27 · 续 55 · Direction-B 人物 NER 集成至 ingest pipeline **主题**：将 `expert/wiki/people/`（64 人）的 frontmatter 别名索引化，接入 `ingest_pipeline.py`，每条事件自动识别提及人名并落盘至 `events.people` 列。 **交付**： - `agent/satellite_agent/wiki_reader.py`：`_parse_person()` 解析人物 frontmatter（role/affiliation/country/aliases）；`_get_cached_people_index()` 进程级 LRU 缓存（64 人，ASCII len≥4 / CJK len≥2）；`match_people(text)` 双路径匹配（ASCII 词边界 + CJK 子串），去重返回显示名列表 - `agent/satellite_agent/db.py`：SCHEMA + `_MIGRATIONS` 新增 `events.people TEXT DEFAULT '[]'`（向后兼容老 DB） - `agent/satellite_agent/repository.py`：`insert_event()` 新增 `people` 参数 - `agent/satellite_agent/ingest_pipeline.py`：每条 RawEvent 自动调 `match_people()` 并注入 `insert_event()` + 返回结果 - `agent/tests/test_people_ner.py`：16 新测试（parse/match/集成/边界，含真实 wiki 集成验证） - `agent/tests/test_schema.py`：migration 计数 14→15 **关键指标**： - tests：556 passed（+16 新测试，schema 计数修正） - corpus baseline：**0.631 ✓**（无回归） - 人物索引：64 人，含 Elon Musk/Gwynne Shotwell/马斯克等中英双语 **commits**：`1cda56b` feat(direction-B): 人物 NER — wiki people/ 别名索引集成至 ingest pipeline **遗留**：events.people 已落盘，看板尚未渲染；Direction-C 概念标签待评估 --- ### 2026-06-26 · 续 54 · Direction-A wiki NER 集成至 match_companies **主题**：将续 53 建成的 wiki NER 词表接入 `match_companies()` 实际分类管线（两段查找），同时修复由此引发的基线回归。 **交付**： - `agent/satellite_agent/wiki_reader.py`：新增 `_get_cached_entity_index()` — `@lru_cache(maxsize=1)` 进程缓存，扫 `entities/*.md` frontmatter aliases，强制 len≥4 过滤（排除 ULA/SES/ABL 等 3 字母 ticker），仅收录 type∈{公司,星座}；索引 494 条 - `agent/satellite_agent/repository.py`：`match_companies()` 第 2 段 wiki entity 扫描（alias_lower 命中 + 大小写敏感二次验证防 "ispace" 误伤）；`company_threads()` SQLite 返回行按 `names` 输入顺序排序（修复非确定性 row order 导致的 thread_in_focus 误判） - `agent/tests/test_enrich.py`：脆弱精确列表断言改为成员检查（`assert "中国卫通" in companies`），兼容 wiki 追加命中 **关键指标**： - corpus baseline：**0.631 ✓**（修复前 wiki 接入后跌至 0.626，两轮诊断后恢复到锚定值） - tests：604/611 pass（7 条预存失败为 `test_llm/test_jobs` cffi 环境缺失，与本次无关） - wiki entity 索引：494 条 alias（alias-only，非 slug 派生，避免短缩词误伤） **根因诊断记录**（两轮）： 1. 第一轮（0.631→0.616）：`load_entity_index()` 使用 slug 派生 key（"ula"/"ast"/"ses"），3 字母词误匹配普通英文词；修复：改为 frontmatter aliases only + len≥4 → 0.616→0.626 2. 第二轮（0.631→0.626）：t006「蓝色起源 NG-3」文本含"(AST Mobile)"→ wiki 别名大小写匹配 AST SpaceMobile → `company_threads()` SQLite 非确定性行序将 AST SpaceMobile 排在 Blue Origin 前 → thread_in_focus 错判为运营支撑；修复：`company_threads()` 按输入 `names` 顺序排序 → 0.626→0.631 ✓ **commits**：`761a1b7` feat(direction-A): wiki NER 集成至 match_companies 两段查找 + 基线保护修复 **遗留**：Tier 1 全部完成；Tier 2 等 operator 动作 --- ### 2026-06-26 · 续 53 · T1-F wiki NER 词表 **主题**：实现 T1-F wiki 实体 NER 词表，将 `expert/wiki/entities/` 和 `expert/wiki/people/` 两个目录的 frontmatter 别名索引化，供运行时文本匹配使用。 **交付**： - `agent/satellite_agent/wiki_ner.py`：新模块；`_parse_frontmatter()` 解析 YAML frontmatter（支持 type / role / aliases 字段）、`load_wiki_ner_index(wiki_dir)` 扫目录构建 `{alias_lower: (canonical, type)}` 索引、`match_from_wiki(text, index)` 文本 NER 命中、`companies_only()` 类型过滤 - `agent/tests/test_wiki_ner.py`：22 个测试，含 fake entity 文件单测 + 真实 `expert/wiki/` 集成验证（SpaceX、Elon Musk 可命中，索引 ≥ 500 条） **关键指标**： - tests：540 passed（+22 新测试） - 覆盖 425 个 entities + 64 个 people，真实 wiki 索引约 1000+ 条别名 - 无副作用：wiki_ner 纯内存索引，不修改 DB；按需 import，不影响现有管线 --- ### 2026-06-25 · 续 49 · T1-A 确认收口 + T1-B 主线热度趋势视图实现 **主题**：实现 T1-B「主线热度趋势视图」，看板新增第 5 面板展示近 14 日 5 条主线每日信号强度。 **交付**： - `agent/satellite_agent/report.py`：新增 `build_thread_trend()` — `events JOIN event_threads` 按日汇总置信度，返回 14 天 × 主线结构 - `agent/scripts/refresh_live_snapshot.py`：调用 `build_thread_trend`，写 `trend.json`，更新 `_payloads` 注入两个 HTML 内嵌 snapshot - `agent/docs/sample/trend.json`：新增 trend 样本数据（2026-05-17 → 2026-05-30） - `index.html`：全宽第 5 面板（`
`），5 线迷你条形图（14 天时序），DEMO_SNAPSHOTS / INLINE_MAP / tasks 三处联动 - `agent/tests/test_report.py`：+4 测试覆盖 trend 函数（条数 / 聚合 / 空天 / _unclassified 过滤） - `agent/tests/test_refresh_live_snapshot.py`：+1 断言 `trend.json` 输出 **T1-A 状态确认**：InvestorManifest 0-hit 问题已在 续41+続19.2 中修复（`company_threads` 逻辑完整，pipeline 覆盖 3 大 Schema），本会话验证通过，无需再动代码。 **关键指标**： - tests：515 passed（移除 test_jobs/test_llm 两个因环境缺失 cffi 的预存失败文件后） - trend 新增测试：4 passed - snapshot 测试：10 passed（含新增 trend.json 断言） **commits**：`3112200` feat: T1-B 主线热度趋势视图 (续 49) **遗留**： - T2-A X 轻量桥：代码已建（`export_x_events.py` 在 续40），等 operator 在本机执行并 commit JSONL - T2-B CNSA 桥：同上，需 operator 在可达网络定期运行 `export_cnsa_events.py` - T1-C 到 T1-F：P2/P3 优先级，留待后续会话 --- ### 2026-06-25 · 续 48 · 分析全仓代码文档，整理开发计划 **主题**：读取所有核心文档（DEVLOG / NEXT-STEPS / dev-roadmap / 历史 reports），梳理系统现状，制定并落盘本开发计划文档。 **交付**： - 新建 `DEVELOPMENT-PLAN.md`（本文件）：系统现状快照 + 路线图 + 当前排期 + 开发记录框架 **关键指标**（无代码改动，指标继承自续 47）： - tests：577 passed - corpus：63.1% / labeled_real：0.68 - events 归档：761 条（英文 RSS 148 + wiki 487 + CNSA 6 + 其他） **遗留**： - T1-A InvestorManifest 修复待下一会话启动 - T2-A X 轻量桥等 operator 跑 export 脚本并 commit - T2-B CNSA 桥需 operator 定期在可达网络执行 `export_cnsa_events.py` --- *（更早的开发记录见 [`DEVLOG.md`](./DEVLOG.md) 和 [`NEXT-STEPS.md §4`](./NEXT-STEPS.md)）* --- ## 6. 快速参考 ### 常用命令 ```bash # 本地跑测试 cd agent && python -m pytest tests/ -q # 本地跑单次数据刷新（需 SATAGENT_DB 指向真实库） python agent/scripts/refresh_live_data.py # 看板快照更新（更新 agent/docs/sample/*.json） python agent/scripts/refresh_live_snapshot.py # 本地起 API（端口 8765） SATAGENT_DB=/path/to/satagent.db uvicorn satellite_agent.api:app --port 8765 # 运行单次决策报告 satagent decision --view both --window 30 # 触发验证（corpus baseline） satagent validate --corpus agent/samples/labeled_validation.jsonl ``` ### 关键环境变量 | 变量 | 用途 | 必填 | |---|---|---| | `SATAGENT_DB` | SQLite 数据库路径 | 是（生产环境）| | `SATAGENT_LLM_API_KEY` | LLM API key（智谱 glm-4.6）| 日报翻译、debate LLM 路径 | | `SATAGENT_LLM_PROVIDER` | LLM provider（默认 zhipu）| 否 | | `SATAGENT_FEISHU_WEBHOOK_URL` | 飞书主通道 webhook | 推送日报/周报 | | `SATAGENT_FEISHU_WEBHOOK_EXTRA` | 飞书副通道 webhook | 双通道推送（v0.6.1）| | `SATAGENT_API_TOKEN` | Bearer 鉴权 token | 生产 API 部署 | | `X_SQLITE_PATH` | X 推文 SQLite 路径 | X 信号入库 | | `SATAGENT_LLM_EMPTY_FALLBACK` | LLM 空主线补判开关（on/off） | 默认 off | ### 关键文件索引 | 文件 | 说明 | |---|---| | `agent/satellite_agent/seed.py` | 公司种子库（SEED_COMPANIES，92 家，29 verified）| | `agent/satellite_agent/ontology.py` | 主题词典（5 主线 + 6 维度 + 影响词典）| | `agent/satellite_agent/classifier.py` | 事件分类器（rules-only 主路径）| | `agent/satellite_agent/decision.py` | 双视角决策报告生成 | | `agent/satellite_agent/jobs.py` | EH-1 调度系统（ACTIONS registry + 状态机）| | `agent/satellite_agent/notify.py` | 飞书通知（FeishuClient + 卡片渲染）| | `agent/satellite_agent/llm.py` | LLM 客户端（LiteLLMClient，5 provider）| | `agent/satellite_agent/sources/` | 数据源抽象（7 个 Source 实现）| | `agent/scripts/refresh_live_data.py` | Actions 数据刷新主入口 | | `agent/scripts/export_x_events.py` | X 推文导出脚本（operator 桥）| | `agent/scripts/export_cnsa_events.py` | CNSA 事件导出脚本（operator 桥）| | `agent/data-live/events-archive.jsonl` | 英文 RSS 事件归档（Actions 可读）| | `agent/data-live/cn-events-archive.jsonl` | 中文 gov 事件归档（operator 维护）| | `agent/data-live/title-translations.json` | 标题翻译持久缓存 | | `.github/workflows/data-refresh.yml` | 每 6h 数据刷新 workflow | | `.github/workflows/daily-feishu.yml` | 每日日报 workflow | | `.github/workflows/failure-alert.yml` | 失败告警 workflow | ### 数据质量标准 | 指标 | 当前值 | 警戒线 | |---|---|---| | corpus overall | 63.1% | < 55% 触发排查 | | labeled_real | 0.68 | < 0.60 触发排查 | | 合成集 | 1.00 | < 1.00 立即修 | | tests | 577 | 任何回归立即修 | --- ## 7. 免责声明 本文档列出的所有公司名、候选数据源、估值假设，均为研究效率与产品演进的工作记录，**不构成任何投资建议**。仓库内 placeholder 数据请在接实盘前由真实数据覆盖。