项目文档索引

OpenCode 源码分析报告 · 10 份文档导航 · 生成于 2026-08-09

本索引为全部 10 份分析文档的导航入口。建议阅读顺序：01 → 03 → 05（快速掌握全貌），02 → 04（深入业务），06 → 10（细节与规划）。

📚 文档索引

#	文档	内容概述
01	项目技术画像	系统定位、核心链路、成熟度评估、优势短板、最优定位方向（300-500 字画像 + 度量卡片）
02	业务背景重建	12 条代码可见业务事实、5 条可推导诉求、5 条不确定信息、架构演进脉络推断
03	系统架构总览	全景数据流图、模块全景图、五层架构、技术栈清单（18 项）、17 张核心数据表、配置体系
04	业务流程梳理	六大业务领域（会话编排/Provider 适配/上下文管理/工具权限/SDK/跨端）流程 + 6 张 Mermaid 图
05	技术亮点评估	TOP 15 技术亮点：S/A 分级 + L1-L4 层级 + 源码佐证 + 风险边界（含 6 个 S 级详解）
06	模块技术说明	13 个核心 workspace 包的职责/导出/关键文件/接口/依赖 + 模块依赖图
07	系统优化专项	10 项优化点：已实现/具备基础/建议补齐三态区分 + S/A/B 优先级 + Trade-off 分析
08	S级亮点专项	面向新人的 6 个 S 级亮点：通俗概述、术语释义表、代码入口链路、新人阅读路线
09	能力缺口分析	AI 应用/评测/RAG/推理性能/分布式四方向能力匹配 + 4 项待建设清单
10	本文档	全部文档导航与阅读指引

📋 关键结论速览

最终总结

系统最核心三项技术优势：

1. 会话可靠性架构：V2 Session Core 准入/执行分离 + Context Epoch 持久化基线，实现”崩溃不丢会话、压缩不丢语义”
2. 契约驱动的平台化：HttpApi → SDK Contract IR → 双 Emitter 代码生成 + 嵌入式 Host，一份契约服务多端
3. Effect 函数式工程化：Service/Layer/Scope/tagged error 全域落地，并发与错误处理由框架保证，五层依赖方向编译期约束

需要谨慎宣传、不可过度拔高的三点：

1. 不可声称”分布式高可用”——Session 执行为进程本地协调（集群化为 TODO）
2. 不可声称”全协议模型兼容”——8 个协议适配器仅部分有测试支撑
3. 不可声称”推理优化/成本优化能力”——仅 Provider 调用层 + 缓存标记 + 压缩，无推理框架与成本核算

推荐的系统发展主线： AI Agent 运行时与开发工具平台（会话可靠性 → 上下文工程化 → 生态扩展 → 平台化 SDK）。

优先落地的三项优化任务：

1. Session 运行态持久化（busy/retrying/interrupted durable 化，S 级）
2. Provider 重试与重复工具调用上界（防失控循环，S 级）
3. Provider 兼容性测试扩展（http-recorder 全协议回归基线，S 级）

🔍 分析自检清单

#	检查项	结果
1	所有结论有源码支撑，无法佐证信息已标注	✅ 通过（enterprise 定位等标注【不确定】）
2	未编造吞吐量/延迟/成本等量化指标	✅ 通过
3	未使用”整体架构负责人/从零搭建”等高危表述	✅ 通过
4	规划方案未描述为已实现功能（【可扩展设计】严格标注）	✅ 通过
5	区分”调用 Provider API”与”推理框架研发”	✅ 通过（文档 09 明确不适合作主线）
6	区分 AI Agent 平台与专用引擎	✅ 通过
7	亮点区分基础工程规范与架构级设计能力	✅ 通过（L1-L4 分级）
8	方案取舍与系统短板完整说明	✅ 通过（每亮点含取舍与风险边界）
9	区分新人通俗说明与专业描述	✅ 通过（文档 08 面向新人）
10	全部条目区分【已实现/推导结论/规划方案】	✅ 通过

---

文档由 opencode-project-analyzer skill 自动生成；Mermaid 图在支持 mermaid 的 Markdown 预览器中可渲染。源数据：E:\opencode-main（v1.18.15，2026-08-09 快照）。

由 opencode-project-analyzer skill 生成