彩色命令面板 BlanCatOra/dsh-colorful-commands

dsh-colorful-commands

给 DeepSeek Harness 的界面按类别上色 —— 思考、命令（按危险性分三级）、读写文件、搜索、网页请求、其他工具，以及输入框旁的权限选择与计划模式控件。

内置传统色预设（中国传统色 742 色库 / 日本传统色 / 马卡龙），每个类别都能自定义浅色与深色；配色刻意走低饱和、受对比度约束，长时间盯着不刺眼、不容易累。

🤖 AI 生成声明：本仓库由 AI 编码代理 blancatora（DeepSeek Harness / deepseek-v4.1-flash）生成，非人类手写。内容可能存在错误或未经充分验证之处，使用前请自行核实。
This project was generated by an AI coding agent — see README.en.md.

🤖 给 AI agent：动手改这个仓库之前，先读 AGENTS.md（怎么改：验证命令、产物、硬性约束、禁区、本仓库特有的坑）与 llms.txt（怎么用：能力、文档索引、已知边界）。人类可以忽略这一行。

它做什么

| 类别 | 着色对象 |
| 思考 / 推理 | 推理行、过程组标题 |
| 命令 · 低 / 中 / 高风险 | bash / pwsh 行 —— 按命令原文的危险迹象分三级，三级同属红色系、饱和度递增 |
| 读取文件 | read、图片读取 |
| 写入 / 编辑 | write / edit |
| 搜索 | grep / glob |
| 网页请求 | web_search / web_fetch |
| 其他工具 | 未分类工具（中性色） |
| 状态 | 「已完成」成功绿、进度圈四档、混合活动标题、尾部「用量 / 分支」 |
| 界面控件 | 权限选择（按等级换色）、计划模式 |

按类别着色：思考 / 命令三档红 / 读写 / 搜索 / 网页 / 混合活动 / 子智能体 / 计划

深色主题下一屏里的实际效果 —— 每类一行颜色：思考紫、命令按风险分三档红、读写绿、搜索青、网页靛蓝、混合活动统一靛蓝、子智能体与计划中性色。

预设与自定义

| 预设 | 色库 | |
| 中国传统色（默认） | 742 色 | 从完整传统色库按语义色相挑选，色调统一、低饱和 |
| 日本传统色 | 58 色 | 更清淡的日式配色 |
| 马卡龙 | 34 色 | 粉彩系，最柔和 |

颜色不是手写色值 —— 按语义色相 + 统一色调 + 对真实宿主背景的对比度自动挑选。

每个类别都能单独改：浅色主题与深色主题分别设置，色板快选或直接填 hex，一键恢复预设值。设置入口在插件详情页（见下方「配置」）。

插件详情页设置：预设切换 + 逐类别浅色/深色两套色板

插件详情页：顶部切预设（中国传统色 / 日本传统色 / 马卡龙 / 不预设），下面每个类别都有浅色、深色两套色板与 hex 输入，可随时恢复预设。

为什么耐看、不容易累眼

- 低饱和优先 —— 全局压低饱和度，不用荧光色、不用高饱和正红正蓝。
- 明暗两套独立配色 —— 浅色主题和深色主题各有一套值，不是同一色值硬套。
- 对比度受约束 —— 每个色值对背景的对比度都在 3.0–10.5 之间：太低看不清，太高刺眼。这条约束写进了测试，改配色会被自动检查。
- 只染该染的 —— 只上色图标、短标签与关键状态；正文与推理内容保持原生色。
避免整屏彩色带来的视觉噪音，这也是"看久了不累"的关键。
- 觉得哪个刺眼就自己调 —— 任一类别的浅/深色都能改成更淡的值。

状态、用量与输入框控件

消息尾部按钮、压缩行、进度圈、输入框底部控件

消息尾部只给「用量」与「分支」上色（复制 / 点赞 / 点踩保持原生灰）；「正在压缩」行、上下文进度圈、输入框旁的权限选择与计划模式也各有配色。

安装

目前通过 GitHub 分发（尚未发布到 npm），所以用 Git 地址安装。

桌面版：设置 → 插件 → 添加插件，填下面这个地址，然后重启应用：

https://github.com/BlanCatOra/dsh-colorful-commands

Web / CLI profile：

dsh plugin --profile <profile> add https://github.com/BlanCatOra/dsh-colorful-commands

若之后发布到 npm，也可以直接用包名 dsh-colorful-commands。

一分钟确认它真的生效

把 docs/DEMO-PROMPT.md 里的 prompt 粘进 DSH 发一次，它会一次点亮所有能被 prompt 触发的配色类别，并附对照色值表。

配置

侧栏 插件 → dsh-colorful-commands（插件详情页）。可以：切换预设、逐类别改浅色 / 深色（色板快选或直接填 hex）、恢复预设值。

⚠️ 插件设置不在「设置」页 —— DSH 的约定是插件配置放在各自的插件详情页。

命令三档红

按命令原文（从 React fiber 读取，不是模型给的描述）匹配危险词：

| 档位 | 触发示例 | 浅色 |
| 低 | 普通命令 | #A7535A |
| 中 | 含 sudo、curl、chmod -R、systemctl 等 | #C02C38 |
| 高 | 含 rm -rf /、mkfs、dd of=/dev/、git push --force 等 | #DE2A18 |

三档同属红色系，只靠饱和度递增表达危险度。

已知限制

- 只给客户端 UI 上色，不改变任何功能与行为。
- 依赖内核 CSS Module 类名的稳定后缀（如 [class*="_title"]）；内核若改后缀会失效（前缀哈希每次构建都变，所以只匹配后缀）。
- 过程组内层行（如「创建子智能体」「更新任务清单」）只有图标上色，文字保持原生色 ——内核没给这些行可区分的语义钩子，见 AGENTS.md §5.6。
- japanese / macaron 色库较小，有少量类别的浅色与深色相同（已知缺陷，清单已冻结在测试里）。

开发

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

lib/client.js 是构建产物，要提交；只改 src/，不要手改产物。
动手前请先读 AGENTS.md。

许可

MIT © 2026 blancatora