精致主题编辑器 Rheasilvia/dsh-pretty-extension

DSH Pretty Extension

为 DeepSeek Harness Web UI 打造的精致主题编辑器。

在原生观感的 Settings → Pretty 页面里，自定义颜色、字体和界面层次。

功能 · 安装 · 用法 · 开发 · 参与贡献

DSH Pretty Extension 给 DeepSeek Harness 加了一套完整的主题编辑器。你可以从 28 个预设里挑一个起步，也可以自己搭浅色和深色调色板，在真实界面里预览每一处改动，最后通过 DSH 的设置系统保存结果。

插件只用 DSH 公开的插件、设置、插槽和主题 API。它不会 fork 或改动 DeepSeek Harness 源码树，而且在你明确启用之前一直保持关闭。

功能

| 能力 | 带来什么 |
| 28 个主题预设 | Ayu、Catppuccin、Codex、Dracula、GitHub、Nord、Proof、Tokyo Night、Vercel、Xcode 等等。 |
| 浅色与深色调色板相互独立 | 每种外观模式都能单独调整强调色、背景色、前景色和侧边栏颜色。 |
| 实时预览 | 保存之前就能看到侧边栏、对话界面和选中会话状态。 |
| 字体控制 | UI 字体和代码字体分开选，浏览器允许时还能用 macOS Font Book 里的本地字体族。 |
| 界面层次 | 调整表面、边框、次要文字、悬停状态，以及可选的半透明侧边栏（按 82% 不透明度渲染）。 |
| 无障碍颜色校正 | 前景色对比度不足时做最小幅度调整，保住 WCAG 4.5:1 的文字对比度。 |
| 原生 DSH 集成 | 使用 DSH 菜单、语义化主题 token、设置持久化、修订保护，以及中英文界面文案。 |

安装

环境要求

- DeepSeek Harness 0.2.0-rc.2 或更高版本（Web 或 Desktop 都行——同一个包同时服务两者，因为桌面应用内嵌了 Web UI）。
- PATH 里有 pnpm；dsh plugin 靠 pnpm 管理配置档依赖。

从 GitHub 安装

先停掉正在运行的 dsh web 进程，再把插件装进 Web 配置档：

sh
dsh plugin --profile web add github:Rheasilvia/dsh-pretty-extension

重新启动 DSH Web： sh
dsh web

桌面端的话，先打开一次 DeepSeek Harness Desktop，让它初始化自己的配置档，然后完全退出，再装到 desktop 配置档里，重新启动应用： sh
dsh plugin --profile desktop add github:Rheasilvia/dsh-pretty-extension

[!IMPORTANT]
dsh plugin add 只更新磁盘上的配置档，不会热重载已经在运行的 DSH 进程的 bundle 集合。所以安装、更新或移除插件之后，都要重启。

[!NOTE]
仓库的 lib/ 下已经带了审核过的 Host 和客户端预构建 bundle、source map 和声明文件。用 Git 安装不会跑插件生命周期脚本，也不需要为 Pretty 单独加 allowBuilds 条目。

想要可复现的安装，就把 GitHub 依赖固定到某个审核过的 commit： sh
dsh plugin --profile web add github:Rheasilvia/dsh-pretty-extension#YOUR_COMMIT_SHA

链接本地 checkout

开发和测试时用链接的 checkout： sh
git clone https://github.com/Rheasilvia/dsh-pretty-extension.git
cd dsh-pretty-extension
corepack enable
pnpm install
pnpm build
dsh plugin --profile web add link:.
dsh web

改完源码后，跑 pnpm build 再重启 dsh web。不用重新添加链接的插件。

用法

1. 用 dsh web 启动 DSH，打开它的回环地址，通常是 http://127.0.0.1:3080。
2. 打开 Settings → Pretty。
3. 打开 Enable Pretty theme。
4. 选浅色或深色调色板，然后挑一个预设，或者自己调颜色、字体和界面效果。
5. 看实时预览，点 Save and apply。

[!NOTE]
Pretty 里的 Light 和 Dark 按钮选的是你正在编辑的调色板。实际生效的应用外观仍然由 Settings → General → Appearance 控制。

插件默认关闭。只安装它不会改变 DSH 界面，也不会写入主题设置。

更新

GitHub 安装没固定 commit 的话，停掉 DSH Web，然后跑： sh
dsh plugin --profile web update dsh-pretty-extension
dsh web

如果固定了 commit，就显式安装新的审核过的 commit SHA。

卸载

停掉 DSH Web，移除插件，重启配置档： sh
dsh plugin --profile web remove dsh-pretty-extension
dsh web

疑难解答

| 问题 | 怎么办 |
| Settings 里看不到 Pretty | 确认插件是用 --profile web 添加的，然后彻底停掉再重启 dsh web。 |
| 「Pretty is read-only in this browser」 | 通过 127.0.0.1、localhost 或其他回环地址打开 DSH。远程浏览器会话有意使用内存设置，无法持久化 Pretty 的改动。 |
| Host settings provider 不可用 | 用标准 Web 配置档，安装或重新构建插件后重启它。 |
| 本地字体不可用 | Local Font Access 需要浏览器支持、loopback 或安全上下文，以及显式授权。内置字体栈仍然可用。 |

配置与隐私

Pretty 的设置会持久化保存：DSH 的配置编辑器把它们写入当前配置档的 cordis.patch.yml，以插件的 ui-pretty 条目 id 作为键。0.3.0 之前的插件版本写在 $DSH_HOME/settings.yaml 里的设置，由 DSH 在升级后的首次启动时导入一次。Restore defaults 会清除 theme 字段的覆盖值，让 DSH 原有的主题 token 重新生效。

只有在你点击 Load system fonts 之后，才会请求 Local Font Access。插件只保存选中的字体族名称，不会复制或上传字体文件。

开发

本地开发需要 Node.js ^22.19.0 || >=24.0.0 和 pnpm 11。

| 命令 | 说明 |
| pnpm typecheck | 运行 TypeScript 类型检查。 |
| pnpm test | 运行领域、控制器、组件、无障碍和设置集成测试。 |
| pnpm build | 构建 Host 入口、浏览器客户端 bundle、声明文件和内联 CSS Modules。 |
| pnpm check | 运行类型检查、测试和生产构建。 |
| pnpm check:dist | 重新构建并校验已提交的 lib/ 目录保持不变。 |
| pnpm watch | 源文件变化时重新构建。 |
| pnpm pack --dry-run | 查看可发布包的内容。 |

lib/ 由 pnpm build 生成并提交到仓库，这样通过 Git 安装时无需执行脚本。绝不要手动编辑它。改动源码或构建工具后，运行 pnpm check，并把重新生成的 lib/ 与源码改动一起提交。之后 pnpm check:dist 必须在干净的提交上以及 CI 中通过。

项目结构 text src/ ├── index.ts # Host composition root and settings schema ├── settings/pretty-settings.ts # Persistent configuration contract └── client/ ├── index.ts # Browser composition root ├── locales.ts # English and Chinese UI copy └── pretty/ ├── PrettySection/ # Settings page and state branches ├── components/ # UI components and CSS Modules ├── state/ # Config form adapter, store, and controller └── theme/ # Presets, font catalog, and token derivation

Host 导出 Config schema，DSH 把它作为 ui-pretty 设置表单提供。浏览器客户端把 Pretty 页面注入 DSH Settings，并通过自己持有的主题 token 覆盖来应用颜色和字体。适配器把 DSH 服务挡在 UI 和主题领域逻辑之外。

贡献

欢迎提交 issue 和 pull request。开 PR 之前请先读 CONTRIBUTING.md，并跑一遍验证关卡： sh
pnpm check
pnpm check:dist
pnpm pack --dry-run

许可证

基于 MIT License 发布。

社区维护的 DeepSeek Harness 插件。本项目与 DeepSeek AI 无关联，也未获其认可。