项目首页 · 文档与代码的总入口

把卫星互联网产业,
变成双视角决策

InvesResearch 仓库里同时住着两个产品 —— 卫星互联网产业的决策辅助 Agent(rules + LLM 混合, 双视角输出 CEO 战略 + 投资仓位),和二级市场的多 Agent 投研工作台(Skills + MCP + LangGraph 编排, 把数天的深度调研压到分钟级)。本页把它们的所有文档、代码、PPT 按 4 层入口铺开,从1 分钟速览逐文件钻入

📡 实时看板(首页)· 真实数据 · 每 6 小时自动刷新 真实跑批 II · 658 events × 8 源 · 命中率 63.7% · L3 第二评委复核 第一期跑批 · 171 events 数据源质量 · 8 源 9 维评分 + P0 已修 全景信息图 · 5 分钟看完全栈 数据视角 · 8 源 6 skill 实测 巡检全程 · 端到端 10 步实跑 12 张 PPT 看 web 产品 demo 🚀 web-backend 生产化交接 📰 本周周报 文档总览 🔍 全市场名称搜索 · 设计 🗺️ 投研平台路线图 · 2026 H2 🚀 SpaceX 专题看板 🛰️ 垣信 · 千帆星座专题 🛰️ 中国星网 · 国网星座专题 🌐 卫星互联网 · 星座竞赛 📊 运营监控指南 · Prometheus/Grafana 🔧 系统如何运作 · 架构全景图 ⌨️ 命令行 CLI · npx invesresearch 📦 npm 包 GitHub
文档36 份 代码模块30 个 tests700 ✅ 数据源8(含 wiki) 主线5 条 入库 events995 corpus baseline63.1% 种子公司87 家(10 家 verified) 2026-06-10v0.4.0 ✅ jobs REST 9 端点 + 飞书签名 + since=auto · 全源真实跑批 171 events → 17 产物(仪表盘 / 决策报告) 2026-06-11v0.5.0 🏷️ 上线任务 #1-#8 全收口 · corpus v3.0 (203 条) · 生产 runbook + 5 标准 job · Cloudflare 部署评估 2026-06-28v0.7.0 🏷️ wiki NER 四向 + wk 面板 · Direction-A/B/C/D · /wiki REST API 5 端点 · 概念热图面板 · 700 tests 2026-07-03v0.8.0 🏷️ web 后端 M1-M3 骨架 + 看板中文化/原文链接 · web-backend 数据层/能力层(DCF)/编排层 149 tests · 概念中文化 + 原文链接 + UI 收尾 · agent 700 tests 2026-07-05v0.8.1 🏷️ web 端前后端打通 · REST 服务层(FastAPI 6 端点+CORS) + 前端 app.html 对接(点调研→真实报告) · web-backend 162 tests · agent 700 tests 2026-07-05v0.9.0 🚀 web-backend 生产化全线上线(美股 + A 股双市场) · A 真实行情(yfinance/edgartools/baostock) + B 真实 LLM(Opus 4.8) + C 部署(阿里云海外 ECS + Caddy HTTPS + 观测/限流) + A5 A 股财报/报价(baostock,茅台 live 验证) · api.oaf.world 公网可访问 · web-backend 237 tests · 生产化交接页 → 2026-07-05v0.10.0 🚀 三市场 + SSE 进度流 + 新闻舆情 · ① 港股接入(yfinance .HK,腾讯 live 验证,对齐 A股/港股/美股) · ② 研报 SSE 实时进度流(/research/stream 逐节点) · ③ 新闻舆情段(/news + 报告舆情) · web-backend 257 tests · agent 700 tests 2026-07-06v0.11.0 🚀 A 股中文舆情 + 港股币种修正 · A 股中文舆情(Google News,baostock 取名,茅台当天新浪/东财新闻) · 港股 HKD/RMB 汇率修正(fetch_fx + USD 腿兜底,估值与现价同币种) · 三市场行情+财报+舆情全 live · web-backend 283 tests · agent 700 tests 2026-07-06v0.12.0 🚀 观测 + 质量 + 前端三市场打通 · ① Langfuse LLM 追踪(litellm callback,一份报告 3 次调用同 trace 各自命名,JP 区 live 出 trace) · ② 跨源财务校验落地(edgartools+yfinance 美股双源,差异 >10% 置 data_quality_flag,报告浮现 ⚠️) · ③ 前端三市场直连(app.html resolveUid,裸代码按后端口径解析市场前缀) · web-backend 296 tests · agent 700 tests · 生产化交接页 → 2026-07-07v0.13.0 🚀 从「工具」到「产品」:黏性 · 运营 · 公司名 · ① 产品黏性(自选列表 localStorage + 实时报价 · 横向对比 /compare 并排估值+LLM研判 · 估值假设可调) · ② 运营加固(healthcheck.py 挂了告警飞书 · /metrics token 访控 · 每日研报 daily_digest.py 定时推飞书 · 均纯标准库复用已部署服务不加 DB) · ③ 公司名(A股中文 baostock · 美/港英文 yfinance + 内置中文映射 60+ 标的) · 后端全程无状态 · web-backend 296→340 tests · agent 700 tests(顺手关闭 InvestorManifest 旧债 + 修脆测试) · 生产化交接页 → 2026-07-07v0.14.0 🚀 个股页真化:从 demo 到真数据 · 把 oaf.world 个股页从「真研判 + 假图/假 KPI/假舆情/假财务」逐块换成真实数据 · ① K线(新增 /bars,价格图从种子造假换真实历史 K 线,三市场统一) · ② 顶部 KPI(/quote 补 shares/currency,算真实 现价/市值/PE/ROE) · ③ 舆情(mock 情绪时序换 /news 真实近期新闻+源链接) · ④ 财务(真实利润表共同百分比 + 新增 /financials/history 多期财务:baostock 循环年份/yfinance 读全列/edgartools failover → 五年趋势表+CAGR) · 守铁律后端有数据才真化、没有的如实降级不编(杜邦/可比公司仍 mock) · web-backend 340→350 tests · agent 700 tests · 生产化交接页 → 2026-07-07v0.15.0 🚀 日报舆情 + 个股页杜邦真化 · ① 每日研报加「📰 近期要闻」段(复用 /news,逐标的去重按时序取前若干条,best-effort) · ② 杜邦分解去 mock(/financials 资产/权益确定性拆解 ROE=净利率×资产周转×权益乘数,美/港股真化、A股如实回落) · web-backend 350→357 tests · agent 700 tests 2026-07-07v0.16.0 🚀 个股页可比公司去 mock · 新增 /peers(内置精选同业集 + 确定性 PE/PB/PS + 行业中位;亏损/负权益/币种不一致置空、未覆盖如实降级不编样本) · 实测 INTC 亏损→PE 空、TSM ADR 币种不一致→三倍数空,护栏自证 · web-backend 370 tests · agent 700 tests 2026-07-07v0.17.0 🚀 个股页护城河/多空辩论去 mock · 新增 /thesis(确定性 analyze_company 拿事实 + 1 次 LLM 写结构化 护城河/看多/看空/仲裁 JSON;数字来自工具、LLM 只写叙事不臆造,解析失败诚实留白) · 生产 opus 经 AIGW 网关,实测 LLM 老实引用工具数字 · web-backend 378 tests · agent 700 tests 2026-07-07v0.18.0 🚀 研究台「市场速读」去 mock · 新增 /indices(US:<yahoo符号> 伪 uid 走 yfinance 取沪深300/上证/恒生/纳斯达克实时报价,绕开个股 uid 交易所推断) · 关注列表表现按自选实时涨跌算真 · 四指数 live 验证零 null · web-backend 382 tests · agent 700 tests 2026-07-08📊 量化筛选(Screener)去 mock 全线上线 · 多因子基本面筛选(价值 PE/PB · 质量 ROE/毛利率 · 成长 营收/净利 CAGR,横截面 z-score 加权排名) · 宇宙全 CSI300 · batch 预计算静态 JSON + ECS cron 每日自动重算提交(复刻 agent「每日刷新」) · A股 total_equity 从 baostock roeAvg 反推(绕开 tushare 积分门槛,一处救 Screener ROE/PB + 个股页杜邦 + peers) · 如实去掉 Alpha158/WorldQuant101 虚框(只做基本面确定性因子) · web-backend 397 tests 2026-07-08🛰️ 行业调研(Industry)去 mock:自下而上聚合 · 产品转型——行业=精选成分股真实财务聚合(合计营收/净利、中位 PE/PB/ROE/毛利率、bottom-up 逐年营收合计、成分表),不做无源 TAM/景气宏观 · 首发卫星互联网(US 龙头 8 家,与 agent 卫星产业线呼应,coverage 全绿、诚实反映"7 家亏损唯 Iridium 盈利"的建设期真相) · 中位指标带有效样本数 · 关键驱动接 LLM 定性(数字来自聚合、只写叙事不臆造,opus live 验证引用 -153亿净利/-29%CAGR) · /industries+/industry · web-backend 409 tests · agent 700 tests 2026-07-13v0.33.0 🚀 投研工作台升级 P0+P1(对标 podsai.ai) · 中间 v0.19→v0.32 围绕日报/数据源/运维打磨(详见 CHANGELOG);v0.33.0 一口气落地五项「让用户每天回来」机制 —— 议事厅(人格化多智能体研判 + 复盘记账战绩,票型确定性/LLM 不打分,/council) · 财报/事件日历(四桶分桶+过期隐藏+缺源留白) · 季度财报轴 + AI 财报快评(/financials/history?granularity=quarter + /earnings-recap,同比确定性算、纪要无源留位) · 卫星互联网全产业链图谱(五环节×37 公司+景气度,制造环节诚实留空) · 每日复盘上站(日报同源落 JSON + daily.html 逐日回翻) · 缺数不编铁律 · web-backend 541 tests · 前端 Playwright 93 断言 · 生产化交接页 → 2026-07-13v0.34.0 🚀 卫星叙事股票池(P2)+ 补齐 PRD 线框 · 对照 PRD 盘点后启动 卫星叙事股票池(入选方法论 + 锚定标杆 + 三梯队 11 标的 + 催化剂时间表 + 优先议事联动议事厅,静态 narrative.json) · 补齐线框:议事厅战绩榜 + 虚拟净值 sparkline(对 ×(1+涨跌)/错 ×(1−涨跌),LLM 不打分) · 季度财报轴 A股缺季度→降级年度(/earnings-recap 返回 granularity) · 产业链图谱节点详情滑出面板(上下游依赖/景气度/深链) · PRD 页标实施进度 + 门户/看板补入口 · 附 publish_release.py(VM 发版绕开 Actions) · 至此 P0+P1 五项 + P2 叙事池全部上线 · web-backend 549 tests · 生产化交接页 → 2026-07-14v0.35.0 🚀 PRD P2 收尾:卷阁分类 · 观点台 · 催化剂自动清过期 · 补齐 P2 余下三项(3D 按 PRD 暂缓):卷阁·付费库类型分类(wiki.html 按真实维度: 报告解读 102 + 人物 63 按 category,不套 podsai 虚构类型) · 观点台(admin 专属最小静态版, 空态不编、CF Access 网关后) · 催化剂自动清过期(cron_static.sh 每日重跑图谱/叙事池 + 清过期催化剂) · 修复 build_chain/build_narrative 宿主 3.6 兼容 + 加 3.6 lint 守护 · 至此 PRD P0+P1+P2 全落地 · web-backend 550 tests · 生产化交接页 → 2026-07-14v0.36.0 🚀 投研看板交互升级:可探索的驾驶舱(P0+P1+P2) · 按《投研看板交互升级 PRD》把只读看板升级为可探索驾驶舱,三轮全上线、纯前端零后端:P0 全局切片条(时间窗/主线)+ 跨面板联动 + 列表下钻 + URL 深链(?w=&t=&c= 可分享视角) · P1 ⌘K 搜索 + 自选关注(localStorage) + 趋势卡聚焦/悬停读数 + 矩阵排序 · P2 布局自定义(折叠/显隐/重排持久化) + 对比模式(两主线并排比确定性指标) · 另 知识图谱进工作台(与看板同源) + 发版自动化(cron_release.sh 一条命令/挂 cron) · 铁律:交互只切片不造数、缺数留白、无账号无 PII、离线可测 · web-backend 555 tests · 生产化交接页 → 2026-07-14v0.36.1 🚀 运维稳态补丁:每日复盘取数重试 + cron 分叉自愈 · 修 v0.36.0 发版与当日每日复盘暴露的两处根因:每日复盘核心 /compare 取数加重试(daily_digest 偶发读超时不再整篇拖垮日报, 仅重试超时/连接/5xx·429, IR_DIGEST_RETRIES/IR_DIGEST_RETRY_DELAY 可调) · 六个 ECS 宿主 cron 分叉自愈(pull --ff-onlyfetch→rebase→冲突则 reset, 修 cron_release 读旧 CHANGELOG 发不出新版、push cron 长期推不动) · 全为宿主脚本 ECS git pull 即生效、无需 rebuild · web-backend 560 tests(新增重试 5 条 + 3.6 守护) · 生产化交接页 → 2026-07-14v0.36.2 🚀 每日复盘研判去单调:换维度 + 存疑不封王 + 盯盘轮换 · 修连日雷同的「今日看点/研判」(天天「买烽火通信」、而它 ⚠️数据存疑):① 换维度(今日看点改讲「今天变了什么」:升温最快主线热度 delta + 临近催化剂读 narrative.json) · ② 存疑不封王(DCF 只认数据可靠且正上行, 无干净标的就诚实留白, 不再捧存疑股为买入) · ③ 盯盘每日轮换(pick_watchlistdate.toordinal() 从更广宇宙滚动补位, /compare 输入天天变→研判随之不同) · 全部确定性计算缺数留白 · web-backend 565 tests(新增 10 条) · 生产化交接页 → 2026-07-16v0.37.0 🚀 卫星互联网 · 跨市场板块(美股 vs A股) · 工作台新增 跨市场板块 视图:卫星互联网美股 vs A股并排——各市场自下而上成分聚合的板块估值/规模(中位 PE/PB/ROE/毛利率、合计营收净利、CAGR、coverage 透明标样本数) + 每市场 LLM 板块叙事 + 事件提及热度代理(明示口径) + 顶线确定性 PE 对比 · 后端加 A 股卫星篮子 satellite_a(CNY 10 只精选、去中兴/中国电信保可比), 复用 /industry、两市场币种独立不混算 · 生产实测 A 股 10/10 覆盖、中位 PE 278.9(仅 4 家有效透明)、板块整体亏损诚实呈现 · 港股纯标的薄暂不单列 · web-backend 566 tests · 生产化交接页 → 2026-07-16v0.38.0 🚀 行业板块「预热缓存」—— 所有访客共享、每日刷新 · 行业调研 / 跨市场板块这类重活视图(并发拉 N 只成分报价+财报聚合 + LLM 板块叙事, ~10s+)原本每次点进都干等实时, 本版做成缓存:先把结果持久化到 localStorage(跨刷新/会话, 点进秒开、按需「↻ 刷新」), 再叠一层服务端静态预算(build_industry.py 每日 batch 写 web/data/industry/<key>.json + cron_industry.sh 提交 main → CF Pages)让缓存所有访客共享、始终预热(任何人首次点进就秒开、无需各自等一次) · 前端静态预热优先、与本地缓存取较新者、都没有才拉实时, 头部标来源(预热缓存 / 缓存 / 实时 · N 前) · 铁律照旧:数字确定性聚合缺数留白、叙事只 LLM 定性、预热文件 best-effort 可降级 · web-backend 570 tests · 生产化交接页 → 2026-07-16v0.39.0 🚀 对话调研接真 —— 自然语言 → 意图路由 → 既有确定性 skill · 工作台 对话调研 原为纯前端演示(写死占位 + 假回复), 本版接到真后端:新增 POST /ask, 用户随口问一句, LLM 只做意图路由 + 实体抽取(不产出任何数字), 再按已解析到的标的数量分派既有确定性 skill——1 标的→护城河多空 /thesis、≥2 标的→横向对比 /compare、命中行业→板块聚合 /industry、都没有→诚实降级给候选 · 答复里数字全部来自这些 skill(真实报价+财报), 名称→uid 走确定性查表 + 代码规范化、识别不到绝不让 LLM 猜代码 · 生产实测「烽火通信护城河如何」端到端跑通、存疑标记如实透传进研判 · web-backend 597 tests · 生产化交接页 → 2026-07-16v0.39.1 🚀 对话调研进 oaf.world 首页 —— 提问框跳工作台自动作答 · v0.39.0 上线的 对话调研 交互好但埋在工作台里访客不一定找得到, 本版把它搬到 首页顶部:加对话调研提问框, 用户一进站就能用自然语言问一句, 回车/点「调研」→ 跳 /web/app?v=chat&q=<问题>、工作台自动进对话视图并作答(像 Perplexity 首页搜索框→结果页) · 问答逻辑仍只在 app.html 一处(v0.39.0 的 /ask), 首页只做提问框+深链、保持纯静态零后端 · 纯前端随 CF Pages 即时、无需 rebuild · Playwright 端到端实测全绿 · 生产化交接页 → 2026-07-16v0.39.2 🚀 对话调研体验补丁 —— 存历史 + 修深链误显英伟达 · 修用户反馈两处:① 对话历史持久化(对话调研问答存本机 localStorage、留最近 40 条, 进 对话调研 自动恢复、切视图/刷新/重开都在, 头部加「清空对话」) · ② 修深链公司页误显英伟达(从对话调研点「打开公司调研页」深链到未入库标的如智谱 HK:02513 时 hero 回落硬编码英伟达外壳、名/uid/板块全错; 改 currentCompany():后端在线且未入库用真 uid 中性外壳、名走 displayName→智谱, 纯模拟态才留英伟达 demo) · Playwright 端到端 7/7 全绿 · 纯前端随 CF Pages 即时、无需 rebuild · 生产化交接页 → 2026-07-16v0.40.0 🚀 全市场标的名称模糊搜索 —— 没有的也能搜 · 对话调研/⌘K 搜索原靠 ~50 条静态表把名称→uid 映射死、表外查不到, 本版接数据源做全市场模糊搜索:新增 GET /search + search.py(混合、实时为主+进程内日缓存)——本地精选秒回 → 中文走 A 股全量中文名(baostock query_all_stock) → 拉丁/代码走 港/美股 Yahoo(英文/拼音/代码, EQUITY 过滤、symbol→uid) · 对话调研 /ask 加搜索兜底(命中即用、歧义列候选不硬猜) · 前端 ⌘K 本地即时 + 防抖调 /search 合并(竞态守卫) · 铁律:名称/代码是数据源事实非 LLM 猜、best-effort 失败回落本地 · 诚实边界:A 股中文名全量、港/美股英文·拼音·代码全量 + 精选中文名(设计文档) · web-backend 611 tests · 生产化交接页 → 2026-07-16v0.40.1 🚀 搜索显示名补丁 —— A 股名回填 · 修 v0.40.0 生产实测发现的 /search?q=宁德 显示成 SZ:300750 而非「宁德时代」(先命中本地别名占位名、A 股名未回填) · search_symbolsadd 改为 uid 已存在且原名占位(=uid)时回填真名 · uid/路由一直正确, 仅显示名修正 · 生产 rebuild 后实测「宁德」→「宁德时代」 · web-backend 612 tests · 生产化交接页 → 2026-07-16v0.40.2 🚀 QA 全功能巡检修复 —— 护城河/多空叙事截断 + 行业研报占位 · 对看板+工作台所有功能点击/执行/验证(Playwright 全量错误巡检 0 未捕获异常 + 行为验证 + 真后端 curl), 改正两处不起作用:① 护城河/多空+对话调研单标的 LLM 叙事全空(根因 max_tokens=512 太小、护城河多空的中文结构化 JSON 被截成半截解析失败, 修为默认 1600 + IR_LLM_MAX_TOKENS env; rebuild 后生产实测 /thesis parse_ok=true、moat/bull/bear 齐全) · ② 行业调研「生成行业研报」占位(原只弹 toast; 新增 genIndustryReport() 用缓存聚合合成真研报进阅读页, 复用报告基建不新增后端) · 14 视图+公司页 7 tab+12 GET 端点+静态数据全部核过, QA 报告 · web-backend 614 tests · 生产化交接页 → 2026-07-16v0.41.0 🚀 2026 H2 路线图 B/C/D/E 一次发版 —— 数据深度 · 覆盖面 · 对话调研深化 · 运营 · 按 2026 H2 路线图四块落地:D 对话调研深化(多轮上下文 + 追问建议 chip + 财报意图, 「它估值贵吗」承接上一轮标的) · C 覆盖面(白酒/家电 A 股行业篮子 + 港股卫星评估诚实留白只单列亚太卫星不硬拼非纯标的 + HK/US 中文名扩 ~60 条 91→151) · B 数据深度(A 股财务字段补全 fetch_financials_filled 接入行业成分/相对估值, 配 TUSHARE_TOKEN 后 ROE·PB 出真数、无备源诚实留空 + 跨源校验扩面到 A 股) · E 运营(叙事分级 IR_LLM_MODEL_FAST 快模型走 /ask 路由/新闻翻译、主模型走护城河多空/议事厅深度叙事, 控成本+提速 ~10x 不降质 + deploy/monitoring/ Prometheus/Grafana 监控叠加层, LLM token 成本走 Langfuse 诚实标注) · web-backend 632 tests · 后端需 ECS rebuild · 生产化交接页 → 2026-07-16v0.41.1 🔧 叙事分级热修 —— 快模型默认回落主模型 + /ask 兜 LLM 异常 · v0.41.0 把快模型 IR_LLM_MODEL_FAST 默认设成 anthropic/claude-haiku-4-5, 但生产走自建 AIGW 网关(openai/wangsu/... + IR_LLM_API_BASE, 无直连 ANTHROPIC_API_KEY), 该直连别名在网关上打不通、且 /askroute() 未兜 llm.complete() 抛错 → 对话调研+新闻标题翻译 rebuild 后报错 · 修:① 默认改留空回落主模型(分级变纯 opt-in、行为不变; 要省成本显式配网关自己的快模型名, 别填 anthropic 直连别名) · route() 包异常(LLM 调用失败诚实降级 unknown、/ask 不 500) · web-backend 633 tests · 后端需 ECS rebuild · 生产化交接页 → 2026-07-17v0.42.0 🚀 卫星互联网专题群 + 行业异动预警 · 起因 7-17 SpaceX 发射失败牵动全板块股市、但看板无预警(诊断两根因:日更快照太慢 + 无预警层) · ① 行业异动预警 sector-pulse(新增 /sector-pulse突发高严重度事件〔板块成分 + SpaceX 作舆情风向标近 48h 新闻, 规则判严重度、只看标题防误报——生产实测过「纳指大跌」大盘综述被摘要 plunge 误报成板块重大事件〕+ 板块中位涨跌异动〔≤-3% 报警、≤-6% 严重〕两确定性信号合成; 垣信/千帆·中国星网/国网·星舰星链走关键词监控〔未上市无 ticker 也预警, Google News 关键词 RSS〕、事件标题快模型翻中文; 都不命中不报警不制造警报) · ② 卫星专题群四张深度看板全交叉互链(/spacex 行情/财务/SpaceX vs 卫星同业对比/护城河多空 + 与 mbabrand 品牌·舆情·创始人三维内联卡片 · /yuanxin 垣信·千帆星座〔未上市诚实留白〕· /xingwang 中国星网·国网 · /constellation 星座竞赛九强总览 + 发射·组网时间线) · ③ E2 监控完整指南(/monitoring-guide 网页版) · web-backend 648 tests · 后端 /sector-pulse·/watch-news 需 ECS rebuild · 生产化交接页 → 2026-07-18v0.43.0 🚀 首页看板实时化 + 实时 K 线行情 · 起因用户巡检 看板 CEO Brief 多处异常(主线评分全 0/如何崩塌空/反方矛盾无链接), 追根到——看板一直走每日静态快照、agent 决策后端从未部署公网 · ① 看板实时化(agent.oaf.world 上线: satellite_agent.api-p deploy compose、Caddy 只读 GET 白名单写端点一律 404、CORS 只放 oaf.world; cron_agent.sh 每小时刷库并自动配证伪触发器〔如何崩塌〕+ 看熊清单〔反方矛盾〕、原子换库; 看板默认连 live、不可达静默回落快照不弹红条; CEO Brief 三 bug 全修、证伪 4 块投资 Brief 去重) · ② 实时 K 线行情(首页顶部蜡烛 K 线面板: SVG OHLC + 悬停 tooltip、12 标的〔SpaceX 默认 + 美股卫星同业 + 英伟达 + A 股卫星 + 亚信安全〔科创板〕+ 亚信科技〔港股〕〕; 市值/PE 币种感知〔$/¥/HK$、同币种才算 PE〕; 时间轴到上市以来/bars 上限 le=500→7300、1M~Max、跨度 >1 年画收盘价面积线〕; 长区间取数失败多级回退近端不再「行情不可达」) · ③ 议事厅诚实报错(单标的多空辩论填对比句/未上市实体解析不出→原误导性「演示数据」, 改诚实引导 + 后端 400/404 诚实报错) · web-backend 648 tests · 后端 agent API·/bars 需 ECS rebuild · 生产化交接页 → 2026-07-26v0.44.0 🚀 命令行客户端 + 全站英文版 + 系统架构页 · 主线「让这套东西能被别人用、也能被别人看懂」 · ① npm 包 invesresearch(零依赖 MIT · Node ≥18 · 21 条命令 · 两个 bin invesresearch/ires; npx invesresearch quote NVDA 即用, 无需注册无需密钥 · 不是第四个服务、只是两个已公开只读接口的瘦客户端, 有专门单测断言从不发 Authorization 头 · 冒烟打真实生产接口抓出 11 处渲染字段名对不上, 补 shapes.test.mjs 用真实响应结构钉住 · 77 个离线单测) · ② 全站英文版(低侵入 i18n 引擎: 按中文原文整串查字典替换界面文案、未覆盖优雅保持中文; 浏览器语言自适应 + 右上/右下角手动切换并记忆; 711 条词条覆盖看板/工作台/卫星四页/CLI 页/架构页; 动态数据不进字典——公司名/新闻/LLM 研判/数字该是什么就是什么) · ③ 两个新页面(/cli 命令行专页〔命令表 + 代码写法 + 数据边界诚实说明〕· /how-it-works 系统架构全景页〔手写内联 SVG 全景图, 纯静态零构建依赖、CSS 变量着色所以深色模式自动跟随; 图里每个名字都从代码核对; 只写已在生产跑着的部分〕+ docs/ARCHITECTURE.md; 九处入口接上) · ④ 秒开与数据面(SWR 本地缓存推广到卫星四页/看板 K 线/工作台公司调研, 先渲染缓存后台再刷、纯前端不加服务器; 事件流三层扩容〔展示上限 + 中文源 2→6 + 四个英文源被 ECS 出口 IP 封改走 Google News〕稳定 100 条、52 条英文) · ⑤ 三起生产问题(空库被换上生产〔磁盘满 + SQLite 页缓存让日志全绿但数据没落盘, 加 --fail-if-empty 硬保护〕· 板块预警阈值分数/百分数混用-0.03 对上百分数 change_pct → 任何红盘日横幅都亮且必判 critical, 文案又乘 100 显示「中位 -457.5%」真实 -4.57%; 656 个测试全绿是因为测试把同一个 bug 一起编码进去了〕· 重建命令漏 -f docker-compose.prod.yml(compose 转而捡走另一份默认配置、不透传 LLM key)致 /thesis·/compare·/research·/ask 静默降级〔HTTP 仍 200 但研判为空, 本次自己造成的, 已加 deploy/rebuild.sh-f 写死 + 重建后自动降级自检〕) · 共同教训: HTTP 200 不等于对 · 测试 661 + 841 + 77 = 1579 · 后端 pulse 修复需 ECS rebuild · 生产化交接页 →
1第一层 · 三条最快路径

不同身份, 3 个入口就够了

第一次来:挑下面其中一张卡 · 1-3 分钟就能建立心智模型。后面 3 层都是"看完想再看"才往下钻。

P
For Anyone · 一分钟速览

12 张PPT看完
整个项目

问题 → 方法 → 结果 → 下一步, 一页一张。方向键 / 空格翻页, scroll-snap 全屏。任何身份的访客这里开始最快。
slides.html
为什么:文字密度极低,视觉密度极高。给完全没看过项目的人。
F
For Engineers · 看流程图

Agent 端到端
12 节流程图

双视角定位 · 输入侧/判断层/决策层 · 真实数据基线 · roadmap · schema · 决策层 mockup, 全部在一页里展开。工程评审常用入口
agent/docs/flow.html
为什么:技术人员要直接看模块边界 + 数据流。规则版 + LLM 兜底全有。
D
For PM / 投资人 · 跑产品

投研工作台
交互 demo

A股 / 港股 / 美股调研系统的完整前端 · 多 Agent 辩论编排 mockup。后端已生产化上线:点调研→打公网 api.oaf.world→真实行情+财报+DCF+Opus 4.8 叙事(美股)。
web/app.html ·
生产化交接页 →
为什么:看产品形态最直接。能点击、能跳转、能看到真实决策长什么样。
2第二层 · 三块面板

认真理解?三张总览面板

这 3 份页面是把整个仓库"切了 3 刀": 一刀按文档树, 一刀按数据生命周期, 一刀按下一步路线。每一张都是单页可达, 各自有内部目录。

面板 #1 · 按文档树

文档总览

把仓库里的 27 份 markdown / HTML + 23 个 Python 模块按"仓库根 / Agent / Web / 代码模块" 4 块组织, 每份标注用途 / 可视化形式 / 对应源码。
含 · 仓库根 6 · Agent 13 · Web 11 · 代码模块 23
面板 #2 · 按数据

数据流转图

以数据为中心, 从哪里来 / 怎么处理 / 到哪里去。横向 3 列总图 + 6 段细化, 末尾有一条端到端 trace 把 demo event 走完整链路。
含 · 5 源 · 7 步 · 4 表 · 7 模块 · 5 出口 · 1 trace
面板 #3 · 开发计划

开发计划全貌 new

一页看懂在做什么 / 已经做到哪一步 / 下一步往哪走 / 为谁做。plan.html 是总览门户(目标 + 全貌 + 已做 + 下一步)· next-steps.html 是 14 commits 详尽工程档案 · NEXT-STEPS.md 是权威源。
含 · 四问索引 · 双视角 · 22 项已交付矩阵 · 3 档路线图
3第三层 · PRD + 路线图全集

逐文件钻入?所有 PRD 都是 md + html 一对

下面是仓库里全部的 PRD / 路线图 / 架构说明 / 本体词典 / 回归报告 — 每份都同时给出 markdown 源和可视化版,色块区分 仓库根 / Agent / Web。"待生成"表示当前只有 markdown。

仓库根 · 纲领 new

PRODUCT-STRATEGY · 产品策略

仓库里 agent / web 两条产品线的关系 · 共享方法学 / 不共享 schema · 里程碑映射 · 当前阶段路径选择
markdown 仅 md
仓库根 · 本轮 new

NEXT-STEPS · 下一步计划

本轮 4 条 P0-P3 任务清单 · 现状 + 任务 + 风险 + 验收 + 时间线 · 含下下轮 EH-1 / EH-3 排期
仓库根 · 研究 new

FE-SKILLS-INTEGRATION · 框架对比 ✅ Round 1 闭环

Fundamental Edge 7 skill + 6 共享指南 对比 satellite_agent 现状 · ROI 3 档 · 高 ROI 三件套 + A v2 + 5 色 全部 ✅(5 commits, 159→262 tests)
仓库根 · 研究 new

ADVICE-INTEGRATION · 外部评估 → PRD 改进

基于 new/advice.md(2026-06-03 第三方评估)4 问框架 + 5 主线 + 5 风险 → 高 ROI 可吸收项落地方案 · 最高 ROI:D 验证回路 V1 - 吻合度对照表(3-5 天) + B skill 沉淀 + E 窄而深 demo · 准备下一步引入开发
仓库根 · 本轮 new

data-flow · 数据生命周期

5 源 / 7 步 / 4 表 / 7 模块 / 5 出口 + 端到端追踪
仅网页 data-flow.html
仓库根 · 本轮 new

slides · 12 张 PPT

问题 → 方法 → 结果 → 下一步 · 方向键翻页
仅网页 slides.html
Agent · PRD

agent PRD · 产品定位

CEO + 投资双视角 · 输入侧 / 判断层 / 决策层三层 · MVP 范围
Agent · 路线图

agent roadmap · Phase 1/2/3

Phase 1/2/2.1/3a/3b/3c 全部交付 · 路线图 + 当前优先级建议
Agent · 架构

agent architecture

三层模块图 · ingest 与 weekly report pipeline · 4 关键决策
Agent · 数据

agent data · 表/种子/缺口

4 张表 · 84 行市场模型 · 25 真实样本 · Phase 3 数据缺口
Agent · 数据字典

agent schema · 字段级口径

2026-06-03 新增 · events / companies / market_model / thesis_state 四表逐字段 · Phase 2 数字字段(订单金额 / capex / opex / 时间窗 / 客户)硬要求
markdown 仅 markdown
Agent · 本体词典

agent ontology

5 主线 × 关键词 · 6 场景 · 6 维度 · 极性词典(45+35)· 反义对 · 06-08 加 LAUNCH_VEHICLE 主线 + 103 关键词
Agent · API

agent api · CLI + REST

13+ CLI 子命令 / 14+ REST 端点 / 错误码 / 3 个典型工作流
Agent · 回归 (合成集)

agent regression

30 条合成样本 · 三项独立指标 · per-thread F1 1.000
Agent · 回归 (真实集)

agent regression-real

25 条公开新闻 · v0 vs v1 · 三项全过 40% → 64% (rules) / 80% (LLM stub)
Agent · 看板

agent dashboard

设计哲学 · 架构 · 三阶段路线 · 当前进度 · 工程评审用
仅网页 dashboard.html
Web · 产品 PRD

web product-prd

3 类用户画像 · 5 个典型场景 · 22 项功能 P0-P2 优先级矩阵
Web · 工程 PRD

web engineering-prd

3 层解耦 · 8 个子系统 · Pydantic schema · 10 项 ADR · 11 项 NFR
Web · 架构图

web architecture-notes

4 张图逐图详解 · 系统总览 · 数据层 · 编排 · Skills+MCP
markdown 可视化待生成
Web · 架构决策

web architecture-decisions

2026-06-03 新增 · "为什么是这套架构"的决策记录 · 5 层分层 + 8 子系统 + 关键 ADR · 与架构图说明互补
markdown 仅 markdown
Web · 路线图

web 24 周路线

W01-W24 三阶段 · M1-M6 拆解(2026-06-03 叠加 M3.5) · Sprint Zero · 6 项风险 · 4 项待决策
Web · 增强 PRD

web enhancement-prd

2026-06-03 新增 · EH-1~EH-7 七条增强主线 · 常驻 agent / 活表格 / 主动推送 / 沙箱抓数 / 自定义 Skill / 复杂任务拆解 / 个性化
Web · 系统设计

web system-design

2026-06-03 新增 · 工程 PRD 与架构决策之间的结构参考 · 组件契约 · 关键时序 · 部署拓扑 · 故障模式
markdown 仅 markdown
Web · 开源调研

web oss-survey

2026-06-03 新增 · 16 个金融 Agent 项目对比 · 支撑产品 PRD §1 差异化论断(深度调研是空白)
markdown 仅 markdown
Web · Harness 实践

web harness-best-practices

2026-06-03 新增 · 工程 PRD 的方法论底稿 · harness 与 agent 解耦 · 8 子系统来源 · 上下文工程 · 选型依据
markdown 仅 markdown
Web · flow

web flow.html · 端到端

五层架构 + 6 里程碑 + M1 关键路径 + 待决策 + 风险
仅网页 flow.html
Web · 部署

web DEPLOY

不用命令行的部署指南 · GitHub + Cloudflare Pages 全程网页点击
markdown 仅 markdown
仓库根 · 流水线 new

SKILL · expert-wiki-ingest · 增量入库流水线

2026-06-07 新增 · 把 expert/raw/ 下新增 docx/pptx/pdf 增量灌进 expert/wiki/ 知识库 · 5 phase(Python 抽文本 → N 路 LLM sub-agent 并行抽实体 → merge → 索引 → HTML)· sub-agent 提示词模板 + 5 个踩坑小记可复用
仓库根 · 图谱 new

module-graph · 全代码模块图谱

2026-06-07 新增 · 全仓库代码模块图 + 完成度。agent 核心 32 模块 / wiki 9 脚本 / X 9 模块 / skills 2 类 / web 纸面 · 5 swim lanes 工程蓝图 + 27 测试覆盖图 + 完成矩阵 + 未做路线图。与 plan(全貌)/ docs(文档)互补,是代码视角
仅网页 module-graph.html
仓库根 · X 采集 new

expert/X architecture · X 账号抓取程序技术文档

2026-07-08 新增 · expert/X twikit 抓取库 + agent 下游桥接的端到端技术文档 · 11 章(架构 / 5 表数据模型 / 抓取逻辑 / CLI / 报告 / x-ingest cron 时序 / 运维 / 已知问题 / 代码索引)· 数据流图 + cron 时序图 + schema 表 + 坑位/更正标注 · 字段与 file:line 以源码为准、经独立核查。
4第四层 · 入口辅助

剩下的 常用入口

给已经熟悉项目、想直接跳到代码 / 部署 / 仓库的访问者。这里是清单, 不展开。

本仓库是两个产品的同源单体

agent/ 是 Python 决策辅助 Agent(可独立跑, 有 64 测试, SQLite 落盘)· web/ 是二级市场调研工作台的对外网站(纯静态, Cloudflare Pages)。两边共享视觉语言, 不共享代码。详细分工见 README.md文档总览