Emu Workbench（Emu 影像工作台）

Emu 平台的 DSH 插件：免费提示词优化 + 生图/改图/批量大级联 + 模型可用性探测 + 许愿 Agent + GitHub 一键授权。 密钥在 eimu.dev「API 密钥」页（/settings/api-keys，每人上限 3 把）自助签发，无需人工开通。

安装

在 DSH 设置 > 插件市场（Plugin Market / 商店）搜索「Emu Workbench」一键安装； 或使用 npm 包 dsh-emu-workbench，通过 DSH 官方推荐的插件安装流程添加。 装完重启 dsh web，在设置 > 插件 > Emu Workbench 里填写凭据即可使用。

DSH 生态的影像生产层：多供应商生图/改图/批量大级联 + 模型可用性探测 + Emu 独家 opencode 许愿 Agent，确认卡交互与会话续聊。注册后提供八个工具：

• emu_optimize_prompt —— 免费提示词优化（免登录、免 API 密钥、无需授权）
• emu_model_status —— 探测各图像模型可用性
• emu_generate_image —— 文生图（gpt-image-2 等多供应商）
• emu_edit_image —— 参考图改图（图生图）
• emu_wish —— 许愿 Agent：自主拆解复杂影像任务直到出图，返回 session_id 可续聊
• emu_wish_reply —— 回答许愿 Agent 的问题，继续消费事件流
• emu_auth_login —— GitHub 一键授权：自动签发密钥并写入 DSH 凭据
• emu_auth_status —— 查询授权状态（凭据是否已配置）

安装后你会看到什么（30 秒上手）

装好并重启后，DSH 会多出三处：

1. 打开任意会话，顶部 tab 行多一个「Emu」标签（在 chat 旁边）——点开是完整的 Emu 界面（画布/图库/Agent），不用离开 DSH
2. 设置 > 插件 > Emu Workbench——配置卡：baseUrl/默认模型/尺寸 + 凭据状态（是否已配 EMU_API_KEY）
3. 对话里：让 Agent 生图（如「帮我画一张…」），结果以图卡形式直接出现在对话流，可复制/下载/在 Emu 画布中打开继续编辑

快速上手：

1. 免费优化提示词：直接用 emu_optimize_prompt——免登录、免 API 密钥、无需授权，输入粗糙/简短的 prompt 即返回改良后的结构化 prompt
2. 生图：装好后在对话里让 Agent 生图；凭据缺失时它会引导运行 emu_auth_login（GitHub 一键授权：自动签发密钥并写入 DSH 凭据，无需复制任何密钥）
3. 对话里说「帮我画一张……」——Agent 会自动调用 emu_generate_image

想批量/复杂愿望？说「用许愿 Agent 帮我做一组 4 张夏日饮品海报」——emu_wish 会把任务交给 Emu 的 opencode Agent 自主拆解迭代。

获取密钥

在 eimu.dev 注册登录后，进入「API 密钥」页（https://www.eimu.dev/settings/api-keys，导航栏用户菜单 → API 密钥）自助签发 sk-biz-... 密钥（每人上限 3 把，可随时吊销）。B 端 OpenAI 兼容端点 https://image.tinchak0207.xyz/v1/*。明文只在签发时显示一次，妥善保管。

更简单：在 DSH 里运行 emu_auth_login 一键授权（GitHub 登录自动签发密钥并写入凭据，无需复制/粘贴）。

配置方式（两步）

1. 凭据：在 DSH 凭据里写入环境变量引用 EMU_API_KEY，值填 sk-biz-...。 默认读取 EMU_API_KEY；可用插件设置 apiKeyEnv 换成其他变量名。
2. 插件设置（可选，均有默认值）：

设置项	默认值	说明
baseUrl	https://image.tinchak0207.xyz	平台基址
apiKeyEnv	EMU_API_KEY	读取密钥的环境变量名
defaultModel	gpt-image-2	默认模型 id
defaultSize	1024x1024	默认尺寸
wishTimeoutMs	240000	许愿单轮最大时长（毫秒）
wishIdleMs	60000	许愿事件流空闲判定（毫秒）

工具与调用示例

emu_model_status

查询当前可用/不可用的图像生成模型，返回 available / unavailable / raw。

参数	必填	说明
（无）

emu_generate_image

参数	必填	说明
prompt	是	完整画面描述（主体/构图/风格/光线）
model	否	模型 id，默认 gpt-image-2
size	否	尺寸如 1024x1024
n	否	张数 1-4

示例：emu_generate_image(prompt="一只戴草帽的橘猫坐在海边看日落，电影感布光", size="1024x1024") 成功后图片已附加到对话。

平台生图是异步任务：提交后 20~60 秒内完成（模型排队），插件自动轮询直到出图，无需手动等待。

emu_edit_image

参数	必填	说明
imageUrl	是	参考图公网 URL（必须可访问，平台会下载原图）
prompt	是	改图要求
model	否	模型 id，默认 gpt-image-2
size	否	尺寸如 1024x1024

emu_wish

参数	必填	说明
wish	是	完整愿望描述
model	否	首选模型 id
size	否	尺寸如 1024x1024

返回 session_id / status / image_urls / pending_question / text_summary。 status 为 completed | timeout | aborted | pending_question。

emu_wish_reply

参数	必填	说明
session_id	是	许愿会话 id（emu_wish 返回）
reply	是	对 Agent 问题的回答

emu_optimize_prompt

参数	必填	说明
prompt	是	粗糙的原始 prompt

免费层：免登录、免 API 密钥、无需授权。返回 ok / prompt（优化后的结构化 prompt）/ usedAgent（Agent 优化或规则层优化）。

emu_auth_login

GitHub 一键授权：自动打开浏览器到站点授权页，完成授权后密钥自动写入 DSH 凭据（无需复制）。返回 configured / message。

emu_auth_status

查询授权状态，返回 configured / source / message。生图前可用它确认凭据已配置。

常见错误

现象	含义	处理
HTTP 401	密钥无效或未配置	检查 EMU_API_KEY 凭据；未配置时工具会给出明确提示
HTTP 502 / 500	上游瞬时不可用	稍后重试，或换 model-status 里 available 的模型
timeout	许愿超时	调大 wishTimeoutMs 后重试；也可用 emu_wish_reply 续聊

License

MIT