dsh-yukimi-theme

dsh-yukimi-theme

一个给 DeepSeek Harness（dsh）Web 界面和 Windows 桌面版用的佐城雪美（佐城雪美 / Yukimi Sajo）主题。

把页面配色、背景、侧栏和几个可交互的小部件，换成《偶像大师 灰姑娘女孩》角色佐城雪美的风格。

功能

• 背景卡面：背景插画清晰展示；仅消息和工具内容使用半透明阅读底板，保留浅色/深色适配。
• 聊天阅读与输入：历史正文和代码块使用轻透底板；输入卡片独立遮挡滚动内容，聚焦时显示柔和蓝紫光晕。
• 浮动小人：始终显示，不收进侧栏或弹窗；可拖动，单击翻转和台词，双击换装，长按打开小人/背景选择面板。
• 键盘互动：聚焦小人后 Enter/空格互动，菜单键打开设置，Escape 关闭设置。
• 浮动卡片和签名：保留原来的页面浮动展示；Mobamas 卡片默认关闭，可长按小人在选择面板中开启；开启后可拖动、自动轮播和点击切换。
• 按窗口空间自动隐藏：宽度小于 1100px 或高度小于 640px 时，只自动隐藏 Mobamas 卡片和签名；恢复大小后按原显示偏好恢复。小人只缩小，不隐藏、不重置服装。
• 保持聊天宽度：不再有装饰侧栏，不为组件预留额外列宽。
• 边界约束：小人拖动和窗口缩放后保持在屏幕内，设置面板限制在视口内。

阈值位于客户端的媒体查询及匹配的 CSS 中。Web profile 的显示偏好保留在当前页面，刷新后恢复默认值；Windows 桌宠的偏好保存到本地，并同步到桌面版页面。

安装

Windows 桌宠（desktop 分支）

桌宠由桌面 profile 的插件自动启动，使用独立透明置顶窗口。主窗口最小化或隐藏后继续显示；停用插件或退出 DSH 时关闭。启动成功后隐藏窗口内的小人，保留背景、签名和 Mobamas；辅助程序启动失败时保留窗口内的小人。

• 监听所有正在运行或保留等待状态的主会话，子代理不单独弹提醒。
• 正常完成、失败、取消按本轮结束分别提示；正常结束不表示整个项目已完成。
• 每个新提醒播放一次原单击翻转效果，使用模仿雪美语气的原创预设文案，没有声音。
• 会话提醒出现时自动将桌宠和气泡提升到其他窗口之上；气泡保留期间维护置顶，消失后恢复平时的层级，不抢键盘焦点。
• 询问和审批气泡直到相应请求处理完才消失；超时后仍可回答的问题继续保留。完成气泡显示约 5 秒，有等待气泡时排队，不重复播放动作。
• 点击气泡唤起 Harness 并通过 uiWorkspace.openSession() 定位对应会话；点击不会代替你作出回答或授权。
• 拖动可到达各显示器的四边和四角，按小人本身而非透明窗口计算边界；气泡和设置自动向有空间的一侧展开。记住小人的屏幕位置，双击换装，长按打开服装和主题设置；透明空白区域允许鼠标穿透。
• 启动后预加载全部小人服装，优先准备当前服装和下一套；换装前等待图片解码完成，加载慢或失败时保留原图，避免首次双击出现空白。

从本地源码构建，并通过 DSH 官方插件管理持久安装桌宠版：

npm install
npm run build:client
npm run check
npm test
npm run desktop:package
# 在「插件」页先关闭 dsh-yukimi-theme，避免运行中的文件被占用。
npm run desktop:install

安装脚本会验证完整 Electron 运行时，生成包含 lib/、desktop/ 及运行时的 .tgz，按内容哈希保存到 $DSH_HOME/yukimi-desktop/packages/，再调用 Desktop 自带 CLI 更新该 profile 的包依赖。请保留这个归档；后续依赖重装会从同一完整包恢复，而不是从 GitHub 默认分支恢复旧版。仅生成归档可运行 npm run desktop:install -- --bundle-only。整个过程不修改 Harness 程序文件。

CLI 更新同名包会保留包开关和内部条目状态，安装成功不代表条目已启用。安装后，在「插件」页开启包，并进入详情确认内部 yukimi-theme 条目也已启用。包总开关和内部条目开关相互独立；若内部条目被停用，反复切换包总开关不会解除它。随后在会话空闲时彻底退出并重新启动 DSH 桌面应用及其 Host 进程；Host 会缓存模块，关闭主窗口、切换插件开关或刷新页面可能仍使用旧版入口。

desktop:sync 保留为临时开发同步：停用插件后执行会备份并覆盖已安装文件，但不更新 profile 的依赖来源，因此后续包管理器重装可能覆盖这些修改。正式安装优先使用上面的 desktop:install。

源码安装不包含 Git 忽略的 Electron 二进制；需先打包，或使用包含 desktop/runtime/win32-x64/ 的完整插件包。npm run desktop:preview 是不调用模型的本地合成状态预览。手动回滚可在停用插件后运行 npm run desktop:sync -- --restore-backup <备份目录>，随后同样彻底退出并重启 DSH，以加载恢复后的 Host 模块。

桌宠位置、服装及提醒去重标识保存在 $DSH_HOME/yukimi-desktop/preferences.json。插件与辅助程序通过带随机握手的本机 Windows 命名管道通信；页面使用 DSH 自带的认证 Connection RPC，没有额外网络监听端口。状态只包含会话标识、标题和预设文字，不向桌宠转发聊天正文。预览使用独立的 build/preview-data/ 设置，不改变正式桌宠偏好。

Web 主题

用 dsh 自带的插件管理命令安装（包装好后会出现在「设置 → 插件」管理界面里）：

dsh plugin --profile web add github:AlyceStocking/dsh-yukimi-theme

停止已运行的 Web 服务，再启动：

dsh web

或 dsh --profile web。

不要用手动复制到 node_modules + 编辑 cordis.patch.yml 的方式安装：那样插件能运行，但因为不是 profile 的 pnpm 依赖，插件管理 UI 不会列出它，也无法在 UI 里启停或移除。 DSH_HOME 在 Windows 上默认是 C:\Users\<你>\.dsh。

开发与测试

仅迭代 Web profile 的页面样式时，可直接编辑 lib/client.js。共享素材在 lib/assets.js，编辑后运行 npm run build:client 同步客户端的生成区块。

npm run check 检查各入口语法及素材同步；npm test 检查阅读对比度、卸载清理、桌宠提醒队列、状态桥接、会话导航、偏好同步和窗口边界。

已安装的 Web profile 使用文件副本；仅更新浏览器样式和素材时，可将生成后的 lib/client.js 同步到该 profile 的插件目录，再刷新浏览器页面；若仍加载旧版客户端，停止并重启 dsh web 服务。

Windows 桌宠更新需按上面的「Windows 桌宠」流程重新构建、打包并同步完整插件。只复制 lib/client.js 不会更新 Host 状态桥接或辅助程序；同步后需要彻底退出并重启桌面应用及其 Host 进程。Web 与 Windows 桌宠的验证范围、结果及官方参考见 验证记录。

版权说明

• 代码：本仓库代码以 MIT License 开源，版权归作者（AlyceStocking）。
• 素材：佐城雪美这一角色、所有立绘 / 卡面 / 纸片小人 / 签名等美术素材，版权均归 Bandai Namco Entertainment / Cygames（《偶像大师 灰姑娘女孩》）所有。本主题只在线引用 imascg wiki 镜像的图片 URL，不打包、不分发任何官方素材文件。
• 本项目仅供个人学习与同好交流，请勿用于商业用途。

致谢

• 角色与素材来源：imascg wiki（萌娘百科镜像）
• 主题配色参考原 wiki 页面中标注的佐城雪美印象色 #171C8F。