WuWL-98/dsh-theme-paper

dsh-theme-paper — 纸质主题

为 DeepSeek Harness（Web GUI）设计的暖色“纸质”外观主题，设计语言参考
Claude Code：奶油纸背景（#FAF9F5）、暖墨水文字（#3D3929）、陶土色强调（#C96442）、
衬线 CJK 友好字体与暖色代码块。

这是一个正式的 DSH 客户端插件（dsh.client 平台条目）：主题通过平台主题服务注册，
外观行被替换为四方块版本 —— 浅色 / 深色 / 跟随系统 / 纸质 —— 与内置行处于同一单元格。
卸载插件后内置外观行原样恢复。

界面预览

纸质主题下的会话列表（奶油纸背景 #FAF9F5、暖墨水文字、陶土色强调）：

主界面

设置 → 常规 → 外观：一行四个方块，纸质 已选中（衬线字体、暖色界面元素）：

外观设置

会话界面（暖色代码块与思考块、书卷质感排版）：

会话界面

工作原理

| 环节 | 位置 |
| --- | --- |
| 加载条目 | ~/.dsh/profiles/web/package.json 的 bundle 层 dsh-theme-paper（dsh.profile.bundles）；条目由本包的 cordis.patch.yml 提供 |
| 包解析 | ~/.dsh/profiles/web/node_modules/dsh-theme-paper（junction 链接 → 本目录） |
| 主题注册 | lib/client.js 中 ctx.theme.register({ id: "paper", colorScheme: "light", tokens }) |
| 设置界面 | 以槽位优先级 -1 遮蔽 settings.general.item 内置的 appearance 单元格（最低优先级渲染；卸载后内置行恢复） |
| 持久化 | 纸质选择存于 localStorage（dsh.ui-theme.paper）；内置选项仍走 settings.yaml |
| 启动层 | web shell 的 dist 中有一份同选择器/同 key 的调色板镜像与引导脚本，避免首帧闪烁；没有它插件也能完整工作 |

安装（一条命令，官方 bundle 形式）

本包是profile bundle（声明了 dsh.bundle.patch），这是 DSH 分发插件的标准方式：
安装进 profile 即自动激活。

任意目录下执行（需要 PATH 上有 pnpm）：
dsh plugin --profile web add
例如：dsh plugin --profile web add github:WuWL-98/dsh-theme-paper
或者：dsh plugin --profile web add D:\path\to\dsh-theme-paper

重启 Web 界面以加载新条目：
dsh web

dsh plugin 会在 profile 目录运行 pnpm 安装，并自动把本包追加到 profile 的
dsh.profile.bundles 层，无需手动改任何配置。

Clone 后安装（一键脚本，Windows）

git clone https://github.com/WuWL-98/dsh-theme-paper.git
cd dsh-theme-paper
powershell -ExecutionPolicy Bypass -File .\install.ps1
dsh web   # 重启生效

脚本做的事情：把仓库目录以 junction 链接进 ~/.dsh/profiles/web/node_modules，并把包名加入 profile 的 dsh.profile.bundles 层。
可重复运行（幂等）；之后 git pull 即更新插件。

需要先至少运行过一次 dsh web（自动初始化 profile）再执行脚本。
macOS / Linux 可手动安装：ln -s  ~/.dsh/profiles/web/node_modules/dsh-theme-paper，再按下方“手动安装”第 2 步注册 bundle 层。

手动安装（无 pnpm）

1. 把包装进 profile
mkdir ~/.dsh/profiles/web/node_modules
New-Item -ItemType Junction -Path ~/.dsh/profiles/web/node_modules/dsh-theme-paper -Target

2. 在 ~/.dsh/profiles/web/package.json 中注册为 bundle 层：
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-theme-paper"] } }

3. 重启 dsh web

web profile 自己的 cordis.patch.yml 保持 [] —— 插件条目来自本包内的 bundle 补丁层（cordis.patch.yml）。

使用 / 关闭主题

打开 设置 → 常规 → 外观：一行四个方块。
点击 纸质 启用主题；点击 浅色 / 深色 / 跟随系统 退出（选择按浏览器记忆）。

卸载 / 停用插件

插件清单（设置 → 插件）显示运行状态，但启停由配置驱动（清单本身只读）：

A. 完全卸载（官方命令，需 pnpm）：
dsh plugin --profile web remove dsh-theme-paper
dsh web

B. 完全卸载（手动）：
1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中移除 "dsh-theme-paper"
2. Remove-Item ~/.dsh/profiles/web/node_modules/dsh-theme-paper
3. 重启 dsh web

C. 临时停用（保留安装，只是不加载）：
编辑本包内 cordis.patch.yml，给条目加 disabled: true：
- id: theme-paper
name: dsh-theme-paper
disabled: true
然后重启 dsh web

卸载后内置外观行原样恢复；仅纸质相关的 localStorage 标记成为惰性数据（没有插件读取它们）。

文件说明

| 路径 | 作用 |
| --- | --- |
| lib/client.js | 客户端 bundle：注册 paper 主题（102 个 token）、注入纸质 CSS、管理 data-ds-paper-theme 属性、持久化选择、渲染四方块外观行 |
| lib/index.js | 服务端 loader 存根（纯浏览器插件） |
| package.json | dsh.bundle.patch（bundle 层声明）+ dsh.client 平台声明与注入边 |
| cordis.patch.yml | bundle 补丁：插入 theme-paper 加载条目 |

GitHub 分享

本目录可直接作为一个 Git 仓库推送（无绝对路径依赖、无构建步骤）。
使用者安装方式见上文“安装”章节。
注意：peerDependencies 中的 @deepseek-ai/* 是 DSH 自带包，使用者无需另行安装；
若对方 DSH 版本不同，可能需要按版本微调（当前针对 0.1.0-rc.6 验证）。