3.4 KiB
独立产品架构
产品使用本地 Node 服务和 React 工作台。客户端负责项目选择、对话、工具轨迹、差异审核与设置;服务端负责模型连接、工具调用、会话存储和恢复。
一次任务
用户消息进入会话后,执行器构造上下文并调用兼容模型服务。模型返回工具调用时,执行器按调用 ID 记录 started 与结果。项目读取和检索直接完成;文件改动先生成带原文 SHA256 的提案;终端命令进入确认状态。结果以 tool_call_id 关联回模型,直到得到最终答复或达到步数限制。
改动与权限
提案只保存建议,不修改项目。用户应用改动时重新检查当前文件是否仍与基线一致,原文保存在应用数据目录后再原子替换。读取、检索、提案与应用路径限制在所选项目内,并解析 junction/symlink 的真实位置。
终端命令每次确认后以当前 Windows 用户权限执行;工作目录为所选项目,但这不是操作系统沙箱。界面显示完整命令。停止任务会中止工作台启动的进程树。
持久化与恢复
状态与工具事件保存在独立应用数据目录。状态使用临时文件原子替换,并保留备份。服务重启后把仍在运行或等待确认的任务标为暂停;未完成 tool_call 按 ID 写入中断结果以保持消息契约。已开始命令的实际结果未知时明确标记,不自动重放终端或应用文件改动。
上下文
完整会话仍保留在磁盘。模型请求使用有预算的投影:以完整 user/assistant/tool 组为单位保留近期内容,较早内容形成有长度限制的本地提要。计数为估算,服务返回的 usage 另外记录。该机制是本产品的独立提取式实现,不声称与 Claude Code 的模型摘要等价。
模型与凭据
支持 OpenAI 兼容的 Chat Completions 工具契约,服务 URL 和模型由用户配置。API Key 仅在服务内存或专用环境变量中使用,不写入会话、导出或配置文件。默认离线演示明确标记,不连接第三方账户。
工作台诊断与模型错误
每轮系统上下文加入工作台保存的最新执行快照。inspect_session只读取当前会话的错误来源、近期工具、提案状态与终端环境;项目内容和历史工具输出按数据处理。最新审核状态独立于历史助手的措辞。旧fetch failed明确归为模型请求失败,同时保留旧版未记录底层原因的限制。
模型请求记录请求阶段和尝试次数,分类认证、限额、服务、网络、DNS、证书、超时和协议错误。最多三次请求,退避受Retry-After和总时长约束。重试只作用于当前模型请求,已完成工具不再执行;用户停止会取消请求与退避。模型响应验证可以使用临时参数,不改变当前连接。
本地原进程升级
1.0.0升级模块保留现有store/provider/runtime及HTTP服务对象,通过实例原型和请求处理器切换实现。升级前核对本地PID与工件路径并要求无活跃任务,升级后验证配置/项目/会话;Key仍在原provider对象中。原版工件作为源码内置fixture支持独立迁移测试。
验证
使用独立测试项目与本地兼容 API 测试服务验证工具循环、审批、差异冲突、停止和重启恢复。浏览器测试覆盖真实本地界面。真实大模型的效果与用户服务连通性单独记录。