文件最后提交记录最后更新时间
23 天前
14 天前
20 小时前
2 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
3 天前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
29 天前
28 天前
27 天前
25 天前
24 天前
24 天前
23 天前
23 天前
22 天前
22 天前
21 天前
21 天前
21 天前
20 天前
20 天前
20 天前
20 天前
19 天前
19 天前
19 天前
18 天前
17 天前
8 天前
7 天前
7 天前
6 天前
16 天前
14 天前
15 天前
12 天前
11 天前
11 天前
10 天前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
3 个月前
1 个月前
1 个月前
1 个月前
1 个月前
13 天前
13 天前
12 天前
13 天前
3 个月前
README

xwcode v0.81.7 架构审计

审计日期: 2026-07-15 审计版本: v0.81.7 (Wave 1 完成) 审计焦点: APAC 闭环 + 自举开发模式 审计角色: opencode-dev


审计文档清单

文档 内容
APAC-loop-analysis.md APAC 闭环深度分析 — 三层循环架构、阶段状态机、数据流、风险项
self-bootstrap-analysis.md 自举开发模式深度分析 — 四角色架构、诊断飞轮、双轨执行、演进史

核心发现摘要

APAC 闭环

xwcode 运行三个不同层次的循环:

  1. ConversationRuntime 外层循环 — LLM 调用→工具执行→结果推送的通用循环
  2. EditAgent APAC 循环 (Analyze→Plan→Act→Check) — BugFix 场景的核心四阶段循环
  3. SpecDrivenAgent 四阶段状态机 (Reading→Planning→Implementing→Verifying) — SDD 模式的独立状态机

最关键的设计决策: v0.81.2 将 APAC 阶段从代码状态机改为"系统 Prompt 引导"模式,阶段标签仅用于变更工具白名单和提示内容。这种设计提高了灵活性,但将阶段转换的正确性完全依赖于 LLM 的指令遵循能力。

主要风险: 双循环架构(ConversationRuntime 和 EditAgent 各有独立循环)导致维护负担加倍;阶段转换依赖 LLM 遵循度而非代码强校验。

自举开发模式

自举 = 让 xwcode 在真实独立环境(km 机器)执行真实开发任务,用诊断信号找出能力差距。

当前状态: Phase 2(独立分支 PR + 双轨执行 + opencode-dev 兜底)。v0.81.3 首次尝试以 Grade F 告终,但产出了 10 项发现;v0.81.4 修复后达到 Grade A。

核心飞轮: 部署→执行→诊断→发现→修复→下一轮。每次循环都让 xwcode 在真实开发能力上提升一步。

关键基础设施: comm v2 消息协议、diagnostics 数据管线、双轨对比框架(BootstrapTask + DiffClassifier)。


审计方法

本次审计基于以下材料:

  • 代码阅读:crates/xw-runtime/ 核心模块(runtime.rs, scene_agent.rs, spec_driven_agent.rs, loop_monitor.rs 等)
  • 架构文档:docs/WORKFLOW.md, docs/SELF_BOOTSTRAP_GUIDE.md
  • OpenSpec 规格:openspec/specs/ 及 openspec/changes/ 下相关版本的设计文档
  • 发布报告:release/v0813/ ~ release/v0816/ 的评审和自评文档
  • 脚本分析:scripts/self_bootstrap_cycle.sh, scripts/dogfood/