dsh-codex-tools
Codex-backed web search, image generation, and image understanding tools for the DeepSeek Harness.
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools说明文档
阅读完整 README ↗dsh-codex-tools
DeepSeek Harness 的图像生成与图像理解——由你的 ChatGPT 订阅驱动,无需 OPENAI_API_KEY。
一个 DeepSeek Harness 插件,注册三个由 Codex 驱动的模型工具:
| 工具 | 作用 |
|---|---|
web_search | 搜索公开网页,返回简洁摘要和来源 URL。 |
image_gen | 通过 ChatGPT Codex 后端生成位图(插画、图标、Logo、照片、概念图、UI 稿等)。 |
image_vision | 用多模态模型描述图片或回答问题——让纯文本模型(如 deepseek-v4-flash)获得"视觉"。 |
三个工具都复用 ChatGPT 登录态(与官方 Codex CLI 相同的 OAuth 凭据),传输层在 scripts/ 中,零 npm 依赖,仅用 Node 内置 https。
工作原理
web_search / image_gen / image_vision(模型工具)
│ harness.registerTool + 凭据服务
▼
index.js(Cordis bundle 入口)
│ shell 服务,参数全部经环境变量传递
▼
scripts/codex-common.mjs / codex-imagegen.mjs / codex-vision.mjs / codex-search.mjs ← 自研传输层
│ OAuth 刷新(auth.openai.com)+ POST chatgpt.com/backend-api/codex/responses
▼
gpt-5.5(多模态)→ PNG 文件 / 文字描述
认证优先级(三个传输脚本一致):CODEX_ACCESS_TOKEN / CODEX_REFRESH_TOKEN / CODEX_ACCOUNT_ID 环境变量(由插件从 DSH 凭据服务解析,对应 OPENAI_CODEX_API_KEY / OPENAI_CODEX_REFRESH_TOKEN / 可选的 OPENAI_CODEX_ACCOUNT_ID)→ $CODEX_HOME/auth.json → ~/.codex/auth.json(codex login)。遇到 HTTP 401 时传输脚本自动刷新 access token 一次,并原子写回选中的登录文件(0600)。本插件只消费 Codex 登录态,不提供 Codex 认证或 LLM provider。
依赖
- DeepSeek Harness(插件以 profile 级 Cordis bundle 形式运行)
- Node.js ≥ 22(传输脚本)
- ChatGPT 订阅登录态:
codex login生成的~/.codex/auth.json(推荐),或- DSH 凭据
OPENAI_CODEX_API_KEY/OPENAI_CODEX_REFRESH_TOKEN
安装
仓库以 bundle 形态发布:装进 profile 后工具注册在 host 注册表,该 profile 的所有会话都能用。
# 从 git 安装(无构建步骤,无需 pnpm allowBuilds 授权)
dsh plugin --profile web add github:SPYQWER1/dsh-codex-tools
# 或发布到 npm 后
dsh plugin --profile web add dsh-codex-tools

