theme-coach-dsh

Readme

# theme-coach-dsh 🎨（DSH 适配版 · UI 主题设计顾问）

`openclaw-ui-theme-coach`（v1.5.0）的 **DSH（DeepSeek Harness）适配版**：通过问答引导帮用户定制任意 Web UI / DSH 界面的主题。

> OpenClaw 用户请用上游版 [hanhan1137/openclaw-ui-theme-coach](https://github.com/hanhan1137/openclaw-ui-theme-coach)；本仓库 = DSH 社区分发版。

## 五大能力

- 🎨 **通用方法论**：问答引导、设计令牌、可读性、验证
- 🧭 **素材指路（默认官方）**：用户要某 IP/风格时，默认帮找官方/授权素材渠道（最贴原版），**自绘仅当用户明确要求或官方素材不可得**（v1.5.0 新规则）
- 📚 **风格技术库**：`references/styles/` 数据化模板（5 种内置 + 社区可扩展）
- 📦 **主题包交付**：产出可落地的 CSS 变量 + 注入模板 + 素材（DSH 版无 heal.sh，主题包即快照，手动重灌）
- 🔁 **反馈学习**：记录用户偏好，越用越贴合

## 安装（DSH）

```bash
# 方式一：克隆到 DSH skills 目录
git clone https://github.com/hanhan1137/theme-coach-dsh.git ~/.dsh/skills/theme-coach-dsh

# 方式二：直接下载 SKILL.md（纯 Markdown + Python 脚本，零依赖）
mkdir -p ~/.dsh/skills/theme-coach-dsh
curl -L https://raw.githubusercontent.com/hanhan1137/theme-coach-dsh/main/SKILL.md -o ~/.dsh/skills/theme-coach-dsh/SKILL.md
# 再把 scripts/ 和 references/ 一并拉下来即可
```

装完重启 dsh 会话，说「帮我做个 XX 风的主题」即触发。

## 怎么用

1. 告诉 DSH 你想做什么风格的主题（或某个 IP，如「海绵宝宝全家桶」「Hello Kitty」）
2. 问答引导确认风格→色彩→氛围（可读性默认锁死）
3. **默认走素材指路**：DSH 帮你找官方/授权素材渠道 → 你下载存本地 → 本地路径引用
4. 主色派生调色板：`python3 scripts/derive-palette.py '#FDF56C' --light`
5. 对比度必查配对清单逐对跑 + 反模式自查（10 对全过才交付）
6. 交付主题包（CSS 变量 + 注入模板 + 素材 + README）

## 与上游的差异

见 [ADAPTATION.md](ADAPTATION.md)：去掉 OpenClaw 专属的 Control UI dist 注入 + heal.sh 自愈假设（DSH 无此环境），交付物 = 主题包；`name: theme-coach-dsh` 匹配目录名（Agent Skills 标准硬规则）。

## 文件结构

```
theme-coach-dsh/
├── SKILL.md                      # 主文档（v1.0.0）
├── README.md                     # 本文件
├── ADAPTATION.md                 # 与上游差异说明
├── references/
│   ├── minecraft-example.md      # MC 像素风完整案例
│   └── styles/                   # 风格技术库（5+1 模板）
├── scripts/
│   ├── derive-palette.py         # 主色派生调色板（--light 浅色）
│   └── contrast-check.py         # WCAG 对比度检查
├── test-prompts.json             # 自测用例
└── data/feedback.json            # 用户偏好记录
```

> 版本 1.0.0 · 基于 openclaw-ui-theme-coach v1.5.0 · 2026-08-21 发布