前言¶

DeepSeek Harness（DSH）的默认 Web UI 以功能优先，但在长时间使用时，屏幕长时间暴露在默认的冷色背景和无衬线字体下，容易产生视觉疲劳。尤其是需要长时间阅读、写作或调试的智能体开发者，更希望界面能提供一种柔和、专注的视觉体验。

暖纸 Warm Paper 是为 DSH Web UI 设计的一套手记风主题，通过米杏纸色、宋体字族与砖红色系的组合，将界面还原为一种类似纸质手记的质感。它不修改宿主源码，而是通过叠加主题 token 实现样式覆盖。

这是什么¶

这是一个为 DeepSeek Harness（DSH）设计的 Web UI 主题插件，由维护者 WitchKlee 发布。

它解决的问题是：为 DSH Web UI 提供一套自定义的视觉方案，让界面呈现米杏纸色背景、宋体书卷气字体、砖红色强调色，并附带纸纹质感、左侧书脊线与日期戳等细节。

设计要点¶

暖纸通过以下方式实现手记风格：

• 色彩：米杏纸 #F5EEE0、深棕墨 #3B2F25、砖红 #A24B3B、灰绿 #586D52。这些颜色通过 ctx.theme.overrideTokens() 覆盖 --dsw-alias-* token（浅色与深色两套）。
• 字体：正文与标题使用旧式衬线字体栈，优先级为 Sitka / Palatino → 宋体 / 思源宋体 → SimSun。通过覆盖 --dsw-font-family 实现，用户在「正文字体」设置中填写的字体排在最前，暖纸衬线栈始终垫后，无效字体名会回落到宋体。
• 材质：180px 极淡颗粒纸纹、左侧 2px 砖红书脊线、砖红选区。通过门控样式表 html[data-warm-paper="on"] 实现。
• 气泡：用户消息气泡使用砖红 #A24B3B 底色、米色 #FBF6EB 文字，链接始终下划线。由于宿主未提供气泡文字单独 token，使用作用域选择器 [class*="_bubble"] 补充样式。
• 悬停卡：侧栏会话/工作区的 HoverCard 改为纸色卡片、墨色文字。通过定位覆盖宿主原语中写死的底色 #2C2C2E 和白色文字。
• 日期戳：输入框下方显示「● 2026 · 10 · 21」格式，通过 conversation.composer.dock 装饰槽实现。

深色模式不是简单反相，而是「夜读纸」——暖褐纸面、米色墨字，砖红提亮为陶土色，灰绿提亮为灯下的苔色。对比度按 WCAG 校准：正文约 11:1，三级文字约 5:1，砖红按钮与气泡上的米色字约 5.4:1。

文件结构¶

index.js           Host half（空 apply，只为让 Client half 随 profile 加载）
client.js          调色板 + 排版/纸纹/气泡/日期戳 + 插件设置页
cordis.patch.yml   bundle patch：插入 warm-paper-theme 条目
locale/en.json     插件管理器的元数据（英文）
locale/zh.json     插件管理器的元数据（中文）
icon.svg           手记纸页 + 砖红印章图标
LICENSE            MIT 许可证

设置界面¶

暖纸自带独立的设置 tab，两个入口共享同一份状态：

• 设置 → 暖纸（设置面板左侧一级 tab，排在「通用设置」和「模型」之间）
• 设置 → 插件 → 已安装 → 暖纸 的 bundle 详情页（描述下方的配置区，即 plugins.bundle.config 槽，按包名 dsh-theme-warm-paper 挂载）

设置项包括：

• 启用暖纸主题：总开关；关掉立即回到宿主原样，其他选择保留
• 纸色：米杏 / 宣白 / 茶褐 三种纸底；只换背景类 token，不动文字与强调色
• 纸纹：无 / 轻 / 重 三档纸面颗粒
• 书脊线：左侧那条 2px 砖红订口线，可单独关掉
• 消息气泡：砖红 / 陶土 / 纸色 三种底色，砖红与陶土自动反白文字
• 正文宋体：关掉后正文回到宿主的无衬线字体
• 衬线字体：宋体 / 思源宋体 / 仿宋（中文家族偏好；宿主「正文字体」仍优先）
• 正文字号：10–22px 步进器，与「通用设置 → 字号大小」是同一个宿主设置，两边同步
• 代码字号：10–16px 步进器，与「通用设置 → 代码字号」同步
• 终端字号：10–20px 步进器，作用于右侧边栏终端面板（需打开终端标签）；与「通用设置 → 终端字号」同步
• 侧栏字号：小 / 标准 / 大；覆盖左侧会话列表与导航的字号（宿主无此设置，由主题 CSS 覆盖）
• 日期戳：完整 / 简 / 关；「简」只留月和日
• 恢复默认：回到出厂设置

页面顶部有实况预览：纸底、宋体样字、用户气泡、日期戳都直接使用当前 token，改任何选项即时反映。

设置存储在本地 localStorage（dsh-theme-warm-paper.settings），刷新后保留，换浏览器不跟随。

安装¶

在 DSH 里由 plugin_manager 以本地目录安装：

plugin_manager({ action: "install_bundle", target: "<本目录绝对路径>" })

安装后 Client 半边随 HMR 生效；若宿主提示需重启，重启 DSH 后再看。

关闭 / 卸载¶

• 关闭：设置 → 插件 → 已安装 → 暖纸 → 详情页里的「启用暖纸主题」开关；或在同一列表里禁用该 bundle（卸载客户端模块，主题与日期戳一起撤走）。
• 卸载：plugin_manager({ action: "remove_bundle", target: "dsh-theme-warm-paper" })。

兼容性¶

• 需要支持 ctx.theme.overrideTokens() 的 DSH（0.2.x Client 契约）。
• 已验证：DSH Desktop 0.2.1-rc.2（2026-10-21），浅色 / 深色 / 跟随系统、设置页、日期戳均正常；完全退出后冷启动复验通过。
• 不 patch 宿主源码、不改宿主 CSS 文件；调色板全部走 --dsw-alias-* token。
• 唯一依赖的宿主类名是用户气泡的 CSS Modules 局部名（<hash>_bubble）与左侧栏的字号类（<hash>_title / _meta / _time 等），因为宿主没有给这两类文字单独的 token。宿主若改名，这两处会退回宿主原样式（气泡底色 + 墨字 / 侧栏原字号），其余部分不受影响。
• 若同时启用了其他主题插件，后注册的 token 层按 token 覆盖，建议只留一个主题。

版本与许可证¶

• 版本：1.0.0（2026-10-21）：首个定稿版本。暖纸浅 / 深双主题、纸纹 / 书脊、宋体栈、三色气泡、日期戳与独立设置页；在 DSH Desktop 0.2.1-rc.2 上验证通过。
• 许可证：MIT。

适用场景与注意¶

适合需要长时间阅读、写作或调试智能体开发场景的用户，希望界面能提供一种柔和、专注的视觉体验。

使用前应检查源码与许可证。插件以当前 DSH 进程权限运行，安装前建议审查代码。

总结¶

暖纸 Warm Paper 是一个为 DeepSeek Harness 设计的手记风 Web UI 主题，通过米杏纸色、宋体字族与砖红色系，将界面还原为类似纸质手记的质感。它支持浅色与深色两种模式，提供纸纹、书脊线、日期戳等细节，并通过独立设置页允许用户自定义纸色、纸纹、气泡、字号等选项。

• 目录页：https://www.skillhub.cn/plugins/WitchKlee/dsh-theme-warm-paper
• GitHub：https://github.com/WitchKlee/dsh-theme-warm-paper