Skip to content

Releases

v0.3.8 —— 新增卸载程序（双击就能卸，并还原默认预设）

v0.3.8 —— 新增卸载程序（双击就能卸，并还原默认预设） Latest
Latest

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 14 Sep 13:31
v0.3.8
356d21f

🧹 这一版加了正经的卸载程序 —— 以前"不会卸"只能自己敲命令，现在双击就行。

🆕 这一版加了什么

uninstall.cmd：双击就能卸（uninstall.ps1 要一起下，放同一个文件夹 —— 见下面说明）。

它会依次做七件事：

  1. 备份 profile 的 package.json / cordis.patch.yml / settings.yaml 到 fairy-backup-<时间戳>\
  2. 卸插件 —— 只卸真正装过的（dsh-fairy-* 开头的，加 dsh-balance-meter / dsh-browser-dock）
  3. 🔴 还原「新会话默认预设」
  4. 删掉人设预设目录与同步指纹
  5. 扫历史残留 —— 老版本 0.2.x 留下的受管块、package.json 残留行、node_modules 残渣
  6. 校验 profile 合成
  7. 把没有删掉的你的数据路径打出来

🔴 为什么第 3 步最重要

卸载最怕的不是删不干净，是卸完反而更坏：
配置里还写着"新会话默认用 Fairy"，而预设已经被删了 —— 结果就是**「点新建会话没反应」**。
这个脚本一定会把它还原（优先用插件自己留的备份，没有就回落内置的 standard）。

🔒 卸载不删你的数据

~/.dsh/fairy-voice/（参考音频 / 朗读设置 / 语音简报 API Key）一个字节都不动，
脚本只在最后把路径打给你。要彻底清干净就自己删那个目录 —— 删了就找不回来。

🧩 旧版本也能卸

脚本带兼容层：认得出老版本在 cordis.patch.yml 里留的受管块、以及 package.json 里的残留行 ——
这些默认只报告不动手，加 -CleanBundle 才会清（清之前先备份）。

📦 下载哪个？

下载这个 干什么 给谁用
install.cmd 装 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 装全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人
uninstall.cmd 卸：卸掉插件与预设，并把改过的「默认会话预设」还原回去 🧹 不用了、想清干净的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管。

⚠️ 要卸载的话得下两个文件：uninstall.cmd 和 uninstall.ps1，放同一个文件夹里。
那个 .cmd 只是个纯 ASCII 启动器（这样在任何中文 Windows 上都不会乱码），真正的逻辑在 .ps1 里。
只想装、不打算卸的人，这两个不用下。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，它会逐项告诉你卡在哪一层

已经装过旧版的人（更新步骤）

  1. 重新下载 install.cmd 双击一遍（或重跑你当初那条安装命令）
  2. 重启 DSH
  3. 完事 —— 预设会在启动时自动重灌成修好的版本

🔧 怎么卸载

不会打命令：双击 uninstall.cmd（uninstall.ps1 记得也下、放同一个文件夹）。

会打命令：

dsh plugin --profile web remove dsh-fairy-visual dsh-fairy-voice dsh-balance-meter
.\uninstall.ps1 -CleanBundle   # 老版本留过受管块 / package.json 有残留行时才需要，会先备份

卸载不删 ~/.dsh/fairy-voice/（参考音频 / 设置 / API Key）—— 要彻底清就自己删那个目录。

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 393147 D6B691E8F387C105CEA3FACDA3E893C3E87D37D0223DBE16E451B1C9B3F18AE7
dsh-fairy-voice.tgz 67409 19CDB64A90BB4C246610897A7DB24DFF7E2FDB3DEBA08C861EC5B575AC243E2E
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22
uninstall.cmd 688 982EA1B2F5251F173B757EE3E932F4178D489D82E4C4DABD0A05F5B95E624650
uninstall.ps1 14624 2CFFBAD5C6D0ADC1FF5C373D051319DC9B426DB17E5DA9DE34CF9CA3829CA8A8

合计 524.8 KB。

相对 v0.3.7：5 个 .tgz 逐字节未变（这次没碰任何插件包）；附件从 7 个变成 9 个。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • 有问题请提到本仓库 Issues 或交流群 1124349108
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
Assets 11
Loading

v0.3.7 —— 预设 text/prefix 双键兼容层（修 v0.3.6 的回归）

v0.3.7 —— 预设 text/prefix 双键兼容层（修 v0.3.6 的回归）

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 14 Sep 11:07
v0.3.7
a1ebdac

🔴 上一版（v0.3.6）装了就更新这一版。 它只修好了一半。

🔴 这一版修了什么

text: / prefix: 是跟着 DSH 版本走的，只写一个必然"修好一台、弄坏另一台"。

v0.3.6 把预设里人设那一行从 text: 改成了 prefix: —— 那是照群友那台的报错改的。
结果一重启，另一台 DSH 上反而彻底开不出会话：

$.text missing required value (at text)

同一个文件、同一版插件，两台机器要的键名正好相反：
老一点的 DSH 只认 text:，新一点的 DSH 只认 prefix:（两边都是必填）。
缺了就直接"预设挂载失败 → 会话创建被回滚"，而客户端把失败吞成一条警告 ——
所以表现就是界面完全正常、点【新建会话】没反应。

✅ 兼容层：同一个预设里两个键都写

位置：fairy-visual/dsh-fairy-visual/.agent-presets/fairy/agent.cordis.yml 的 persona 行。

- id: persona
  name: '@deepseek-ai/dsh-persona'
  config:
    # [compat 0.3.7] 旧版 DSH 的 persona 只认 text:，新版只认 prefix:
    #               两边都会忽略自己不认识的键 —— 所以两个都写，谁认识谁拿
    text: |-            # ← 老版 DSH 用这个
      （人设语料 35 行，一个字没动）
    prefix: |-          # ← 新版 DSH 用这个（同一段语料，逐字相同）
      （同上）

为什么这招一定成立：两边的报错都只抱怨"少了我认识的那个键"，
从没抱怨过"多了个我不认识的键" → schema 会忽略陌生键。

为什么不按版本写不同的键：插件拿不到宿主 persona 的 schema，判版本又脆。
双键不依赖版本号 —— 以后 DSH 再改键名，只要还是这两个之一就都活着。

人设语料本身没有任何改动（打包时校验过两段逐字相同）。

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管。

不想用安装器也可以：下 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装。
上面两个链接永远指向最新版，想更新时重新下载再双击一次即可。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）—— 插件在启动时才装载
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，它会逐项告诉你卡在哪一层

已经装过旧版的人（更新步骤）

  1. 重新下载 install.cmd 双击一遍（或重跑你当初那条 dsh plugin add 命令）
  2. 重启 DSH
  3. 完事 —— 预设会在启动时自动重灌成修好的版本，不用你手动做什么

万一还不行：打开 设置 → Fairy，把人设预设开关关掉再打开一次（= 强制重灌），
然后 Ctrl + F5 硬刷新，再点「新建会话」。

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 393147 D6B691E8F387C105CEA3FACDA3E893C3E87D37D0223DBE16E451B1C9B3F18AE7
dsh-fairy-voice.tgz 67409 19CDB64A90BB4C246610897A7DB24DFF7E2FDB3DEBA08C861EC5B575AC243E2E
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 496.1 KB。

相对 v0.3.6，只有 dsh-fairy-visual 变了（0.1.7 → 0.1.8）；另外 4 个包与两个 install.cmd 字节未变（仍照传，附件是整体替换的）。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • 有问题请提到本仓库 Issues 或交流群 1124349108
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
Loading

v0.3.6 —— 修 Fairy 预设挂载失败（新建会话点了没反应）

v0.3.6 —— 修 Fairy 预设挂载失败（新建会话点了没反应）

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 14 Sep 10:56
v0.3.6
07ce6c1

🔴 如果你遇到「点新建会话没反应」，这一版就是修它的。建议立刻更新。

🔴 这一版修了什么

Fairy 预设挂载失败 → 新建会话被回滚 → 界面上看就是"点了没反应"。

  • 上游预设文件里，人设那一行用的是 text:，而当前这版 DSH 的 dsh-persona 只认 prefix:（且必填）
  • 于是 text 被当未知键丢掉 → prefix 缺失 → 预设挂载失败 → 会话创建被回滚
  • 客户端把这个失败吞成一条 console.warn，所以表面完全正常，只是点了没反应，很难自己查出来
  • 现在已改成 prefix: —— 人设语料一个字都没动

另加一条兜底：插件启动时同步一次预设 —— 包里的预设变了就自动重灌，
没变就一个字都不动（你自己改过的预设不会被覆盖）。
以前预设只在你手动点设置里的开关时才刷新，所以"更新了包也修不好"，现在不会了。

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管。

不想用安装器也可以：下 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装。
上面两个链接永远指向最新版，想更新时重新下载再双击一次即可。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）—— 插件在启动时才装载
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，它会逐项告诉你卡在哪一层

已经装过旧版的人（更新步骤）

  1. 重新下载 install.cmd 双击一遍（或者重跑一次你当初那条 dsh plugin add 命令）
  2. 重启 DSH
  3. 就算完事 —— 预设会在启动时自动重灌成修好的版本，不用你手动做什么

万一还是不行：打开 设置 → Fairy，把人设预设那个开关关掉再打开一次（= 强制重灌），
然后 Ctrl + F5 硬刷新页面，再点「新建会话」。

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 392945 B1DA994C4CBD0A1E0648B91A8B7E88190236C9EC03BA8BE9F932C2F61FDCAD53
dsh-fairy-voice.tgz 67409 19CDB64A90BB4C246610897A7DB24DFF7E2FDB3DEBA08C861EC5B575AC243E2E
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 495.9 KB。

相对 v0.3.5，只有 dsh-fairy-visual 变了（0.1.6 → 0.1.7）；另外 4 个包与两个 install.cmd 字节未变（但仍照传，附件是整体替换的）。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • 有问题请提到本仓库 Issues 或交流群 1124349108
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
Loading

v0.3.5 —— 修两条误判 + 新增检查更新

v0.3.5 —— 修两条误判 + 新增检查更新

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 14 Sep 05:45
v0.3.5
a971b29

这一版修了两条"冤枉好人"的误判（都来自群友实报），外加大家问得最多的一个功能：检查更新。

🔴 修「消息识别」报了假案

以前自检第 7 项报"读不到会话的消息结构"时，一律说成"插件与 DSH 版本不匹配"，
让人以为是 DSH 升级搞坏的。真相往往不是 —— 是页面上的朗读客户端还是旧包（更新插件之后，页面还在跑旧脚本）。

现在会先分辨：

  • 诊断信息里缺 chatSource → 判定为你页面里的朗读客户端是旧版本，直接让你重启 DSH + 按 Ctrl+F5 强刷
  • 只有确认客户端是新包，才按原来的"适配问题"提示

📌 顺带说清一件事：设置页顶部那个「整理版」版本号来自视觉包，代表不了 dsh-fairy-voice ——
以后说"我装的是新版"时，看诊断里有没有 chatSource 才算数。

🟢 SoVITS 自检不再把 WebUI 当成"老版 api.py"

原来只看 /docs 一个响应码，404 就猜"可能是老版 api.py"。
实际最常见的真相是：GPT-SoVITS 整合包的「一键启动」跑的是 Gradio 网页界面（常见端口 9872），它本来就没有 /docs。

现在 404 时会再认一次，是 Gradio 就直说：

这个端口看着是 GPT-SoVITS 的网页界面（WebUI），不是朗读要用的推理接口 ——
另开一个窗口进 GPT-SoVITS 目录跑 runtime\python.exe api_v2.py（默认 9880），
再把「SoVITS 地址」改成 http://127.0.0.1:9880。别和 WebUI 同时开着，显存小的机器会爆。

🆕 新增：检查更新

设置 → Fairy 最顶上一行，平时是一行小灰字：

  • 正在检测更新…… → 已是最新版本（vX.Y.Z）· 打开仓库（可点，跳本仓库）
  • 连不上 GitHub 时：检测更新失败 —— 连不上 GitHub，可能需要代理。不影响 Fairy 的使用。
  • 真的查到新版本才变成红字：带下载链接 + 一条可直接复制的更新命令

检查走两条路、共用一份缓存（3 小时内不重复查）：
① 宿主启动后延迟 5 秒查一次；② 打开设置页时若缓存过期，由浏览器再查一次（走系统/梯子代理，成功率高），查到就写回宿主。

⚠️ 插件不能自己更新自己：这条只负责"告诉你有新版、怎么装"。
装就是双击一次 install.cmd（它永远指向最新版），或者复制红字里那条命令。

📋 「复制诊断信息」现在一次就够

以前诊断信息和结构摘要是两个框，要复制两次、发出去一大一小两段，看着乱还容易漏。
现在结构摘要会一起复制进去，点一次、粘一次就行 —— 面板底部那个只读框也直接删掉了。

📐 面板排版

  • 每个主标题都加了分隔线：通用 / Fairy 人设预设 / 朗读设置 / 朗读自检 / 语音简报 / 诊断信息
  • 新增「通用」小标题：给上游那块设置（启用 HDD 视觉 / 日间模式 / 显示主视觉 / 低功耗）补了标题
  • 「第 2 步」补上了复选框 —— 位置跟「第 1 步」完全一致，勾上 = 一键设为默认，取消 = 还原
    （原来那行是裸文字、顶到最左边，看着不平整 —— 不是显示 bug，是对齐问题）

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管 —— 它们只是给想手动安装的人备用。

想手动装：下那 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装。
两个安装器链接永远指向最新版，想更新时重新下载再双击一次即可。

📌 已经在用旧版的朋友：双击一次 install.cmd 就等于更新到本版（装完记得重启 DSH）。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，
    它会逐项告诉你卡在哪一层，并给出怎么修

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 391611 DC97C1A8D23C92E406239CF3AA268397950FE8BFA2DDA79DE97ACF4A33B86B74
dsh-fairy-voice.tgz 67409 19CDB64A90BB4C246610897A7DB24DFF7E2FDB3DEBA08C861EC5B575AC243E2E
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 508.3 KB。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
  • 检查更新只提示、不自动装（插件没法重装自己）
  • 有问题请提到本仓库 Issues
    或交流群 1124349108，请不要打扰上游作者
Loading

v0.3.4 —— 设置面板改进：引擎卡片可点选 + 未保存提醒

v0.3.4 —— 设置面板改进：引擎卡片可点选 + 未保存提醒

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 13 Sep 19:40
v0.3.4
2e17e3a

这一版全在设置面板上：引擎卡片能点了、改动没保存会红字提醒、选中 MOSS 时多一句音色提醒，自检的试合成也缩短了。

✨ 设置面板

  • 引擎卡片可以直接点 —— 「两个引擎各有所长」下面那两块，原来只能看，现在点一下就选中
    （和上面的下拉框完全同步；只改表单，仍要点「保存设置」才生效）
  • 改动没保存会红字提醒 —— 只要表单改过、还没点「保存设置」，
    「改完点『保存设置』才生效…」那句就变成红色粗体 ⚠；保存后自动变回灰色
  • 选中 MOSS 时多一句音色提醒 —— 土黄色一行，不加框：
    音色几乎完全由参考音频决定，请按 reference\README.txt 的要求放素材

⚡ 朗读自检变快

试合成那句从「语音自检，一二三四五，Fairy 朗读正常。」缩短成 「孤舟蓑笠」。
MOSS 在 CPU 上约 0.5 秒/字 —— 原来光等这句话就要十几秒，只为证明"能出声"不值得，四个字同样能证明链路通。

📄 参考音频说明重写（这条最值得看）

~/.dsh/fairy-voice/reference/README.txt 改成「怎么挑 / 怎么放 / 出问题先看这里」。核心是一句话：

念出来的音色，几乎完全由参考音频决定。它录成什么样，Fairy 就说成什么样。

这是实测出来的：参考音频的高频特质会被近乎 1:1 搬进合成结果 ——
参考干净，念出来就干净；参考带着降噪/压缩的痕迹，念出来就发毛、发沙。
所以文件里特别提醒：别用「降噪」「人声增强」处理过的音频。

⚠️ 这份 README.txt 只在首次创建参考音频目录时写入。已经用过插件的朋友不会自动更新 ——
想换成新版内容，把 ~/.dsh/fairy-voice/reference/README.txt 删掉再重启一次 DSH 即可重新生成。
你自己的 fairy_ref.wav 千万别删。

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管 —— 它们只是给想手动安装的人备用。

想手动装：下那 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装。
两个安装器链接永远指向最新版，想更新时重新下载再双击一次即可。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，
    它会逐项告诉你卡在哪一层，并给出怎么修

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 388532 A28A1AAB3173EAF044571EAB39C673DF054FF6813DC2008FA130F94CFA187306
dsh-fairy-voice.tgz 65507 1844EADF27D4ACDDA91044C58224A55291CF10724F736539A7F729590E865E1C
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 503.4 KB。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
  • 有问题请提到本仓库 Issues
    或交流群 1124349108，请不要打扰上游作者
Loading

v0.3.3 —— 紧急修复 v0.3.2 装完无法启动

v0.3.3 —— 紧急修复 v0.3.2 装完无法启动

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 13 Sep 18:34
v0.3.3
4e638da

这是紧急修包版：v0.3.2 装完之后一重启 DSH 就起不来，本版修的就是它。
已经装了 v0.3.2 但还没重启的人，请尽快更新 —— 你只要重启一次就会撞上。

🔴 本版修了什么

症状：装了 v0.3.2 之后重启 DSH，启动直接失败并打出：

Error: dsh: plugin tree failed to load: failed to apply loader entry
fairy-voice (dsh-fairy-voice): ensureFairyDirectories is not defined

原因：dsh-fairy-voice 启动时要建「参考音频」目录，但它调用那个函数时忘了把它导入。
语法完全正确，所以常规检查查不出来 —— 只有真正启动才会暴露。

影响范围：只有 v0.3.2。 v0.3.1 及更早版本没有这行调用，不受影响。

已经装了 v0.3.2 怎么办：直接用本版覆盖安装即可，不需要先卸载。

以下摘自0.3.2

v0.3.2 ——没有NVIDIA显卡也能朗读！

给朗读加了第二条路：没显卡也能用。 顺带把设置面板重做了一遍，修掉两个自检相关的 bug。

新增

  • MOSS-TTS-Nano 朗读引擎（CPU 实时，不用显卡）

    • 与 GPT-SoVITS 在 设置 → Fairy → 朗读设置 → 朗读引擎 里任意切换，改完即时生效、不用重启
    • 两个引擎各记各的地址，来回切换不丢；参考音频两份共用

  • MOSS 一键安装

    • tools/install-moss.ps1 —— 一条命令装完，6 个必踩的坑全写死；幂等，可重复运行
    • tools/moss-tts-server/server.py —— 自带服务端，绕开官方服务的 pynini 依赖（PyPI 上没有 Windows 轮子）
    • tools/moss-tts-server/verify.py —— 验证器：服务通不通 / 能不能真合成 / 音频格式对不对
    • docs/install-moss.md —— 给 AI Agent 的任务书（含失败判定表）
    • 设置面板里有 「复制安装说明」 按钮 —— 点一下复制好一段话，发给你的 AI Agent 即可

  • 回归测试 fairy-voice/test/moss-tts.test.js —— 10 个用例，全绿

改进

  • 设置面板重排为「先配置、后验证」：人设预设 → 朗读设置 → 朗读自检 → 语音简报 → 诊断信息
  • 「朗读设置」「朗读自检」改名，不再分不清哪个是哪个
  • 自检明细默认折叠，但结论行（✅/❌）常显 —— 不展开也知道好没好
  • 新增两个引擎的优缺点对照卡，当前生效的那个高亮
  • 去掉顶部与下方重复的大红框，待办拆进各自的区块

修复

  • 点「重新自检」会把没保存的引擎选择重置回 GPT-SoVITS
  • 引擎切成 MOSS 后，自检仍去测 SoVITS（现在跟着眼前填的设置走，不用先保存）

变更

  • 参考音频位置改为 ~/.dsh/fairy-voice/reference/fairy_ref.wav；插件启动时自动创建目录并附一份 README.txt
  • 旧位置保留兼容回退，老用户升级不会丢文件

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。

下面那 5 个 .tgz 不用管 —— 它们只是给想手动安装的人备用。

想手动装：下那 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装。
两个安装器链接永远指向最新版，想更新时重新下载再双击一次即可。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，
    它会逐项告诉你卡在哪一层，并给出怎么修

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 387385 11655E73899227D42E385678E743A0DF07B2C2D1ACE4A3A627C9820FAB589191
dsh-fairy-voice.tgz 65043 FA2637810BE970BB1D65A202B3959F5170720ADA870B877A5FD43157B9C337EB
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 488.1 KB。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机有一个 TTS 服务（GPT-SoVITS 或 MOSS-TTS-Nano），不装也能用其它部分
  • 有问题请提到本仓库 Issues
    或交流群 1124349108，请不要打扰上游作者
Loading

v0.3.2-deleted

v0.3.2-deleted

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 13 Sep 17:34
v0.3.2
5b91b65

❌ 此版本的包有严重缺陷，请不要安装

v0.3.2 的 dsh-fairy-voice 装完之后，一重启 DSH 就会启动失败：
ReferenceError: ensureFairyDirectories is not defined

修复版是 v0.3.3，
或者直接用最新版。

本页仅作存档保留 —— 请不要下载本页的附件。
本版的变更说明已经并入 v0.3.3 的正文，不再单独维护。

Loading

v0.3.1 —— 修复「消息识别」读不到消息

v0.3.1 —— 修复「消息识别」读不到消息

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 13 Sep 14:36
v0.3.1
1fb2ed2

v0.3.1 变更

这一版修的是「语音读不到消息」这个致命问题，另加一组诊断与提示改进。

🐞 修复：语音「消息识别」永远失败

症状 说明
设置 → Fairy 自检第 7 项永远 ❌ 「消息识别」判定不通过
朗读没有内容可读 自动朗读拿不到要念的文本
每条回复下方没有朗读按钮 同上（按钮只在能读到消息时才出现）

根因：DSH 0.1.2-rc.1 把聊天内容从 useSession 快照里拆了出去。
会话槽位（conversation.input.left）另外提供了 useChat / useConversation /
useProjection 等 hook，其中 useChat 返回的才是旧的 chat 结构
（order / nodes / timeline / legacy）；插件仍按 snapshot.chat 读，永远读空。

修复：读消息的适配层改用 useChat，并保留 snapshot.chat 回落 → 新旧 DSH 都能用。
朗读、合成、播放逻辑一行未改（改动均标注 [local patch 0.3.1]）。

🐞 修复：runningCalls 在新结构中消失

新 chat.legacy 只有 nodes / turnTimings / turnEnds / partial，
原来的 runningCalls（判断"正在跑工具"）没了，波形与阶段判断会变钝。
现改为双来源兜底：先走 legacy.runningCalls，取不到就扫 chat.nodes.byKey 中
status === 'running' 且 kind 含 tool 的节点。诊断字段 runningSource 会显示走的是哪条。

✨ 设置页底部：统一的「诊断信息（排查用）」

  • 结构摘要：只输出字段名 + 类型（最多两层），不含任何字段取值 / 对话内容
  • 文本框收窄到 380px；点「复制诊断信息」产生的文本也归到这一栏
  • 文案改准：原来写的「这里只有字段名与类型」并不成立（诊断信息里含本机路径与自检结果）

✨ 右下角语音异常提示

检测到「读不到会话消息」（即上面那个故障复发）时，右下角出现红色提示框，
带「稍后再说（静默 6 小时）」「不再提示（30 天）」；正常时不出现——
没装 GPT-SoVITS、或主动关掉 HDD 视觉模式都不会弹。

本版包版本

  • dsh-fairy-visual 0.1.1 → 0.1.2
  • dsh-fairy-voice 1.0.0 → 1.0.1

已装过的群友：重下 install.cmd 双击即可（永久地址永远拿最新版）。

📌 这是旧版本。当前最新是 v0.3.4 —— 去发布页。
下面三块是当初发这版时漏贴的，现在补上，方便翻历史的人看懂怎么装、怎么核对。

📦 下载哪个？

下载这个 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，有已知风险） ⚠️ 清楚后果、确实想要的人

下载后双击它，按屏幕上的中文提示走就行。下面那 5 个 .tgz 不用管。

⚠️ 但请注意：那两个安装器链接永远指向最新版。
想精确复现 v0.3.1 才用本页的 7 个附件；否则直接装最新的就好。

🚀 装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 打开最上面的「启用」开关
    （不开的话视觉和朗读都不出现 —— 这是设计如此，不是没装上）
  3. 想用朗读：设置 → Fairy → 朗读自检 → 点「开始自检」，
    它会逐项告诉你卡在哪一层，并给出怎么修

🔐 SHA256

文件 字节 SHA256
dsh-fairy-visual.tgz 383687 346C3EDBB7D935924FB9ABDC1C54AF8276DF35235392FF5A7E6F75C46C7859D7
dsh-fairy-voice.tgz 55061 8D688F89FD9AA9B25D0EC88750A519124F5081B458E7219B40D58C10FC436ABB
dsh-balance-meter.tgz 12791 454F6DE02A825A9C5D4CAF75E214660AB727AA6FB389A35B63660697B8A72693
dsh-fairy-startup.tgz 5018 EE3C28A3231194CF5670526DA5B85F05BA3B09D4228275D02DD6ED54B8AFF452
dsh-browser-dock.tgz 29592 03460446635A5F21DA3E4DBA11D83AF0EFA55564E288BDE1ECF2FCE5C29E4986
install.cmd 6619 B35B0FCEF3FF2A5319546C40BB89F6CBCE71D77560BFFAD29A54E6742D4AA55B
install_full.cmd 7470 5917A5D6917E38E4CA489A2B8B5A8FB78BFE70416D79F13D5CF275292D518B22

合计 488.5 KB。

前两个 SHA 是 2026-09-14 重新下载本页附件复算过的，与仓库记录一致。

⚠️ 说明

  • 本分支是非官方整理分支，上游作者没有参与本分支的任何改动
  • dsh-fairy-startup 每次启动会清空会话选择；dsh-browser-dock 会暴露控制 token —— 默认都不装
  • 朗读需要本机跑一个 TTS 服务；v0.3.1 这版只支持 GPT-SoVITS（MOSS-TTS-Nano 是 v0.3.2 才加的）
  • 有问题请提到本仓库 Issues
    或交流群 1124349108，请不要打扰上游作者
Loading

0.3.0

0.3.0

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 13 Sep 07:43
v0.3.0
785a116

我该下载哪个？

下载 装什么 给谁用
install.cmd 3 个：视觉浮层 + 朗读 + 余额 ✅ 推荐，绝大多数人用这个
install_full.cmd 全部 5 个（多装启动画面 + 截图 Dock，都有已知风险） ⚠️ 清楚后果、确实想要的人

下载完 双击，按屏幕上的中文提示走。

下面那 5 个 .tgz 是插件本体，普通用户不用管 —— install.cmd 会自动下载它们。
会敲命令的可以直接：

dsh plugin --profile web add https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/dsh-fairy-visual.tgz https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/dsh-fairy-voice.tgz https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/dsh-balance-meter.tgz

装完做什么

  1. 重启 DSH（关掉再打开）
  2. 设置 → Fairy → 把最上面的「启用」打开（不开的话视觉和朗读都不出现）
  3. 想用 Fairy 人设：同一页打开「Fairy 人设预设」

五个插件分别是什么

插件 干什么 建议
dsh-fairy-visual 宠物浮层、HDD 主题、界面重绘、设置面板 ✅ 推荐
dsh-fairy-voice 朗读回复（需本机跑 GPT-SoVITS） ✅ 可用
dsh-balance-meter 侧栏显示 DeepSeek 余额 ✅ 可用
dsh-fairy-startup 启动画面 ⚠️ 谨慎：每次启动清空会话选择
dsh-browser-dock 截图 Dock ❌ 不建议：控制 token 暴露、截图落盘

install.cmd 只装前 3 个；后两个要显式用 install_full.cmd。

非官方整理分支。 问题请提到 Issues 或交流群 1124349108，请不要打扰上游作者 橙汁本色。

Loading

整理版 v0.2.3

整理版 v0.2.3

Choose a tag to compare

View all tags
@Guzhou2002 Guzhou2002 released this 12 Sep 17:18
v0.2.3
95d0c28

Fairy-DSH 整理版 v0.2.3

基于 橙汁本色/Fairy-DSH main @ d639887 的优化分支。
构建来源：本仓库 main @ 95d0c28

下载哪个

附件用英文名（GitHub 会吞掉附件名里的中文），内容与 QQ 群里的中文名压缩包完全一致。

附件 对应群文件 给谁用
Fairy-DSH-v0.2.3-deploy-with-deps.zip Fairy-DSH-v0.2.3-一键部署版-含依赖.zip 发给群友 / 小白：自带依赖，解压即装，不需要 pnpm、不需要联网补依赖
Fairy-DSH-v0.2.3-lite.zip Fairy-DSH-v0.2.3-一键安装版.zip 自己用 / 网络通畅：体积小，首次安装需 pnpm 并联网补依赖

校验（SHA256）

D9077D6217D9AE5324DF46558A8F84AD9C482D7357AD68DE23581E656C513073  Fairy-DSH-v0.2.3-一键安装版.zip
19671848CD9218A7FECFD078D8BE7DC944286DA46F6FA6348CB5CBD43415DB57  Fairy-DSH-v0.2.3-一键部署版-含依赖.zip

安装

  1. 解压到任意目录（例如 C:\Fairy-DSH）
  2. 双击 install.cmd（或 install.ps1），按数字键选择要装的插件
  3. 重启 DSH，然后在浏览器里按 Ctrl+F5
  4. 打开 设置 → Fairy，按面板提示启用

详见包内 安装说明.txt。

本版主要改动

  • 朗读功能自检面板：7 项检查 + 逐项「怎么修」+ 一键复制诊断信息
  • SoVITS 地址与参考音频路径可配置，改完即时生效
  • Fairy 人设一键设为默认预设（含还原备份），设置栏顺序调整为人设优先
  • 首次使用醒目提示：设置页红色提示框 + 启动时设置图标红点
  • 修正：无备份时取消默认不再写空值；新增 HDD 视觉模式前置检查

归属

上游原创代码 Apache-2.0（见 LICENSE / NOTICE）。本分支作者：孤舟蓑笠。

⚠ 这是非官方分支，上游作者没有参与本分支的改动。
问题请提到本仓库 Issues 或进群（1124349108），不要打扰上游作者。

Loading