前言¶
在 DSH 里给助手固定一个人格时，往往需要一张能随场景变化的形象图。自己找图或手动画成本高，也不一定和「发色、服装、表情」等设定一致。若每次换造型都要离开会话去别的工具出图，再手动放进上下文，流程也偏碎。
dsh-appearance 把这一步收进插件：在会话里通过工具参数描述外观，调用兼容 OpenAI 格式的文生图接口，把结果落到本地相册目录，并返回路径与完整提示词，便于后续引用。
这是什么¶
dsh-appearance 是维护者 mei0769 发布的 DeepSeek Harness 插件（MIT，当前 package.json 版本为 0.1.0）。它面向「给 DSH 会话里的人格换外观」：按发色、服装、配件、表情（及可选补充描述）生成一张新形象图，写入 ~/.dsh/plugins-data/appearance/gallery/。
插件本身零额外运行时依赖，只依赖一个 /v1/images/generations 兼容接口；README 中默认示例后端为硅基流动（SiliconFlow）。
社区目录页：https://www.skillhub.cn/plugins/mei0769/dsh-appearance
源码与说明：https://github.com/mei0769/dsh-appearance
核心功能¶
README 中声明的两项工具有明确分工：
| 工具 | 作用 |
|---|---|
appearance_generate |
传入 hair / outfit / accessory / expression / extra / size，返回生成图的本地路径与完整提示词 |
appearance_status |
展示后端是否已配置、接口地址、模型、密钥掩码、基础外形设定、素材目录 |
提示词拼接规则为：style + body + 服装（参数或默认）+ 头发 + 服装 + 配件 + 表情；negative 单独传给后端。换模型只需改配置里的 backend.model，无需改插件代码。
若接口返回带签名的临时图片 URL（如硅基流动 s3.siliconflow.cn/temporary/…），README 说明约 1 小时后会过期；插件会在拿到 URL 后立即下载到本地，避免会话里引用失效链接。
安装与启用¶
本地链接安装（README 原文，<本仓库路径> 替换为实际路径）：
dsh plugin --profile desktop add --prefer-offline link:<本仓库路径>
发布到 npm 后可用包名安装：
dsh plugin --profile desktop add dsh-appearance
安装命令须以 README 为准，勿凭仓库名自行拼接 github:owner/repo 等形式。
配置与生成图片的数据目录均为 ~/.dsh/plugins-data/appearance/。首次使用前在配置中填入自己的 apiKey，且勿将密钥提交进仓库。
示例配置结构（字段含义见 README 注释）：
{
"backend": {
"provider": "openai",
"baseUrl": "https://api.siliconflow.cn/v1",
"apiKey": "",
"model": "Qwen/Qwen-Image",
"size": "1024x1024"
},
"style": "2D 动漫插画，平涂上色，清晰线稿，赛璐璐风格，纯白背景，全身站姿…",
"body": "一个圆滚滚的可爱少女（拟人化鲸鱼娘，人形，不是鲸鱼）…",
"outfit": "鲸鱼造型的连帽斗篷…",
"negative": "3D 渲染，手办，塑料质感，半身像，特写…"
}
典型用法¶
- 安装插件后，在
~/.dsh/plugins-data/appearance/写好backend与基础style/body/outfit/negative。 - 在会话中先调用
appearance_status，确认接口地址、模型与密钥掩码、素材目录是否符合预期。 - 调用
appearance_generate，按需要传入发色、服装、配件、表情等参数；需要不同分辨率时可传size（亦受backend.size默认值影响）。 - 使用返回的本地路径；若需复现同一张图，可参考返回的完整提示词。
生成文件保存在 gallery/ 下，文件名带时间戳与中文摘要，便于在本机检索历史造型。
适用场景与注意¶
适合已经在 DSH desktop profile 下开发人格、且愿意自备 OpenAI 兼容文生图 API（或硅基流动等同类后端）的开发者。不适合希望完全离线、不调用任何外部图片接口的场景。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek、幻方无官方从属关系，本文介绍的安装与配置均来自项目 README 与 package.json。
权限与安全：插件以当前 dsh 进程权限运行，安装前请阅读源码与 MIT 许可证，确认 apiKey 仅保存在本机配置目录。星标等目录页统计以社区站点为准时，请以你访问目录页时的显示为准（线索中 GitHub 星标为 0）。
结尾¶
dsh-appearance 把「人格外观」从静态素材变成可按参数再生成的一步：两个工具覆盖状态检查与出图，配置集中在 ~/.dsh/plugins-data/appearance/。若要试用或跟进更新，可看目录页 https://www.skillhub.cn/plugins/mei0769/dsh-appearance 与仓库 https://github.com/mei0769/dsh-appearance。
