# 🎨 DeepSeek Harness 外观插件
**DeepSeek Harness Web 的外观设置插件：主题、强调色、字体、背景壁纸，一键个性化你的 Web UI。**
[English](https://github.com/levi52/dsh-appearance/blob/main/README.en.md) · 中文
[](https://github.com/levi52/dsh-appearance/actions)
[](https://www.deepseek.com/harness/)
特性
- 🎨 主题：浅色 / 深色 / 跟随系统 + 9 个预设主题（Claude、GitHub、新粗野主义、终端、Dracula、Tokyo Night、Gruvbox、Solarized、Material），支持自定义主题（编辑器调整 5 个关键色，其余自动推导）
- 🌈 强调色：8 个预设色 + 自定义取色器，叠加在任意主题上，自动按 WCAG 计算反色文字
- 🔤 字体：界面字体 / 代码字体（默认、无衬线、衬线、等宽、自定义），支持系统字体选择器（直接挑选电脑已装字体），字号三档缩放
- 🖼️ 背景壁纸：本地上传或粘贴 URL；历史壁纸画廊一键切换、可删除；透明度（最高纯壁纸无遮罩）与模糊度可调
- 📤 导出 / 导入：整套外观配置导出为 JSON，便于备份、分享与换机迁移
- ⚡ 快捷切换：侧边栏底部「外观」按钮即时切换主题与强调色，无需打开设置页
- 💾 自动持久化：所有设置保存到
$DSH_HOME/settings.yaml，刷新后自动恢复 - 🧩 草稿工作流：修改先入草稿，点「保存并应用」才生效，可随时放弃更改
安装
环境要求
- DeepSeek Harness（
dshCLI）已安装并运行过 Web profile - Node.js ≥ 18（开发环境为 v22）
安装步骤
# 1. 一键安装（把 bundle 注册到 web profile）：
npm run install-plugin
# 等效于手动执行下面一步，也可用 --profile <name> 指定其他 profile：
# dsh plugin --profile web add <本目录路径>
# 2. 重启 dsh web卸载
npm run uninstall-plugin
# 移除 bundle；用户数据（settings.yaml 的 ui-appearance 段与
# wallpapers/ 目录）会保留，如需彻底清除请手动删除。纯客户端改动（主题色、字体、壁纸设置等）只需强制刷新浏览器；宿主侧改动（schema、路由）需要重启。
界面说明
| 区域 | 说明 |
|---|---|
| 主题 | 三态 + 9 预设 + 自定义卡片；自定义卡片点击展开/折叠编辑器，实时调色 |
| 强调色 | 预设色板圆点 + 自定义取色器，「主题默认」不叠加 |
| 字体 | 界面字体、代码字体、字号三档（界面缩放） |
| 背景图片 | 上传 / URL / 历史壁纸画廊切换与删除、透明度、模糊度 |
| 操作 | 保存并应用、放弃更改、恢复默认、导出、导入 |
数据存储
- 设置：
$DSH_HOME/settings.yaml的ui-appearance:段（小字段，如主题、字体、透明度） - 壁纸图片：
$DSH_HOME/wallpapers/目录（上传的图片存为文件，设置只保存服务 URL，不会把大图写进 settings）
开发
npm run typecheck # 类型检查
npm run build # 构建 lib/ 产物
npm run watch # 监听 src/ 变更自动构建源码位于 src/（宿主侧 index.ts、浏览器侧 client/index.ts），构建产物输出到 lib/。
工作原理
- 主题通过
--dsw-alias-*颜色 token 覆盖实现；预设主题由「紧凑调色板」自动展开为完整 token 集 - 壁纸通过宿主路由存储（
/dsh-appearance/*），浏览器侧用半透明表面层让壁纸透出，色调跟随当前主题 - 第三方/自定义主题 id 存入
ui-appearance.theme（内建ui-theme.preference只接受 light/dark/system） - 设置如何暴露给浏览器：宿主半启动时通过
ctx.settings.register注册ui-appearance设置命名空间；DSH 的网关会向浏览器暴露所有已注册的命名空间（注册即暴露，不存在需要手动维护的「白名单」）。因此安装时无需修改任何 DSH 文件，只要 bundle 已加入 profile 且宿主半正常启动，设置页就能读写ui-appearance并持久化到$DSH_HOME/settings.yaml。若设置不生效，请先确认 bundle 已注册（重新执行安装并重启 dsh web），而不是去改网关代码。
安全说明
- 所有数据仅存储在本机（
$DSH_HOME），不上传任何内容 - 壁纸上传接口只接受图片格式，文件名白名单校验防路径穿越
- 不采集任何密钥或凭据
🤖 AI 声明
本项目使用 DeepSeek Harness 开发。
许可证
MIT © Levi5