loyalchiiina/dsh-font-enhancer

dsh-font-enhancer

按区域分别设置 DSH 界面字体、字号、颜色，支持统一控制、主题保存/切换、随机配色/字体。

DSH 的界面长什么样，你说了算。

You decide what DSH looks like.

npm
license
dsh

一个 DSH（DeepSeek Harness）插件，让你可以按区域设置界面样式——每个区域（侧边栏、消息区、输入框、代码块等）都可以拥有自己的中/英文字体、字号、行高、字重、斜体和文字颜色。功能包括统一的全局字体/颜色覆盖、主题保存/切换、框选（选取区域）元素选择，以及随机字体/颜色生成器。

字体区域设置面板

右侧「字体区域设置」面板：选择主题 / 保存方案、全局统一（颜色 / 字体 / 字号 / 字重 / 斜体）、框选区域、随机字体 / 随机颜色、刷新，以及按区域展开的独立属性（英文字体 Times New Roman、中文字体 楷体、字号 15、行距 1.6、字重 400 + 文字颜色）。
按区域设置面板：主题选择器和保存、统一颜色/字体/字号/字重/斜体、框选区域、随机字体/颜色，以及按区域设置的属性。

为什么值得装 / Why it's worth it —— 觉得默认字号太小？中文字体不好看？想给整个界面统一换字体就开「全局统一」，想给某个角落单独上色就点「框选区域」在页面上直接框元素（不用记 CSS 选择器）。配色纠结就点「随机配色」生成一套，喜欢就存成主题随时切回来。

默认字体太小？中文字体不合口味？打开统一，让所有地方都使用同一种字体；或者点击框选区域，直接在实时页面上拖出一个框来设置某个角落的样式——无需 CSS 选择器。拿不定颜色主意？随机颜色会生成一套配色；把你喜欢的保存为主题。

✅ v1.3.0 同时支持 DSH 网页端（浏览器访问 Web GUI）和 桌面端（Electron 内置窗口）。
新增一键下载安装可爱字体（霞鹜文楷/得意黑/站酷快乐体等，带实时下载进度）、添加自提供安装包、
🔄 刷新按钮、保存方案记住统一状态等功能。搜「字体」即可在插件市场找到本插件。

✅ v1.3.0 同时支持 DSH 网页端（浏览器）和桌面端 Electron 窗口。
新增：一键安装可爱字体（霞鹜文楷 / 得意黑 / 站酷快乐体等，带实时
下载进度）、添加你自己的字体文件、刷新按钮、主题记住统一覆盖设置。
在插件市场搜索“font / 字体”即可找到它。

功能总览 · At a glance（中英对照 / Bilingual）

区域样式 · Per-region styling

| 中文 | English |
|---|---|
| 15 个预校准区域：左侧栏、Logo、新建会话、任务板、工作区名、设置、消息区、会话标题、输入区、Tabs、轮次指示、Agent/模型名、右侧扩展面板、代码块、底部展开条 | 15 个预校准区域：侧边栏、Logo、新建会话、任务板、工作区名、设置、消息区、会话标题、输入区、Tabs、轮次指示、Agent/模型名、右侧面板、代码块、底部栏 |
| 每区域独立设置：中文字体、英文字体、字号、行距、字重（100–900 滑块）、斜体、文字颜色（取色器） | 按区域设置：中文字体、英文字体、字号、行高、字重（100–900 滑块）、斜体、文字颜色（取色器） |
| 勾选区域复选框展开该区域设置面板 | 勾选某个区域的复选框即可展开该区域的设置面板 |

全局统一与框选 · Unified & pick-region

| 中文 | English |
|---|---|
| 「统一颜色」：一个取色器应用到所有启用区域 | 统一颜色：一个取色器应用到所有启用区域 |
| 「统一字体」：一种字体+字号应用到所有启用区域 | 统一字体：一种字体 + 字号应用到所有启用区域 |
| 「框选区域」：在实时页面上拖框直接选中元素，无需记 CSS 选择器 | Pick Region：在实时页面上拖框直接选中元素，无需记 CSS 选择器 |

主题系统 · Theme system

| 中文 | English |
|---|---|
| 保存整套配置为命名主题 | 将整套配置保存为命名主题 |
| 应用 / 重命名 / 删除主题 | 应用、重命名和删除主题 |
| 主题跨 DSH 重启与插件版本升级保留 | 主题在 DSH 重启与插件版本升级后保留 |

随机生成与字体 · Random & fonts

| 中文 | English |
|---|---|
| 🎲 随机字体（中/英）与 🎨 随机配色（黄金角高区分度配色） | 🎲 随机字体与 🎨 鲜艳高区分度配色（黄金角步进） |
| 一键下载安装可爱字体（霞鹜文楷 / 得意黑 / 站酷快乐体等，带实时进度） | 一键安装可爱字体（霞鹜文楷 / 得意黑 / 站酷快乐体等），带实时进度 |
| 添加自提供安装包：选择本地字体文件自动校验并安装 | 添加你自己的字体文件：选择本地文件，自动校验并安装 |
| 字体列表与 Microsoft Word 一致（Times New Roman、楷体、宋体、微软雅黑…） | 字体列表与 Microsoft Word 一致（Times New Roman、楷体、宋体、微软雅黑…） |

三球共享皮肤 · Shared ball skins

| 中文 | English |
|---|---|
| 与 dsh-todo-float-ball / dsh-skill-browser 共享同一套 128 款皮肤目录（window.__DSH_BALL_SKINS） | 与 dsh-todo-float-ball / dsh-skill-browser 共享同一套 128 款皮肤目录（window.__DSH_BALL_SKINS） |
| 任一处切换，三个悬浮球与其面板颜色实时同步 | 在任一处切换，三个悬浮球与其面板颜色实时同步 |
| 「原版（仅本球）」选项可让字体球单独回到原始暖极光外观 | 「原版（仅本球）」选项可让字体球单独回到原始暖极光外观 |

平台与持久化 · Platforms & persistence

| 中文 | English |
|---|---|
| 网页端（浏览器访问 Web GUI）与桌面端（Electron 内置窗口）双端可用 | 网页端（浏览器访问 Web GUI）与桌面端（Electron 内置窗口）双端可用 |
| 全部设置存 localStorage，刷新与重启后保留 | 全部设置存于 localStorage，刷新与重启后保留 |
| 纯客户端插件，无宿主服务、无外部依赖、无构建步骤 | 纯客户端插件：无宿主服务、无外部依赖、无构建步骤 |

功能 Features

区域样式 Per-region Styling
- 预校准区域，覆盖 DSH Web GUI 界面：
左侧边栏、Logo、新建会话、任务板入口、工作区名称、设置、
对话消息、会话标题、输入框/编辑器、标签页、轮次指示器、
智能体/模型名称、右侧扩展面板、代码块、底部展开栏。
- 按区域控制：中文字体、英文字体、字号、行高、
字重（100–900 滑块）、斜体开关、文字颜色（带取色器）。
- 每个区域都有一个复选框——勾选后展开该区域的设置面板。

全局统一 Unified Controls
- 统一颜色复选框：一个取色器应用于所有已启用区域。
- 统一字体复选框：一个字体族 + 字号应用于所有已启用区域。
- 当统一开启时，随机生成器随机化统一值（而非按区域）。

🎨 三球共享 128 皮肤 Unified Ball Skins
- 与 dsh-todo-float-ball / dsh-skill-browser 共享同一套 128 款皮肤目录（window.__DSH_BALL_SKINS）。
- 面板 🎨 按钮或 DSH 设置页任一处切换，三个悬浮球与其展开面板颜色实时同步。
- 「原版（仅本球）」选项可让字体球单独回到原始暖极光外观，不影响另两球。

主题系统 Theme System
- 保存当前完整配置（所有区域的字体 + 颜色）为命名主题。
- 应用任何已保存的主题以恢复其设置。
- 通过内联输入框 + ✏ 按钮重命名主题。
- 删除不需要的主题。
- 主题在 DSH 重启和插件版本升级后依然保留。

随机生成 Random Generation
- 🎲 随机字体 — 为所有（或单个）已启用区域随机化中文 + 英文字体。
- 🎨 随机颜色 — 随机化鲜艳、高区分度的颜色（黄金角步进）。
- 每个卡片头部都有按区域的 🎲/🎨 按钮，用于单区域随机。

面板 UI Panel UI
- 浮动 Aa 按钮（右下角，可像宠物一样拖动）。
- 卡片头部采用左右布局：左侧为复选框 + 颜色圆点 + 名称，
右侧为 🎲字体/🎨颜色/⟳重置/✕删除按钮。
- 卡片主体分为两列：左侧为字体，右侧为字号/字重/斜体/颜色。
- 所有保存/应用/删除操作均使用 Toast 通知（不使用 window.alert）。
- 通过折叠浮动按钮重载插件（隐藏 → 重建）。

其他
- 字体列表与 Microsoft Word 一致（Times New Roman、Arial、Calibri、楷体、宋体、微软雅黑…）。
- 默认：英文 = Times New Roman，中文 = 楷体（KaiTi）。
- 所有设置持久化于 localStorage；在页面刷新和 DSH 重启后依然保留。
- 面板字体固定为楷体（KaiTi），因此不会随插件自身规则而变化。

安装 Install

From the DSH profile directory:
dsh plugin --profile desktop add ./dsh-font-enhancer

或将文件夹复制到 node_modules/，并将包名添加到配置文件的
bundles 列表中，然后重启 DSH。

Requirements
- DSH Desktop 2.0+（已在 0.1.0-rc.6 上测试）。
- 本版本仅验证 DSH 网页端（浏览器访问 Web GUI）；桌面端窗口适配见顶部 ⚠️ 说明。

版本 Versions
| 版本 | 说明 |
|------|------|
| v1.3.0 | 最新：网页端+桌面端双端可用。一键下载安装可爱字体（带进度）、添加自提供安装包、刷新按钮、保存方案记住统一状态、字重斜体。搜「字体」可找到。 |
| v1.0.0 | 旧版：内置区域样式 + 统一控制 + 主题。 |

用法 Usage

1. 点击浮动 Aa 按钮（右下角）。
2. 勾选某个区域的复选框 → 设置面板会在下方展开。
3. 调整中文/英文字体、字号、行高、字重、斜体和颜色。
4. 使用统一颜色 / 统一字体将单个设置应用到所有区域。
5. 将你的配置保存为主题（输入名称，点击 💾存）。
6. 随时通过下拉框 + 应用按钮切换主题。
7. 使用 🎲 随机字体 / 🎨 随机颜色进行快速试验。

插件卡顿 Plugin stuck?
- 点击 DSH 的“重载”（Reload）按钮，或
- 点击 Aa 浮动按钮将其折叠——这会触发完整的插件重建。

快速上手 Quick start

想给所有消息区域换一种字体/颜色？
1. 点右下角 Aa 按钮打开面板。
2. 在 全局统一 区勾选 统一字体 → 选中文/英文字体 → 所有区域立即统一。
3. 勾选 统一颜色 → 点色块选色 → 所有区域统一变色。

想单独设置 输入框 的字号？
1. 打开面板 → 找到「输入区」卡片 → 勾选它的复选框（展开设置）。
2. 右侧列改 字号 / 字重，左侧列改中/英文字体。

想存一套配色以后换着用？
1. 调好各区域字体、颜色。
2. 在顶部输入框填名字 → 点 💾存。
3. 之后随时在下拉框选中 → 点 应用 切换。

原理 How it works

纯客户端插件。lib/client.js 是一个 __ModuleLoader__ 包，它会：
1. 注入一个  标签，为每个已启用区域设置 CSS 规则。
2. 渲染一个浮动控制面板（原生 JS，无框架）。
3. 使用 localStorage 进行持久化，并带有 SCHEMA_VERSION 哨兵值。
4. lib/index.js 是一个极简的 Cordis 模块，以便该 bundle 能够被加载。

无宿主服务、无外部依赖、无构建步骤。

常见问题 FAQ

插件卡住了 / 样式不生效？
- 点击 DSH 左下角 重载 按钮。
- 或点击右下角 Aa 悬浮球使其折叠——折叠时会自动重建插件（删除旧注入样式并重新初始化）。

区域颜色互相串色 / 某区域颜色不对？
- 检查该区域是否被更靠前的区域（如 body 兜底区域）覆盖。
- 15 个预校准区域的顺序已按层叠优先级排列，但如果你自定义了区域，注意后列出的规则会覆盖前面的（同特异性）。
- 各区域的具体 CSS 选择器可在卡片中查看和编辑。

统一颜色/字体勾选了，但随机后没变化？
- 统一开关 开启 时，随机按钮直接改变统一值（统一颜色/字体本身），而不是改变各区域。这是正常行为——关掉统一开关后随机才会分别改各区域。

主题保存后找不到？
- 保存成功会有 toast 提示"已保存：xxx"。主题在下拉框中，选中后点击 应用 即可切换。
- 主题保存在 localStorage，升级插件版本也不会丢失。

面板字体怎么是楷体，和界面字体不一样？
- 面板字体固定为楷体（KaiTi），这是有意为之——防止插件自身的 CSS 规则覆盖面板 UI，确保面板始终可读。

文件结构 File structure

dsh-font-enhancer/
├── package.json        # Plugin manifest with dsh.bundle + dsh.client
├── cordis.patch.yml    # Cordis patch: registers the bundle
├── lib/
│   ├── index.js        # Host half (minimal Cordis module)
│   └── client.js       # Client bundle (all UI + logic, ~1000 lines)
├── README.md           # This file
├── LICENSE             # MIT
└── .gitignore

支持 Support

发现 bug 或有功能建议？欢迎在
GitHub Issues 提 issue。

Found a bug or have an idea? Open an issue at
GitHub Issues.

License

MIT