这里汇总 SztuCode 的使用、开发、架构、运维和历史资料。根目录 README 用于快速了解和启动项目；详细规则以本目录中的现行文档为准。
| 文档 | 适合解决的问题 |
|---|---|
| 安装与启动 | 如何准备环境、安装依赖并启动 TUI 或桌面端 |
| 配置参考 | 如何配置模型、daemon、权限、压缩和日志 |
| 运维手册 | 如何管理 daemon、查看日志和排查常见故障 |
| 文档 | 适合解决的问题 |
|---|---|
| 贡献指南 | Issue、分支、编码、提交和 Pull Request 的完整流程 |
| 社区行为准则 | 协作边界、问题报告与执行原则 |
| 项目路线图 | 当前版本目标、研究方向和明确非目标 |
| 开发环境 | 本地开发环境、常用命令和模块修改约束 |
| 仓库目录地图 | 两条运行链、文档分类、诊断脚本和本地产物放在哪里 |
| 测试指南 | 单元、集成、协议和桌面端测试如何选择与运行 |
| 文档规范 | 文档放置、链接、生成文件和归档规则 |
| 安全策略 | 漏洞报告渠道、敏感信息和 Agent 安全边界 |
| 文档 | 状态 | 说明 |
|---|---|---|
| 架构说明 | 现行 | daemon、客户端、运行链路和数据持久化 |
| 架构决策记录 | 现行 | 重大技术决策、背景和替代方案 |
| Wire Protocol | 自动生成 | JSON-RPC 命令、事件和 Schema |
| 系统提示词架构 | 参考 | 分层提示词结构的可视化说明 |
| Workbuddy 提示词集成 | 现行 | 完整资源、技能、插件、子代理和产品模板的接入方式 |
| 内置插件 | 参考 | 插件来源、技能目录和启用方式 |
| 记忆与压缩系统 | TS 实现参考 | 包含早期设计材料，能力边界以代码及最新核对为准 |
| 评估指南 | 指南 | SWE-bench 与轨迹质量评估方法 |
| Terminal-Bench 评测指南 | 指南 | 通过 Harbor 接入 Terminal-Bench 的运行、模型与成本控制 |
| 微信接入指南 | 指南 | 通过 OpenClaw 微信插件，以 ACP 将 SztuCode 接入微信 |
| 多智能体工作流现状 | 现行 | TypeScript DAG、角色化子 Agent 与当前验证边界 |
| Agent 能力核对（2026-09-30） | 当前核对快照 | Python 默认运行链、TS 桌面链、已验证能力与限制 |
| Agent 能力评审 | 评审快照 | Runtime 各项能力打分、性能障碍与分阶段扩展路线 |
| Agent 能力审计（第二版） | 评审快照 | 阶段二、三落地后的重新评分、性能瓶颈、顶级产品差距和 durable 路线 |
| Agent 能力审计（第三版） | 评审快照 | Durable checkpoint 落地后的边界审计、性能回归、故障矩阵和 operation 恢复路线 |
| Agent 能力审计（第五版） | 评审快照 | 阶段五 operation lifecycle、durable replay 与真正 resume 前置条件审计 |
| AI 辅助开发方法论 | 指南 | 使用 AI 开发时的验证、审查与取舍 |
archive/ 中的内容用于保存设计过程和阶段性复盘，可能包含过时的架构、数量、路径或技术选型，不能作为当前实现依据：
设计提案保留在 plans/、superpowers/，外部研究材料保留在 研究参考/；这些内容不证明功能已经交付。
- 现行：与当前代码契约保持一致，修改相关行为时必须同步更新。
- 指南：提供推荐流程，允许随实践持续完善。
- 自动生成：由脚本生成，不接受手工编辑。
- 历史资料：只用于背景理解，不定义当前行为。
发现文档与实现不一致时，请以可执行代码和测试为证据，同时提交文档修正。具体规则见 文档规范。