Skip to content

Latest commit

 

History

History
161 lines (102 loc) · 8.63 KB

README.zh.md

File metadata and controls

161 lines (102 loc) · 8.63 KB

DeepAgent Code 标志

面向长期任务的 AI 编程工作区

代码、项目记忆、持续任务、浏览器与个人代理通信,在同一个工作区中协同。

English | 简体中文 | 下载安装 | 版本更新


DeepAgent Code(DAC) 将桌面编程工作区和终端智能体连接到同一个执行内核。面对跨文件、多轮对话、多种工具和多人讨论的工作,你可以保留项目上下文、维护可编辑的计划、委派独立子任务、查看执行过程,并让最终回答回到发起工作的对话中。

当前源码面向 2.0.5。已提供的安装包以 GitHub Releases 为准。

为什么选择 DAC

你的需求 DAC 提供的能力
持续推进复杂任务 持久会话、可编辑目标和计划、执行中补充指令、后续任务排队,让工作跨多轮保持清晰。
减少重复交代背景 可查看的项目记忆连接事实、决策、技能与执行证据,保留来源,并按规则进入模型上下文。
分工协作时保持掌控 子智能体处理独立任务;持久任务记录保留状态,可写协作通过独立 worktree 隔离。
让代码与网页工作衔接 桌面内置受控浏览器,把页面查看、授权交互和文件交换纳入当前任务。
把讨论直接转成实际工作 在公网 IM 中使用 /dac 调用自己的本机 DAC,同一会话连续追问,最终回答返回原对话。
按项目选择模型和工具 GUI 与 TUI 共用内核;模型供应商、Skills、领域包和 MCP 按需接入。

2.0.5 重点更新

更一致的模型设置。 提供商连接变更后刷新模型列表,推理档位与所选模型支持的选项保持一致。

更清晰的 MCP 管理。 添加和配置服务器、连接或断开服务,并查看当前连接状态和错误信息。

更好地掌控长任务。 编辑 Goal 计划、选择上下文压缩模式,并在需要手动操作时接管受管浏览器。浏览器操作仍取决于当前主机的能力和权限。

绑定设备的 IM 权益。 在设置中查看当前设备的 IM 权益状态、套餐和有效期。IM 激活与连接模型提供商分别处理。

Windows 安装器修复。 改进用户安装路径处理,以及升级和卸载过程中的 PATH 恢复。

已发布版本的详细变更见 更新记录。

为持续工作提供基础

保留意图的持久会话

用户输入先保存,再安排执行。DAC 工作时,你可以继续补充方向,指令在下一个安全的模型轮次边界接入;也可以把独立任务排队,等当前任务结束后执行。较长的工作可以使用目标和可编辑计划,记录推进过程。

持久化也让不确定状态可见。任务中断后,DAC 会区分已记录的工作与需要恢复确认的外部操作,不默认把结果不明的工具或模型调用重新执行一遍。

可查看、可管理的记忆和上下文

项目知识保留类型、作用域、状态、版本和来源引用。保存的决策与通过准入的经验可以在后续会话复用,你可以查看和修正这些内容。

上下文按预算组装。代码引用、项目记忆、执行文档、Skills 和领域知识按需要加载;稳定指令与不断变化的任务状态分开组织,以支持供应商缓存。实际 token 消耗取决于任务和模型。

有明确归属的任务协作

把独立的调研、实现和审查交给子智能体。持久任务记录保留归属、状态、结果和父任务通知;可写协作使用独立 worktree,并具有审查边界。

事件工作流为已配置的自动化增加依赖关系协调,用持久投递和可观察状态支撑交互执行之外的任务推进。

编程工具与可扩展生态

DAC 结合文件编辑、终端命令、基于 LSP 的代码导航、受控浏览器和项目知识。Skills 描述可重复的工作流程,领域包补充专业知识,MCP 将外部工具和资源接入同一个带权限控制的工作流。

连接已支持的官方供应商或配置兼容端点,按任务选择模型。模型和工具支持以供应商能力为准;IM 个人代理可以单独选择本机已配置的模型。

在 IM 中调用自己的代理

例如,与同事讨论一个问题时:

/dac 检查当前项目的登录处理逻辑,修复失败用例,并运行相关测试。

DAC 打开或复用与这段对话关联的本机 Session。你可以在正常的 DAC 工作区中查看流式执行,最终回答随后回到 IM 对话。下一条 /dac 指令可以沿用同一 Session 继续工作;需要独立上下文时,也可以显式新建 Session。

IM 使用独立的设备绑定权益,每份最多绑定 1 台设备,支持 1 年、3 年或终身套餐,不自动续费。通过管理员或授权分发渠道获取激活凭据,在设置中检查本设备、查看权益信息,再兑换激活码或绑定已有权益。是否可购买、当前是否有效及实际到期时间,以配置的 IM 服务返回的信息为准;未知有效期不视为终身。连接模型供应商不会购买或激活 IM。IM 文件和图片附件每份最多 10 MiB。

公网 IM 负责消息通信,代理在你自己的电脑上执行。2.0.5 不提供公网远程执行中转、供他人调用的共享代理或全桌面 Computer Use。

开始使用

桌面应用

从 GitHub Releases 下载适合你平台的安装包。打开 DAC,在设置中连接模型供应商,选择项目后开始对话。

从源码运行

使用根 package.json 固定的 Bun 版本:当前为 Bun 1.4.2。

git clone --branch 2.0.5 --single-branch https://github.com/deepagent-ltd/deepagent-code.git
cd deepagent-code
bun install

在仓库根目录运行:

# 桌面工作区
bun run dev:desktop

# 终端界面
bun run dev

# Web UI 开发服务
bun run dev:web

执行一次性任务,或在导入历史前预览:

bun run --cwd packages/deepagent-code dev run "查找并修复失败的登录测试"
bun run --cwd packages/deepagent-code dev import-history --from codex --dry-run

独立 Web UI 需要运行中的 DAC 后端;Web UI 指南给出了两个开发服务的启动方式。

各包的开发和构建说明见 Desktop 指南、Web UI 指南 和 CLI/server 指南。

连接模型

在 设置 → 供应商 中连接可用供应商,或者填写兼容端点的 Base URL 和 API Key。根据当前任务选择模型和推理强度。DeepAgent API 平台 是已支持的选项之一,也可以使用你自己的其他供应商凭据。

已安装的终端应用可以使用:

deepagent auth login
deepagent auth list
deepagent-code

macOS 和 Linux 的配置与本地状态保存在 ~/.deepagent/code/。Windows 配置保存在 %APPDATA%\deepagent-code,数据保存在 %LOCALAPPDATA%\deepagent-code。模型凭据按供应商认证路径保存,MCP secret 引用在可用时使用系统凭据存储;凭据、工具权限和对外操作在各自执行边界接受检查。

文档与贡献

许可证与来源

DeepAgent Code 使用 AGPL-3.0-or-later 许可证,完整条款见 LICENSE。

DAC 基于 opencode 等开源组件开发。原始许可证和来源声明保留在 NOTICE 及对应软件包中。上游项目及其贡献者未为 DAC 背书。

Built by DeepAgent