dsh-plugin-grok2api-media-tool

配置

插件配置保存在 ~/.dsh/settings.yaml 的 grok2api-media-tool: 节，以下三种方式任选其一，效果相同，保存后即时生效（无需重启）。

方式 1：直接对话配置

在对话里直接提出即可，模型会调用 configure_grok2api 工具写入并生效：

• 「grok2api 复用 llm-pi-ai 里配好的 grok 提供商」
• 「把 grok2api 地址配成 http://192.168.1.100:8000，密钥 sk-xxx」
• 「生成的图片不要保存到工作区」

方式 2：复用已配置的 LLM 提供商

如果已在 dsh 的「模型」设置里配好 grok 提供商，插件可以直接复用它（地址、密钥、模型均取自该提供商），无需重复填写：

grok2api-media-tool:
  apiSource: llm-provider
  llmProvider: grok   # llm-pi-ai.providers 下的键名

方式 3：手工编辑配置文件

编辑 ~/.dsh/settings.yaml（Windows 为 %USERPROFILE%\.dsh\settings.yaml）：

grok2api-media-tool:
  baseUrl: http://192.168.1.100:8000
  apiKey: sk-xxx
  apiFlavor: chenyme

说明：当前 dsh 版本的设置页只开放内置命名空间，插件暂无法提供图形化配置表单，请使用以上方式配置。

方式 1：直接对话配置

在对话里直接提出即可，模型会调用 configure_grok2api 工具写入并生效：

• 「grok2api 复用 llm-pi-ai 里配好的 grok 提供商」
• 「把 grok2api 地址配成 http://192.168.1.100:8000，密钥 sk-xxx」
• 「生成的图片不要保存到工作区」

方式 2：复用已配置的 LLM 提供商

如果已在 dsh 的「模型」设置里配好 grok 提供商，插件可以直接复用它（地址、密钥、模型均取自该提供商），无需重复填写：

grok2api-media-tool:
  apiSource: llm-provider
  llmProvider: grok   # llm-pi-ai.providers 下的键名

方式 3：手工编辑配置文件

编辑 ~/.dsh/settings.yaml（Windows 为 %USERPROFILE%\.dsh\settings.yaml）：

grok2api-media-tool:
  baseUrl: http://192.168.1.100:8000
  apiKey: sk-xxx
  apiFlavor: chenyme

说明：当前 dsh 版本的设置页只开放内置命名空间，插件暂无法提供图形化配置表单，请使用以上方式配置。

配置项

未填写的字段使用默认值。

键	默认值	说明
baseUrl	http://127.0.0.1:8000	grok2api 服务地址
apiKey	''	客户端密钥；非空时以 Authorization: Bearer 发送
apiKeyEnv	''	存放密钥的环境变量名（如 GROK_API_KEY）；apiKey 为空时使用
apiSource	manual	manual（使用本节字段）或 llm-provider（复用 llm-pi-ai 中的提供商）
llmProvider	''	apiSource: llm-provider 时，llm-pi-ai.providers 下的键名
apiFlavor	chenyme	chenyme（Go 版）或 aurora（Python 版）
image.enabled	true	是否启用 generate_image
image.model	grok-imagine-image-quality	默认图片模型；留空使用后端默认
image.timeoutMs	180000	图片生成总超时（毫秒）
video.enabled	true	是否启用 generate_video
video.model	grok-imagine-video	默认视频模型；留空使用后端默认
video.timeoutMs	1200000	视频生成总超时（毫秒）
video.pollIntervalMs	5000	视频进度轮询间隔（毫秒）
vision.enabled	true	是否启用 recognize_image
vision.model	latest	识图默认模型；latest 会查询 grok2api 的 /v1/models 自动选最新 Grok 语言模型（同一会话只查一次，失败回退 grok-4.6），也可直接填具体模型 id
vision.timeoutMs	60000	识图单次请求超时（毫秒）
vision.bridgeToText	true	是否把聊天上传的图片先用 Grok 转成文字，再交给纯文本主模型（如 DeepSeek）
saveToWorkspace	true	是否将生成的媒体下载到会话工作区
saveDir	generated	媒体保存子目录（相对工作区根）
requestTimeoutMs	60000	单次 HTTP 请求超时（毫秒）
mediaDownloadTimeoutMs	300000	单个媒体文件下载超时（毫秒）

使用

在 dsh（Web 或 headless）中直接提出需求即可：

• 「帮我生成一张赛博朋克城市夜景图，16:9」
• 「做一个 8 秒的视频：一只橘猫在雪地里奔跑」
• 「生成 2 张水彩灯塔图片，保存到项目里」
• 「分析这张图片里有什么」/「识别 /path/to/image.png 里是什么」
• 点击聊天输入框左侧的 🖼️ 按钮，选择一张图片，插件会把本地路径插入输入框；发送后模型会调用 recognize_image 用 Grok 识别

生成的图片会以内嵌卡片展示，视频可直接在对话中播放；本地保存的文件路径会以行内代码形式出现在回复里。识图结果会以普通文本返回。