dsh-codex
中文 | English
用于 DeepSeek Harness 的本地 Codex CLI 集成插件。
它以一个 DSH bundle 安装。在模型选择器中选择 Codex 后,插件会为该会话启动本地 codex app-server --stdio 进程,跨回合保留 Codex thread,将可支持的审批请求交由 DSH 处理,并在标准 Web 对话中渲染 Codex 的推理、工具活动、用量与生成图片。
前置条件
- DeepSeek Harness
0.1.0-rc.5至<0.2.0 - Node.js
^22.19.0 || >=24.0.0 - PATH 中存在 Codex CLI
0.147.0或更高的兼容版本 - 已通过
codex login完成 Codex 认证
插件使用本机 Codex 配置、沙箱和认证信息。除非 Codex 的配置本身要求,否则无需 OpenAI API Key。
安装
当前仅支持从 GitHub 安装,并建议固定到已经验证的提交:
dsh plugin --profile web add github:lgyytm/dsh-codexcli-llm#COMMITGitHub 安装会在本机构建该包。pnpm 10 或更新版本会要求显式允许该构建。将提示的键加入 $DSH_HOME/profiles/web/pnpm-workspace.yaml:
allowBuilds:
dsh-codex: true随后重新执行安装命令。启动或重启 Web 进程,并选择 Codex default 或本机 Codex CLI 报告的模型。
配置
bundle 会挂载一个 llm-codex 行。profile patch 可以设置它的配置:
- id: llm-codex
config:
cwd: !!js process.cwd()
approval: ask
reasoningSummary: detailedapproval: ask 是默认值,会将命令、文件变更和额外权限请求路由至 DSH 审批 UI。无人值守策略可设置为 allow、decline 或 cancel。
行为与限制
Codex 仍是执行其原生工具的 agent。DSH 记录其可持久化的生命周期事件,为已支持的审批请求提供中介,并渲染已报告的推理、工具参数、结果、终端输出、token 用量和生成图片。它不会替代 Codex 的工具循环或沙箱。
只能显示 Codex app-server 实际公开的推理文本;插件无法公开模型的私有推理。用户输入和 MCP elicitation 请求会 fail closed,因为 DSH 的审批服务尚不能表达其结构化答案。
开发
pnpm install
pnpm run build
pnpm run typecheck
pnpm testpnpm pack 会生成 registry 工件。发布前请在新的 DSH profile 中测试该工件:
pnpm pack
dsh plugin --profile codex-test add ./dsh-codex-0.1.0.tgz
dsh --profile codex-test --dump-configGitHub 源码安装与版本标签说明见 [PUBLISHING.md](PUBLISHING.md)。
许可证
[MIT](LICENSE)