CSS 颜色工具箱TYEclipse/dsh-color

dsh-color

DeepSeek Harness (dsh) 颜色工具箱：解析并转换任意 CSS 颜色、计算 WCAG 对比度、查询 CSS 颜色名称、生成和谐配色方案、调整颜色明暗与饱和度。

纯本地数学计算——零运行时依赖、无网络、无副作用。

工具

| 工具 | 说明 |
|------|------|
| convert_color | 解析任意 CSS 颜色（hex #rgb/#rgba/#rrggbb/#rrggbbaa、rgb()/rgba()、hsl()/hsla()、hwb()、CSS 颜色名），并转换为 hex / rgb / hsl / hwb——或一次性输出全部格式 |
| contrast_ratio | 两个颜色的 WCAG 2.x 对比度，并给出普通/大号文字的 AA/AAA 判定（WCAG 1.4.3 阈值） |
| color_info | CSS 颜色名查询：按名称子串搜索（"blue" → blue、blueviolet、lightblue…）或按精确值反查（aqua ≡ cyan），每个匹配给出 hex/rgb/hsl/相对亮度 |
| color_scheme | 由基色生成和谐配色：互补、类似（3/5 色）、三角、分裂互补、四角（矩形）、方形、单色（2–9 个明度梯度）——每个颜色输出 hex + rgb + hsl |
| adjust_color | 调整颜色：变亮 / 变暗 / 加饱和 / 去饱和（百分点）或色相旋转（度数）——输出 hex + rgb + hsl |

安装

dsh plugin --profile web add github:TYEclipse/dsh-color

把 web 换成你的 profile 名（dsh plugin 没有默认 profile）。

使用示例

convert_color("rebeccapurple")
→ hex #663399, rgb(102, 51, 153), hsl(270, 50%, 40%), hwb(270 20% 40%)

convert_color("#ff000080", format: "hex")
→ #ff000080（保留 alpha）

contrast_ratio("#777777", "#ffffff")
→ 4.48:1——普通文字不达标，大号文字 AA

contrast_ratio("white", "hsl(0, 100%, 50%)")
→ 4.0:1——仅大号文字 AA

color_info(query: "blue", limit: 5)
→ blue #0000ff、blueviolet #8a2be2、cadetblue #5f9ea0、…

color_info(query: "#00ffff", by: "value")
→ aqua、cyan（都映射到 #00ffff）

color_scheme("#336699", type: "triadic")
→ #336699, #993366, #669933

color_scheme("#ff0000", type: "analogous", count: 5)
→ #ff00ff, #ff0080, #ff0000, #ff8000, #ffff00

color_scheme("#336699", type: "monochromatic", count: 4)
→ #030508, #24476b, #4f8ac4, #b3cce6

adjust_color("#336699", op: "lighten", amount: 25)
→ #79a6d2

adjust_color("#ff0000", op: "hue", amount: 120)
→ #00ff00

特性

- 输入格式：hex 缩写/全写（3/4/6/8 位）、传统逗号语法（rgb(255, 0, 0)）与现代空格语法（rgb(255 0 0 / 50%)）、百分比（rgb(100% 0% 0%)）、色相角度单位（deg/rad/grad/turn）、全部 148 个 CSS Color 4 命名色、以及 transparent。
- Alpha 全程保留；hex 仅在 alpha < 1 时输出 8 位形式。
- WCAG 数学：按 WCAG 2.x 计算相对亮度（sRGB 线性化）、对比度 (L1+0.05)/(L2+0.05)；普通文字 AA 4.5 / AAA 7，大号文字（≥18pt 或 ≥14pt 加粗）AA 3 / AAA 4.5。
- 配色数学：旋转类方案保持基色饱和度/明度，按经典偏移旋转色相（互补 +180°、三角 +120°/+240°、分裂互补 +150°/+210°、四角 +60°/+180°/+240°、方形 +90°/+180°/+270°）；类似色以基色为中心（−30°/0/+30°，5 色时 −60°/−30°/0/+30°/+60°）；单色保持色相/饱和度、明度在 [l−0.4, l+0.4]（钳制到 [0.02, 0.98]）内均匀步进。
- 调整数学：变亮/变暗/加饱和/去饱和按百分点移动通道（钳制 0–100）；色相按度数旋转（任意符号，自动归一化）。灰色加饱和为空操作（与 CSS filter 语义一致）。
- 通道序列化：四舍五入（0.5 进位）并带浮点尘埃防护，与 CSS 序列化一致（如 hsl(210, 100%, 50%) → rgb(0, 128, 255)）。
- 越界通道自动钳制（现代 CSS 行为）。

开发

pnpm install     # 提示构建脚本审批时用 CI=true
pnpm build       # tsc → dist/
pnpm test        # vitest
pnpm lint        # oxlint src test

许可证

MIT