先按要完成的事情找入口。V1 是稳定版，V2 是独立的预览版；指南中的能力范围以对应产品为准，是否已发布请查看 Releases。
| 我想…… | 阅读 |
|---|---|
| 安装、更新、回滚或卸载 | 安装指南 |
| 使用稳定版 | V1 指南 · English |
| 开始使用 V2，搜索和恢复会话 | V2 使用指南 · 会话生命周期 |
| 连接团队、Pull/Push、分享会话或管理资源 | 团队协作流程 · 团队空间操作 |
| 编写团队资产清单，了解安装和恢复规则 | 团队资产参考 |
| 让 Agent 查找处理经验、规范和 Skill | Agent 检索指南 |
| 用命令行配置团队、查询会话和资源 | CLI 使用与配置 |
| 处理 Electron 安装失败 | 安装排障 |
首次参与开发先读贡献指南与仓库约定，再看所属模块的规格和源码。规格记录当前代码契约，ADR 记录重要选择的原因，两者均不代替本次验证结果。
| 要修改的范围 | 入口 |
|---|---|
| 进程、数据归属与模块边界 | 架构总览 |
| 会话解析、增量索引与查询 | 会话索引 |
| 启动、刷新或长会话卡顿 | 性能检查 · 桌面生命周期 |
| 团队资产、本地视图与同步冲突 | 团队资产规格 |
| Agent 执行、工作流与评估 | Runtime · Workflow · Eval |
| MCP、Skills、Memory 或服务商配置 | 全部功能规格 |
| 理解决策背景与替代方案 | ADR 索引 |
| macOS 打包和验证 | 打包说明 |
| 位置 | 保存什么 |
|---|---|
v1/、v2/ |
对应产品的使用指南与专题参考 |
spec/ |
当前行为、接口、数据、失败和兼容边界 |
adr/ |
架构取舍与后果；被替代的决定仍保留 |
designs/ |
有明确适用范围与实现边界的专项设计 |
project/archive/ |
不再维护的计划、交接和排查记录 |
专项设计和历史记录单独查阅，不作为新用户的上手流程。旧文档地址保留跳转说明；历史任务状态不能用来判断当前功能是否可用。
维护方式见文档约定。