@deepseek-ai/dsh-client-ui-anime-theme

Readme

# dsh-ui-tint · DeepSeek Harness 界面色调插件

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-available-brightgreen)](#)

基于 [anywhere-labs/deepseek-harness-desktop](https://github.com/anywhere-labs/deepseek-harness-desktop)（DeepSeek Harness 桌面版）的**轻量 UI 界面色调调整插件**：把主界面三大区域——**侧边栏、聊天区、对话框**——的颜色完全交给用户，带现成预设、颜色深度（浓郁度）、深浅主题自动适配，所有滑杆跟手流畅、改动即时生效并持久化。

> A lightweight UI tint plugin for DeepSeek Harness: tint the sidebar, chat area, and input box independently, with ready-made presets, a vividness slider, scheme-adaptive colors, and buttery-smooth sliders.

## ✨ 功能

- **一键预设**——「二次元粉」「薄荷绿」「程序员灰黑」单击即套用整套三区域配色与配套颜色深度。
- **三区域独立调色**——侧边栏 / 聊天区 / 对话框各自拥有：
  - 选色器（系统取色器）
  - 透明度滑杆（0–100%）
  - 亮度滑杆（80–130%）
- **颜色深度（浓郁度）滑杆**——0–100，数值越高颜色越**浓郁、越艳丽**（提升饱和度并拉回原始色相），而不是变灰。
- **深浅主题自动适配**——区域颜色按当前配色方案自动重调：浅色模式下深色自动提亮为同色相淡彩、深色模式下浅色自动压暗为同色相深彩，字体永远清晰可读。
- **启用即展开的插件形态**——设置行默认只显示标题与「启用主题插件」开关，开启后才展开全部调色功能。
- **流畅跟手的滑杆**——拖动采用本地乐观更新 + rAF 合并重算 + 250ms 批量落盘，全程零网络等待，不卡顿。
- **持久化**——所有参数写入 dsh 设置文档（`ui-anime-theme` 命名空间），重启后自动恢复。

## 📦 安装

插件以 **dsh bundle** 形式分发，安装进你正在使用的 profile（桌面版默认为 `web`）：

```sh
# 方式一：直接从 GitHub 仓库安装
dsh plugin --profile web add github:STA-running/dsh-ui-tint

# 方式二：下载 tarball 离线安装
dsh plugin --profile web add ./deepseek-ai-dsh-client-ui-anime-theme-0.1.0-rc.5.tgz

# 方式三：npm 发布后按包名安装
dsh plugin --profile web add @deepseek-ai/dsh-client-ui-anime-theme
```

> 桌面版内置的 `dsh` 命令在应用的 `resources\host` 目录下，或直接使用 `scripts/install-desktop.ps1`（见本仓库 `scripts/`）。

安装完成后**重启一次** dsh（或桌面应用）——插件集变更重启生效。

## 🎨 使用

1. 打开 **设置 → 通用**，找到「自定义主题」行。
2. 打开「启用主题插件」开关，调色面板展开。
3. 点一个预设（如「二次元粉」）整体换肤，或逐个区域拖动选色器 / 透明度 / 亮度 / 颜色深度滑杆。
4. 切换 dsh 的浅色 / 深色主题，区域色自动适配、文字始终可读。
5. 「恢复默认」一键回到出厂状态。

## 🔧 兼容性

- 适配 **deepseek-harness-desktop**（[anywhere-labs/deepseek-harness-desktop](https://github.com/anywhere-labs/deepseek-harness-desktop)，Electron 桌面版）与 dsh Web GUI。
- 基于 dsh rc.5 插件体系（`dsh.bundle` + `dsh.client`），依赖 `@deepseek-ai/*` 平台包（peerDependencies 按版本解析）。

## 🛠 开发

本插件在 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) monorepo 的 `packages/client/ui-anime-theme` 中开发与构建；本仓库同步其源码与构建产物，并可直接安装使用。

```sh
# 构建产物位于 lib/，已随仓库提交；重新构建需在 monorepo 内执行：
pnpm --filter @deepseek-ai/dsh-client-ui-anime-theme exec tsc -b && pnpm --filter @deepseek-ai/dsh-client-ui-anime-theme bundle
```

## 📄 License

[MIT](LICENSE)