前言¶
在 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
