前言¶
在 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、hostedweb_search和遠程壓縮,失敗時回退到 DSH 實現。 - 在 Codex 模式的模型菜單中開啓 Fast 後,向 Responses 請求發送
service_tier: "priority"。 - 點擊輸入欄旁的上下文用量指示器,可設置
1K–1000Ktokens;下一次請求和自動壓縮使用該值。 - 可配合
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、hostedweb_search、遠程壓縮、Fast 請求或上下文容量控制。 - 你希望通過 DSH 插件機制擴展編碼工具鏈。
使用前需要注意:插件會以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。該插件當前許可證爲 MIT。
鏈接¶
- 目錄頁:https://www.skillhub.cn/plugins/shuind/dsh-codex-harness
- GitHub:https://github.com/shuind/dsh-codex-harness