feat: 第二版文档上传
This commit is contained in:
李岩岩
parent
e4b45c5971
commit
da87569131
@ -4,10 +4,10 @@
|
||||
|
||||
## 使用方式
|
||||
|
||||
- 每个大功能点一个文件，文件头标记 `状态` 与 `期望阶段`。
|
||||
- `todo`、`doing`、`done` 表示当前进度；阶段只表示建议先后，不构成严格依赖顺序。
|
||||
- 每完成一个独立提交，在对应文档中补充提交、blog 和实现说明。
|
||||
- 未明确的方案写在“待细化”中，不提前冻结实现。
|
||||
- 每个大功能点一个文件，大功能本身不设置状态或阶段。
|
||||
- 大功能文档内部拆分小功能点，每项分别记录期望实现阶段、实际开发状态、已确认点和待确认点。
|
||||
- 阶段只表示期望先后，不构成严格依赖顺序；实际开发状态按实施进展更新。
|
||||
- 每完成一个独立提交，在对应小功能点中补充提交、blog 和实现说明。
|
||||
|
||||
## 导航
|
||||
|
||||
|
||||
@ -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 统计。
|
||||
|
||||
@ -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。
|
||||
- 待确认点：取消信号传播、失败后续跑和重试时的上下文复用。
|
||||
|
||||
@ -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/<task-id>/workspace/`；Shell 和文件 Tool 默认以其为作用域。
|
||||
- 待确认点：初始化内容、路径展示、临时文件和清理行为。
|
||||
|
||||
## 待细化
|
||||
## 文件 Tool
|
||||
|
||||
- Shell 超时、取消、后台进程和大输出处理。
|
||||
- 文件写入与补丁的交互方式。
|
||||
- Tool 描述和参数 Schema 的具体格式。
|
||||
- 期望实现阶段：P2
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：首批支持读写文件、目录浏览和文本搜索。
|
||||
- 待确认点：补丁接口、编码处理、大文件限制与二进制文件策略。
|
||||
|
||||
## Shell Tool
|
||||
|
||||
- 期望实现阶段：P2
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：记录命令、输出、退出码和错误；首期安全机制保持轻量。
|
||||
- 待确认点：超时、取消、后台进程、交互命令和输出上限。
|
||||
|
||||
## 单 Agent Tool Calling
|
||||
|
||||
- 期望实现阶段：P2
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：Agent 自主选择 Tool、读取结果并继续调用模型，直至给出最终回复。
|
||||
- 待确认点：循环上限、失败反馈、并行调用和客户端事件协议。
|
||||
|
||||
@ -1,8 +1,5 @@
|
||||
# 本地数据与目录
|
||||
|
||||
状态：todo
|
||||
期望阶段：P1
|
||||
|
||||
## 原则
|
||||
|
||||
数据以本地普通文件保存，保持易读、易调试、易由 Agent 修改。早期不承诺兼容性，不预先建设 schema migration；重要数据依靠备份，格式变更需要时再写一次性转换脚本。
|
||||
|
||||
@ -1,8 +1,5 @@
|
||||
# 架构总览
|
||||
|
||||
状态：todo
|
||||
期望阶段：P1
|
||||
|
||||
## 定位
|
||||
|
||||
这是纯个人使用的开发助手与电脑管家。它支持 Project 和 Task 两种并列 Space，并通过 CLI、Web、Desktop 三个客户端访问同一个本地 Runtime。
|
||||
|
||||
@ -1,20 +1,45 @@
|
||||
# 电脑管家与自动化
|
||||
|
||||
状态：todo
|
||||
期望阶段：P4
|
||||
电脑管家能力让 Task 能处理浏览器、本机应用和日常临时事务。
|
||||
|
||||
## 目标
|
||||
## 本机基础能力
|
||||
|
||||
将 Task 从临时聊天空间发展为可处理本地日常事务的电脑管家。
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：候选能力包括剪贴板、通知、文件整理和进程信息，并通过 Tool 逐项加入。
|
||||
- 待确认点：优先能力、跨平台范围和系统 API 选择。
|
||||
|
||||
## 已确定
|
||||
## 浏览器读取与交互
|
||||
|
||||
- 能力通过 Tool 逐项加入，不预先建设完整桌面自动化平台。
|
||||
- 候选能力包括剪贴板、通知、文件整理、进程信息、浏览器读取与交互、应用/窗口控制、截图、键鼠自动化、定时任务和后台任务。
|
||||
- 常用工作流可以沉淀为模板或 Behavior，但不在早期固定格式。
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：需要覆盖网页搜索、读取、结构化提取和交互操作。
|
||||
- 待确认点：浏览器驱动、登录态复用、下载、标签页管理和真实提交确认。
|
||||
|
||||
## 待细化
|
||||
## 应用与窗口控制
|
||||
|
||||
- 首个接入的本机/浏览器能力由真实日常需求决定。
|
||||
- 浏览器驱动、桌面自动化方式和各平台兼容性。
|
||||
- 自动化任务的确认、停止和恢复体验。
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：逐步加入应用启动、窗口管理和文件定位等能力。
|
||||
- 待确认点：操作系统优先级、原生桥接方式和无障碍权限。
|
||||
|
||||
## 桌面自动化
|
||||
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：候选能力包括截图、屏幕理解、键盘和鼠标操作。
|
||||
- 待确认点：视觉驱动方式、坐标可靠性、停止机制和操作确认。
|
||||
|
||||
## 定时与后台任务
|
||||
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：未来支持提醒、定时执行与长期后台任务。
|
||||
- 待确认点：调度器归属、Runtime 重启恢复、错过任务和结果通知。
|
||||
|
||||
## 自动化模板
|
||||
|
||||
- 期望实现阶段：P4
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：重复工作可沉淀为 Behavior 或工作流模板，但不提前固定格式。
|
||||
- 待确认点：模板创建、参数化、分享、修改和版本管理。
|
||||
|
||||
@ -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 的边界、权限申请、平台差异和无界面运行方式。
|
||||
|
||||
@ -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
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：后续管理配置、扩展、记忆和高影响操作确认。
|
||||
- 待确认点：功能范围、本地/远程访问边界与是否需要轻量认证。
|
||||
|
||||
@ -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 和人工编辑体验。
|
||||
|
||||
@ -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、基准任务以及新旧版本比较方式。
|
||||
|
||||
@ -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、扩展回滚和是否需要独立分发机制。
|
||||
|
||||
@ -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 状态、当前配置与日志位置。
|
||||
- 待确认点：配置修改入口、诊断报告和调试模式。
|
||||
|
||||
@ -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 执行。
|
||||
- 待确认点：首版内部模块边界，以及哪些能力进入微内核、哪些保留为可替换实现。
|
||||
|
||||
@ -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 初始化与升级交互。
|
||||
|
||||
@ -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
|
||||
- 实际开发状态：未开始
|
||||
- 已确认点：先使用普通文件和全文检索；向量/混合检索、文档导入按真实需求增加。
|
||||
- 待确认点：索引方式、切分、引用来源、支持格式与向量存储。
|
||||
|
||||
@ -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 统计、并发冲突与结果合并。
|
||||
|
||||
@ -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、执行产物和长期磁盘占用。
|
||||
- 待确认点：自动清理阈值、回收站、归档和用户固定机制。
|
||||
|
||||
@ -11,16 +11,18 @@
|
||||
| P5 | Web 产品线 | Runtime 的 Web 客户端与管理界面 |
|
||||
| P6 | Desktop 产品线 | 本地常驻控制台与系统集成 |
|
||||
|
||||
## 进度标记
|
||||
## 功能记录格式
|
||||
|
||||
每个功能文档使用：
|
||||
大功能本身不设置状态和阶段。大功能文档中的每个小功能点分别记录：
|
||||
|
||||
```text
|
||||
状态：todo | doing | done
|
||||
期望阶段：P1 | P2 | ...
|
||||
期望实现阶段：P1 | P2 | ...
|
||||
实际开发状态：未开始 | 设计中 | 开发中 | 已完成 | 暂停
|
||||
已确认点：当前已经达成共识的要求
|
||||
待确认点：实现前仍需讨论或通过实践决定的问题
|
||||
```
|
||||
|
||||
新增需求先归类到已有大功能点；如果它确实是新的长期能力，再新建一个功能文件。实现过程中允许调整阶段和拆分，不要求回头重排整份路线图。
|
||||
新增需求先归类到已有大功能点；如果它确实是新的长期能力，再新建一个大功能文件。实现过程中允许新增、合并或拆分小功能点，不要求回头重排整份路线图。
|
||||
|
||||
## 提交与 blog
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user