前言¶
DeepSeek Harness（DSH）的 Web 界面默認偏工具向：配色統一、佈局固定，長時間盯會話時缺少「換一換環境」的選項。社區裏也有單角色或試驗性主題，但維護分散，和桌寵、會話提醒往往各做各的。下面介紹維護者 AlyceStocking 的 dsh-cgss-idol-theme：面向《偶像大師 灰姑娘女孩》（CGSS）的多角色主題，在同一套插件裏提供 Web 頁面樣式、小人互動，以及在 Windows desktop profile 下的獨立桌寵與會話提醒。素材從 BWiki CDN 在線加載，需要網絡；插件在 DSH 進程權限下運行，安裝前建議自行查看倉庫源碼與許可證。
這是什麼¶
dsh-cgss-idol-theme 是 DSH 的客戶端主題插件，npm 包名與倉庫名一致，Cordis 內部條目爲 cgss-idol-theme。它由 Web 主題與可選的 Windows 桌寵組成：默認角色爲佐城雪美，可通過姓名或羅馬字搜索切換；倉庫由原 dsh-yukimi-theme 與 dsh-idol-theme 合併更名而來，不再是單獨雪美主題或雙角色試驗副本。分類上屬於社區目錄中的「趣味換裝」；展示頁見 alycestocking.github.io/dsh-cgss-idol-theme，目錄頁見 skillhub.cn 插件頁，源碼與說明在 GitHub。
核心功能¶
角色與素材覆蓋¶
角色目錄列出 190 位偶像，當前 188 位可選；向井拓海、村上巴因採集返回 HTTP 567 暫列「待收錄」。另有 8 套缺少配套圖標元數據的服裝被排除，細節見倉庫 research/roster/。可選角色側包含大量在線 URL：約 1,850 套服裝、7,400 張小人姿態圖、3,702 張 CGSS 背景；運行時實際有 1,843 套服裝的專屬臺詞池（資料給出的文本規模見 README）。印象色、簽名、Mobamas 卡片、貼紙與過場動畫按角色數據提供，並非每位角色都有貼紙或過場動畫。
Web 配色與閱讀¶
強調色和光暈跟隨角色印象色，適配淺色與深色主題。聊天內容、工具和部分管理頁使用半透明磨砂底板，歷史記錄上下漸隱，輸入卡片獨立遮擋滾動內容。寬度小於 1100px 或高度小於 640px 時自動隱藏卡片與簽名並縮小小人；另有沉浸模式下的顯示規則。
純背景模式：點擊聊天空白背景或按 Alt+I，臨時收起側欄、標題、輸入欄和歷史記錄；再點背景、向上滾輪或按 Esc 恢復。
沉浸閱讀模式：長按歷史區域 650 毫秒或按 Alt+Shift+I，收起側欄、標題與輸入欄但保留可滾動的歷史記錄；再次長按、再次按快捷鍵或 Esc 恢復。移動、滾動、改變文字選區會取消長按；按鈕、鏈接、輸入控件及寬表格不觸發此長按。
1.3.4 起修復思考時空白小框與新會話頂部半透明空欄，保留狀態提示與佈局按鈕，兼容淺/深色與寬/窄屏（見倉庫 docs/empty-surfaces-validation.md）。
小人互動與臺詞¶
拖動、單擊翻轉並顯示臺詞、雙擊換裝、長按打開角色/服裝/背景選擇。聚焦後可用 Enter/空格互動、菜單鍵打開設置、Escape 關閉設置。點擊臺詞優先抽取當前服裝的中文譯文，再回退公共臺詞或佔位；各池使用洗牌隊列，避免相鄰兩輪首尾重複。啓動按本機時間問候，切換角色使用「體力已滿」場景。沒有語音播放，也不是模型生成的對話。
Web 小人約每 5 秒檢查：距上次自動臺詞至少 10 分鐘且頁面最近 30 秒有鼠標/鍵盤活動時觸發；30% 使用「體力已滿」場景臺詞。
偶像查詢與收藏（1.3.2）¶
Web 面板與 Windows 桌寵均使用單個可搜索下拉框，輸入姓名或羅馬字篩選。旁側五角星收藏當前偶像；已收藏爲橙色實心星，下拉列表中收藏角色帶星並優先排列。支持方向鍵、Enter 與 Escape。收藏保存在各自本地存儲，Web 與桌寵之間不共享。
Windows 桌寵¶
獨立桌寵僅在 Windows 的 desktop profile 啓動；普通 Web profile 不啓動桌面輔助程序。透明窗口可在 DSH 主窗口最小化或隱藏後繼續顯示；桌寵就緒後隱藏頁面內小人，啓動失敗則保留頁面內小人。
桌寵監聽主會話（含等待中的請求），不爲子代理單獨彈提醒；提醒區分正常結束、失敗、中止、需要回答和需要審批，使用當前角色場景臺詞。點擊氣泡喚起 Harness 並定位會話，不會自動回答或批准。支持跨顯示器拖動、邊界約束與透明區域鼠標穿透；位置與設置面板位置獨立保存。偏好寫入 $DSH_HOME/idol-desktop/preferences.json 並同步到同一 desktop profile 的頁面；普通 Web 頁主題偏好刷新後恢復默認，偶像收藏在本地存儲中不隨刷新清空。
Host 與輔助程序通過帶隨機握手的本機命名管道通信，頁面使用 DSH 認證 RPC；傳給桌寵的是會話標識、標題、狀態和預設臺詞，不包含聊天正文。1.3.3 修復 Electron Host 將有效獨立運行時誤判爲未安裝的問題；有效 Electron 44.5.1 緩存可複用，更新後需完整重啓 Host。
安裝與啓用¶
插件以當前 DSH 進程權限運行；請勿同時啓用舊的 dsh-yukimi-theme 或 dsh-idol-theme，它們與新包共用部分 RPC、樣式和存儲。遷移前在會話空閒時操作，並備份桌寵偏好；dsh-idol-theme 的 idol-desktop 目錄可沿用，原雪美版 yukimi-desktop 不會自動搬遷。
輕量 npm 包（當前資料版本 1.3.4）含全部 Web 與桌寵代碼，不含 Electron 二進制；Web 用戶無需安裝桌寵運行時，Windows x64 桌寵用戶需在安裝插件後顯式安裝運行時。沒有 postinstall，插件啓動也不會自動下載 Electron。
按 profile 二選一，desktop 側請使用 DSH Desktop 自帶 CLI：
# Web 主題
dsh plugin --profile web add dsh-cgss-idol-theme@1.3.4
# Windows 桌寵（還需下一步安裝運行時）
dsh plugin --profile desktop add dsh-cgss-idol-theme@1.3.4
npm 不可用時，可安裝 GitHub 上的 Web 主題（倉庫已提交瀏覽器 JS 產物，無需再 prepare）：
dsh plugin --profile web add github:AlyceStocking/dsh-cgss-idol-theme
固定版本可在地址後加 #<提交 SHA>。請使用官方插件管理命令或管理頁安裝，不要手動複製到 node_modules 再手寫 patch。
移除已安裝舊包（未安裝則不必執行）：
dsh plugin --profile web remove dsh-yukimi-theme
dsh plugin --profile web remove dsh-idol-theme
安裝後確認新包總開關與內部 cgss-idol-theme 條目均啓用，再完整重啓對應的 DSH 服務或桌面應用及 Host；Web 側停止舊服務後運行 dsh web 並刷新頁面。
Windows 桌寵運行時（輕量包）¶
在 Windows x64 上需 Node.js 22.12.0 或以上及 npm，顯式執行：
npx --yes --package=dsh-cgss-idol-theme@1.3.4 dsh-cgss-idol-runtime install
npx --yes --package=dsh-cgss-idol-theme@1.3.4 dsh-cgss-idol-runtime status
自定義 DSH_HOME 時，install 與 status 必須指向同一目錄，例如：
npx --yes --package=dsh-cgss-idol-theme@1.3.4 dsh-cgss-idol-runtime install --dsh-home "D:\DSHData"
npx --yes --package=dsh-cgss-idol-theme@1.3.4 dsh-cgss-idol-runtime status --dsh-home "D:\DSHData"
運行時固定爲 Electron 44.5.1 / Windows x64，保存在 $DSH_HOME/idol-desktop/runtimes/electron-44.5.1-win32-x64/（默認 DSH_HOME 爲 ~/.dsh）。status 確認後完整重啓 DSH Desktop 與 Host。
也可安裝 GitHub Release v1.3.0 的預構建完整包（已含運行時，無需再執行上述 runtime 命令）：
dsh plugin --profile desktop add "https://github.com/AlyceStocking/dsh-cgss-idol-theme/releases/download/v1.3.0/dsh-cgss-idol-theme-1.3.0.tgz"
npm 頁面以 registry 與 npmjs.com 爲準；若指定版本 404，優先 GitHub 安裝方式。
典型用法¶
- 安裝並啓用插件後，在 Web 或桌寵設置中搜索偶像姓名或羅馬字，切換角色與服裝；雙擊小人換裝，長按打開角色/服裝/背景選擇。
- 需要少干擾看歷史時：長按歷史區進入沉浸閱讀，或
Alt+Shift+I；需要幾乎只看背景時：Alt+I純背景模式。 - 常用角色點下拉旁五角星收藏；下次打開列表裏收藏項優先顯示。
- Windows desktop 用戶：桌寵在後臺顯示會話狀態；需要處理時在氣泡提醒後點擊喚起 Harness 定位會話，自行回答或審批。
適用場景與注意¶
適合長期在 DSH Web 或 Windows 桌面 Host 上工作、希望用 CGSS 角色印象色與小人互動調節閱讀體驗的用戶。桌寵與 Web 小人功能重疊但存儲分離，收藏與部分偏好不互通。
圖片依賴 BWiki CDN，離線或 CDN 不可用時小人/背景可能無法加載。插件不屬於 DeepSeek 或幻方官方產品；社區目錄 SkillHub 爲獨立站點。輕量 npm 包體積小不等於桌寵總佔用小：首次使用桌寵仍需下載約幾百 MB 的 Electron 緩存。
結尾¶
dsh-cgss-idol-theme 把 CGSS 多角色 Web 主題、沉浸閱讀快捷鍵、臺詞與小人與 Windows 會話提醒收進一個 DSH 插件；Web 用戶可只裝輕量包，Windows 桌寵用戶再按需安裝運行時或 v1.3.0 完整包。進一步說明與英文 README 見 GitHub 倉庫，插件目錄頁見 SkillHub。
