dsh-font-enhancer

Readme

# dsh-font-enhancer

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

![npm](https://img.shields.io/npm/v/dsh-font-enhancer)
![license](https://img.shields.io/github/license/loyalchiiina/dsh-font-enhancer)
![dsh](https://img.shields.io/badge/DSH-Plugin-8A2BE2)

A DSH (DeepSeek Harness) plugin that lets you style the UI **per-region** — each
region (sidebar, message area, input box, code block, etc.) gets its own
Chinese/English font, font-size, line-height, weight, italic, and text color.
Features **unified** global font/color overrides, **theme** save/switch, **框选
(pick-region)** element selection, and **random** font/color generators.

> ✅ **v1.3.0 同时支持 DSH **网页端**（浏览器访问 Web GUI）和 **桌面端**（Electron 内置窗口）。**
> 新增**一键下载安装可爱字体**（霞鹜文楷/得意黑/站酷快乐体等，带实时下载进度）、**添加自提供安装包**、
> **🔄 刷新按钮**、保存方案记住统一状态等功能。搜「字体」即可在插件市场找到本插件。
>
> ✅ v1.3.0 supports both the DSH **Web GUI** (browser) and the **Desktop Electron window**.
> New: one-click install of cute fonts (LXGW WenKai / Smiley Sans / ZCOOL KuaiLe etc. with live
> download progress), add your own font file, refresh button, themes remember unified overrides.
> Search "font / 字体" on the plugin market to find it.

---

## 功能 Features

### 区域样式 Per-region Styling
- Pre-calibrated regions covering the DSH **Web GUI** UI:
  Left sidebar, Logo, New Session, Taskboard entry, Workspace name, Settings,
  Conversation messages, Session title, Composer/input, Tabs, Turn indicator,
  Agent/model name, Right extension panel, Code blocks, Bottom expand bar.
- **Per-region controls**: Chinese font, English font, font-size, line-height,
  font-weight (100–900 slider), italic toggle, text color with color picker.
- Each region has a **checkbox** — tick it to expand the settings panel for that region.

### 全局统一 Unified Controls
- **Unified Color** checkbox: one color picker applies to **all** enabled regions.
- **Unified Font** checkbox: one font family + size applies to **all** enabled regions.
- When unified is ON, the randomizer randomizes the unified value (not per-region).

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

### 主题系统 Theme System
- **Save** the current full configuration (all regions' fonts + colors) as a named theme.
- **Apply** any saved theme to restore its settings.
- **Rename** themes via the inline input + ✏ button.
- **Delete** unwanted themes.
- Themes survive DSH restarts and plugin version bumps.

### 随机生成 Random Generation
- **🎲 Random Font** — randomize Chinese + English font for all (or one) enabled regions.
- **🎨 Random Color** — randomize vivid, high-distinction colors (golden-angle stepping).
- Per-region 🎲/🎨 buttons on each card head for single-region random.

### 面板 UI Panel UI
- Floating **Aa** button (bottom-right, draggable like a pet).
- **Left-right layout** in card head: checkbox + color dot + name on the left,
  🎲font/🎨color/⟳reset/✕delete buttons on the right.
- **Card body** splits into two columns: fonts on the left, size/weight/italic/color
  on the right.
- **Toast** notifications (no window.alert) for all save/apply/delete operations.
- **Reload** the plugin by collapsing the floating button (hide → rebuild).

### 其他
- Font lists mirror Microsoft Word (Times New Roman, Arial, Calibri, 楷体, 宋体, 微软雅黑…).
- Default: English = Times New Roman, Chinese = 楷体 (KaiTi).
- All settings persist in `localStorage`; survive page refresh and DSH restart.
- Panel font is fixed to KaiTi (楷体) so it never changes with the plugin's own rules.

---

## 安装 Install

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

Or copy the folder into `node_modules/` and add the package name to the profile
`bundles` list, then restart DSH.

### Requirements
- DSH Desktop 2.0+ (tested on `0.1.0-rc.6`).
- **本版本仅验证 DSH 网页端（浏览器访问 Web GUI）**；桌面端窗口适配见顶部 ⚠️ 说明。

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

---

## 用法 Usage

1. Click the floating **Aa** button (bottom-right).
2. **Tick** a region's checkbox → the settings panel expands below.
3. Adjust Chinese/English font, size, line-height, weight, italic, and color.
4. Use **统一颜色** / **统一字体** to apply a single setting to all regions.
5. Save your configuration as a **theme** (type a name, click 💾存).
6. Switch themes anytime via the dropdown + **应用** button.
7. Use **🎲 随机字体** / **🎨 随机颜色** for quick experimentation.

### 插件卡顿 Plugin stuck?
- Click the DSH "重载" (Reload) button, or
- Click the **Aa** floating button to collapse it — this triggers a full plugin rebuild.

---

## 快速上手 Quick start

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

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

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

---

## 原理 How it works

Pure **client-side** plugin. `lib/client.js` is a `__ModuleLoader__` bundle that:
1. Injects a `<style>` tag with CSS rules per enabled region.
2. Renders a floating control panel (vanilla JS, no framework).
3. Uses `localStorage` for persistence with a `SCHEMA_VERSION` sentinel.
4. `lib/index.js` is a minimal Cordis module so the bundle loads at all.

No host services, no external dependencies, no build step.

---

## 常见问题 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](https://github.com/loyalchiiina/dsh-font-enhancer/issues) 提 issue。

Found a bug or have an idea? Open an issue at
[GitHub Issues](https://github.com/loyalchiiina/dsh-font-enhancer/issues).

---

## License

MIT