前言¶
在 DeepSeek Harness 的工作流中，模型可能需要訪問公網、生成位圖，或讀取本地圖片並回答關於圖片的問題。dsh-codex-tools 是一個面向 DeepSeek Harness 的插件，由 SPYQWER1 維護，註冊三個 Codex 支持的工具：codex_web_search、image_gen 和 image_vision。
它使用現有 ChatGPT/Codex 登錄態，不提供登錄，也不提供 LLM provider。
核心功能¶
codex_web_search¶
codex_web_search 用於搜索公網，並返回摘要和來源 URL。
參數如下：
query：必填。maxSources：默認5，範圍1到10。freshness：可選cached或live。model：默認gpt-5.4-mini。
image_gen¶
image_gen 用於生成位圖；不編輯或轉換已有圖片。
參數如下：
prompt：必填。out：默認output/imagegen/<timestamp>.<format>，必須相對當前 DSH session workspace。size：可選auto、1024x1024、1536x1024、1024x1536、2048x2048、2048x1152。format：可選png、jpeg、webp，默認png。model：默認gpt-5.5。
路徑限制：
out只接受當前 DSH session workspace 內文件。- 拒絕絕對路徑、父目錄段和符號鏈接。
- 不覆蓋已有文件，父目錄會被創建。
image_vision¶
image_vision 用於讀取本地圖片，並返回描述或回答關於圖片的問題。
參數如下：
image：必填，限當前 DSH session workspace 內png、jpeg/jpg、webp或gif，最大15 MiB。question：可選。model：默認gpt-5.5。
路徑限制：
image只接受當前 DSH session workspace 內文件。- 拒絕絕對路徑、父目錄段和符號鏈接。
安裝與啓用¶
先確認運行環境：
- DeepSeek Harness。
- Node >=22。
- ChatGPT/Codex 登錄態；可使用 DSH 憑據
OPENAI_CODEX_API_KEY或OPENAI_CODEX_REFRESH_TOKEN。
從 Git 安裝：
dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools
從 npm 安裝：
dsh plugin --profile web add dsh-codex-tools
安裝後重啓 DSH：
dsh web
或：
dsh --profile web
移除插件：
dsh plugin --profile web remove dsh-codex-tools
憑據與登錄態¶
憑據優先從環境變量解析：
CODEX_ACCESS_TOKEN
CODEX_REFRESH_TOKEN
如果這些變量不存在，則讀取 auth 文件：
$CODEX_HOME/auth.json
~/.codex/auth.json
如果通過 DSH 注入憑據，可使用 OPENAI_CODEX_API_KEY 或 OPENAI_CODEX_REFRESH_TOKEN。HTTP 401 後，傳輸層會刷新 access token 一次，並嘗試持久化刷新後的登錄狀態到 auth 文件。注入 DSH credentials 時，刷新代碼仍可能寫入由 CODEX_HOME 或默認路徑選擇的 auth 文件。
運行限制與合規¶
- 插件使用
chatgpt.com/backend-api/codex/responses。該端點是內部端點，非公開文檔 API，可能變更或受限。 - 搜索摘要和片段由模型生成；應打開來源 URL 覈對原文。
- Web search 和 image generation 使用 ChatGPT plan 的 metered Codex-usage bucket。
- 需遵守 OpenAI Terms of Use；不得使用 ChatGPT 訂閱支撐公開面向的 image-generation service。
image_gen的out和image_vision的image只接受當前 DSH session workspace 內文件；拒絕絕對路徑、父目錄段和符號鏈接。
適用場景與注意¶
適合已有 DSH 環境和 ChatGPT/Codex 登錄態，希望給 DSH 流程增加公網搜索、位圖生成或本地圖片理解的開發者。
插件以當前 DSH 進程權限運行；安裝前應檢查源碼與 MIT 許可證。
鏈接¶
- GitHub：https://github.com/SPYQWER1/dsh-codex-tools
