dsh-grok-image

DeepSeek Harness 插件:把 Grok Imagine 图片生成(订阅额度)注册成 DSH 的模型工具 image_gen。针对 DSH 0.1.2-rc.1。

• GitHub: https://github.com/clarkzhao/dsh-grok-image (待发布)
• topic: dsh-plugin

能力

• 工具 image_gen:根据文本描述生成图片
• 走 Grok 订阅端点 https://cli-chat-proxy.grok.com/v1/images/generations,与 dsh-llm-grok 同一凭据(GROK_SESSION_TOKEN)与代理(Clash http://127.0.0.1:7890)
• 凭据不会自动续期。自动把 grok CLI token 挂进 DSH：见 dsh-llm-grok/docs/credential-sync.md
• 模型:grok-imagine-image-quality(默认,可配置)
• 比例:auto / 1:1 / 16:9 / 9:16 / 3:2 / 2:3
• 参数 inline_image(默认 true):是否把图片内联进对话。当前模型适配器不支持图片内容时(如 deepseek),设 false 只返回保存路径
• 生成结果:
  • 写入 DSH 附件服务 → Web UI 直接内联渲染,模型可继续看图(grok 模型)
  • 同时落盘到 outputDir(默认 ~/grok-images)→ 本地文件副本
  • 用量记入 usage.log.jsonl(成本核算用;Imagine API 不返回单次 usage)

本地媒体（可选 AIRP 舞台）

本插件不自建 HTTP 路由。装了 dsh-airp 时，生成图挂到 Host 的 airpStage（/airp-media）。工具回执带同源绝对 URL，叙述者写进对白：

![水墨斗笠猫](http://127.0.0.1:3080/airp-media/mashui-cat-xxx.jpg)

Web Markdown 只渲染绝对 http(s)，且须与当前 GUI origin 一致。没有 AIRP 时仍落盘 + 附件，不贴本地路径。

安装

dsh plugin --profile web add dsh-grok-image
# 本地开发:
dsh plugin --profile web add ./dsh-grok-image

安装后 bundle 写入 grok-image 并注册 image_gen 工具。需重启 DSH 生效。

配置

- id: grok-image
  name: dsh-grok-image
  config:
    baseURL: https://cli-chat-proxy.grok.com/v1
    apiKeyEnv: GROK_SESSION_TOKEN
    proxy: http://127.0.0.1:7890
    model: grok-imagine-image-quality
    outputDir: ~/Workspace/grok-images
    usageLog: true

开发

pnpm install
npm test
npm run build

限制

• 只实现 image_gen;image_edit(图生图)与 video_gen 未实现,参考 grok-build 同模式可后续扩展
• 免费 / X Basic 档用户会被订阅端点零额度限制(SuperGrok 专属能力)
• 生成耗时可达 1-2 分钟,工具超时 300s