dsh-beautify-plugin

Readme

# dsh-beautify-plugin — DSH 美化插件

一个给 DeepSeek Harness 换外观的插件：改字体、颜色、背景图，还能像浏览器的「检查元素」一样——
**鼠标移到哪个字上，点一下，就能单独改那个字**。

所有修改**实时生效**，并且自动保存到 DSH 的数据目录里（不是浏览器缓存），**退出重开不丢失**。

---

## 功能一览

| 功能 | 说明 |
| --- | --- |
| 🔍 **检查元素** | 点「检查元素」→ 鼠标移到界面任意文字上会**蓝色高亮** → 点击选中 → 单独修改它。标题、侧边栏、聊天栏标题、按钮……每一个都能独立设置，互不影响 |
| 元素独立设置 | 每个元素可调：**文字颜色、字号、字重（加粗）、文字阴影（强度+颜色+透明度）、背景色**，颜色全部带**透明度滑块** |
| 一键套用 | 「套用上一个元素的设置」：同类元素一键复制上一份调好的设置，不用重复调 |
| 主题配色 | 6 套预设（默认 / 樱花粉 / 薄荷绿 / 深海蓝 / 暖阳橙 / 暗夜紫 / 极简黑白） |
| 背景颜色 | 整体背景、侧边栏、用户气泡、输入框、代码块等 8 个区域，各自独立调色 + 透明度 |
| 分区背景图 | 侧边栏、聊天区各自上传背景图（图已内嵌保存，原图删了也不影响），各调不透明度 |
| 字体 | 界面字体、代码字体、正文基准字号（12–22 滑块）、默认字重 |
| 聊天宽度 | 聊天内容列宽度 640 / 748 / 860 / 980 |
| 撤销 | 随时「↩ 撤销」，最多回退 60 步 |
| 导出 / 导入 | **复制 JSON / 下载 JSON / 复制 CSS / 导入文件 / 粘贴导入**，设置可以随意备份和分享 |

---

## 怎么安装（给新电脑 / 分享给别人）

**把这个 `dsh-beautify-plugin` 文件夹发给对方**，对方按下面任一种方式装。

### 方式一：直接复制（最简单，不用装任何软件）

1. 找到 DSH 数据目录，默认是：

   ```
   C:\Users\<你的用户名>\.dsh
   ```

2. 进入里面的 `profiles\web` 文件夹（没有的话先正常打开一次 DeepSeek Harness 再关闭，它就会生成）。

3. 把整个 `dsh-beautify-plugin` 文件夹**复制**到：

   ```
   C:\Users\<你的用户名>\.dsh\profiles\web\node_modules\
   ```

4. 用记事本打开 `profiles\web\cordis.patch.yml`，把里面的内容**全部替换**为：

   ```yaml
   - insert:
       - id: beautify
         name: 'dsh-beautify-plugin'
   ```

   （如果里面原本就有别的配置，就在最前面加上上面这几行，不要删掉原有内容。）

5. **完全退出** DeepSeek Harness（含托盘图标）再重新打开。

6. 打开 设置 → **美化**，就能用了。

### 方式二：pnpm 安装（懂命令行的人用）

在 `profiles\web` 目录下执行：

```bash
pnpm add file:D:/插件所在位置/dsh-beautify-plugin
```

然后把 `package.json` 里的 `dsh.profile.bundles` 加上 `"dsh-beautify-plugin"`，再重启应用。

---

## 怎么用

### 1. 修改某个文字（重点功能）

1. 打开 设置 → 美化 → 点 **🔍 检查元素**（或右下角 🎨 工具栏里的同款按钮）。
2. 鼠标移到界面上你想改的文字上——**它会蓝色高亮**，旁边显示它的类名。
3. **点击**这个文字，它就被选中了，下方出现编辑面板：
   - **文字颜色** + 透明度
   - **字号**（滑块）
   - **字重**（400 正常 ~ 800 粗体）
   - **文字阴影**：无 / 柔和 / 明显 + 阴影颜色 + 阴影透明度
   - **背景色** + 透明度
4. 改完立即生效。想给别的同类元素用同一套设置：选中它，点「**套用上一个元素的设置**」。
5. 改错了随时点「**↩ 撤销**」。

### 2. 换整套配色 / 背景

- **主题配色**：点预设卡片一键换整套。
- **背景颜色**：8 个区域各自取色 + 透明度（浅色/深色两套，用"编辑目标"切换）。
- **分区背景图**：侧边栏、聊天区各自「选择图片」上传，用滑块调不透明度；图片已内嵌保存，删掉原图不影响。

### 3. 导出 / 导入设置

| 想做什么 | 怎么做 |
| --- | --- |
| 备份设置 | 「下载 JSON」（保存成文件）或「复制 JSON」（复制到剪贴板） |
| 分享给朋友 | 「复制 JSON」发过去，对方在「粘贴导入」里粘进去点「应用导入」 |
| 换电脑恢复 | 「导入文件」直接选之前的 .json 文件 |

> 注意：导入会**覆盖当前全部设置**，导入前建议先复制一份 JSON 备份。

### 4. 恢复默认

点「恢复默认设置」即可清空全部自定义。

---

## 卸载

1. 从 `profiles\web\node_modules\` 里删除 `dsh-beautify-plugin` 文件夹。
2. 把 `profiles\web\cordis.patch.yml` 里加的几行删掉。
3. 重启应用。

---

## 常见问题

| 问题 | 解决 |
| --- | --- |
| 改了颜色没反应 / 界面还是旧的 | 浏览器缓存了旧脚本：**刷新页面（F5）**；还不行就**完全重启 DeepSeek Harness** |
| 检查元素时点不中想要的元素 | 点得更靠近文字本身；或滚动后再试；Esc 可退出检查模式 |
| 背景图上传后不显示 | 把「图不透明度」滑块调高一点 |
| 设置被覆盖/想找回 | 点「↩ 撤销」，或从之前导出的 JSON 导入 |
| 完全想清除所有设置 | 删除 `C:\Users\<你的用户名>\.dsh\storages\beautify.json` 后重启 |

---

## 目录结构（给想研究的人）

```
dsh-beautify-plugin/
├── package.json        # 插件声明（浏览器半区 + 补丁层）
├── cordis.patch.yml    # 补丁层：注册插件入口
├── index.js            # 后台部分：启动防闪烁 + 设置持久化接口
├── client.js           # 界面部分：美化页 + 检查元素 + 全部编辑逻辑
└── README.md
```

## 工作原理（简版）

- 插件由 DSH 在启动时加载（`cordis.patch.yml` 声明入口，`node_modules` 提供代码）。
- 配色通过 DSH 主题系统官方覆盖层（`overrideTokens`）应用，浅色/深色各一套，卸载即还原。
- 每个元素的独立设置通过注入 CSS 生效（按元素类名精确匹配，互不影响）。
- 设置自动写入 DSH 数据目录 `storages\beautify.json`，启动时自动恢复。