前言¶

DeepSeek Harness（DSH）以插件扩展对话能力时，若需要把另一套 OpenAI 兼容接口接进当前会话——例如审查代码、翻译，或在工作区内直接出图——往往得自己写远程调用与凭据管理。社区插件 dsh-gpt-api（维护者 wildbyteai，分类：模型推理）把文本调用、文生图、参考图生图和可搜索的模型选择收成配置页加三条对话工具；Key 走 DSH 凭据服务，基础地址可指向官方或中转服务。当前版本 1.2.0，许可 MIT。下文按安装、配置、对话用法与注意点说明。

这是什么¶

dsh-gpt-api 是面向 DeepSeek Harness 的 GPT API 插件：在对话里通过 gpt_call 做文本类任务，通过 gpt_image 做文生图或基于工作区本地图的参考图生图，通过 gpt_models 查询 /models 检查连接。配置页支持填写 API Key、基础地址，并在弹窗中搜索、选择文本模型与图片模型。项目为独立社区插件，参考 OpenAI Developers 插件入口思路，并非 OpenAI 官方插件。

• 目录页：https://www.skillhub.cn/plugins/wildbyteai/dsh-gpt-api
• 源码与说明：https://github.com/wildbyteai/dsh-gpt-api

核心功能¶

1. 文本：gpt_call 用于文本、代码、分析、翻译；只发送本次传入的 prompt 与可选 context，不自动上传整段会话。
2. 文生图：省略 reference_images 或传空数组时，走 /images/generations。
3. 参考图生图：最多 10 张工作区内 PNG / JPEG / WebP（每张 ≤ 30 MiB），经 multipart 请求 /images/edits。
4. 模型发现：配置页「获取模型」会保存当前接口配置，弹窗支持搜索、错误重试；图片相关名称优先排序。
5. 接口模式：文本默认走 responses，可改 chat-completions；兼容 OpenAI 协议的中转地址需自带 /v1 等前缀。

安装与启用¶

图形界面¶

1. 打开 DSH 侧栏 插件 → 添加插件。
2. 粘贴仓库链接并安装（无需手动克隆或构建）：

https://github.com/wildbyteai/dsh-gpt-api

3. 安装后打开 插件 → GPT API，填写 API Key 与 API 基础地址。仓库不包含 Key；官方 Key 用官方地址，中转 Key 用对应服务地址。

命令行¶

dsh plugin --profile desktop add "github:wildbyteai/dsh-gpt-api"

环境要求以包声明为准：Node.js ≥ 22，DSH 版本 >=0.2.1-rc.5 <0.3.0。插件在当前 DSH 进程权限下运行，安装前应自行查看源码与 MIT 许可证。

配置要点¶

安装后在插件配置页保存 Key 与地址。基础地址需包含 API 前缀（如 /v1），插件再追加具体路径；勿在地址里写用户名、密码或查询参数。默认项如下（已手动保存的模型优先于默认）：

在 文本模型 或 图片模型 旁点击 获取模型，搜索选中后 保存更改，即可在对话中使用所选模型。

典型用法¶

对话中的自然语言¶

在对话中说明要使用 GPT API，例如：

调用 GPT，帮我审查这段代码，指出可能的 bug。
用 GPT 生图：一只在窗边晒太阳的橘猫，水彩风格，正方形。
检查 GPT API 连接并列出可用模型。

参考图生图¶

把参考图放在当前会话工作区内，相对路径按对话工作目录解析。生成结果默认落在 output/gpt-api/，使用唯一文件名。

单图示例：

用 GPT 生图，参考 assets/subject.png。
保留主体和构图，把背景换成海边，输出横版图片。

多图时说明每张用途（主体 / 风格等）。网络图或对话附件须先保存到工作区再写路径；reference_images 只接受本地路径，不接受 URL 或 Base64。

工具参数（集成或细调时）¶

gpt_image 常用：prompt（必填）、size（默认 auto）、quality、output_format、n（1–4）。gpt_call 常用：prompt（必填）、可选 context、instructions、max_output_tokens（默认 4096）。gpt_models() 无参数。

适用场景与注意¶

适合：需要在 DSH 里统一走一套 OpenAI 兼容 API 的团队或个人；既要文本又要图片，且希望用配置页选模型、用凭据服务管 Key。

注意：

• 文本与生图计入所配置 API 账号用量；超时后不会自动重试。
• 参考图内容会上传至配置的提供方；只读工作区时生图前会提示切换可写模式。
• HTTP 401 时核对 Key 与地址是否匹配；/images/edits 400/404 时核对提供方是否支持参考图编辑及生图模型。
• 从 GitHub 安装要更新版本：卸载后用同一链接重装；刷新页面不会拉取新源码。

问题反馈：https://github.com/wildbyteai/dsh-gpt-api/issues

结尾¶

经过上面的步骤，dsh-gpt-api 把 GPT 兼容 API 的文本、生图、模型列表和 Key 管理收进 DSH 插件形态，减少自写桥接代码。进一步细节见 GitHub README 与 SkillHub 目录页。