dsh-ernie-image

DSH 百度 ERNIE-Image-Turbo 文生图插件：宿主端注册图像生成工具（图片落盘 + 注册为会话附件，agent 可继续读图），浏览器端提供插件配置卡（密钥用户自填、测试连接、默认参数）与「✨ 文生图」生成画廊面板（prompt → 变体 → 预览/下载/同 seed 复现/换 seed 出变体 → 插入会话）。

定位

• 数据源：百度 AI Studio 的 ERNIE-Image-Turbo 文生图模型（/llm/lmapi/v3/images/generations）。
• 宿主工具：
  • ernie_generate_image(prompt, {size, n, seed, usePe, steps, guidance}) → 生成 PNG 落盘到 $DSH_HOME/ernie-image// 并注册为会话附件，返回附件引用 + 磁盘路径；同 seed 同参数可复现同一张图。
  • ernie_image_test() → 最小请求（n=1、小 prompt）探测密钥与网络；未配置密钥时返回指向设置卡的引导。
• 浏览器 UI：
  • 设置 → 插件配置 → ERNIE 文生图 卡片：密钥（走 DSH 凭据保险箱，值永不回传浏览器）、测试连接、 生成默认参数（size / use_pe / steps / guidance）、面板开关。
  • 右下角 ✨ 文生图 面板：prompt + 7 档尺寸预设 chips + 张数/seed/步数/引导 → 生成骨架屏 → 画廊（大图预览 / 下载 / 同 seed 重生成 / 换 seed 出变体 / 插入会话，插入会话直接把图作为消息附件发给 agent）。

密钥获取与配置

1. 打开 aistudio.baidu.com 并登录百度账号；
2. 右上角头像 → 访问令牌 → 新建，复制令牌；
3. 在 DSH 设置 → 插件配置 → ERNIE 文生图 卡片粘贴并保存（或设置环境变量 ERNIE_IMAGE_API_KEY，环境变量优先且只读遮蔽）。

与 OCR 插件（paddle-ocr）使用的是同一个 aistudio token，可以填同一个。

⚠️ 安全提醒：请勿复用旧 token。 本插件的前身 skill（kk_skill/skills/ernie-image/generate.py） 曾把 AI Studio 访问令牌硬编码进脚本并进入 git 历史，该 token 视为已泄漏：请到 AI Studio 令牌页轮换（删除重建），不要把旧 token 填入本插件。本插件自身不含任何密钥，凭据只写入 DSH 凭据保险箱（$DSH_HOME/.credentials.yaml），不进入设置文档、日志或会话内容。

安装

# 宿主组合（profile cordis.patch.yml / bundle patch）插入一行：
- insert:
    - id: ernie-image
      name: dsh-ernie-image

浏览器半区通过包内 dsh.client 清单自动发现（exports["./client"]），无需额外配置。 宿主行挂载后客户端 bundle 以 /plugins/dsh-ernie-image/client.js 提供服务。

说明：配置卡的默认参数读写走插件自带的 /ernie-image loopback RPC 通道，而不是 settingsScope——DSH 的 settings 线上域按 api-proxy 允许名单暴露命名空间，自包含插件 用自己的 RPC 即可在热重载下立刻可用，无需改动部署源码。

参数速查（ERNIE-Image-Turbo）

参数	范围/取值	默认
size	1024x1024 / 1376x768 / 1264x848 / 1200x896 / 896x1200 / 848x1264 / 768x1376