前言¶
DeepSeek Harness（DSH）的界面默认样式偏工程向，长时间对着同一套视觉容易疲劳；若只靠改系统主题或浏览器缩放，又很难同时照顾磨砂玻璃、版式密度和运行指标这类细节。社区插件「琉光」（Liuguang）把两套完整设计语言装进 DSH：液态玻璃与苏联构成主义，可在面板里即时切换，并附带个性化选项、投放式 CSS 皮肤包和鲸鱼娘桌宠。下面按定位、功能、安装与用法说明。
这是什么¶
琉光（npm 包名 dsh-theme-liuguang）是由维护者 ShokouP 发布的 DSH 皮肤/主题插件，在 SkillHub 插件目录 中归类为「趣味换装」。
一句话定位：给 DSH GUI 提供两套可随时切换的设计语言——液态玻璃（半透明磨砂、内部发光玻璃珠、跟随指针的镜面高光）与苏联构成主义（米色纸面、血红与墨黑、硬直角与海报式排版）——外加个性化面板、用户目录下的皮肤包，以及可交互的鲸鱼娘桌宠。
插件通过 --dsw-* 设计令牌与语义化 DOM 钩子注入样式，README 写明不依赖 CSS-module 哈希类名，并标注与 DSH 0.2.0-rc.2 兼容。代码许可为 MIT；桌宠立绘为社区二创，CC BY-NC-SA 4.0（禁止商用），与 DeepSeek 官方无隶属关系。
两套设计语言¶
切换入口在界面右下角 ✦ → 外观 → 设计语言，点选后即时生效，无需重启或刷新，选择会被记忆。
液态玻璃（Liquid Glass）¶
视觉特征包括半透明磨砂、细噪点、内部发光玻璃珠，以及跟随指针的镜面高光。底色有三套预设：墨银（暖灰黑 + 香槟金）、深海（藏蓝 + 青）、暖砂（褐黑 + 琥珀）；强调色可用预设或取色器自定义。
该语言下独立选项包括：底色、强调色、磨砂（0–60px）、通透、圆角、动效。
苏联构成主义（Constructivism）¶
视觉为米色纸面搭配血红与墨黑，硬直角、粗边框、实心偏移投影与海报式标题下划线；提供米色正片与墨黑夜版两种海报明暗。
独立选项面向实际使用：纸张（米白/灰白/牛皮/蓝图纸）、套色（血红/朱砂/赭石/普鲁士蓝/墨）、版心（宽/中/窄）、字号（小/标准/大，调整正文实际字号）、编号（无 / 01 / 02 / 03 小角标）、印章（时钟 / 模型 / 关）、状态（自动 / 关）、指标（开 / 关）。README 说明红色主要用于状态与层级信号（如选中会话、输入卡聚焦、主按钮、印章），而非大面积装饰色块。
构成主义模式下，运行数据可显示在输入框左侧的页边注栏（右对齐、红色竖标朝向输入框），例如步数/轮次、tok/s、累计 token、缓存命中率等；仅当能从界面文本按标签解析到的数字才会显示。打开个性化面板时该栏自动隐藏。状态选项与顶栏斜纹联动：仅在 agent 执行任务时出现并缓慢移动，停下后静止消失。
核心功能¶
- 设计语言切换：玻璃 ↔ 构成主义，即时生效并记忆。
- 投放式皮肤包：将
~/.dsh/liuguang-packs/<id>/目录（含pack.json与theme.css）放入后，面板中即可选用；损坏的包只影响自身。格式说明见仓库 docs/skin-packs.md。 - 个性化面板：外观（两套语言各自选项）、桌宠（显示/大小/话痨/七种表情试玩/归位）、关于（版本/署名/恢复默认）。
- 鲸鱼娘桌宠：七种表情，可拖拽；悬停变开心，点击随机反应并说话；约 90 秒无操作进入犯困状态。
- 可验证的配色：颜色在 OKLCH 中定义并由脚本转 sRGB；仓库提供
npm run check:contrast按 WCAG 校验文字与 UI 配对（见 docs/digest.md）。 - 卸载与回退：
dsh plugin remove dsh-theme-liuguang可移除依赖并注销 bundle，刷新后回到原版界面；README 强调不修改app.asar。
安装与启用¶
推荐通过 DSH 插件命令从 npm 安装（README 建议全局安装 pnpm 后再执行）：
npm i -g pnpm
dsh plugin add dsh-theme-liuguang
安装完成后重启一次 DSH；若右下角出现 ✦ 入口，即表示加载成功。
当 npm 不可用时，README 提供等价路径：
npm i -g pnpm
dsh plugin add github:ShokouP/dsh-theme-liuguang
卸载：
dsh plugin remove dsh-theme-liuguang
当前 npm 包版本为 0.3.1（以仓库 package.json 为准）。插件在 DSH 进程内运行，安装前宜自行查阅 GitHub 源码 与许可证，确认符合本机安全与合规要求。
典型用法¶
切换外观与调参¶
- 打开 DSH，点击右下角
✦。 - 在 外观 → 设计语言 中选择「液态玻璃」或「苏联构成主义」。
- 在同一面板中按当前语言调整底色、强调色、磨砂、纸张、套色、指标等项；需要时可在桌宠分区开关显示、大小与话痨程度。
投放自定义皮肤包¶
在用户目录创建皮肤包文件夹，例如：
~/.dsh/liuguang-packs/<你的包 id>/
├── pack.json
└── theme.css
保存后回到 DSH，在琉光面板的皮肤相关选项中应能看到新包；具体字段以 docs/skin-packs.md 为准。仓库自带示例 examples/packs/mist/（樱雾）可作参考。
开发本机调试（Windows）¶
维护者在 README 中记录了本仓库脚本路径（适用于克隆后的本地开发，非普通用户必选项）：
D:\yangchengcup\ui\apply.cmd
D:\yangchengcup\ui\restart-dsh.cmd
撤销皮肤可使用同目录下的 revert.cmd；多 profile 时支持 apply.cmd -ProfileName <名称>。
适用场景与注意¶
适合希望在 DSH 里长期换肤、对比两种反差强烈的 UI 语言，或需要页边注式运行指标与构成主义排版风格的开发者。液态玻璃路线适合偏好磨砂与动态高光；构成主义路线适合需要固定印刷感、版心与字号可控的阅读场景。
注意事项：
- 桌宠素材 CC BY-NC-SA 4.0，商用需另行处理授权。
- Windows 标题栏模式下，README 说明侧栏会关闭
backdrop-filter，以避免 fixed 标题栏按钮层叠异常。 - 插件与 DSH 升级的配合以
dsh.compatibility与 README 为准；大版本升级后若样式异常，可先卸载插件验证是否为皮肤层问题。
结尾¶
琉光把「液态玻璃」与「苏联构成主义」做成两套独立参数体系，而不是同一组滑杆换配色；配合皮肤包与桌宠，属于 DSH 生态里偏重界面表达的一类插件。目录页：SkillHub · dsh-theme-liuguang；源码与截图：GitHub · ShokouP/dsh-theme-liuguang。
