dsh-paper-theme

August 14, 2026 · View on GitHub

给 DeepSeek Harness Web GUI 的温暖纸张浅色主题插件。

米纸底色、赭石棕橙强调、墨棕文字、衬线标题与极淡纸张噪点——长时间使用的聊天/工作界面也能保持舒适。深色模式完全不受影响,随时可一键卸载还原。

⚠️ 非官方项目,与 DeepSeek 官方无关;纯第三方主题,不改任何功能逻辑。

特性

  • 🎨 浅色模式整体换装:底色 / 文字 / 按钮 / 边框 / 状态色 / 滚动条 / 代码块,88 个设计 token 全覆盖
  • 🌙 深色模式原样不动:所有深色值逐字透传官方样式表,并由校验器自动防漂移
  • ✍️ 标题衬线(宋体/Georgia 栈)+ 正文无衬线,本地字体零下载
  • 📄 纸张质感:极淡 SVG 噪点纹理 + 暖色聚焦环 + 按钮/输入框暖色柔和阴影
  • 🔌 走官方主题扩展点(theme.overrideTokens),不碰安装目录,升级 dsh 不丢失
  • ♻️ 幂等安装/卸载脚本,一条命令恢复原样

配色

用途颜色
纸底#F6F0E4
面板层级#EFE7D6 / #EAE0CB
主文字#2E2620
次级文字#5F5244 / #756650
强调/主按钮#B4552D(悬停 #9C4A26)
品牌文字/链接#8F3E1F
成功 / 警告 / 错误#4E7A4F / #B9822F / #B34A3C

环境要求

  • DeepSeek Harness 0.1.0-rc.6(或同代 Web GUI)
  • Windows + PowerShell 5.1+(脚本用 PowerShell 编写;插件本体跨平台,其他系统可手动部署)

安装

git clone https://github.com/Baurt-Li/dsh-paper-theme.git
cd dsh-paper-theme
pwsh -NoProfile -File deploy/install.ps1

首次安装后重启一次 Web 应用(dsh web),刷新页面即生效。 之后微调样式只需:改文件 → 重跑 install.ps1 → 浏览器 Ctrl+F5,无需重启。

卸载(完全还原)

pwsh -NoProfile -File deploy/uninstall.ps1

然后重启 Web 应用。

微调配色 / 字体 / 纹理

编辑 packages/ui-theme-paper/lib/client.js:

  • /* @paper-tokens-begin */ 之间:浅色模式的 token 映射,格式 { "light": 颜色, "dark": 颜色 }——dark 值必须与官方 design-platform.css 深色段一致(校验器会强制比对)
  • /* @paper-css-begin */ 之间:纸张纹理 / 衬线标题 / 聚焦环 / 阴影等 CSS(仅限结构选择器,不能引用组件哈希类名,不能改布局)

改完执行:

node deploy/validate.mjs        # 校验(必须 PASS)
pwsh -NoProfile -File deploy/install.ps1

工作原理

DSH Web GUI 的主题由 ThemeRuntime 服务(@deepseek-ai/dsh-client-ui-theme)管理,支持第三方以 token 覆盖层的方式换肤。本插件是注册进 web profile 的客户端插件(dsh.client 标记 + 预构建工厂包):

  1. 宿主扫描到插件行 → 通过 /plugins/dsh-ui-theme-paper/client.js 提供给浏览器
  2. 插件激活时调用 theme.overrideTokens("dsh-ui-theme-paper", PAPER_TOKENS) 叠加暖纸 token 层(浅色生效,深色原值透传)
  3. 同时注入内嵌 CSS(字体、纹理、阴影),全部置于 body:not([data-ds-dark-theme]) 守卫内

仓库结构

packages/ui-theme-paper/    插件本体(package.json + lib/)
deploy/install.ps1          幂等安装脚本
deploy/uninstall.ps1        幂等卸载脚本
deploy/validate.mjs         校验器(深色透传防漂移等)
docs/                       设计文档与实施计划

License

MIT © 2026 Baurt-Li