前言¶

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 爲準。