dsh-colorful-commands:按类别给 DSH 界面着色

前言

在 DeepSeek Harness(DSH)里跑智能体时,一屏里会交替出现推理过程、Shell 命令、读写文件、搜索和网页请求等行。默认样式往往只靠图标或排版区分,长时间盯屏时,哪一行是「危险命令」、哪一行是「思考」并不一眼能分清。有人靠主题或终端配色习惯自己脑补分类;也有人希望客户端在不动功能的前提下,用稳定、低饱和的颜色把语义标出来。dsh-colorful-commands 就是面向后者的 DSH 插件:只给客户端 UI 上色,不改变任何行为。

这是什么

dsh-colorful-commands(展示名「多彩命令」)由维护者 BlanCatOra(作者署名 blancatora)发布,归类为社区目录中的「趣味换装」。仓库声明由 AI 编码代理 blancatora(DeepSeek Harness / deepseek-v4.1-flash)生成,非人类手写;使用前请自行核对 README 与源码。

插件当前版本为 0.2.0,许可证 MIT。它按固定类别给 Harness 界面元素着色,并内置中国传统色、日本传统色、马卡龙三套预设,每个类别在浅色与深色主题下均可单独自定义。

着色覆盖哪些类别

下面表格对应 README 中的分类方式;命令行按命令原文(从 React fiber 读取,而非模型描述)划分三级风险,三档同属红色系、饱和度递增。

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

命令三档红的触发示例(资料中的浅色参考值):

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

正文与推理内容保持原生色;插件只染图标、短标签与关键状态,避免整屏彩色带来的噪音。

预设与自定义

三套预设并非手写固定 hex,而是按语义色相、统一色调,并对真实宿主背景做对比度挑选:

预设 色库
中国传统色(默认) 742 色
日本传统色 58 色
马卡龙 34 色

配色策略在 README 中写得很具体:低饱和优先、浅色与深色各一套独立值、每个色值对背景的对比度约束在 3.0–10.5(改配色会由测试检查)。觉得某一类刺眼时,可在插件详情页把该类别的浅/深色改成更淡的值或恢复预设。

配置入口在侧栏 插件 → dsh-colorful-commands(插件详情页),不在全局「设置」页——这是 DSH 对插件配置的约定。详情页可切换预设、逐类别改色板或填 hex、一键恢复预设值。

安装与启用

目前通过 GitHub 分发(README 写明尚未发布到 npm),安装地址使用仓库 URL,不要自行拼接未在文档出现的命令形式。

桌面版:设置 → 插件 → 添加插件,填入下列地址后重启应用:

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

Web / CLI profile:

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

若之后发布到 npm,README 注明也可使用包名 dsh-colorful-commands。

插件以当前 DSH 进程权限加载客户端补丁;安装前建议浏览仓库源码与 LICENSE,确认符合你的环境策略。社区目录站点 skillhub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系,属于社区生态分发。

一分钟确认是否生效

README 建议将仓库内 docs/DEMO-PROMPT.md 中的 prompt 粘贴到 DSH 发送一次,可一次触发所有能被 prompt 覆盖的配色类别,并附带对照色值表。升级 DSH 后若发现不上色,可先跑该自检,再按仓库 AGENTS.md 的排查顺序定位。

兼容性说明:在 DSH 0.2.1-rc.2(Arch 包 0.2.1rc.2-1)上 README 记载实测通过——插件加载 ok: true、样式注入、122 个元素被正确分类着色。package.json 中 engines.dsh 为 >=0.2.0-0;README 另说明内核版本判定与是否声明 engines.dsh 的取舍见 AGENTS.md。

已知限制与适用场景

适合:希望在 DSH 客户端里用颜色快速区分思考、命令风险、读写、搜索与网页等行,且能接受依赖内核 CSS Module 类名稳定后缀(如 [class*="_title"])的 UI 插件。内核若改后缀,着色可能失效。

需要注意:

  • 只改 UI,不改功能与行为。
  • 过程组内层行(如「创建子智能体」「更新任务清单」)目前只有图标上色,文字保持原生色——内核未提供可区分的语义钩子。
  • japanese / macaron 色库较小,少量类别的浅色与深色可能相同(README 列为已知缺陷)。

开发侧自检可执行:

npm test

即构建加全量测试;lib/client.js 为构建产物且需提交,修改应只动 src/。

结尾

dsh-colorful-commands 把「这一类活动在干什么」映射到一套可预设、可逐类微调的低饱和配色上,并单独处理命令风险三档红与权限、计划模式等控件。若你正在用 DSH 做长会话开发,可以先按上文安装,再用 DEMO-PROMPT 对照色表确认效果。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜