dsh-codex-tools
由 Codex 提供支持的网页搜索、图像生成和图像理解工具，适用于 DeepSeek Harness。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-codex-tools@1.0.3Codex Tools 以 dsh-codex-tools 发布，当前版本为 1.0.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness plugin that registers three tools provided by ChatGPT Codex:
| Tool | Function |
|---|---|
codex_web_search | Searches the public web and returns a summary with source URLs. |
image_gen | Generates a bitmap image. It does not edit or transform an existing image. |
image_vision | Reads a local image and returns a description or an answer to a question about it. |
It consumes an existing Codex/ChatGPT login; it does not provide login or an LLM provider.
codex login with an auth file, or credentials in DSH:
OPENAI_CODEX_API_KEYOPENAI_CODEX_REFRESH_TOKENCredentials are resolved from CODEX_ACCESS_TOKEN and CODEX_REFRESH_TOKEN environment variables first (the plugin maps the DSH credential names above to these variables). If those are absent, the transport reads $CODEX_HOME/auth.json when CODEX_HOME is set, or ~/.codex/auth.json otherwise. Set CODEX_HOME to choose another auth directory; the default is ~/.codex. After an HTTP 401, a transport refreshes the access token once and attempts to persist the refreshed login state to that auth file. When the plugin injects DSH credentials, the refresh code may still write to the auth file selected by CODEX_HOME or the default path.
# Git
dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools
# npm
dsh plugin --profile web add dsh-codex-tools
Restart after installation (dsh web or dsh --profile web).
Remove it with dsh plugin --profile web remove dsh-codex-tools.
codex_web_search| Parameter | Type | Default / limits |
|---|---|---|
query | string (required) | Public-web research question. |
maxSources | integer | 5; from 1 to 10. |
freshness | string | cached, or live for time-sensitive queries. |
model | string | gpt-5.4-mini. |
The result contains summary and sources; each source has a title, URL, and snippet.
image_gen| Parameter | Type | Default / limits |
|---|---|---|
prompt | string (required) | Describe the subject, style, composition, palette, and constraints. |
out | string | output/imagegen/<timestamp>.<format>; must be relative to the current DSH session workspace. The workspace root comes from DSH's sandbox-policy service. Absolute paths, parent-directory segments, and symbolic links are rejected. Parent directories are created, and existing files are never overwritten. If out is omitted, the extension follows format. |
size | string | auto, 1024x1024, 1536x1024, 1024x1536, 2048x2048, or 2048x1152. |
format | string | png, jpeg, or webp; default png. |
model | string | gpt-5.5. |
image_vision| Parameter | Type | Default / limits |
|---|---|---|
image | string (required) | Existing png, jpeg/jpg, webp, or gif under the current DSH session workspace; absolute paths, parent-directory segments, and symbolic links are rejected. Maximum 15 MiB. |
question | string | Optional focus question; omitted means a full description. |
model | string | gpt-5.5. |
The transport reads the local file, embeds it in the request, and sends it to the ChatGPT Codex endpoint. Only files inside the transport workspace are accepted.
Harness model tool
|
v
index.js -> tools.js -> scripts/codex-*.mjs
|
+-- OAuth refresh (auth.openai.com)
+-- POST chatgpt.com/backend-api/codex/responses
|
codex_web_search: gpt-5.4-mini by default
image_gen / image_vision: gpt-5.5 by default
chatgpt.com/backend-api/codex/responses is an internal endpoint used by the official Codex CLI, not a documented public API. It may change or be restricted without notice.MIT — see LICENSE.