dsh-appearance

dsh-appearance

给 DSH 会话里的人格换外观：按发色、服装、配件、表情生成一张新的形象图，存进本地相册目录。

零依赖，只调用一个兼容 OpenAI 格式的图片接口（默认硅基流动）。

工具

工具	作用
appearance_generate	传 hair / outfit / accessory / expression / extra / size，返回生成图的本地路径与完整提示词
appearance_status	显示后端是否配好、接口地址、模型、密钥掩码、基础外形设定、素材目录

安装

dsh plugin --profile desktop add --prefer-offline link:<本仓库路径>

或发布到 npm 后 dsh plugin --profile desktop add dsh-appearance。

配置

配置与图片都在 ~/.dsh/plugins-data/appearance/：

{
  "backend": {
    "provider": "openai",              // openai = OpenAI 兼容 /v1/images/generations
    "baseUrl": "https://api.siliconflow.cn/v1",
    "apiKey": "",                      // 自己填，不要提交进仓库
    "model": "Qwen/Qwen-Image",
    "size": "1024x1024"
  },
  "style": "2D 动漫插画，平涂上色，清晰线稿，赛璐璐风格，纯白背景，全身站姿…",
  "body": "一个圆滚滚的可爱少女（拟人化鲸鱼娘，人形，不是鲸鱼）…",
  "outfit": "鲸鱼造型的连帽斗篷…",
  "negative": "3D 渲染，手办，塑料质感，半身像，特写…"
}

提示词按 style + body + 服装（参数或默认）+ 头发 + 服装 + 配件 + 表情 拼成，negative 单独传给后端。

说明

• 生成的图存到 ~/.dsh/plugins-data/appearance/gallery/，文件名带时间戳与中文摘要
• 换模型只改 backend.model，不用改代码
• 接口返回的图片 URL 若是签名地址（硅基流动的 s3.siliconflow.cn/temporary/…），会在 1 小时后过期，本插件会立刻下载落盘

License

MIT