Fairy-DSH-Optimized

Fairy-DSH

给 DSH 加一只看着您的 Fairy —— 浮层、HDD 视觉主题、朗读（可以不依赖显卡！）、余额、截图 Dock。

> 🔗 上游血缘：本项目整理自 [橙汁本色](https://github.com/Chengzhibense/Fairy-DSH) 的 Fairy-DSH，

> 是它的分支优化版（对外叫 孤舟版）—— 在橙汁的代码上做分发：一条命令装完、出问题能自己查。

> 🤝 友情链接 · 生态里的三家（同一个源头，各干一段，别装重）

>

> | 谁 | 仓库 | 是什么 |

> | --- | --- | --- |

> | 🍊 橙汁本色（原作者） | [Chengzhibense/Fairy-DSH](https://github.com/Chengzhibense/Fairy-DSH) | 上游原始仓库。作者的最终目标是独立的 Electron 桌宠应用，这里是他的开发仓库，不含安装器、外人装不上 |

> | ⛵ 孤舟版（本仓库） | [Guzhou2002/Fairy-DSH-Optimized](https://github.com/Guzhou2002/Fairy-DSH-Optimized) | 在橙汁代码上做分发与排障：install.cmd 一条命令、Release + SHA256、朗读自检面板、面向新手的文档 |

> | ☁️ 云朵版 | [addsas222/Fairy-DSH-Exp](https://github.com/addsas222/Fairy-DSH-Exp) | 另一套独立分发的功能深度实验版：人格包引擎、多会话模式、搜索枢纽、长期记忆、角色扮演+去 AI 味、多 TTS 引擎与语音输入 |

>

> ⚠️ 孤舟版与云朵版没有代码血缘、互不同步，而且装的东西会互相覆盖 —— 只装一个。

> 想折腾功能面，可以去看看云朵版；想装上就能用、出问题能自己查，留在这儿。

> ⚠️ 这是非官方整理分支。

> 基于 [橙汁本色](https://github.com/Chengzhibense/Fairy-DSH) 的 Fairy-DSH 源代码整理而成，

> 上游原创代码按 Apache-2.0 发布。本分支只做安装分发和少量本地增强。

>

> **有问题请提到[本仓库 Issues](https://github.com/Guzhou2002/Fairy-DSH-Optimized/issues)

> 或交流群 1124349108，请不要打扰上游作者。**

> 📌 当前版本 v0.3.8 —— 版本号见仓库根 [VERSION](VERSION)；

> [发布页](https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest) ·

> 本版修了什么见 [RELEASE-NOTES.md](RELEASE-NOTES.md)

---

装起来

🤖 让 Agent 帮你装

把下面这段话丢给你的 DSH Agent：

> 从 https://github.com/Guzhou2002/Fairy-DSH-Optimized 安装 dsh-fairy-visual 和

> dsh-balance-meter和dsh-fairy-voice 到我的 web profile，不要装 dsh-fairy-startup 和 dsh-browser-dock。

> 更完整的说明见 [AGENTS.md](AGENTS.md)。

> 装完执行 dsh --profile web --dump-config 确认已经挂载。

🟢 完全不懂技术 → 下载、双击

| 下载这个 | 干什么 | 给谁用 |

| --- | --- | --- |

| [install.cmd](https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/install.cmd) | 装 3 个：视觉浮层 + 朗读 + 余额 | ✅ 推荐，绝大多数人用这个 |

| [install_full.cmd](https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/install_full.cmd) | 装全部 5 个（多装启动画面 + 截图 Dock，有已知风险） | ⚠️ 清楚后果、确实想要的人 |

| [uninstall.cmd](https://github.com/Guzhou2002/Fairy-DSH-Optimized/releases/latest/download/uninstall.cmd) | 卸：卸掉插件与预设，并把你改过的「默认预设」还原回去 | 🧹 不用了、想清干净的人 |

📦 即装即卸

• 装（推荐）：下 install.cmd，双击 —— 自动装 3 个安全插件（视觉浮层 / 朗读 / 余额）
• 装全部 5 个：下 install_full.cmd，双击（装前会先把风险讲清楚并要求确认）
• 卸：下 uninstall.cmd，双击 —— ⚠️ uninstall.ps1 要一起下，两个放同一个文件夹里（那个 .cmd 只是启动器，真正的逻辑在 .ps1 里）
• 不想用安装器：直接下 5 个 .tgz，用 dsh plugin --profile web add <文件路径> 装

下载完 双击它，按屏幕上的中文提示走就行。缺什么它会自己装、自己说人话，失败了也会告诉你卡在哪一步、该怎么办。

> 🔒 卸载不删你的数据：参考音频、朗读设置、语音简报的 API Key 都在 ~/.dsh/fairy-voice/，

> 卸载脚本一个字节都不动 —— 要彻底清干净，脚本会在最后把这个路径打给你，删不删由你自己决定。

> 💡 这几个链接永远指向最新版 —— 收藏起来，想更新时重新下载再双击一次就行。

>

> ⚠️ 如果你是从 Releases 页面进来的，会看到一堆 .tgz 文件 ——

> 那些不用管，只需要下载里面的 install.cmd（或 install_full.cmd）；卸载则用 uninstall.cmd + uninstall.ps1。

🟡 会敲命令 → 一条就够

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

> 用的是别的 profile？把 web 换成你的 profile 名。

> 想装某几个而不是全部？把不要的那几行 URL 删掉。

---

⚠️ 装之前先看这张表

| 插件 | 干什么 | 建议 |

| --- | --- | --- |

| dsh-fairy-visual | 核心。宠物浮层、HDD 主题、界面重绘、设置里的 Fairy 面板 | ✅ 推荐 |