# InvesResearch

> 两个独立但同源的投研系统:**二级市场投研工作台**(`web/`) 与 **卫星互联网产业 Agent**(`agent/`)。

## 目录布局

```
InvesResearch/
├── README.md          ← 本文件
├── web/               ← 二级市场投研工作台(静态站点,独立 git repo)
└── agent/             ← 卫星互联网产业研究 Agent(Python,Phase 1 MVP)
```

## web/ — 二级市场投研工作台

面向专业投资人与分析师的 AI 调研系统演示站。覆盖 A股 / 港股 / 美股,采用 Skills + MCP 架构与多 Agent 辩论编排。**纯静态,零构建依赖**,可直接部署到 Cloudflare Pages / GitHub Pages / Netlify / Vercel。

- 入口:[`web/index.html`](./web/index.html)(落地首页)+ [`web/app.html`](./web/app.html)(投研工作台)
- 部署:[`web/DEPLOY.md`](./web/DEPLOY.md) — 不需要命令行的全程网页点击中文指南
- 路线图(可视化):[`web/roadmap.html`](./web/roadmap.html)
- 文档:[`web/docs/`](./web/docs/) — product PRD / engineering PRD / architecture notes / roadmap
- 架构图:[`web/assets/diagrams/`](./web/assets/diagrams/) — 4 张 SVG 矢量图(系统总览 / 数据层 / 编排 / Skills+MCP)
- Git:独立仓库,远程指向 `github.com/zhanglunet/InvesResearch`

> 当前 web/ 展示的是模拟数据,用于演示与交互体验。接入实盘需要后端把 MCP 工具与编排跑起来,把模拟数据替换为真实 API 调用。

## agent/ — 卫星互联网产业决策辅助 Agent

把卫星互联网产业的政策、订单、公告、产品、标准事件,自动映射到**核心网 / 终端 / 芯片 / 运营支撑**四条主线, 在此之上输出**双视角决策辅助**: CEO 视角看主驱动变量与战略, 投资视角看公司相对位势与仓位信号。Phase 1 已交付 rules-based 分类输入层 (合成集 100%, 真实集 64%), Phase 2 接 LLM 兜底 + 数字字段抓取, Phase 3 是决策层。SQLite 落盘, 本地可跑。

- PRD:[`agent/PRD.md`](./agent/PRD.md)
- 入口:[`agent/README.md`](./agent/README.md) — 快速开始 + CLI 示例
- 视觉化总览:[`agent/docs/dashboard.html`](./agent/docs/dashboard.html) — 设计哲学 · 架构 · 路线图 · 当前进度
- 文档:[`agent/docs/`](./agent/docs/) — architecture / ontology / api / regression / roadmap
- 状态:Phase 1 Research Agent ✅ 已交付。30 条 labeled regression 100% 通过,18 个 pytest 通过

```bash
cd agent
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
satagent init
satagent ingest-file samples/events.jsonl
satagent report --format md
```

## 两个项目的关系

`web/` 的视觉系统(暗色金调 · Fraunces + Inter Tight + JetBrains Mono)被 `agent/docs/dashboard.html` 延用,所以打开两边的 HTML 看起来像同一个产品族。但它们**面向不同市场、有不同的后端**,共享品牌而不共享代码。

## 免责声明

本仓库及其产出的所有内容仅用于研究效率提升与教育目的,**不构成任何投资建议**。