前言¶
在 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。
