DeepSeek Harness 插件:dsh-codex-media

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。DeepSeek 的多模态模型(如 deepseek-v4-flash-vision-exp)原生支持图片输入与理解,能够直接处理粘贴的图片。但对于图片的生成与编辑,通常需要额外的 API 调用或复杂的本地部署。本插件提供了一个解决方案:利用本机已登录 ChatGPT Plus 的 Codex CLI 来处理图片的生成与编辑任务。

dsh-codex-media 是一个为 DeepSeek Harness (DSH) 设计的 Codex 扩展。它通过 MCP (Model Context Protocol) 协议注册四个工具,让 DSH 能够调用本机的 Codex CLI 执行生图、改图、剪贴板存盘以及委托独立任务。插件由 yujianjian1013 维护,遵循 MIT 许可证。

核心功能

插件包含以下核心能力:

  1. 生图 (generate_image):调用 Codex 托管的 image_generation 模型,将生成的图片输出到指定路径。
  2. 改图 (edit_image):支持带参考图重绘。参考图接受本地路径、SHA256 附件 ID 或剪贴板输入。
  3. 剪贴板图片存盘 (clipboard_to_image):将剪贴板中的图片保存到本地。在 Windows 上需配合 PowerShell 单线程模式 (pwsh -STA) 使用;非 Windows 平台该输入源不可用,其余功能正常。
  4. Codex 子代理 (codex_task):将一段独立的非图处理任务(如读写文件、执行命令)交给本地 Codex 执行,以节省 DeepSeek 的 token 消耗。

安装与启用

安装前请确保环境满足以下依赖:

  • DeepSeek Harness (DSH) >= 0.1.0-rc.6
  • Node.js >= 22.19
  • 本机已安装并登录 ChatGPT 的 Codex CLI(生图和改图功能需要 Plus 订阅额度)
  • 系统为 Windows(剪贴板功能需要 PowerShell 单线程模式支持)

安装命令如下:

dsh plugin --profile web add github:yujianjian1013/dsh-codex-media

安装完成后,需在 DSH 的 cordis.patch.yml 中添加 MCP 服务器配置,否则工具无法注册。参考配置如下:

- insert:
    - id: mcp-codexmedia
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: codexmedia
        transport: stdio
        command: node
        args: !!js '(() => { const { createRequire } = process.getBuiltinModule("node:module"); const home = process.env.DSH_HOME || ((process.env.USERPROFILE || "") + "/.dsh"); return [createRequire(home + "/profiles/web/package.json").resolve("dsh-codex-media/mcp/server.mjs")]; })()'

修改配置后,重启 dsh web 并刷新页面即可生效。

典型用法

  • 识图:直接使用 DeepSeek 的多模态模型。粘贴图片后,模型会将其作为 image block 接收,无需插件介入。
  • 生图:在对话中直接说“画一只……”。模型会识别意图并调用 generate_image 工具。
  • 改图:粘贴一张参考图,然后说“把它改成……”。模型会调用 edit_image 工具进行重绘。
  • 剪贴板存盘:在对话中说“把剪贴板图片存到 X”。模型会调用 clipboard_to_image 工具保存图片。
  • Codex 子代理:对于代码任务,直接说“请帮我读取并修改 /path/to/file”。模型会调用 codex_task 工具,由本地 Codex 执行。

注意事项

  • 费用:生图和改图功能消耗 ChatGPT 订阅的图像额度,而非 DeepSeek 的 token。
  • 存储:生成的图片默认保存在 ~\.codex\generated_images 目录下,建议定期清理。
  • 连接稳定性:当 Codex 连接 chatgpt.com 时,如果 WebSocket 偶发重置(错误码 10054),插件会自动降级并尝试 HTTPS 重试,属于正常现象。

生态背景

DeepSeek Harness 的生态强调「一切皆插件」。本插件通过 GitHub 维护,可在 技能中心目录 查看,与 DeepSeek 官方无直接隶属关系。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜