前言¶

DeepSeek Harness（DSH）的 Web 界面默认是通用开发者工具风格。若你长期在本地跑智能体、又希望桌面壳有一点《绝区零》Fairy 终端的代入感，社区里已有把 H.D.D 开机动画、眼徽与问候语接进 DSH 的皮肤类插件；原版实现里常驻 requestAnimationFrame 驱动动效，在侧栏待机时主线程占用偏高，首屏静态资源体积也较大。SkyWingDN/dsh-fairy-zzz 是在上游开源作品基础上的第三方修改版（非官方），在保留 H.D.D 体验的前提下做性能与资源压缩，并补充用量气泡、眼徽拖拽、欢迎页文案与可选本地朗读等能力。下面介绍它是什么、能做什么，以及如何安装与使用。

这是什么¶

dsh-fairy-zzz（当前版本 v1.6.2）由维护者 SkyWingDN 发布，在 SkillHub 社区目录中归类为「趣味换装」。插件把 DSH Web UI 包装成 Fairy 的 H.D.D 终端：全屏开机动画 → 居中时段问候 → 眼徽收拢到会话区左缘常驻，并替换侧栏与欢迎页上的品牌位。代码基础来自 AssassinVIX/fairy-zzz-plugin（MIT），眼徽 SVG 与眼睑 / 呼吸 / 故障动效几何来自 Chengzhibense/Fairy-DSH（Apache-2.0）；开机视频与角色形象版权归 miHoYo / HoYoverse，README 明确仅限个人桌面改造，请勿商用或二次分发素材。本仓库不包含 GPT-SoVITS 模型或推理引擎，回复朗读需自行部署引擎。

与只想用上游原版的情况相比，本修改版的主线是：去掉常驻 rAF 主循环、压缩首屏资源（README 称运行时下载约从 9.0 MB 降到 2.9 MB）、把思考态眼睑改为静态半闭，并在 v1.3.0 起增加宿主路由 GET /fairy-zzz/usage 供「电费」口径的用量气泡使用。

核心功能¶

开机、问候与常驻眼徽¶

1. 开机动画：播放 H.D.D 启动片（带片源自带启动音效；浏览器若拦截有声自动播放，会先静音并提示点击开启）。
2. 居中问好：动画结束后淡入眼徽与 HOLLOW DEEP DIVE SYSTEM 标题，按凌晨 / 上午 / 中午 / 下午 / 傍晚 / 深夜六个时段播放问候；v1.4.0 起每个时段 5 条预录 mp3（共 25 条），随机播放且不连续重复同一条。
3. 收成眼徽：问候结束约 1.9s 后，眼徽飞到会话区左缘中线（侧栏右侧蓝圈内）常驻，作为状态指示与交互入口。

眼徽动效在 v1.6.0 采用单 SVG + 15fps ticker 写 transform，配合 CSS steps() 时间线驱动光晕等大面积层；思考 / 工作期间眼睑保持静态半闭。页面隐藏时会冻结动画；插件不随系统「减少动态效果」降级。

主题与品牌位¶

深蓝玻璃、青蓝霓虹 token、网格与扫描线壁纸、H.D.D 风格滚动条。隐藏官方 SVG 字标并在原位置叠加 Fairy 眼徽与斜体 Fairy 字标；v1.1.1 起还接管欢迎页 conversation.hero.brand.mark，把新会话页标题左侧的 DeepSeek 鲸鱼 logo 换成同一眼标。外观不再提供三档手动切换（v1.6.2）：始终自动跟随 DSH 深色 / 浅色主题。

电费气泡与拖拽（v1.3.x 起）¶

• 点击眼徽：弹出「电费余额 / 今日电费 / 电费倍率倒计时」气泡（谷时文案「五倍电费」、峰时「十倍电费」；每轮回答结束还会自动弹出本轮结算，18s 自动关闭）。数据由宿主 GET /fairy-zzz/usage 增量解析会话日志得到；dock 后 700ms 预取，点开即显。点气泡外或按 Esc 关闭。
• 按住拖动：只写眼徽自身 transform，限制在会话内容区内，松手距边缘 64px 内四边吸附；位置可持久化。设置里可关闭拖动、隐藏眼徽或复位。若与更高 z-index 的挂件（如鲸鱼 widget）重叠，会沿吸附边让位。

语音（可选）¶

开场问候仅依赖仓库内预录 mp3，不需要引擎。助手回复的自动朗读或单条朗读按钮，需本地 GPT-SoVITS（CPU 推理），由宿主通过 /fairy-zzz/tts、/fairy-zzz/engine 等路由与外部 fairy_server.py 协作。默认引擎端口 FAIRY_TTS_PORT=9800，合成缓存目录默认 <插件目录>/cache。

性能（修改版重点）¶

README 在 headless Chrome 10s 稳态下对比上游：侧栏待机主线程约 31.2% → 1.8%，模型思考中约 30.9% → 1.6%，问候页待机约 41.1% → 2.5%；v1.2.0 用户实测 dock 待机 GPU 引擎平均约 43.1% → 5.1%（约 −88%）。归因说明与复测方法见仓库 docs/PERFORMANCE.md。

安装与启用¶

需要已安装 DeepSeek Harness；插件在运行时调用宿主槽位与 webServer，不直接 import @deepseek-ai/*。

方式一：让 agent 装（README 推荐）

先取得本仓库源码目录（例如按 README 从 GitHub 获取 SkyWingDN/dsh-fairy-zzz），再在 DSH 会话中执行：

plugin_manager install_bundle  target=<克隆下来的目录>

方式二：手动合并 patch

将仓库根目录 cordis.patch.yml 中的 insert 段合并进 profile patch（Windows 一般为 %USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml）：

- insert:
    - id: fairy-zzz-skin
      name: 'dsh-fairy-zzz'

方式三：Windows 一键脚本

在仓库根目录执行：

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1            # 装
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 -Uninstall  # 卸

脚本会查找 profile、将插件放入 node_modules\dsh-fairy-zzz 并补 patch；若不希望脚本改文件，用方式一或二。

装好后整页刷新一次；涉及宿主新路由（如 /usage）的版本需完全重启 DSH。皮肤仅「插入一行插件注册 + 宿主侧若干本地 HTTP 路由」，不修改 DSH 自带文件。

典型用法¶

设置面板¶

打开 DSH 设置 → Fairy，常用项包括：

1. 自动朗读回复：回答完成后自动合成语音；关闭后仍可对单条消息点朗读。
2. 语音引擎目录：填写含 fairy_server.py、GPT-SoVITS/、models/ 的目录 → 保存（写入 <插件目录>/voice-home.txt）或 检测 / 清除。
3. 启动引擎 / 停止引擎：由宿主托管外部引擎进程；加载约 20s，完成前面板显示「启动中」。
4. 试听问候：每次点击从当前时段 5 条问候中重新随机一条并显示台词（v1.6.2）。
5. 拖动眼徽 / 显示眼徽 / 复位位置：控制交互与布局。

引擎目录查找顺序（用户指定优先）：voice-home.txt 保存路径 → 环境变量 FAIRY_VOICE_HOME → 插件同级 voice/ → 兼容旧变量 FAIRY_TTS_DIR。均未配置时皮肤与问候 mp3 仍可用，面板会提示指定目录。

查看眼徽状态（诊断）¶

宿主提供只读路由，例如 GET /fairy-zzz/mood 返回 idle / thinking / working / done（由宿主 agents 注册表驱动）；加 ?diag=1 可返回诊断信息。完整路由表见 README「路由」一节。

可选 Agent 预设¶

仓库内 presets/fairy-mode.patch.yml 为可选「Fairy 模式」预设，依赖较多 @deepseek-ai/dsh-* 插件，默认未写入主 patch；需按文件说明自行追加到 profile 并确认当前 DSH 版本具备所列插件。

适用场景与注意¶

适合：长期在 DSH 里做智能体开发、想要绝区零 Fairy H.D.D 视觉与问候 ritual，又在意侧栏待机 CPU/GPU 占用；需要时在本地接 GPT-SoVITS 朗读回复。

不适合或需知：

• 寻求官方或米哈游授权产品：本插件为社区第三方修改，与 DeepSeek、幻方、HoYoverse 无从属关系；SkillHub 目录为独立社区站点，不是官方应用商店。
• 插件以当前 DSH 进程权限运行，安装前应阅读 GitHub 源码 与 LICENSE / NOTICE-fairy-dsh.md，确认可接受 MIT（修改部分）及上游许可条款。
• 品牌位实现为「隐藏官方内联 SVG + 同位置叠加」，非宿主原生槽位替换；官方 DOM 变更可能需要跟进选择器。
• 桌面壳窗口标题、菜单、侧栏条目文案插件无法修改。
• 与其它占据角落的插件同时启用时可能争用空间；语音引擎、模型权重需自行部署，仓库不提供下载。

排错时可对照 README「排错」表：例如气泡一直显示「—」多为旧版 index.js 无 /usage，需重启 DSH；问候能播但回复不念，多为引擎未就绪。

结尾¶

dsh-fairy-zzz 把 DSH Web 界面做成 Fairy H.D.D 终端体验，并在 SkyWingDN 修改版里把性能与资源体积作为一等公民，同时补上电费口径用量气泡、可拖拽眼徽、主题随宿主切换与可选 GPT-SoVITS 朗读。若要在社区目录浏览元信息，可打开 SkillHub 插件页；安装、配置与性能细节以 GitHub 仓库 README 为准。