dsh-colorful-commands

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

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

English | 中文

🤖 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 色库较小，有少量类别的浅色与深色相同（已知缺陷，清单已冻结在测试里）。

兼容性

在 DSH 0.2.1-rc.2（Arch 包 0.2.1rc.2-1，内置 runtime 0.2.1-rc.2）实测通过： 插件正常加载（ok: true）、样式注入、122 个元素被正确分类着色，颜色与设计值一致。

• 内核版本判定见 AGENTS.md §3.5：本插件是否声明 engines.dsh 有讲究， 当前刻意不声明（理由见该节）。
• 升级 DSH 后若发现不上色，先跑 docs/DEMO-PROMPT.md 自检， 再按 AGENTS.md 的排查顺序定位。

开发

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

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

许可

MIT © 2026 blancatora