English | 中文
`dsh-theme` 是一个独立的社区插件，用于定制 DeepSeek Harness Web UI。修改会立即生效，并在当前浏览器刷新后自动恢复。
## 功能
- 浅色、深色和跟随系统三种模式。
- 十五组精选主题，包括五组阅读型主题，以及面向代码阅读的“碳夜代码”。
- 每个预设会把颜色层级、界面字体、代码字体和字号作为一个完整视觉方案同步应用。
- 实时调整强调色、背景色、文字色、表面色和侧栏色。
- 分别设置界面字体和代码字体。
- 分别设置界面字号和代码字号。
- 使用带版本的浏览器本地配置，刷新后仍然保留。
## 安装
```sh
npx @deepseek-ai/dsh plugin --profile web add github:oil-oil/dsh-theme
```
重启 `web` profile，然后打开**设置 → 外观**。
`0.2.0` 已适配 Harness `0.1.2-rc.1`（DSH Desktop `2.0.5` 内置版本）。旧版插件出现 `dsh-client-runtime/client` 加载错误时，请更新插件后重启。安装、更新和版本核对见[兼容说明](./docs/compatibility.md)。
## 开发
```sh
pnpm install
pnpm test
pnpm typecheck
pnpm build
```
本地开发时可以直接安装目录：
```sh
npx @deepseek-ai/dsh plugin --profile web add ./dsh-theme
```
## 能力边界
插件只使用 Harness 官方 Theme 和 Slot API，因此可以在不替换 Harness 组件的情况下修改字体类型和语义字号。
主题值保存在当前 Harness 地址对应的浏览器存储中，不会同步到其他浏览器或不同地址下的 profile。这是插件选择的保存范围。
Harness 目前没有提供统一的全局圆角 Token。`dsh-theme` 不使用脆弱的全局 CSS 覆盖，因此暂不支持修改组件圆角。
新增的阅读型主题只提取本机阅读主题的配色与气质，再重新建模为 Harness 的浅色、深色语义 Token。插件没有复制 Typora 的 CSS、DOM 选择器或字体文件，显示名称也使用独立命名。
主题建模方法、兼容边界和回归规范见 [docs/theme-design.md](./docs/theme-design.md)。
## 开源协议
[MIT](LICENSE)
---
这是一个独立的社区项目，与 DeepSeek 无隶属或背书关系。DeepSeek Harness Logo 来自 [DeepSeek Harness 官方仓库](https://github.com/deepseek-ai/deepseek-harness)，仅用于标明插件兼容的平台。