前言¶
DeepSeek Harness（dsh）的理念是「一切皆插件」，Web 客戶端的外觀和交互都可以由插件擴展。默認界面穩定夠用，但如果你每天要在瀏覽器里長時間使用它，難免想換一套更合自己口味的視覺；另外 API 餘額信息也不在客戶端界面裏，想確認餘額通常得另開頁面。
這類需求可以自己寫插件解決，但要同時處理主題注入、交互狀態和主機端 RPC，細節不少。下面介紹的 dsh-blue-archive-shiroko 把這些做成了現成的安裝包：裝上就能得到一套蔚藍檔案風格的主題、一個可互動的白子桌寵，以及順手可查的 DeepSeek API 餘額。
這是什麼¶
dsh-blue-archive-shiroko 是由 mldhao 維護的 DSH Web 客戶端主題插件，當前版本 0.6.0，源代碼採用 MIT 許可證。一句話定位：面向 DeepSeek Harness（dsh）Web 客戶端的蔚藍檔案風格非官方同人主題插件，含白子桌寵、Codex 風格短句氣泡、撫摸互動與 DeepSeek API 餘額查詢。
需要先說明的是，這是非官方同人作品，與 NEXON Games、NEXON、Yostar、《蔚藍檔案 / Blue Archive》或 OpenAI 無隸屬、授權或合作關係。角色名稱、角色形象及用戶提供的圖片不包含在 MIT 授權範圍內，發佈或再分發前請確認素材使用權，細節見倉庫中的 ASSET_NOTICE.md。
核心功能¶
蔚藍檔案風格 UI¶
主題以學院藍和青色高光爲主，配白色磨砂面板與戰術網格背景，適配 DSH 的側欄、消息、輸入區、按鈕、代碼塊和設置界面。也就是說裝完後整個客戶端是同一套視覺，而不是隻有聊天區換色。
白子桌寵¶
桌寵支持拖動、縮放、隱藏、位置復位和動畫開關。空閒時會自主切換打招呼、觀察、伸展、好奇等互動，默認開啓，頁面空閒約 12–25 秒後觸發；任務執行、菜單打開或頁面隱藏時會暫停。各項設置保存在當前瀏覽器的 localStorage 中。
安全餘額查詢¶
短按桌寵即可查詢餘額。實現方式是插件主機端讀取 DSH 已配置的 DEEPSEEK_API_KEY，調用 DeepSeek 官方 https://api.deepseek.com/user/balance 接口，顯示幣種與可用餘額，低餘額警告閾值可在設置中調整。
密鑰不會進入瀏覽器或 localStorage；餘額 RPC 僅允許運行 DSH 的本機（迴環地址）頁面調用，局域網遠程頁面會被拒絕。另外，自定義 OpenAI 兼容代理通常不提供 DeepSeek 官方餘額接口，餘額查詢默認僅支持 DeepSeek 官方 API。
Codex 風格短句氣泡¶
插件讀取當前對話中的助手輸出並拆分爲短句，支持流式同步、逐字顯示、閃動光標和完成後輪播，最多保留最近 8 個短句。「Codex 風格」指的只是短句、逐字顯示與狀態提示的交互方式，沒有複製官方寵物圖片、語音或音效。
撫摸互動、音效與設置界面¶
按住角色頭部約 420ms 觸發撫摸互動，包含點頭、粉色光圈、上浮愛心和專屬臺詞；拖動超過 8px 會取消，避免誤觸。音效包含角色點擊音、助手回覆完成音和低餘額警告音，警告音有 60 秒冷卻，可在設置中關閉。設置界面在桌面端完整居中顯示，窄屏自動切換橫向標籤佈局，並尊重 prefers-reduced-motion。
安裝與啓用¶
環境要求：已安裝並可正常運行的 DeepSeek Harness / dsh，已啓用 DSH Web 客戶端；查詢餘額需配置有效的 DEEPSEEK_API_KEY；瀏覽器使用 Chromium、Chrome、Edge 等現代瀏覽器。
推薦從 GitHub 的 Releases 頁面下載 dsh-blue-archive-shiroko-0.6.0.tgz，然後執行安裝命令，路徑替換爲你的實際下載位置：
dsh plugin --profile web add "C:\path\to\dsh-blue-archive-shiroko-0.6.0.tgz"
安裝完成後需要完全重啓 DSH Web，再按 Ctrl+F5 強制刷新。僅刷新頁面不夠，0.6.0 的主機端 RPC 需要重啓才能生效。
如果想直接在源碼上調試，可以從源碼目錄安裝：
git clone https://github.com/mldhao/dsh-blue-archive-shiroko.git
cd dsh-blue-archive-shiroko
dsh plugin --profile web add "$PWD"
重啓 DSH Web 後刷新頁面即可，目錄裏的修改通常可在重啓或刷新後直接驗證。安裝後用下面的命令確認插件已出現在 web profile 的插件列表中：
dsh plugin --profile web list
日常使用¶
交互都集中在桌寵身上：
1、短按角色：播放點擊音並查詢 DeepSeek API 餘額。
2、按住頭部：約 420ms 後觸發撫摸效果。
3、拖動角色：移動超過 8px 進入拖動，不會誤觸餘額查詢或撫摸，位置自動保存。
4、點擊齒輪按鈕：打開或關閉快速麪板，面板裏可立即觸發一次自主互動。
5、桌寵離開可視區域時，在設置中點擊「恢復桌寵位置」。
白子主題設置裏可以控制桌寵顯示、對話同步、桌寵音效、低餘額閾值、動畫、自主互動和縮放，也可以手動查詢餘額。想自定義外觀的話，主題色與 DSH token 在 lib/client.js 的 TOKENS；桌寵圖片是 assets/shiroko-custom.webp，更換後需同步更新 lib/client.js 中的 PET_IMAGE，否則運行中的插件仍會顯示舊圖。
本地預覽與開發¶
倉庫提供不依賴 DSH 的靜態視覺預覽。在倉庫目錄下啓動一個本地靜態服務：
cd dsh-blue-archive-shiroko
python -m http.server 4173
瀏覽器訪問 http://127.0.0.1:4173/preview/，預覽頁面可以切換桌寵狀態並拖動角色。
開發和打包用三個命令：npm run check 做語法檢查，npm test 跑餘額解析和憑據邊界測試，npm run pack:release 生成安裝包到 dist/。
npm run check
npm test
npm run pack:release
適用場景與注意事項¶
適合想要個性化 DSH Web 客戶端、喜歡蔚藍檔案題材，同時希望順手看到 DeepSeek API 餘額的個人用戶。使用前有幾點需要留意：
1、插件以當前 dsh 進程的權限運行，主機端可以讀取 DSH 已配置的 DEEPSEEK_API_KEY。安裝前建議檢查源碼與許可證：源代碼是 MIT，但角色名稱與形象素材不在 MIT 授權範圍內。
2、對話同步依賴 DSH 當前的 DOM 結構，例如 [data-chat-flow-kind="assistant-step"] 和停止按鈕的 aria-label，DSH 大幅更新後可能需要調整選擇器。
3、瀏覽器未授權音頻播放、頁面處於後臺或系統限制 Web Audio 時，點擊、完成和警告音可能靜默跳過。
4、卸載相關的移除命令在不同 DSH 版本間可能有差異，執行 dsh plugin --help 和 dsh plugin --profile web --help 可以查看當前 CLI 支持的參數。
小結¶
這個插件把換膚和實用功能放在了一起：主題負責視覺，桌寵負責互動，餘額查詢解決實際的信息需求，安全邊界（密鑰不進瀏覽器、RPC 限迴環）也有明確設計。如果你在用 DSH Web 客戶端，裝上試一試的成本不高，不合口味卸掉即可。項目主頁與收錄頁面：
- GitHub：https://github.com/mldhao/dsh-blue-archive-shiroko
- 社區目錄：https://www.skillhub.cn/plugins/mldhao/dsh-blue-archive-shiroko
