前言¶

在开发基于 DeepSeek Harness (DSH) 的智能体时，经常会遇到需要处理颜色格式、计算对比度或生成配色方案的场景。如果直接让大模型输出 RGB 值往往不够精确，或者需要手动编写转换逻辑。DSH 的插件生态提供了解决这一途径。

插件简介¶

dsh-color 是一个 DSH 客户端插件，由用户 uckkk 维护。它使用纯 Node.js 实现，专注于颜色处理。

核心功能¶

该插件提供以下能力：

• 颜色格式互转：支持 Hex、RGB、HSL 三种格式之间的相互转换。
• 辅助计算：提供补色计算、明暗计算以及前景文字对比度计算。

安装与启用¶

安装该插件需要使用 DSH CLI。

1. 执行安装命令：

    dsh plugin add dsh-color

或者通过 GitHub 仓库安装：

    dsh plugin add github:uckkk/dsh-color

2. 安装后，需要在项目的 profile 目录下的 package.json 中配置 dsh.profile.bundles。在配置文件中添加 "dsh-color" 字段，以将其加载到运行环境中。

典型用法¶

安装成功后，在 DSH 会话中即可调用插件注册的工具。例如，查询某个 Hex 颜色的 RGB 和 HSL 值，以及推荐的前景文字颜色：

这个颜色 #3b82f6 的 rgb 和 hsl 是什么，配什么文字颜色
→ 调用 color_convert(color="#3b82f6")

适用场景与注意事项¶

• 适用场景：该插件适合需要生成高可读性的 UI 配色，或者进行精确的颜色数值计算的智能体开发。
• 安全注意：安装即在本机运行第三方代码，请自行审阅源码（GitHub 仓库）。
• 依赖要求：该插件依赖 @deepseek-ai/cordis (>= 4.0.1) 和 @deepseek-ai/dsh-tools (>= 0.1.0-rc.6)。

总结¶

dsh-color 通过封装纯 Node.js 的计算逻辑，为 DSH 提供了精确的颜色处理能力。开发者可以在智能体开发中直接调用其接口，无需重复造轮子。更多细节可查阅 SkillHub 目录 或 GitHub 仓库。