openInvest Wiki
2026-07-05：Web GUI 已退役（等重做），Web API 标记 deprecated（存量端点服务 remote hub 模式）。文档中 GUI/:8765 面板相关描述均为历史内容；当前入口 = CLI 子命令 + MCP 工具。
路径约定：2026-07-04 起后端代码在
src/openinvest/（PyPI 布局）。01–03 章已写全路径；其余章节里省略前缀的core/…jobs/…services/…connectors/…capabilities/…calc/…utils/…均指src/openinvest/下同名目录。数据目录（memory/db/docs/logs/）仍在仓库根 /$INVEST_HOME。
多资产 AI 投资委员会系统的完整文档。 主仓库 longsizhuo/openInvest · 前端 GUI longsizhuo/invest-gui（已于 2026-07-05 退役，仅作历史参考） 主页 README.md · 30 分钟 fork QUICK_START.md
按读者画像选路径
🎯 我是用户，想用起来
- README.md hero —— 这工具到底在做什么
- QUICK_START.md —— 30 分钟从 clone 到第一份 AI memo
- 09-troubleshooting.md —— 跑挂了去哪里看
🛠 我是开发者，想改 / 扩
- 01-architecture.md —— 心智模型必读
- 05-data-model.md —— v2 schema + concurrent RMW
- 07-extending.md —— cookbook: 加资产 / 数据源 / agent 角色
- 06-api.md —— REST 端点（deprecated，仅服务 remote hub 模式）
- 08-deployment.md —— Caddy + CF Access + systemd
🧠 我是研究者，想懂"为什么这么设计"
- 02-agents.md —— 4 LLM 角色 + cross-challenge + REGIME 中性概率口径
- 03-dreaming.md —— OpenClaw 风格的三阶段记忆整合
- 04-execution-paths.md —— Skill vs Web/Cron 双路径
- 11-rl-training.md —— Optuna + paper trade + 训练 pipeline（澄清：不是 GPU 训练）
- 12-verification.md —— 实测数据 / "科学证据" / negative results
- 13-param-tuning-feasibility.md —— 参数调优可行性诊断 + 补充文档
- 15-path-probability.md —— 概率表路径化：多窗分布 + 四类路径形状（卖出时机的核心读数）
- 16-ta-analysts-experiment.md —— TradingAgents 式分析师实验：预注册 Gate 0/3 过线
- 17-asset-feature-sets.md —— 资产类别特征集显式契约（黄金 ≠ 股票语义）
- 18-governance-conventions.md —— 治理章程：口径/判据/脏数据红线/否决权（用户签字）
- 19-telemetry-and-analytics.md —— 埋点与数据收集：匿名安装统计 / Opt-out / 隐私承诺
- 21-intel-sentinel.md —— 情报哨兵：任意 agent 平台定时喂料 ingest_event 的标准配方
- adr/ —— 架构决策记录（为什么不上 Claude Agent SDK 等）
🎨 我是设计师 / 前端（GUI 已退役，以下为重做时的历史参考）
- 10-design-system.md —— Token 三层 + 排版 + IA
- invest-gui/README.md —— 前端仓库结构
全部章节
| # | 章节 | 一句话 |
|---|---|---|
| 01 | 架构总览 | 4 层（Connectors / Agents / Core / Memory）+ 数据流 + 并发模型 |
| 02 | 4 角色委员会 | Macro / Quant / Risk / CIO + cross-challenge + REGIME |
| 03 | Dreaming 记忆整合 | Light / REM / Deep Sleep 三阶段，跨会话长期记忆 |
| 04 | 双执行路径 | Skill（Claude 真 subagent）vs Web/Cron（DeepSeek 多线程） |
| 05 | 数据模型 | v2 schema (cash dict + holdings list) + 迁移 + 并发安全 |
| 06 | Web API | FastAPI 40+ 端点 + Pydantic + 同源部署 |
| 07 | 扩展指南 | 加新资产 / 新数据源 / 新 agent 角色 |
| 08 | 生产部署 | Caddy + Cloudflare Access + systemd |
| 09 | 故障排查 | 线上跑挂去哪查 journal / SSE 断了 / sync 失败 |
| 10 | 设计系统 | （GUI 已退役，历史参考）GUI token + 排版三层 + IA 决策 |
| 11 | RL 训练 / Backtest | Optuna 调参 + paper trade simulation + DSPy（不是真 ML 训练） |
| 12 | Verification 实测验证 | 7 个核心主张的实测数据 + negative results + 复现命令 |
| 13 | 参数调优可行性诊断 | 50+ 硬编码常数清单 + 耦合分析 + Optuna 回顾 + sweep 策略 |
| 14 | Sweep Runner | 参数 sweep 工具链 |
| 15 | 概率表路径化 | 30/60/90 多窗分布 + 四类路径形状 + regime 持续标注 |
| 16 | TA 分析师实验 | 信号存在性两阶段实验，3 分析师 0/3 过预注册 Gate |
| 17 | 资产特征集契约 | 特征×资产类别矩阵；黄金 VIX 语义审查；反事实记账 |
| 18 | 治理章程 | 三原则(冻结快照/否决权/判据裁决) + 口径单源 + 合并前置 + 审计log |
| 19 | 埋点与数据收集 | 一次性匿名安装统计 + 三个 opt-out 环境变量 + 隐私承诺 |
| 20 | 使用教程 | 安装（plugin/MCP）→ onboarding → 日常自然语言用法 → 决策闭环 record_execution/decisions |
| 21 | 情报哨兵 | 三层情报架构 + 标准哨兵 prompt 模板 + 各平台接法 + 防注入纪律 |
| 22 | 配置参考 | LLM provider .env 契约 + ADR-017 runtime overrides 全表（从 README 迁入） |
| 23 | 模拟账户 autopilot | opt-in 执行层：独立 INVEST_HOME 里按确定性规则成交当日裁决，对照「人执行」 |
| 24 | 盈透实盘 autopilot | opt-in 真单执行层：LLM 每周选美股标的、委员会每天定买卖、代码硬闸兜底，按券商成交记账 |
架构决策记录 (ADR)
记录"为什么这么做"，给将来想推翻设计的人留依据。
| ID | 决策 | 状态 |
|---|---|---|
| 001 | 委员会保留 Skill + Web/Cron 双路径 | ✅ 已采纳 |
| 002 | 暂不升级到 Claude Agent SDK | ✅ 已采纳 |
| 003 | portfolio.md 升 v2 通用 schema | ✅ 已采纳 |
| 004 | v1 fallback 正式退场 | ✅ 已采纳 |
| 005 | daily_report 拆 builder/notifier | ✅ 已采纳 |
| 006 | 事件感知层 + 轻量新闻 RAG | 🚧 实现中（feature flag 默认关） |
| 007 | few-shot (v1-v4) 退役，CIO 保持 zero-shot，反保守走 Dreaming | ✅ 已采纳 |
| 008 | caution 改 lift-based 评分（试金石验证非 reward hacking）；现有数据下休眠；"过度保守"假设缺证据 | ✅ 已采纳 |
| 009 | 否决 TradingAgents 式分析师 subagent（test_ta 实验，预注册 Gate 0/3） | ✅ 已采纳 |
| 025 | 价格异动哨兵：10min vs 日ATR% 垂直线检测，先报警邮件后触发委员会 | ✅ 已采纳 |
| 026 | 决策核心三层纯度契约：calc 计算层 + 输入完备 + 全量留痕 | ✅ 已采纳 |
维护规则
- 本 wiki 是"为什么"的源——具体实现细节看代码 + 子目录 README，本 wiki 只讲设计意图
- 新加一个大功能：必须同步更一页（或开新页）
- 新加一个架构决策：必须开 ADR
- 子目录 README 改名 / 重组：本 wiki 链接要跟着
- ADR 一旦"已采纳"就别改，要推翻新开一个 supersedes 它
老规矩：CONTRIBUTING vs Wiki 分工——CONTRIBUTING 写"怎么参与"（稳态），Wiki 写"系统是什么"（活的）。