dsh-codex-tools

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

dsh-codex-tools

[English](./README.md)

一个 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](./LICENSE)。