SPYQWER1/dsh-codex-tools

dsh-codex-tools

English

一个 DeepSeek Harness 插件，注册三个由 ChatGPT Codex 提供的工具：

| 工具 | 作用 |
| --- | --- |
| codex_web_search | 搜索公开网页，返回摘要和来源 URL。 |
| image_gen | 生成位图；不编辑或变换已有图片。 |
| image_vision | 读取本地图片，返回描述或针对图片的问题答案。 |

它消费已有的 Codex/ChatGPT 登录态，不提供登录功能或 LLM provider。

运行时前置条件

- DeepSeek Harness。
- ChatGPT/Codex 登录态，二选一：使用 codex login 生成登录文件，或在 DSH 中配置：
- OPENAI_CODEX_API_KEY
- OPENAI_CODEX_REFRESH_TOKEN

认证优先使用环境变量 CODEX_ACCESS_TOKEN、CODEX_REFRESH_TOKEN（插件将上述 DSH 凭据名映射为这些变量）。如果这些变量没有值，设置了 CODEX_HOME 时读取 $CODEX_HOME/auth.json，否则读取 ~/.codex/auth.json。设置 CODEX_HOME 可更换认证目录，默认目录是 ~/.codex。HTTP 401 后，传输脚本会刷新 access token 一次，并尝试把刷新后的登录态写回该认证文件。插件注入 DSH 凭据时，刷新逻辑仍可能写入由 CODEX_HOME 或默认路径选中的认证文件。

安装

Git
dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools

npm
dsh plugin --profile web add dsh-codex-tools

安装后重启（dsh web 或 dsh --profile web）。
使用 dsh plugin --profile web remove dsh-codex-tools 卸载。

示例截图

图片生成

图片生成示例

图片识别

图片识别示例

工具参数

codex_web_search

| 参数 | 类型 | 默认值 / 限制 |
| --- | --- | --- |
| query | string（必填） | 公开网页研究问题。 |
| maxSources | integer | 5；范围 1–10。 |
| freshness | string | cached，时效性问题可用 live。 |
| model | string | gpt-5.4-mini。 |

结果包含 summary 和 sources；每个来源包含标题、URL 和片段。

image_gen

| 参数 | 类型 | 默认值 / 限制 |
| --- | --- | --- |
| prompt | string（必填） | 描述主体、风格、构图、配色和约束。 |
| out | string | output/imagegen/.；必须是相对于当前 DSH 会话工作区的路径。工作区根目录由 DSH 的 sandbox-policy 服务提供。绝对路径、父目录片段和符号链接都会被拒绝。会创建父目录，已有文件不会被覆盖。省略 out 时，扩展名跟随 format。 |
| size | string | auto、1024x1024、1536x1024、1024x1536、2048x2048 或 2048x1152。 |
| format | string | png、jpeg 或 webp；默认 png。 |
| model | string | gpt-5.5。 |

image_vision

| 参数 | 类型 | 默认值 / 限制 |
| --- | --- | --- |
| image | string（必填） | 当前 DSH 会话工作区内已存在的 png、jpeg/jpg、webp 或 gif；绝对路径、父目录片段和符号链接都会被拒绝。最大 15 MiB。 |
| question | string | 可选的焦点问题；省略时返回完整描述。 |
| model | string | gpt-5.5。 |

传输脚本会读取本地文件，将其嵌入请求并发送到 ChatGPT Codex endpoint。只接受传输工作区内的文件。

架构

Harness 模型工具
|
v
index.js -> tools.js -> scripts/codex-*.mjs
|
+-- OAuth 刷新（auth.openai.com）
+-- POST chatgpt.com/backend-api/codex/responses
|
codex_web_search：默认 gpt-5.4-mini
image_gen / image_vision：默认 gpt-5.5

注意事项与服务条款

- chatgpt.com/backend-api/codex/responses 是官方 Codex CLI 使用的内部 endpoint，不是文档化的公开 API，可能在无通知的情况下变更或受限。
- 网页搜索的摘要和片段由模型整理；依赖结果前应打开返回的来源 URL，核对原文。
- 网页搜索和生图会消耗 ChatGPT 套餐的 Codex-usage 计量配额。
- 请遵守 OpenAI 服务条款；不要用 ChatGPT 订阅搭建面向公众的图像生成服务。

许可

MIT —— 见 LICENSE。