From 164ea149b419ff391b0f1d630dfcb9c1b77de035 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E5=B2=A9=E5=B2=A9?= Date: Thu, 16 Jul 2026 09:24:26 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E7=AC=AC=E4=BA=8C=E7=89=88=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E4=B8=8A=E4=BC=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/README.md | 8 ++-- docs/agent/model-chat.md | 36 ++++++++++------ docs/agent/runs-behavior.md | 37 +++++++++------- docs/agent/tools-workspace.md | 45 +++++++++++++------- docs/architecture/local-data.md | 3 -- docs/architecture/overview.md | 3 -- docs/automation/computer-butler.md | 49 ++++++++++++++++------ docs/clients/desktop.md | 36 ++++++++++------ docs/clients/web.md | 43 +++++++++++++------ docs/development/project-assistant.md | 44 ++++++++++++------- docs/development/system-evolution.md | 51 ++++++++++++++++------- docs/extension/hooks-extensions.md | 44 ++++++++++++------- docs/foundation/cli.md | 51 ++++++++++++++++------- docs/foundation/runtime.md | 36 ++++++++++------ docs/foundation/spaces.md | 37 +++++++++------- docs/intelligence/memory-knowledge.md | 43 +++++++++++++------ docs/intelligence/planning-multi-agent.md | 43 +++++++++++++------ docs/operations/reliability-safety.md | 44 ++++++++++++------- docs/roadmap.md | 12 +++--- 19 files changed, 445 insertions(+), 220 deletions(-) diff --git a/docs/README.md b/docs/README.md index 24968db..379b13f 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,10 +4,10 @@ ## 使用方式 -- 每个大功能点一个文件，文件头标记 `状态` 与 `期望阶段`。 -- `todo`、`doing`、`done` 表示当前进度；阶段只表示建议先后，不构成严格依赖顺序。 -- 每完成一个独立提交，在对应文档中补充提交、blog 和实现说明。 -- 未明确的方案写在“待细化”中，不提前冻结实现。 +- 每个大功能点一个文件，大功能本身不设置状态或阶段。 +- 大功能文档内部拆分小功能点，每项分别记录期望实现阶段、实际开发状态、已确认点和待确认点。 +- 阶段只表示期望先后，不构成严格依赖顺序；实际开发状态按实施进展更新。 +- 每完成一个独立提交，在对应小功能点中补充提交、blog 和实现说明。 ## 导航 diff --git a/docs/agent/model-chat.md b/docs/agent/model-chat.md index 706ad32..986c3e6 100644 --- a/docs/agent/model-chat.md +++ b/docs/agent/model-chat.md @@ -1,21 +1,31 @@ # 模型与聊天 -状态：todo -期望阶段：P1 +首版聚焦可靠的 DeepSeek 聊天体验，模型扩展能力在真实需求出现后逐步提炼。 -## 目标 +## DeepSeek Adapter -先提供可靠、连续的 DeepSeek 聊天能力；模型接入保持可替换，但不提前实现多 Provider 系统。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：第一版只兼容 DeepSeek API；模型调用由 Runtime 管理。 +- 待确认点：默认模型、API 地址、请求参数、Key 的读取与配置方式。 -## 已确定 +## 流式聊天 -- 第一版只兼容 DeepSeek API。 -- 支持流式回复和会话历史加载。 -- 模型调用由 Runtime 管理，CLI 只渲染流。 -- 未来模型提供商属于 Adapter 层。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：回答通过 Runtime 流式传递给客户端，并持久化至当前 Conversation。 +- 待确认点：断线处理、中途取消、重连以及部分回复的保存规则。 -## 待细化 +## 对话上下文 -- API Key 的读取位置与配置体验。 -- 默认模型、请求参数和失败/限流提示。 -- 上下文窗口压缩策略。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：聊天加载当前 Conversation 的历史；复杂记忆系统后置。 +- 待确认点：系统提示词、上下文窗口裁剪、历史过长时的摘要策略。 + +## 多模型支持 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：未来模型提供商属于 Adapter 层，不应写死在 Agent Behavior 中。 +- 待确认点：Provider 接口、模型路由、降级、成本与 Token 统计。 diff --git a/docs/agent/runs-behavior.md b/docs/agent/runs-behavior.md index 4fe5db2..cdaa11f 100644 --- a/docs/agent/runs-behavior.md +++ b/docs/agent/runs-behavior.md @@ -1,22 +1,31 @@ # Run 与 Agent Behavior -状态：todo -期望阶段：P1 +Run 为一次用户请求提供可观察的执行边界；Behavior 定义 Agent 如何完成这次执行。 -## 目标 +## Run 生命周期 -使一次用户请求拥有可观察的运行边界，并为未来不同 Agent 行为留下接缝。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：一次用户消息默认产生一个 Run；纯聊天和 Tool 行动使用同一个 Run 概念。 +- 待确认点：首版状态、取消、失败、重试和后台运行语义。 -## 已确定 +## DefaultAgent Behavior -- 一次用户消息默认产生一个 Run。 -- 纯聊天 Run 只产生模型回答；行动 Run 还包含 Tool 调用、输出和产物。 -- 第一版仅实现 `DefaultAgent`，不预设 Planner/Worker/Reviewer 流程。 -- Behavior 定义 Agent 如何准备上下文、调用模型、调用 Tool 和结束 Run。 -- Run 记录输入、输出、错误、时间和原始执行日志。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：首版只有单 Agent；Behavior 负责准备上下文、调用模型、调用 Tool 和结束 Run。 +- 待确认点：Behavior 的 TypeScript 接口，以及系统提示词与上下文组装的位置。 -## 待细化 +## 执行日志 -- Run 的取消、重试和失败显示。 -- 行为接口的具体 TypeScript 形状。 -- 后续 Plan/Step 与 Run 的关系。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：记录输入、模型输出、Tool 调用、错误和时间；生成脚本文本记录在日志中，不额外保存脚本副本。 +- 待确认点：JSONL 记录粒度、大输出截断、日志与产物的边界。 + +## Run 控制 + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：客户端最终需要取消、查看和重新执行 Run。 +- 待确认点：取消信号传播、失败后续跑和重试时的上下文复用。 diff --git a/docs/agent/tools-workspace.md b/docs/agent/tools-workspace.md index 0c10b93..22f86d9 100644 --- a/docs/agent/tools-workspace.md +++ b/docs/agent/tools-workspace.md @@ -1,23 +1,38 @@ # Tools 与 Workspace -状态：todo -期望阶段：P2 +Tool 是 Agent 主动调用外部能力的统一边界；Workspace 是文件与 Shell 操作的默认作用域。 -## 目标 +## Tool 契约与注册 -让单 Agent 在隔离工作区中使用文件与 Shell 完成真实任务。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：Tool 声明名称、描述、参数并返回结构化结果；实际执行由 Runtime 承载。 +- 待确认点：参数 Schema、错误结果、流式 Tool 输出与注册 API。 -## 已确定 +## Task Workspace -- Tool 是 Agent 主动调用的外部能力。 -- 第一批能力：读写文件、目录浏览、文本搜索和 Shell 执行。 -- 每个 Task 有独立 Workspace；Shell 默认在该目录执行。 -- Tool 调用参数、输出、错误和生成脚本文本写入 Run 日志。 -- Agent 通过模型 Tool Calling 自主选择、调用并读取 Tool 结果。 -- 初期不建设复杂审批或权限语言；真实破坏性操作出现后再增强。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：位于 `~/.agent/tasks//workspace/`；Shell 和文件 Tool 默认以其为作用域。 +- 待确认点：初始化内容、路径展示、临时文件和清理行为。 -## 待细化 +## 文件 Tool -- Shell 超时、取消、后台进程和大输出处理。 -- 文件写入与补丁的交互方式。 -- Tool 描述和参数 Schema 的具体格式。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：首批支持读写文件、目录浏览和文本搜索。 +- 待确认点：补丁接口、编码处理、大文件限制与二进制文件策略。 + +## Shell Tool + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：记录命令、输出、退出码和错误；首期安全机制保持轻量。 +- 待确认点：超时、取消、后台进程、交互命令和输出上限。 + +## 单 Agent Tool Calling + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：Agent 自主选择 Tool、读取结果并继续调用模型，直至给出最终回复。 +- 待确认点：循环上限、失败反馈、并行调用和客户端事件协议。 diff --git a/docs/architecture/local-data.md b/docs/architecture/local-data.md index 3ff8d92..610a7b3 100644 --- a/docs/architecture/local-data.md +++ b/docs/architecture/local-data.md @@ -1,8 +1,5 @@ # 本地数据与目录 -状态：todo -期望阶段：P1 - ## 原则 数据以本地普通文件保存，保持易读、易调试、易由 Agent 修改。早期不承诺兼容性，不预先建设 schema migration；重要数据依靠备份，格式变更需要时再写一次性转换脚本。 diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md index 855a9a2..b2a7f6c 100644 --- a/docs/architecture/overview.md +++ b/docs/architecture/overview.md @@ -1,8 +1,5 @@ # 架构总览 -状态：todo -期望阶段：P1 - ## 定位 这是纯个人使用的开发助手与电脑管家。它支持 Project 和 Task 两种并列 Space，并通过 CLI、Web、Desktop 三个客户端访问同一个本地 Runtime。 diff --git a/docs/automation/computer-butler.md b/docs/automation/computer-butler.md index 5321f95..317ffc9 100644 --- a/docs/automation/computer-butler.md +++ b/docs/automation/computer-butler.md @@ -1,20 +1,45 @@ # 电脑管家与自动化 -状态：todo -期望阶段：P4 +电脑管家能力让 Task 能处理浏览器、本机应用和日常临时事务。 -## 目标 +## 本机基础能力 -将 Task 从临时聊天空间发展为可处理本地日常事务的电脑管家。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：候选能力包括剪贴板、通知、文件整理和进程信息，并通过 Tool 逐项加入。 +- 待确认点：优先能力、跨平台范围和系统 API 选择。 -## 已确定 +## 浏览器读取与交互 -- 能力通过 Tool 逐项加入，不预先建设完整桌面自动化平台。 -- 候选能力包括剪贴板、通知、文件整理、进程信息、浏览器读取与交互、应用/窗口控制、截图、键鼠自动化、定时任务和后台任务。 -- 常用工作流可以沉淀为模板或 Behavior，但不在早期固定格式。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：需要覆盖网页搜索、读取、结构化提取和交互操作。 +- 待确认点：浏览器驱动、登录态复用、下载、标签页管理和真实提交确认。 -## 待细化 +## 应用与窗口控制 -- 首个接入的本机/浏览器能力由真实日常需求决定。 -- 浏览器驱动、桌面自动化方式和各平台兼容性。 -- 自动化任务的确认、停止和恢复体验。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：逐步加入应用启动、窗口管理和文件定位等能力。 +- 待确认点：操作系统优先级、原生桥接方式和无障碍权限。 + +## 桌面自动化 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：候选能力包括截图、屏幕理解、键盘和鼠标操作。 +- 待确认点：视觉驱动方式、坐标可靠性、停止机制和操作确认。 + +## 定时与后台任务 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：未来支持提醒、定时执行与长期后台任务。 +- 待确认点：调度器归属、Runtime 重启恢复、错过任务和结果通知。 + +## 自动化模板 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：重复工作可沉淀为 Behavior 或工作流模板，但不提前固定格式。 +- 待确认点：模板创建、参数化、分享、修改和版本管理。 diff --git a/docs/clients/desktop.md b/docs/clients/desktop.md index fdc665c..6e555c6 100644 --- a/docs/clients/desktop.md +++ b/docs/clients/desktop.md @@ -1,21 +1,31 @@ # Desktop -状态：todo -期望阶段：P6 +Desktop 是本地常驻控制台与系统集成层，复用 Web 界面与同一个 Runtime。 -## 目标 +## Desktop Host -将 Desktop 建设为本地常驻控制台和系统集成层，复用 Web 界面与 Runtime。 +- 期望实现阶段：P6 +- 实际开发状态：未开始 +- 已确认点：负责拉起、连接和观察本地 Runtime；Desktop 框架在进入本阶段前单独讨论。 +- 待确认点：框架、打包、更新、Web 前端复用和跨平台目标。 -## 已确定 +## 常驻体验 -- Desktop 在 CLI 和 Web 产品线之后开发。 -- 负责 Runtime 生命周期、托盘、通知、快捷键、原生确认、版本切换与健康状态。 -- 可逐步承担剪贴板、窗口、文件系统和其他原生能力桥接。 -- Desktop 框架在进入本阶段前单独讨论确定。 +- 期望实现阶段：P6 +- 实际开发状态：未开始 +- 已确认点：支持托盘、通知、全局快捷键和后台状态提示。 +- 待确认点：开机启动、任务完成通知、快捷入口和菜单设计。 -## 待细化 +## 原生确认与版本控制 -- 框架选择与打包更新策略。 -- Web 前端复用方式。 -- 原生权限、后台常驻和跨平台边界。 +- 期望实现阶段：P6 +- 实际开发状态：未开始 +- 已确认点：提供高影响操作确认、版本切换、Runtime 重启、回退与健康状态面板。 +- 待确认点：确认弹窗队列、Supervisor 连接和故障恢复体验。 + +## 原生能力桥接 + +- 期望实现阶段：P6 +- 实际开发状态：未开始 +- 已确认点：可逐步承载剪贴板、窗口、文件系统和其他原生能力桥接。 +- 待确认点：与 Runtime Tool 的边界、权限申请、平台差异和无界面运行方式。 diff --git a/docs/clients/web.md b/docs/clients/web.md index a759b14..ef3c832 100644 --- a/docs/clients/web.md +++ b/docs/clients/web.md @@ -1,21 +1,38 @@ # Web -状态：todo -期望阶段：P5 +Web 是 Runtime 的第二个客户端，不复制 Agent、存储或 Tool 逻辑。 -## 目标 +## Web 连接层 -将 Web 建设为 Runtime 的第二个客户端，不复制 Agent、存储或 Tool 逻辑。 +- 期望实现阶段：P5 +- 实际开发状态：未开始 +- 已确认点：复用同一个本地 Runtime，并支持请求、流式事件和状态查询。 +- 待确认点：HTTP/SSE/WebSocket、远程访问方式和断线恢复。 -## 已确定 +## 会话工作台 -- Web 在 CLI 产品线之后开发。 -- 首先覆盖 Space、Conversation、流式聊天和 Run 观察。 -- 后续覆盖 Tool 日志、产物、Plan、项目记忆、Diff、扩展、确认和 System Evolution 管理。 -- Web 框架进入本阶段前单独讨论确定。 +- 期望实现阶段：P5 +- 实际开发状态：未开始 +- 已确认点：覆盖 Space、Conversation、流式聊天与历史浏览。 +- 待确认点：前端框架、状态管理、路由与移动端适配。 -## 待细化 +## 执行观察台 -- Runtime 的 HTTP/SSE/WebSocket 访问层。 -- 本地与远程访问方式。 -- 前端框架、状态管理和视觉设计。 +- 期望实现阶段：P5 +- 实际开发状态：未开始 +- 已确认点：查看 Run、Tool、Plan、Agent、日志和产物，并提供必要的取消/恢复操作。 +- 待确认点：实时视图、长日志渲染、后台任务和多 Run 并行展示。 + +## 项目与进化工作台 + +- 期望实现阶段：P5 +- 实际开发状态：未开始 +- 已确认点：后续展示项目规则、记忆、测试结果、Git Diff 和 System Evolution 过程。 +- 待确认点：文件编辑、Diff Review、发布确认和版本回退体验。 + +## Web 管理能力 + +- 期望实现阶段：P5 +- 实际开发状态：未开始 +- 已确认点：后续管理配置、扩展、记忆和高影响操作确认。 +- 待确认点：功能范围、本地/远程访问边界与是否需要轻量认证。 diff --git a/docs/development/project-assistant.md b/docs/development/project-assistant.md index fd4e5b9..4082e90 100644 --- a/docs/development/project-assistant.md +++ b/docs/development/project-assistant.md @@ -1,22 +1,38 @@ # Project 开发助手 -状态：todo -期望阶段：P2 +Project 模式让 Agent 在绑定的源码目录中完成长期开发工作。 -## 目标 +## Project 初始化与绑定 -让 Agent 能在绑定源码目录中完成“理解 → 修改 → 测试 → 汇报”的开发闭环。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：Project 绑定本地源码目录，并在项目根目录使用 `.agent/` 保存会话、Run 和项目上下文。 +- 待确认点：初始化命令、已有 `.agent/` 的处理、路径移动与解绑。 -## 已确定 +## 代码工程 Toolset -- Project 在项目根目录使用 `.agent/` 存放自身会话、Run 和项目上下文。 -- 项目规则、架构摘要和决策记录会逐步沉淀，但不预先引入 RAG。 -- 开发 Tool 包含代码搜索、修改/补丁、测试执行和测试结果收集。 -- 初期由单 Agent 完整完成开发任务；多 Agent 协作由后续真实需求驱动。 -- Git 支持 status、diff、log 与 worktree；候选修改默认放在隔离 worktree。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：包括代码搜索、修改/补丁、测试执行和测试结果收集；复用通用 Tool Runtime。 +- 待确认点：测试命令发现、语言适配、代码索引和大仓库性能。 -## 待细化 +## 单 Agent 开发工作流 -- 项目说明文件的名称和注入时机。 -- worktree 的目录、清理和默认分支策略。 -- Task 升级 Project 的 CLI/TUI 流程。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：先跑通“理解源码 → 修改 → 测试 → 汇报”；第一版不强制 Planner/Worker/Reviewer。 +- 待确认点：项目上下文装配、修改前计划、完成判定与失败反馈。 + +## Git 与 Worktree + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：支持 status、diff、log 和 worktree；候选修改默认发生在隔离 worktree。 +- 待确认点：worktree 路径、分支命名、清理策略与普通 Project 的 Git 写操作确认。 + +## 项目知识沉淀 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：项目规则、架构摘要和决策记录以普通文件起步，不预先引入 RAG。 +- 待确认点：文件名称、自动更新时机、是否进入 Git 和人工编辑体验。 diff --git a/docs/development/system-evolution.md b/docs/development/system-evolution.md index d4e3cbb..16bd32c 100644 --- a/docs/development/system-evolution.md +++ b/docs/development/system-evolution.md @@ -1,22 +1,45 @@ # System Evolution -状态：todo -期望阶段：P3 +System Evolution 让 Agent 像维护普通开发项目一样维护自身。进化目标由用户提出，不要求 Agent 主动发现问题。 -## 目标 +## System Evolution Profile -使 Agent 能像维护普通开发项目一样维护自身。进化由用户在专属 Project 中提出需求或反馈驱动，不要求 Agent 主动发现问题。 +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：它是绑定 Agent 自身源码仓库的特殊 Project Profile，不是独立系统。 +- 待确认点：初始化方式、默认项目规则、允许使用的 Tool 与上下文装配。 -## 已确定 +## 候选版本工作区 -- `System Evolution` 是特殊 Project Profile，绑定 Agent 自身源码仓库。 -- Agent 在 Git worktree 中分析、修改、测试候选版本。 -- 用户查看 Diff 后确认 Git commit/merge/push 等写操作。 -- Supervisor 在内核外负责候选版本切换、启动、健康检查和失败回退。 -- 初期以 Git 历史和 Run 日志记录演化过程；复杂评估与进化档案后置。 +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：Agent 在隔离 Git worktree 中分析、修改和测试自身，不直接篡改当前运行副本。 +- 待确认点：worktree 生命周期、并行候选版本和磁盘清理。 -## 待细化 +## 变更与测试报告 -- Supervisor 的最小实现和版本切换方式。 -- 候选版本测试、健康检查和回退判定。 -- 发布确认在 CLI/TUI/Web/Desktop 中的体验。 +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：发布前向用户展示 Diff、测试结果和变更说明。 +- 待确认点：最低测试门槛、健康检查、失败结果的保留与重新修改。 + +## Git 发布确认 + +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：commit、merge、push 等 Git 写操作必须经用户确认。 +- 待确认点：确认粒度、CLI/TUI 交互、拒绝后的候选版本处理。 + +## Supervisor 与回退 + +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：Supervisor 位于内核外，负责版本切换、启动、健康检查和失败回退。 +- 待确认点：部署布局、进程交接、版本指针和自动回退判定。 + +## 进化历史与评估 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：初期 Git 历史和 Run 日志即为进化记录；后续可关联需求、Diff、测试、发布和回退。 +- 待确认点：是否需要独立 Evolution Record、基准任务以及新旧版本比较方式。 diff --git a/docs/extension/hooks-extensions.md b/docs/extension/hooks-extensions.md index 1b97475..5eb6caf 100644 --- a/docs/extension/hooks-extensions.md +++ b/docs/extension/hooks-extensions.md @@ -1,22 +1,38 @@ # Hooks、扩展与 Profile -状态：todo -期望阶段：P4 +扩展体系让新能力以 Tool、Hook、Behavior、Adapter 或 Profile 的形式生长，而不是全部进入微内核。 -## 目标 +## 基础 Hook 接缝 -让新能力在需要时能以 Tool、Hook、Behavior、Adapter 或 Profile 的形式优雅生长。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：第一版只保留 `beforeTool`、`afterTool`、`afterRun` 三个轻量 Hook 点，并允许内置代码注册。 +- 待确认点：回调签名、错误传播、是否允许修改输入输出。 -## 已确定 +## Hook Runtime -- 第一版只保留 `beforeTool`、`afterTool`、`afterRun` 三个轻量 Hook 点。 -- Hook 用于观察、约束或响应生命周期；不承担 Run 状态、存储一致性或 Tool 实际执行。 -- Tool、Hook、Behavior、Adapter 是不同扩展形态，不混为“插件”。 -- Project、Task、System Evolution 的差异最终由 Profile 组合表达。 -- 自动发现、manifest、依赖管理、调试台均后置，等出现真实的独立扩展需求再实现。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：Hook 用于观察、约束或响应生命周期，不承担存储一致性、Run 状态或 Tool 实际执行。 +- 待确认点：优先级、异常隔离、启停、同步/异步行为和更多稳定事件。 -## 待细化 +## 扩展加载 -- Hook 的注册、顺序、异常隔离和启停。 -- 扩展目录、加载方式和本地开发体验。 -- Profile 的配置格式与覆盖规则。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：当独立扩展需求出现后，再支持 Tool、Hook、Behavior、Adapter 的本地发现与加载。 +- 待确认点：目录布局、manifest、版本依赖、热加载和调试方式。 + +## Profile 组合 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：Project、Task、System Evolution 的差异最终由默认 Tool、Hook、Behavior 和策略组合表达。 +- 待确认点：配置格式、继承覆盖、项目级自定义和运行时切换。 + +## 扩展开发体验 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：扩展应可单独测试、启停和定位运行问题。 +- 待确认点：模板生成、调试 CLI/TUI、扩展回滚和是否需要独立分发机制。 diff --git a/docs/foundation/cli.md b/docs/foundation/cli.md index d0fe070..6471371 100644 --- a/docs/foundation/cli.md +++ b/docs/foundation/cli.md @@ -1,26 +1,45 @@ # CLI -状态：todo -期望阶段：P1 +CLI 是第一条完整产品线，既要适合快速对话，也要能观察和管理复杂运行。 -## 目标 +## 自然语言 REPL -CLI 是第一条完整产品线，应能独立完成聊天、空间管理、执行观察和日常开发/临时事务。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：普通输入发送给当前 Conversation；提示符展示当前 Task/Project 与 Conversation；回答支持流式输出。 +- 待确认点：启动时恢复最近上下文还是显示选择器；输入历史、多行输入与中断体验。 -## 已确定 +## 斜杠命令 -- 以自然语言 REPL 为主；普通文本发送给当前 Conversation。 -- 使用少量斜杠命令处理 Space、会话、Run 等确定性控制操作。 -- 提示符需要明确显示当前 Task/Project 与 Conversation。 -- Agent 的普通回答流式输出；Tool 调用显示简短状态、结果和失败信息，不展示内部推理。 -- 除 REPL 外，CLI 还应提供全屏 TUI，用于浏览 Space、会话、Run、日志与产物；它属于 CLI 产品线，不是可遗忘的远期附属功能。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：斜杠命令只处理确定性控制操作；候选包括 `/new`、`/switch`、`/task`、`/project`、`/runs`、`/log`、`/cancel`、`/exit`。 +- 待确认点：第一批命令范围、参数格式、命令补全和错误提示。 -## 候选命令 +## Space 与会话导航 -`/new`、`/conversations`、`/switch`、`/tasks`、`/task`、`/project`、`/runs`、`/log`、`/cancel`、`/exit`。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：CLI 能创建、查看、切换 Task/Project 和它们内部的多个 Conversation。 +- 待确认点：列表样式、编号/名称选择、最近使用记录与快速切换方式。 -## 待细化 +## Tool 与 Run 呈现 -- 启动时恢复最近上下文还是提供编号选择器。 -- REPL 与 TUI 的切换方式、TUI 库、布局和快捷键。 -- 长 Tool 输出的折叠、复制与完整日志查看方式。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：显示 Tool 名称、关键参数、结果和失败，不展示模型内部推理；长输出保留完整日志入口。 +- 待确认点：流式事件样式、折叠规则、颜色、产物链接和后台 Run 展示。 + +## 全屏 TUI + +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：TUI 属于 CLI 正式能力，用于浏览 Space、Conversation、Run、日志与产物；REPL 仍保留用于快速工作。 +- 待确认点：TUI 库、布局、快捷键、命令面板，以及与 REPL 的切换方式。 + +## CLI 诊断与配置 + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：CLI 应能查看 Runtime 状态、当前配置与日志位置。 +- 待确认点：配置修改入口、诊断报告和调试模式。 diff --git a/docs/foundation/runtime.md b/docs/foundation/runtime.md index 96f48fb..0a3023c 100644 --- a/docs/foundation/runtime.md +++ b/docs/foundation/runtime.md @@ -1,21 +1,31 @@ # Runtime -状态：todo -期望阶段：P1 +Runtime 是本地常驻的唯一运行宿主，负责状态写入、Agent 执行与 Tool 调用。CLI、Web、Desktop 都是它的客户端。 -## 目标 +## 工程与包边界 -建立一个常驻本地 Runtime。它是唯一的状态写入者，也是 Agent、Tool 和未来客户端的运行宿主。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：TypeScript + Node.js + monorepo；Runtime、客户端与共享边界需要清晰。 +- 待确认点：Node 版本、包管理器、monorepo 工具、首批包的职责与依赖方向。 -## 已确定 +## 常驻进程 -- 技术基础为 TypeScript + Node.js + monorepo。 -- CLI 从第一天起连接常驻 Runtime，而不是把 Runtime 嵌入在 CLI 进程中。 -- Runtime 负责 Space、Conversation、Run、本地数据和 Tool 执行。 -- Web 与 Desktop 以后只是同一 Runtime 的客户端，不重复 Agent 逻辑。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：Runtime 从第一天起独立常驻；CLI 日常启动时自动连接，必要时自动拉起。 +- 待确认点：单实例检测、启动/停止、健康检查、日志位置和异常退出行为。 -## 待细化 +## 本地通信 -- CLI 与 Runtime 的本地通信方式。 -- Node 版本、包管理器、monorepo 工具和包边界。 -- Runtime 启动、健康检查、单实例和停止行为。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：客户端不直接读写 Agent 数据；协议不绑定 CLI，并应能支持流式输出。 +- 待确认点：HTTP + SSE、Unix Socket 或其他本地 RPC 方案。 + +## Runtime 服务边界 + +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：Runtime 负责 Space、Conversation、Run、本地数据、Agent Behavior 与 Tool 执行。 +- 待确认点：首版内部模块边界，以及哪些能力进入微内核、哪些保留为可替换实现。 diff --git a/docs/foundation/spaces.md b/docs/foundation/spaces.md index 46be972..8aed449 100644 --- a/docs/foundation/spaces.md +++ b/docs/foundation/spaces.md @@ -1,22 +1,31 @@ # Space 与 Conversation -状态：todo -期望阶段：P1 +Project 与 Task 是并列的一级空间，两者内部都可以包含多个 Conversation。 -## 目标 +## Task Space -提供两种并列的一级空间，并让每个空间拥有多个独立会话。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：用于闲聊与临时事务；数据存放于用户目录；每个 Task 拥有专属 Workspace。 +- 待确认点：默认 `inbox`、自动命名、归档、删除与最近使用策略。 -## 已确定 +## Project Space -- `Project`：长期开发空间，绑定本地项目目录。 -- `Task`：临时个人事务空间，可用于闲聊、脚本、浏览器或应用控制。 -- 两类 Space 均包含多个 Conversation。 -- 一次实际 Agent 执行称为 `Run`，避免与 Task 概念混淆。 -- `inbox` 可以作为默认 Task；具体生命周期在实现前确认。 +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：用于长期开发工作；绑定本地项目目录；Agent 数据存放在项目的 `.agent/` 中。 +- 待确认点：项目初始化、路径移动、解绑与多工作区支持。 -## 待细化 +## Conversation -- Task 的默认命名、归档和删除体验。 -- Conversation 标题生成与重命名体验。 -- Project/Task 切换在 REPL 与 TUI 中的展示。 +- 期望实现阶段：P1 +- 实际开发状态：未开始 +- 已确认点：每个 Space 可以拥有多个 Conversation；会话承载消息与相关 Run。 +- 待确认点：标题生成、重命名、归档、搜索和跨会话引用。 + +## Task 升级为 Project + +- 期望实现阶段：P2 +- 实际开发状态：未开始 +- 已确认点：Task Workspace 结构尽量与 Project 工作区一致；升级时迁移到用户指定位置并补充 Project 元数据。 +- 待确认点：目录冲突、历史记录路径更新、Git 初始化与升级交互。 diff --git a/docs/intelligence/memory-knowledge.md b/docs/intelligence/memory-knowledge.md index c2b0c92..a546e7d 100644 --- a/docs/intelligence/memory-knowledge.md +++ b/docs/intelligence/memory-knowledge.md @@ -1,21 +1,38 @@ # 记忆与知识 -状态：todo -期望阶段：P4 +记忆能力为 CLI、Web、Desktop 共享个人、项目和会话上下文，同时保持数据本地、可读和可编辑。 -## 目标 +## Conversation 记忆 -让三端共享有用的个人、项目和会话上下文，同时保持数据本地化和可编辑。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：会话可以生成摘要，降低长历史的上下文成本。 +- 待确认点：生成时机、更新方式、人工编辑和与原始消息的关系。 -## 已确定 +## Space 记忆 -- 目标层级：Conversation、Task/Project、全局个人记忆，以及短暂的 Run 工作记忆。 -- 初期优先使用摘要、项目说明、架构记录和决策记录等普通文件。 -- 记忆应能查看、编辑、固定或遗忘。 -- 全文检索、文档导入、向量检索和混合检索均后置。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：Task/Project 各自保存长期上下文；Project 可沉淀规则、架构和决策。 +- 待确认点：文件布局、跨会话提炼、失效信息和 Task/Project 差异。 -## 待细化 +## 全局个人记忆 -- 何时自动摘要与提炼记忆。 -- 跨 Space 的记忆引用和隔离规则。 -- 个人偏好写入全局记忆的确认体验。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：保存跨 Space 有效的个人偏好与长期事实，供三端共享。 +- 待确认点：写入确认、隐私边界、冲突处理和从 Space 提升的规则。 + +## 记忆管理 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：记忆应能查看、编辑、固定、遗忘并追溯来源。 +- 待确认点：客户端体验、自动清理、可信度与过期策略。 + +## 检索与知识导入 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：先使用普通文件和全文检索；向量/混合检索、文档导入按真实需求增加。 +- 待确认点：索引方式、切分、引用来源、支持格式与向量存储。 diff --git a/docs/intelligence/planning-multi-agent.md b/docs/intelligence/planning-multi-agent.md index 9149dc8..08a11f0 100644 --- a/docs/intelligence/planning-multi-agent.md +++ b/docs/intelligence/planning-multi-agent.md @@ -1,21 +1,38 @@ # 计划与多 Agent -状态：todo -期望阶段：P4 +这一能力在单 Agent 出现真实瓶颈后引入，用于拆解复杂目标并协调多个执行者。 -## 目标 +## Plan 与 Step -在单 Agent 已表现出真实瓶颈后，为复杂目标加入计划、步骤和多 Agent 协作。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：复杂目标可拆为可执行步骤并自动依序执行；它们属于 Run 之上的行为能力。 +- 待确认点：数据结构、编辑方式、完成条件、CLI/TUI 展示和与 Conversation 的关系。 -## 已确定 +## 步骤执行与重规划 -- 复杂行动目标可拆为可执行步骤并自动依序执行。 -- 计划、步骤与子 Agent 都是 Run 之上的行为能力，不应先写死进 MVP。 -- Planner、Worker、Reviewer 是候选角色，不构成强制工作流。 -- 并行、DAG、自动重规划和模型路由均在确认需要后再引入。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：未来需要失败重试、跳过和重新规划，但不在 MVP 中预设完整状态机。 +- 待确认点：失败分类、重试上限、人工介入点和上下文继承。 -## 待细化 +## 子 Agent 委派 -- Plan/Step 的交互编辑与 CLI/TUI 展示。 -- 子 Agent 上下文隔离、结果回收和失败处理。 -- 协作质量评估与成本控制。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：主 Agent 可以创建子 Run，分配目标并回收结果。 +- 待确认点：上下文隔离、Tool 范围、并发限制、取消传播与结果可信度。 + +## Agent 角色与协作模板 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：Planner、Worker、Reviewer 是候选角色，不构成强制工作流。 +- 待确认点：角色声明、Behavior 组合、Reviewer 门槛和用户自定义方式。 + +## 并行与模型路由 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：并行、DAG、不同角色使用不同模型都属于后续增强。 +- 待确认点：调度策略、成本/Token 统计、并发冲突与结果合并。 diff --git a/docs/operations/reliability-safety.md b/docs/operations/reliability-safety.md index 60843f8..f1c6038 100644 --- a/docs/operations/reliability-safety.md +++ b/docs/operations/reliability-safety.md @@ -1,22 +1,38 @@ # 可靠性与个人安全 -状态：todo -期望阶段：P4 +安全能力不阻塞早期个人探索，但在 Agent 开始影响真实文件、网站和系统后，需要逐步补足恢复与确认能力。 -## 目标 +## Run 恢复 -在 Agent 开始影响真实项目、文件、网站和本机系统后，逐步补足恢复与确认能力，而不阻塞前期个人探索。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：长期需要取消、暂停、恢复与 Runtime 崩溃后的未完成 Run 处理。 +- 待确认点：恢复粒度、可重放 Tool、幂等性和异常进程清理。 -## 已确定 +## 数据备份与迁移 -- 系统是单用户、本地优先项目；不考虑多租户、账号和企业权限。 -- Git 写操作在 System Evolution 中必须经用户确认。 -- 后续高影响操作包括删除文件、真实网页提交、系统设置和应用控制。 -- 候选可靠性能力包括取消/暂停/恢复、崩溃恢复、备份、导入导出、Workspace 清理和产物归档。 -- 候选安全能力包括终端确认、Keychain、敏感日志处理和最小风险等级。 +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：本地数据最终需要备份、导入导出和目录迁移；早期格式变化可使用一次性脚本。 +- 待确认点：备份位置、周期、保留数量、恢复验证和格式兼容范围。 -## 待细化 +## 高影响操作确认 -- 哪些操作先加入确认、确认的默认交互。 -- 数据备份位置和保留策略。 -- 长期任务、异常退出和资源回收。 +- 期望实现阶段：P3 +- 实际开发状态：未开始 +- 已确认点：System Evolution 的 Git 写操作必须确认；删除文件、真实网页提交、系统设置等后续按实际风险加入。 +- 待确认点：确认粒度、默认允许范围、超时和拒绝后的 Run 行为。 + +## 密钥与敏感数据 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：项目是单用户、本地优先，不建设多租户权限；长期可接入系统 Keychain 并处理敏感日志。 +- 待确认点：首版 API Key 保存方式、脱敏规则和敏感 Tool 输出保留策略。 + +## Workspace 与产物清理 + +- 期望实现阶段：P4 +- 实际开发状态：未开始 +- 已确认点：需要管理临时文件、候选 worktree、执行产物和长期磁盘占用。 +- 待确认点：自动清理阈值、回收站、归档和用户固定机制。 diff --git a/docs/roadmap.md b/docs/roadmap.md index 62f6292..bc24c10 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -11,16 +11,18 @@ | P5 | Web 产品线 | Runtime 的 Web 客户端与管理界面 | | P6 | Desktop 产品线 | 本地常驻控制台与系统集成 | -## 进度标记 +## 功能记录格式 -每个功能文档使用： +大功能本身不设置状态和阶段。大功能文档中的每个小功能点分别记录： ```text -状态：todo | doing | done -期望阶段：P1 | P2 | ... +期望实现阶段：P1 | P2 | ... +实际开发状态：未开始 | 设计中 | 开发中 | 已完成 | 暂停 +已确认点：当前已经达成共识的要求 +待确认点：实现前仍需讨论或通过实践决定的问题 ``` -新增需求先归类到已有大功能点；如果它确实是新的长期能力，再新建一个功能文件。实现过程中允许调整阶段和拆分，不要求回头重排整份路线图。 +新增需求先归类到已有大功能点；如果它确实是新的长期能力，再新建一个大功能文件。实现过程中允许新增、合并或拆分小功能点，不要求回头重排整份路线图。 ## 提交与 blog