在输入框下方加一个 Codex 开关:点亮后该会话的编码需求交给本机 Codex CLI 理解、写实现提示词并验收,实现由 dsh-baton 派给 Harness 会话执行,最后回报改动文件、测试结果和逐条需求对照。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:zhangasdfr/codexskill
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 DeepSeek Harness 桌面版加一个 Codex 开关:在输入框下方点亮它,之后这个会话里发的编码需求就交给 Codex 负责理解与验收——Codex 写好实现提示词,通过 dsh-baton 派给 Harness 子会话执行,跑完再核对改动文件、测试结果和逐条需求,报告回到当前对话。
你写需求 → Codex(动脑:理解、写 prompt、验收)
│ dsh_send / dsh_wait
▼
DeepSeek Harness 子会话(动手:改代码、跑测试)
│
▼
报告回到原会话(改动文件 / 测试 / 需求对照)
- 输入框底部多一个
Codexchip,就在「工作区内修改」右边;点亮即生效,下一条消息就走委派。 - 开关按会话隔离,刷新页面不丢;重启 Harness 后回到关闭。
- 关闭时插件对模型完全透明:不注入提示词、不调用 Codex。
- 顺带注册一个
codex-delegate技能,模型可以按需查用法和排错表。
安装
仓库是公开的,谁都能
git clone;但往仓库推送要仓库主人的 GitHub 凭据(GCM 登录一次即可)。
一键(Windows 桌面版)
git clone https://github.com/zhangasdfr/codexskill.git; cd codexskill; powershell -ExecutionPolicy Bypass -File .\install.ps1
一键(Linux / macOS)
git clone https://github.com/zhangasdfr/codexskill.git && cd codexskill && bash install.sh
脚本会:
- 把插件复制到
%USERPROFILE%\.dsh\profiles\desktop\plugins\dsh-codex-mode; - 在 profile 的
node_modules里建一个 junction(不用跑 pnpm); - 往
%USERPROFILE%\.dsh\profiles\desktop\package.json里补dependencies和dsh.profile.bundles; - 如果还没有
~/.codex/unattended.config.toml,写一份approval_policy = "never"的无人值守 profile; - 检查 Codex CLI 和 dsh-baton-host,缺什么就提示你补什么,最后告诉你重启 Harness。
装完重启一次 DeepSeek Harness(插件组合只在启动时读取)。重启后输入框下方就会出现 Codex。
手动 / 让 AI 帮你装
把本仓库目录作为包交给官方 plugin_manager 工具:action: install_bundle,target 传仓库的绝对路径。新装可以热加载,不用重启。
或者手工三步:复制到 ~/.dsh/profiles/desktop/plugins/dsh-codex-mode → package.json 的 dependencies 加 "dsh-codex-mode": "file:./plugins/dsh-codex-mode"、dsh.profile.bundles 追加 "dsh-codex-mode" → 重启 Harness。
卸载:powershell -ExecutionPolicy Bypass -File .\uninstall.ps1。
装好后插件会额外注册一个 codex-delegate 技能:以后在本会话里直接问「Codex 开关怎么用 / 为什么没生效 / 怎么让 Codex 动脑」时,模型会自动读这份技能(skills/codex-delegate/SKILL.md),不用你手动交代。
前置条件
| 需要 | 说明 |
|---|---|
| DeepSeek Harness 桌面版 | 已登录,且至少启动过一次(生成 ~/.dsh/profiles/desktop) |
| Codex CLI | npm i -g @openai/codex,codex --version 能跑通;额度按 ~/.codex/config.toml 里的 provider 走 |
| 无人值守 profile | ~/.codex/unattended.config.toml:approval_policy = "never"(安装脚本会补) |
| dsh-baton-host 插件 | 在 Harness 插件市场里启用即可,它负责把 Codex 的 dsh_send 接到本机 Harness |
用法
- 输入框下方点亮 Codex。
- 正常写需求发出去,例如「把登录页改成手机号验证码登录,跑通现有测试」。
- 本会话的模型会调用
codex_delegate;Codex 派活、等待、验收,最后把三段式报告带回来:改动文件、测试/校验结果、逐条需求对照。
配置
插件 patch(cordis.patch.yml)里的 config 可以覆盖默认值:
| 键 | 默认 | 说明 |
|---|---|---|
codexScript |
%APPDATA%\npm\node_modules\@openai\codex\bin\codex.js |
Codex CLI 入口 |
nodePath |
当前跑 Harness 的 node | 用来启动上面的入口 |
profile |
unattended |
codex exec -p <profile>,对应 ~/.codex/<profile>.config.toml |
timeoutMs |
3600000 |
单次委派上限,也是 codex_delegate 的 timeoutMs |
排错
| 现象 | 原因 / 处理 |
|---|---|
| 没有 Codex chip | 没重启 Harness;或 profile package.json 缺 dsh-codex-mode;看 Harness 设置里的插件列表有没有加载失败 |
| 有 chip 但不走 Codex | chip 只对「当前会话」生效,且状态在宿主内存里,重启后要重新点亮 |
codex_delegate 报找不到 Codex CLI |
改 cordis.patch.yml 的 config.codexScript,指向真实的 codex.js |
报 dsh_send 不存在 |
dsh-baton-host 没装/没启用;装好后重启 Harness,再新开 Codex 会话 |
| 报告写「需要人在 Harness 界面点审批」 | Harness 侧弹了 UI 审批(needs_input: harness-ui),MCP 无法代答;去 Harness 窗口点,或让任务留在工作区内 |
一直 timed_out |
任务太大,拆小;或调大 timeoutMs |
开发
npm test # 离线测试:假 ctx,不碰网络,不调 Codex
npm run e2e # 端到端:真的启动 Codex,经 dsh-baton 派给 Harness(约 1 分钟)
文件:
lib/index.js— 宿主半:会话开关、/__dsh-codex/state路由、codex_delegate工具、按会话注入的提示词段、技能注册。lib/client.js— 浏览器半:conversation.input.left槽里的 Codex chip。cordis.patch.yml— 往 profile 组合里插入codex-mode一行。skills/codex-delegate/SKILL.md— 模型按需读的操作手册。install.ps1/uninstall.ps1— Windows 一键装/卸。
License
MIT
链接
同类插件
loopx-project/loopx#dsh-loopx-plugin★ 6694
LoopX——面向长周期 Agent 的提供商中立、本地优先状态内核与控制平面:在 DeepSeek Harness 执行层之上持久化 Goal、Todo、门禁、证据、配额、恢复与交接状态;插件负责引导安装 CLI 与技能、准入有界的同会话续跑,并为精确绑定的工作循环提供本地 GoalBar。
Q00/ouroboros#integrations/dsh-plugin★ 6373
通过 DSH MCP 客户端挂载 Ouroboros 的纯配置包,在 DSH 中提供 36 个涵盖需求访谈、Seed、执行、评估与演化流程的工具。
chuspeeism/dashi-taskboard#deepseek-harness★ 3495
把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述文件连接,而不是使用固定端口。
NanmiCoder/dsh-agent-teams★ 2978
AgentTeams 多智能体团队。
EthanYoQ/AI-Novel-Writer#dsh-ai-novel-writer★ 2670
安装专用 AI 小说创作预设与工作台:提供带修订号的本地项目资产、紧凑侧边工作台,以及需要原生审批的逐文件变更。
shanliuling/dsh-image-gen★ 1576
为 DeepSeek Harness 提供原生对话生图能力:直接让 Agent 画图,插件自动完成生成并把结果保留在当前会话中。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。