该插件架构基本完善，如dsh无破坏性更新，此插件长期可用，语音包持续更新ing

dsh-gal · DSH 立绘挂件

在 DeepSeek Harness 界面里放一个会说话的立绘：实时显示 DeepSeek 余额 与 今日已用， 每轮对话结束报出本轮 消耗与花费，点击立绘随机播放语音、随机换立绘。

立绘包、语音包、图标、对话框都是普通文件夹，可以自己换。

功能

安装

前置：已在 DSH 里配置好 DEEPSEEK_API_KEY 凭据。

到 Releases 下载 dsh-gal.tgz （不带版本号的那个，永远指向最新版），然后按本地文件安装：

dsh plugin --profile desktop add C:\path\to\dsh-gal.tgz

必须重启 DSH Desktop：宿主路由和注入脚本在进程启动时装配，只刷新页面不够。

用网页端（npx @deepseek-ai/dsh web）的话，把命令里的 --profile desktop 换成 --profile web —— 网页端读的是 web profile，装到 desktop 里网页端看不到挂件 （宿主路由不会注册，页面里也不会注入脚本）。两个 profile 各自维护自己的插件， 两端都想用就两端各装一次；素材包、设置、余额记账是共用的（都在 %USERPROFILE%\.dsh 下）。

# 验证：配置树里应该出现这一行
dsh --profile desktop --dump-config | Select-String dsh-gal

# 卸载（会同时清掉 dependencies 和 bundles 两处记录）
dsh plugin --profile desktop remove dsh-gal

使用

位移小于 5px 算点击，超过算拖拽。打字中再次点击会打断当前这句、直接开始下一句。

设定面板

点 ⚙ 弹出（半透明白色，默认在立绘上方）。共 7 组：

「对话框」一组里还有 对话框底图：更换图片… 挑一张自己的图（PNG / JPEG / WebP / GIF）， 空白底图 换成随插件自带的纯白面板，恢复默认 还原成自带立绘。三者都立即生效， 不必重启 DSH；想微调裁切和留白就改 ui\dialog.json（见 docs/customize.md）。

「3 语音语言」下面还有 语音顺序：洗牌池（默认）/ 纯随机，点一下切换，立刻生效。 想让某几句多放或少放，在语音包目录里放一个 weights.json（见 docs/customize.md）。

自定义立绘包 / 语音包

把文件夹放进用户目录（升级不会被覆盖），设置面板里就会多出这个选项：

%USERPROFILE%\.dsh\dsh-gal\packs\
└── mychar\
    ├── sprites\   01.png  02.png ...     ← 立绘
    ├── voices\    my0001.wav ...         ← 语音
    ├── script.csv                        ← 可选：语音 → 台词对照表
    └── pack.json                         ← 可选：显示名 / 默认立绘 / 裁切

• 两个文件夹也可以叫 立绘\ / 语音\（或 立ち絵\ / ボイス\），插件都认，不用改名。
• 只放 sprites\ 就是立绘包，只放 voices\ 就是语音包。
• 语音包不放 script.csv 就是「只有语音没有台词」：点击立绘照常出声、照常换立绘， 对话框改为显示「余额 / 今日已用」。
• 立绘的透明边距会自动裁掉，不需要自己切图。
• 默认立绘：由 pack.json 的 defaultSprite 指定；没写就按自然顺序自动选第一张 —— 所以任何立绘包都一定有默认立绘，什么配置都不写也能用。

完整格式（script.csv 列名、pack.json 字段、换对话框底图、定价表）见 docs/customize.md。

文档

疑难

• 点了立绘没声音、或者立绘不换图 / 设定里换立绘包没反应：都是同一个原因 —— 页面繁忙时浏览器会饿死低优先级的图片和媒体请求（实测 stalled 十秒以上， 一发消息就一起放行，所以症状看起来像「要聊一句才生效」）。 现在语音、立绘、对话框底图、设定图标都先用 fetch 取字节，再交给 blob: 播放 / 渲染； 取不到字节就退回原来的直连方式，不会白屏也不会静音。 控制台里出现 [dsh-gal] …字节读取失败 或 语音播放被拒绝 就是这条路径在报错，欢迎带日志提 issue。

角色

角色	默认立绘	获取方式
neri		随插件自带
Mashiro 精简版		Releases 的 mashiro-pack.zip
noir音效		Releases 的 noir-pack.zip
Karuha		Releases 的 karuha-pack.zip

下载解压到 %USERPROFILE%\.dsh\dsh-gal\packs\，刷新页面即可在设定面板的「立绘包 / 语音包」里选用。

Mashiro 有两份：

• mashiro-pack.zip —— 精简版（推荐）：37 张立绘 + 135 条语音，台词逐条筛过。
• mashiro-pack-full.zip —— 完整版：原台词过于伤感，不建议使用，296 条语音原样留存。 包 id 是 Mashiro-full，和精简版可以同时装，在设定面板里分开选。