前言¶
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。
