# dsh-colorful-commands

> 给 DeepSeek Harness 的界面按**类别**上色的客户端插件：思考、命令（按危险性分三级）、读写文件、搜索、网络请求、其他工具，以及输入框附近的权限选择/计划模式控件。内置中国传统色、日本传统色、马卡龙三套预设，支持逐类别自定义浅色/深色值。

这是个 **DSH 客户端插件**（不是独立应用）：它通过 `window.__ModuleLoader__`
注册到宿主前端，用 CSS 变量与作用域选择器给已有的 DOM 上色，不替换任何宿主组件。

## 文档

- [README.md](./README.md) — 安装、配置、权限、已知限制（**人类入口**）
- [AGENTS.md](./AGENTS.md) — **怎么改这个仓库**：验证命令、构建产物、硬性约束、
  禁区、本仓库特有的坑（**agent 入口**）
- [CHANGELOG.md](./CHANGELOG.md) — 版本变更记录
- [docs/DEMO-PROMPT.md](./docs/DEMO-PROMPT.md) — **一键配色自检 prompt**：
  粘进 DSH 发一次就能点亮全部配色类别（安装后验证是否生效、或回归测试用）

## 能力（给要调用/集成它的 agent）

- **按类别着色**：从内核 DOM 的 `data-process-activity` / `data-tool` / `data-variant`
  等机器属性判定语义，再用作用域选择器上色。
- **三套传统色预设**：`chinese`（中国传统色 742 色库）/ `japanese`（58 色）/ `macaron`（34 色），
  按语义色相 + 统一色调 + 对真实宿主背景的对比度**自动选色**，不是手写色值。
- **逐类别自定义**：浅色 / 深色主题分别设置，色板快选或填 hex，可一键恢复预设。
- **低疲劳设计**：低饱和、明暗两套独立配色、对比度约束在 3.0–10.5、只染图标与短标签
  （正文保持原生色），长时间使用不刺眼。
- **命令三级风险**：按命令文本的危险迹象分低/中/高，红系（196 色表）对比度递增。
- **状态类固定色**：进度圈四档（`<35` 绿 / `35-49` 黄 / `50-67` 橙 / `>=68` 红）、
  「已完成」成功绿、聚合活动标题（靛蓝）、尾部用量/分支按钮。
- **设置界面**：注册在插件详情页（`plugins.bundle.config`），
  可切预设、逐类别改浅/深色（含 hex 输入与两行色板快选）、恢复预设。

## 快速验证（改代码后）

```sh
npm test     # 构建 + 全量测试（一条命令）
```

## 已知边界

- DSH **客户端插件**（桌面版 / Web 均可），不提供独立 HTTP 服务。
- 依赖内核 CSS Module 类名的**稳定后缀**（`[class*="_title"]` 等），
  内核若改类名后缀会失效（前缀哈希每次构建都变，所以只用后缀）。
- `macaron`/`japanese` 色库较小，有少量类别浅深同色（已知缺陷，已冻结清单，见 AGENTS.md §5.4）。

## 许可

MIT