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 会多出三处：
- 打开任意会话，顶部 tab 行多一个「Emu」标签（在 chat 旁边）——点开是完整的 Emu 界面（画布/图库/Agent），不用离开 DSH
- 设置 > 插件 > Emu Workbench——配置卡：baseUrl/默认模型/尺寸 + 凭据状态（是否已配 EMU_API_KEY）
- 对话里：让 Agent 生图（如「帮我画一张…」），结果以图卡形式直接出现在对话流，可复制/下载/在 Emu 画布中打开继续编辑
快速上手：
- 免费优化提示词：直接用 emu_optimize_prompt——免登录、免 API 密钥、无需授权，输入粗糙/简短的 prompt 即返回改良后的结构化 prompt
- 生图：装好后在对话里让 Agent 生图；凭据缺失时它会引导运行 emu_auth_login（GitHub 一键授权：自动签发密钥并写入 DSH 凭据，无需复制任何密钥）
- 对话里说「帮我画一张……」——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 登录自动签发密钥并写入凭据，无需复制/粘贴）。
配置方式（两步）
- 凭据：在 DSH 凭据里写入环境变量引用
EMU_API_KEY，值填 sk-biz-...。
默认读取 EMU_API_KEY；可用插件设置 apiKeyEnv 换成其他变量名。
- 插件设置（可选，均有默认值）：
| 设置项 | 默认值 | 说明 |
|---|
| 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
