dsh-theme-kit

Readme

# dsh-theme-kit

[English](README.en.md) | 中文

<p align="center">
  <img src="docs/cover.jpg" alt="dsh-theme-kit 封面" width="100%" />
</p>

<p align="center">
  <a href="https://github.com/ink5897/dsh-theme-kit"><img src="https://img.shields.io/badge/DSH-Web_GUI_插件-4a90d9" alt="DSH 插件"></a>
  <a href="https://www.npmjs.com/package/dsh-theme-kit"><img src="https://img.shields.io/npm/v/dsh-theme-kit" alt="npm"></a>
  <a href="https://github.com/ink5897/dsh-theme-kit/releases"><img src="https://img.shields.io/github/v/tag/ink5897/dsh-theme-kit" alt="版本"></a>
  <a href="https://github.com/beancookie/awesome-dsh-plugin"><img src="https://awesome.re/badge.svg" alt="Awesome"></a>
  <a href="LICENSE"><img src="https://img.shields.io/github/license/ink5897/dsh-theme-kit" alt="许可证"></a>
</p>

> 给 DeepSeek Harness 的 Web 界面换一套好看的外观：32 款配色主题、动态与静态壁纸、东方纸纹、分区透明度与文字深浅，还送一只会跟着按键动的键盘桌宠。

## 亮点

- **32 款主题**：莫兰迪 / 马卡龙 / 中国传统色三个色系，一键切换
- **动态壁纸**：内置视频壁纸，随界面流畅播放
- **纸纹纹理**：7 种东方纸纹，可调强度与颜色
- **分区精调**：主区 / 侧边栏 / 卡片 / 输入区 / 设置面板的透明度与文字深浅
- **按键桌宠**：跟随按键的桌面宠物，可拖动、缩放

## 展示

### 主题（三色系各一）

| 莫兰迪 | 马卡龙 | 中国传统色 |
|---|---|---|
| ![莫兰迪](docs/theme-morandi.png) | ![马卡龙](docs/theme-macaron.png) | ![中国传统色](docs/theme-chinese.png) |

### 设置

| 预设主题设置 | 自定义背景设置 | 纹理设置 |
|---|---|---|
| ![预设主题设置](docs/settings-preset.png) | ![自定义背景设置](docs/settings-background.png) | ![纹理设置](docs/settings-texture.png) |

## 快速开始

```bash
dsh plugin --profile web add dsh-theme-kit
```

重启 `dsh web`，在设置面板打开「主题与配色」即可开始。

## 预设主题

三个色系共 32 款：

| 色系 | 数量 | 主题 |
|---|---|---|
| 莫兰迪 | 12 | 燕麦摩卡、豆粉年糕、橄榄奶糖、苔藓奶绿、紫苏麻薯、莓语轻风、橙香奶盖、海苔奶冻、甜桃榛果、桂花乌龙、薄荷奶咖、蓝藻奶巧 |
| 马卡龙 | 8 | 海盐冰沙、樱花奶昔、蜜桃奶糖、莓果奶霜、柠檬海风、紫薯奶黄、抹茶杏子、葡萄奶冻 |
| 中国传统色 | 12 | 石青赭脂、藕荷绛色、雪青桃夭、苍筤霁青、长安三彩、朱墙驼铃、胭脂青黛、落日胡天、胡桃琥珀、紫藤青杏、金桂竹影、蓝田碧玉 |

## 壁纸

| 类型 | 数量 | 壁纸 |
|---|---|---|
| 动态（视频） | 3 | 五条悟、柯基小狗、线条小狗 |
| 静态（图片） | 3 | 夏日海边、树荫、线条小狗 |

## 纹理

7 种东方纸纹：纸纹 1、祥云纹、回纹、涟漪纹、波浪纹、螺旋纹、菱格纹，支持强度与颜色调节。

## 可自定义内容

| 类别 | 说明 |
|---|---|
| 主题 | 32 款预设，或跟随系统 / 浅色 / 深色 |
| 背景 | 导入并裁剪图片，或 6 张内置壁纸 |
| 玻璃 | 模糊、饱和度、亮度 |
| 纹理 | 7 种纹样 + 强度 + 颜色 |
| 位置 / 缩放 | 居中 / 顶部 / 底部；铺满 / 适应 / 原尺寸 |
| 表面透明度 | 主区 / 侧边栏 / 卡片 / 输入区 / 设置面板 |
| 文字深浅 | 主区 / 侧边栏 / 卡片 / 输入区 / 设置面板 |
| 按键桌宠 | 开关、拖动、缩放、重置位置 |

## 安装

前置条件：DeepSeek Harness（`dsh`）、Node.js 18+、`pnpm` 在 PATH。

### 从 npm 安装（推荐）

```bash
dsh plugin --profile web add dsh-theme-kit
```

### 从源码安装

```bash
git clone https://github.com/ink5897/dsh-theme-kit.git
cd dsh-theme-kit
dsh plugin --profile web add link:.
```

## 开发

插件是单个 DSH bundle 包，无需构建步骤，DSH 直接加载源码：

- `lib/index.js` — 宿主半区：`themeKit` 远程服务（持久化）+ `/dsh-theme-kit-wallpapers` 壁纸路由
- `lib/client.js` — 浏览器半区：背景 / 主题 / 文字深浅 / 按键桌宠
- `wallpapers/` — 内置壁纸与纹理资产
- `cordis.patch.yml` — 挂载插件的 bundle patch

## 已知限制

- 分区透明度与文字深浅通过作用在界面 DOM 上的 CSS 自定义属性覆盖实现，界面内部类名可能随版本变化。
- 按键桌宠与标志配色规则依赖界面的 DOM 结构。

## 许可证

[MIT](LICENSE)