颜色预览 ywsldxk/dsh-color-preview

dsh-color-preview

DeepSeek Harness 颜色预览插件：按需预览对话中提到的十六进制颜色。

当模型在对话中给出一个颜色代码（如 #F59E0B）时，你只需要说一句「预览这个颜色」，对话流里就会渲染出一张色块卡片——72px 真实色块 + RGB / HSL / WCAG 对比度 / 颜色名。

为什么做这个

Codex 终端里输入 #F59E0B 会显示一个同字号的小色块，而 DeepSeek Harness 没有这个能力。我们本可以修改 markdown 渲染器全局扫描 #hex，但那会：

- 引入常驻扫描的性能开销（每个 text 节点跑正则）
- 产生误匹配（#fff、#123456 在代码、issue 编号里到处都是）
- 需要 patch 编译产物，升级即被覆盖

这个插件选择了另一条路：零扫描、零渲染开销，只有工具被调用才工作。这正是「按需」的含义——不常驻、不打扰、要的时候一秒钟出结果。

特性

- ✅ 按需触发：模型给出色号 → 你说「预览」→ 卡片出现。不扫描、不常驻、零性能影响
- ✅ 真实色块：对话流内渲染 72px 色块，暗色自动配白字、亮色配黑字
- ✅ 完整信息：RGB / HSL / 白字对比度 / 黑字对比度 / 常用颜色名（中英双语）
- ✅ 格式宽容：支持 #F59E0B（6 位）、#fff（3 位）、#ff000080（8 位含透明度）
- ✅ 纯增量：注册在 tool.call.toolview 的开放 key 域，不替换任何官方 UI
- ✅ 无源码改动：纯 Cordis 动态插件机制，不动 node_modules，升级不丢

安装

方法一：作为 preset 静态插件（推荐，持久）

1. 把 color-preview.mjs 复制到你的 agent preset 目录：

$target = Join-Path $env:USERPROFILE '.dsh\.agent-presets\<你的preset>\color-preview.mjs' Copy-Item -LiteralPath .\color-preview.mjs -Destination $target

2. 在 agent.cordis.yml 里加一行（放在任意位置）：

- id: color-preview
name: ./color-preview.mjs

3. 重启 DSH，新建会话即可。

方法二：作为动态插件（临时体验）

如果你只是想试试，可以在 DSH 的创造模式（cordis preset）里用动态插件机制加载本文件的 host / client 两半。

使用

1. 对话里让模型给一个颜色（或自己提一个）：「帮我看看 #F59E0B 这个颜色」
2. 模型调用 color_preview 工具
3. 对话流里出现色块卡片：

┌──────────────────────────┐
│ ████████████████████████ │ ← 72px 真实色块 │ #F59E0B │ ├──────────────────────────┤ │ 名称: Amber 琥珀 │ │ RGB: rgb(245, 158, 11) │ │ HSL: hsl(38, 92%, 50%) │ │ 白字对比度: 2.15:1 │ │ 黑字对比度: 9.78:1 │ └──────────────────────────┘

工作原理

Host 半：harness.defineTool 注册 color_preview hex → RGB → HSL → WCAG 亮度/对比度 → 颜色名 ↓ 返回 JSON Client 半：slots.register('tool.call.toolview', key='color_preview') 读取 ToolCallBlock（RunningToolCall | ToolResultNode）的 argsRaw + content → 渲染色块卡片

关键点：Client 读取的 ToolCallBlock 字段是 callId / argsRaw / content（RunningToolCall 与 ToolResultNode 两种形态），不是 arguments / result——这是本插件调试中踩过的最大的坑。

兼容性

- DeepSeek Harness 0.1.0-rc.6 实测通过
- 需要支持动态工具注册（harness.defineTool）与 tool.call.toolview Slot 的版本

许可

MIT License。参见 LICENSE。

相关

- DeepSeek Harness — 官方仓库（社区插件请发布到自己的项目并打上 dsh-plugin topic）