前言¶

在 DSH 中搭建编码会话时，常见诉求很具体：想要一套 Codex 风格的预设，又不希望提示词、工具、上下文和请求档位全部写死。DSH 的插件化思路提供了扩展空间，社区插件目录也可以承载这类场景。

shuind/dsh-codex-harness 就是针对这个方向的一个 DSH 插件：为 DSH 提供可自定义提示词与 Codex 工具的编码模式。下面介绍它的功能、安装方式和常用配置。

定位¶

@shuind/dsh-codex-harness 由 shuind 维护，许可证为 MIT。它的核心定位是：在 DSH 中提供一个可编辑提示词、可配置模型行为、并带有一组 Codex 工具的编码模式。

它不是独立的编码工具，而是 DSH 插件体系中的一个预设和工具扩展。使用它的前提，是你已经在 DSH 中使用 Web 端 Agent 会话，并且希望把 Codex 风格的工作流接入当前会话。

核心功能¶

下面是已核实的主要能力：

• 使用精简 Codex 提示词，并对 GPT 做了少量提示词约束。
• 在 设置 → 插件 → 插件配置 → Codex Harness 中查看、编辑或恢复完整提示词。
• 提供 exec_command、write_stdin、apply_patch 和 update_plan。
• 支持 Fast 请求、GPT 图片、思考强度和上下文容量。
• 实时显示请求模型、模型回复和上下文压缩状态及耗时。
• Responses 请求优先使用原生 apply_patch、hosted web_search 和远程压缩，失败时回退到 DSH 实现。
• 在 Codex 模式的模型菜单中开启 Fast 后，向 Responses 请求发送 service_tier: "priority"。
• 点击输入栏旁的上下文用量指示器，可设置 1K–1000K tokens；下一次请求和自动压缩使用该值。
• 可配合 dsh-codex-connect 使用 ChatGPT 订阅模型。

安装与启用¶

先安装插件，再重启 Web，最后把会话切到 Codex 模式。

1、安装插件。

dsh plugin --profile web add @shuind/dsh-codex-harness@0.2.1

2、重启 Web。

3、在 Agent 预设 中选择 Codex 模式，再创建会话。

典型用法¶

配置模型¶

先做模型接入：在 DSH 的 Models 中配置支持 OpenAI Responses 的 provider、endpoint、API key 和 GPT 模型。

配置示例如下：

api: openai-responses
baseURL: https://your-responses-endpoint.example.com
apiKeyEnv: OPENAI_API_KEY

如果希望使用 ChatGPT 订阅模型，也可以配合 dsh-codex-connect 使用。

编辑提示词¶

打开：

设置 → 插件 → 插件配置 → Codex Harness

编辑器会展示本插件实际注入的完整提示词。你可以查看、编辑或恢复默认模板；保存后从下一次请求开始生效。

需要注意的是，身份、模型、工作目录、工具说明和 DSH 运行时上下文由对应插件动态提供，不会写死在可编辑模板中。

开启 Fast¶

在 Codex 模式的模型菜单中开启 Fast。

开启后，插件会向 Responses 请求发送：

"service_tier": "priority"

设置上下文容量¶

点击输入栏旁的上下文用量指示器，可以设置上下文容量，范围为 1K–1000K tokens。

下一次请求和自动压缩会使用你设置的值。

适用场景与注意¶

这个插件适合以下场景：

• 你在 DSH 的 Web 端使用 Agent 会话。
• 你希望使用 Codex 风格的编码预设。
• 你需要查看并修改实际注入的完整提示词。
• 你需要在 Responses 请求中使用 apply_patch、hosted web_search、远程压缩、Fast 请求或上下文容量控制。
• 你希望通过 DSH 插件机制扩展编码工具链。

使用前需要注意：插件会以当前 dsh 进程权限运行，安装前应检查源码与许可证。该插件当前许可证为 MIT。

链接¶

• 目录页：https://www.skillhub.cn/plugins/shuind/dsh-codex-harness
• GitHub：https://github.com/shuind/dsh-codex-harness