前言¶
在 DSH 插件方式里，界面外观调整也可以做成可安装、可卸载的客户端层。对 DSH Web 使用者来说，一个具体诉求是：想要一组更稳的 light/dark 视觉值，同时保留自己的 light、dark 或 system 偏好，并且卸载后能恢复到原有主题。
ui-song-theme 就是围绕这个位置做的插件：它为 DeepSeek Harness 提供 Song-inspired 的 light 与 dark 主题层。
这是什么¶
ui-song-theme 由 yunfei07 维护，包名为 ui-song-theme，许可证为 MIT。
一句话定位：它是 DeepSeek Harness 的 Song-inspired light and dark theme plugin。它主要解决“叠加一层可回退的主题 token，而不是直接改基础主题”的问题。
核心功能¶
- 提供可逆的
ThemeRuntime.overrideTokens()层，包含完整的 light 与 dark 值。 - 保留用户的
light、dark或system偏好。 - 将可见的 legacy blue selections 和 browser focus outline 重绘到同一 botanical color family。
- 卸载插件时只移除插件自己的层，并恢复下面的主题。
安装与启用¶
安装前，先确认运行环境满足以下要求：
- Node.js
^22.19.0或>=24.0.0 - DeepSeek Harness UI theme
>=0.1.0-rc.6 <0.2.0 - Peer dependencies 包含
@deepseek-ai/cordis ^4.0.1和@deepseek-ai/dsh-client-ui-theme >=0.1.0-rc.6 <0.2.0
下面把插件安装到 Web profile。执行这条命令后，ui-song-theme 会作为主题层加入该 profile。
dsh plugin --profile web add github:yunfei07/ui-song-theme
安装完成后，用下面命令启动 Web profile，检查 light、dark 和 system 偏好下的实际效果。
dsh --profile web
典型用法¶
如果是可复现安装，可以先固定 commit。这样后续同一 profile 安装时不会跟随仓库默认分支漂移。
dsh plugin --profile web add github:yunfei07/ui-song-theme#<commit-sha>
使用阶段如果不再需要这组主题，执行卸载命令。卸载后只移除 ui-song-theme 层，并恢复它下面的主题。
dsh plugin --profile web remove ui-song-theme
如果进入仓库做本地检查，可以用下面这组命令，依次覆盖安装、检查、构建和打包检查。
corepack pnpm@11.21.0 install
pnpm check
pnpm build
pnpm pack:check
适用场景与注意¶
这个插件适合希望调整 DSH Web 界面视觉 token 的使用者，尤其是想保留 light/dark/system 偏好，并且需要可卸载回退的场景。已核实的能力集中在主题 token 层。
注意以下事项：
- 插件代码会在当前 dsh 进程权限下运行。安装前请检查源码、依赖和许可证。
- 系统字体可用性会影响 exact Song glyph metrics，不同系统上的具体字形度量可能不完全一致。
- 项目许可证声明为 MIT。
结尾¶
ui-song-theme 的价值在于把 Song-inspired 明暗主题做成可叠加、可卸载的 DSH 插件层：安装时获得一组完整的 light/dark 值，卸载时恢复原有主题。
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；这里列出可核实的仓库地址：
