# 文档索引

> Satellite Agent Infra Analyst · 全部技术与设计文档入口

## 入口选项

视觉化总览(推荐先开这个):
- **[`../../docs.html`](../../docs.html)** — InvesResearch 全文档树统一入口(Agent + 二级市场调研工作台)
- **[`flow.html`](./flow.html)** — 全流程图示 · 双视角定位 · 端到端数据流 · 真实数据基线 · 失败 case · roadmap · schema · 决策层 mockup 一页可检
- **[`dashboard.html`](./dashboard.html)** — Phase 1 设计哲学 · 架构 · 路线图 · 当前进度 看板

按主题深读(每份 md 都配一个同名 `*-viz.html` 可视化版):

| 文档 | 可视化 | 适合谁 | 主要回答 |
|---|---|---|---|
| [`../PRD.md`](../PRD.md) | [`prd.html`](./prd.html) | PM / 决策 / 全角色 | 产品定位、双视角需求、决策层输出 |
| [`architecture.md`](./architecture.md) | [`architecture-viz.html`](./architecture-viz.html) | 工程师 / 评审 | 为什么这样设计?模块怎么分?数据怎么流? |
| [`ontology.md`](./ontology.md) | [`ontology-viz.html`](./ontology-viz.html) | 产业 / 标注 / 算法 | 4 主线和关键词词典完整定义 + 维护原则 |
| [`api.md`](./api.md) | [`api-viz.html`](./api-viz.html) | 调用方 / 前端 | CLI 怎么用?REST 端点有哪些? |
| [`regression.md`](./regression.md) | [`regression-viz.html`](./regression-viz.html) | QA / 算法 | 怎么评估准确率?合成集当前基线?限制? |
| [`regression-real.md`](./regression-real.md) | [`regression-real-viz.html`](./regression-real-viz.html) | QA / 算法 / PM | 真实新闻盲测基线 + 失败 case 根因 + Phase 2 修订建议 |
| [`roadmap.md`](./roadmap.md) | [`roadmap-viz.html`](./roadmap-viz.html) | PM / 决策 | Phase 1/2/3 拆解?现在做完哪些? |
| [`data.md`](./data.md) | [`data-viz.html`](./data-viz.html) | 工程 / PM / 全角色 | 数据视角 — 4 表 · 84 行 · 25 真实样本 · 词典 · 决策层数据缺口 |
| [`flow.html`](./flow.html) | (本身就是视觉版) | 全角色 / 人工检查 | 端到端流程一页可检 · 12 节 |

## 与代码的对应

| 文档 | 主要对应代码 |
|---|---|
| architecture.md | 全部 `satellite_agent/*.py` 的模块边界 |
| ontology.md | `satellite_agent/ontology.py` |
| api.md | `satellite_agent/cli.py` + `satellite_agent/api.py` |
| regression.md | `satellite_agent/regress.py` + `samples/labeled_regression.jsonl` + `tests/test_regression.py` |
| regression-real.md | `samples/labeled_real.jsonl`(25 条真实新闻盲测集) |
| roadmap.md | PRD.md §5 |
| data.md | `satellite_agent/db.py` schema + `satellite_agent/seed.py` + `samples/*.jsonl` |

## PRD

原始 PRD 在 agent 项目根 [`../PRD.md`](../PRD.md)。本文档树是它的工程化展开。