DeepSeek Harness 是 DeepSeek 开源的 AI Agent 工具。选一个本地文件夹作为工作区,配好模型,就可以让它读取文件、修改代码、整理资料、执行命令,还能通过插件扩展功能。
前面,我已经分享过一篇DeepSeek Harness 桌面端安装和使用教程,介绍了账号配置、工作区,以及 Better Sidebar、DSH Market 两个插件。
前两天,DeepSeek Harness 发布了 v0.2.1-alpha.2 预发布版本。这次有几个变化值得试试:
- 官方插件列表新增 Claude Code、Codex 子智能体组合包的按需安装入口;
- 新增实验性的 Git 工作树和思考过程机器翻译插件。
这篇文章就从新的安装入口开始,试一次 Codex 任务委派,再看看 Git 工作树和思考翻译怎么用。
先确认一下版本
本文使用的是 0.2.1-alpha.2 Web 版。
安装 Node.js 后,可以指定版本启动:
npx @deepseek-ai/dsh@0.2.1-alpha.2 web
实测时,我的 DeepSeek Harness 桌面端更新提示的目标版本是 0.2.0-rc.2,并不是 0.2.1-alpha.2。如果在插件列表里找不到 Codex 子智能体,先确认运行的版本;本文后面的入口和操作均以指定版本的 Web 版为准。
让 Codex 接手一个任务
先说明一下:Claude Code 和 Codex 子智能体此前已经可以接入 Harness。v0.1.0-rc.8 的发布说明就列出了 Profile Bundle 按需安装、非交互权限模式和多个命名实例。这次新增的是官方插件列表里的安装入口,可以直接在界面中安装与当前 Harness 版本匹配的组合包。
在上述 0.2.1-alpha.2 Web 版中,打开左侧的“插件”,在“官方”列表中找到 Codex 子智能体,打开开关即可触发安装。
这次安装的是与 Harness 对应的 0.2.1-alpha.2 组合包,完成后已经启用,详情页可以看到两个组件都在运行。
同一列表里也有 Claude Code 子智能体。它们会调用各自的原生运行时,认证和设置仍沿用对应工具的配置。只登录 DeepSeek 账号,还不足以使用这两个子智能体。
具体到 Codex,插件会启动依赖包里的 Codex CLI 程序,以 app-server --stdio 模式运行,再通过标准输入、输出上的 JSON-RPC 协议创建会话、提交任务和接收结果。它使用的是插件配套的 Codex 程序,认证与配置则沿用 Codex 原生设置。
这次任务的核心修改要求如下:
把下面的任务交给 Codex 子智能体执行:
给 index.html 增加 0.5 倍、1 倍、2 倍速度选择。
切换速度时不重置飞机位置,保留播放、暂停和重新开始。
保持单文件,不引入外部依赖。
Harness 发出委派后,会等待子任务的结果,再继续处理。当前这种委派每次都会开启一个新的 Codex 会话,不支持继续追问或恢复那次子会话,所以任务最好一次说完整。
这次第一轮没有改成功。 Codex 返回了只读环境下无法写文件的说明。Harness 界面虽然选的是“工作区内修改”,但 Codex 子进程的权限还受自身配置和插件的 permissionMode 控制。
插件默认的 permissionMode: never 表示不请求权限审批,并不会覆盖 Codex 原生的沙箱设置,也不等于自动允许写入。如果子进程运行在只读沙箱中,就无法修改文件。这次确认了只读返回和文件没有变化,但没有继续定位是哪项配置导致只读。
我随后让它改做只读审查:检查动画代码,给出新增倍速的建议,顺便看看暂停、重置和后台恢复的行为。这轮 Codex 完成了审阅,结果也返回到了 Harness。
其中一条建议是,先限制过长的帧间隔,再乘速度倍率。如果先乘倍率再限制上限,遇到较长帧间隔时,2 倍速度会被截断,实际倍率就不准确了。
这次跑通的是任务委派和审查结果返回。检查 Git 状态后,工作树没有代码差异,倍速功能没有落盘。准备让它修改项目的朋友,除了启用插件,还要确认对应工具的写入权限。
给修改单独开一个目录
这次任务开始前,Harness 还做了一件事:创建 Git 工作树。
比如你手上有一个能运行的页面,想保留原版,再让 AI 尝试另一种改法,可以让它创建新分支和独立目录,在那个目录里继续。原版和尝试版都能分别打开查看。
在“插件 → 官方”中启用 Git 工作树。
然后给出这样的要求:
从当前仓库的 HEAD 创建名为 flight-speed 的 Git 工作树,
切换进去,再处理后续任务。
这次 Harness 确实创建了 flight-speed 分支,检出目录位于仓库的 .agents/worktrees/flight-speed。我核对了 Git 记录,新工作树与原目录从同一个提交开始。
准备这样用时,先把需要带过去的内容提交好。这个插件不会复制原目录里尚未提交的修改和未跟踪文件;离开工作树后,目录和分支也会保留。它的具体行为可以看工作树文档。
把思考过程翻译成中文
这次任务里出现了不少英文思考内容,正好试一下新加的翻译插件。
在官方插件列表启用“思考过程机器翻译”,展开思考内容,就会开始翻译。默认使用 Bing,也可以在详情里选择 Google,或者付费的 DeepSeek Flash;目标语言可以跟随界面。
原文会保留,点击“查看原文”就能切回去。翻译只影响展示,不会把模型上下文里的原文替换掉。
另外,展开的思考内容会发送给选中的翻译服务,其中可能包含代码和对话细节。涉及不便发给该服务的内容,就保留原文阅读。
已经在用 Harness 的朋友,可以先挑一个小任务试试:让 Codex 审查一份文件,或者创建一个工作树尝试改动。
⭐️推荐阅读:
- 后端开发学习 + 面试指南:覆盖 Java、计算机基础、数据库、框架、系统设计等后端开发核心知识与面试内容。
- AI 应用开发学习 + 面试指南:覆盖 LLM、RAG、Agent、MCP、Prompt、评测、系统设计等 AI 应用开发知识与面试内容。
- AI 编程实战指南:覆盖 Claude Code、Cursor、Codex、Trae 等工具的使用技巧与面试内容。