SPYQWER1/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/<timestamp>.<format>；必须是相对于当前 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。