能力匹配分析 · 待建设清单 · 明确标注【可扩展设计】
📑 返回索引：项目文档索引
一、AI 上层应用方向能力匹配分析
| 能力项 | 现状 | 证据 | 建设建议 |
|---|---|---|---|
| LLM 上层应用架构 | ✅ 已具备 | Session 编排 + Provider 适配 + Tool 调用完整链路 | — |
| Agent / 多智能体 | ✅ 已具备 | build/plan/general/explore/compaction 多 Agent 体系，subagent 调用 | — |
| 工具调用与权限 | ✅ 已具备 | ToolRegistry + Permission + ToolRuntime.dispatch | — |
| 上下文注入 / 提示词管理 | ✅ 已具备 | System Context Registry + AGENTS.md 指令发现 + Skill 指引 | — |
| 流程编排（Workflow） | ✅ 已具备 | Context Epoch + Safe Provider-Turn Boundary + Compaction 续跑 | — |
| 效果评测体系 | 🟡 部分具备 | Provider 兼容测试 + http-recorder 录制回放；无系统性 agent 效果评测集 | 建设 agent 行为评测基准（多语言/多任务） |
| 业务数据反馈闭环 | 🟡 部分具备 | stats 平台（S3 数据湖 + Athena 查询 inference event）；无产品内反馈回路 | 基于 stats 建立模型效果监控面板 |
| 失败兜底 | ✅ 已具备 | Unavailable stale-while-revalidate + SessionRetry.policy | — |
| 调用成本管控 | 🟡 部分具备 | Cache Policy + Compaction；无成本核算模块 | 扩展 cache-policy 协议覆盖 |
二、智能单元 / RAG / 流程编排方向
| 能力项 | 现状 | 证据与说明 |
|---|---|---|
| 智能单元抽象（Agent） | ✅ 已具备 | Agent.Info + State.create store + 多 Agent 选择 |
| 检索增强（RAG） | 🟡 部分具备（轻量） | 项目指令发现（AGENTS.md）、reference 配置、文件系统 glob/grep 检索；无向量检索/重排序体系 |
| 流程编排 DSL | ✅ 已具备 | HttpApi + SDK Contract IR 构成声明式契约 DSL |
| 长任务调度 | 🟡 部分具备 | Session Drain + background-job；无跨进程任务队列 |
| 人工介入机制 | ✅ 已具备 | Permission ask + Deferred + Question API |
三、推理性能优化方向
结论：本项目不包含模型推理框架源码，推理性能优化【不适合作为系统发展主线】。
OpenCode 通过 packages/llm 适配层调用外部 Provider API（AI SDK），仓库内无 GPU 调度、模型量化、KV 缓存、算子优化、分布式通信等推理相关源码。与推理相关的仅有两项轻量能力：Cache Policy（提示词缓存标记注入）与 Compaction（上下文压缩）。文档表述时须严格区分”调用外部模型 API 的适配层”与”底层推理框架研发”。
四、分布式存储 / 检索方向
| 能力项 | 现状 | 说明 |
|---|---|---|
| 本地存储 | ✅ 已具备 | SQLite + Drizzle，WAL 模式，满足单机场景 |
| 云侧数据湖 | ✅ 已具备（平台侧） | infra/lake.ts：S3 Tables + Glue Iceberg 数据湖（inference event） |
| 分布式一致性 | ❌ 缺失 | Drain 进程本地协调，无分布式锁/选主（源码 TODO 明确集群化为未落地项） |
| 全文/向量检索 | ❌ 缺失 | 无搜索引擎/向量数据库；会话搜索依赖 SQLite 查询 |
| 多租户隔离 | 🟡 部分具备 | Location（workspace/directory）概念 + LocationMiddleware 解析；无账户级数据隔离 |
五、待建设清单
待建设 1：Agent 行为评测体系
当前状态：【可扩展设计】
| 项 | 内容 |
|---|---|
| 建议新增模块 | packages/eval 或 packages/benchmark |
| 现有基础 | http-recorder 录制回放、@playwright/test、Provider 兼容测试、stats 数据湖 |
| 当前缺口 | 无”给定任务 → 期望行为”的 agent 效果评测集与评分体系 |
| 建设价值 | 可量化模型/策略/工具变更对任务完成率的影响 |
| 完成后提升的能力 | 效果评测、模型路由决策、回归防护 |
| 适配系统方向 | AI Agent 平台 |
| 方案要点 | 任务集（编码/检索/规划）+ 评分器（可执行校验/LLM 裁判）+ 报告输出 |
| 落地成本与风险 | 中等成本；评测集维护与评分偏差是主要风险 |
| 不能算作现有能力的原因 | 仓库中无评测数据集与评分实现 |
待建设 2：Session 集群化执行（durable ownership）
当前状态：【可扩展设计】
| 项 | 内容 |
|---|---|
| 建议新增模块 | core/session 扩展（ownership + lease） |
| 现有基础 | 持久化事件系统（replay/divergence 校验）、session_context_epoch 持久化、SessionRunCoordinator |
| 当前缺口 | 多节点 ownership 与故障接管；runner 源码 TODO 明确未实现 |
| 建设价值 | 支撑云端多实例部署与故障转移 |
| 完成后提升的能力 | 横向扩展、高可用 |
| 适配系统方向 | 平台化 |
| 方案要点 | durable lease 表 + 心跳续约 + 过期接管；事件流天然支撑恢复 |
| 落地成本与风险 | 高成本；一致性窗口、双活风险需严格设计 |
| 不能算作现有能力的原因 | 当前 Drain 明确为 process-local |
待建设 3：会话全文检索与向量检索
当前状态：【可扩展设计】
| 项 | 内容 |
|---|---|
| 建议新增模块 | core 检索扩展（FTS5 索引 或 向量库） |
| 现有基础 | SQLite 存储、Page 分页、filesystem search 工具 |
| 当前缺口 | 无会话历史全文索引；无向量检索（历史会话语义召回） |
| 建设价值 | 大库场景会话搜索体验；RAG 化开发助手 |
| 完成后提升的能力 | 检索能力、记忆增强 |
| 适配系统方向 | AI Agent 平台 |
| 方案要点 | SQLite FTS5 起步；向量检索视成本后置 |
| 落地成本与风险 | 中成本；索引体积与实时性权衡 |
| 不能算作现有能力的原因 | 无任何检索索引实现 |
待建设 4：插件热重载与 v2 生态迁移
当前状态：【可扩展设计】
| 项 | 内容 |
|---|---|
| 建议新增模块 | plugin v2 完善（registration 已有 dispose/reload 基础） |
| 现有基础 | PluginContext（hooks & reload）、Registration{dispose}、Reload{reload} |
| 当前缺口 | CONTEXT.md 标注”Plugin-defined context registration and hot-reload lifecycle remain a follow-up” |
| 建设价值 | 插件生态繁荣的必要条件 |
| 完成后提升的能力 | 动态能力注入、用户侧插件体验 |
| 适配系统方向 | 平台化 |
| 方案要点 | 基于 SystemContextRegistry 扩展插件 Context Source 注册 + 热替换原子性 |
| 落地成本与风险 | 中成本；热替换与 Epoch 一致性交互需谨慎 |
| 不能算作现有能力的原因 | 插件注册 SystemContext 明确标注 follow-up |
六、能力缺口汇总雷达
| 方向 | 已具备 | 部分具备 | 缺失 |
|---|---|---|---|
| AI 应用架构 | 会话编排/Agent/工具/上下文/编排 | 评测体系、成本管控 | — |
| 检索体系 | 指令发现、文件检索 | — | 向量检索、全文索引 |
| 分布式 | — | Location 隔离 | 集群化、分布式一致性 |
| 推理性能 | 缓存标记、压缩 | — | 推理框架（明确不适合主线） |
| 工程治理 | 可观测/权限/迁移/代码生成 | 插件热重载 | — |
本分析严格区分【代码已实现】与【可扩展设计】：所有”缺失”条目均确认无对应源码，仅作为建设规划参考。
由 opencode-project-analyzer skill 生成