🎨 dsh-themes

DeepSeek Harness Web GUI 主题集 —— 8 套手调主题（每套含浅色/深色双形态），外加一份基于 @deepseek-ai/* 第一手源码研究的 DSH 插件开发指南。

🌀 极光 · 🌸 樱花 · 🎋 竹影 · 🟣 紫罗兰 · 🔶 琥珀 · 🌊 深海 · ⬛ 石墨 · 🌙 午夜

✨ 特性

🎨 8 套主题 × 双形态	每套 12 个核心色板参数经生成器产出 80 个 --dsw-* 语义 token（浅色/深色各一套值，跟随系统偏好）
🧮 原生 CSS color-mix()	层级/边框/文字/交互等派生色由浏览器实时混色，零 JS 混色工具链
💾 选择持久化	主题选择写入浏览器本地存储（dsh-aurora/settings/v1），刷新/重启后自动恢复上次的选择
🏷️ 语义色统一	错误/成功/警告 8 套共享，语义清晰不混淆
⚡ 双形态安装	会话级动态插件（cordis_define）或持久化正式插件（install.ps1）
📖 完整开发指南	双半区模型 / cordis 五动词 / 插槽系统 / 主题机制 / 持久化 / 社区案例拆解

🚀 快速使用

会话内安装（动态插件）

1. 让 AI 执行 cordis_define：kind: "new"、idPrefix: "aurora"、code.client ← plugins/dsh-aurora/client.js 全文
2. cordis_run 激活并批准授权 —— 页面立即变为极光配色
3. 设置 → 通用 →「🎨 主题」行：8 个色块点击切换，选择自动记住

持久化安装（重启不丢）

powershell -ExecutionPolicy Bypass -File plugins\dsh-aurora\persist\install.ps1
# 然后重启 dsh（npm run dsh）并硬刷新浏览器

安装/卸载/迁移细节见 plugins/dsh-aurora/README.md；npm install 清掉 node_modules 后重跑 install.ps1 即可恢复。静态预览：双击打开 plugins/dsh-aurora/preview.html。

🎨 主题一览

主题	色板（浅色主色 / 深色主色）	气质
🌀 极光 aurora	#0d9488 / #2dd4bf	冷静通透 · 深海质感
🌸 樱花 sakura	#db2777 / #f472b6	温柔甜美 · 粉调
🎋 竹影 bamboo	#4d7c0f / #a3e635	清雅自然 · 抹茶系
🟣 紫罗兰 violet	#7c3aed / #a78bfa	神秘优雅 · 紫色系
🔶 琥珀 amber	#d97706 / #fbbf24	温暖醇厚 · 秋日系
🌊 深海 abyss	#1d4ed8 / #60a5fa	冷静专业 · 蓝色系
⬛ 石墨 graphite	#111827 / #d1d5db	极简专业 · 中性灰
🌙 午夜 midnight	#4f46e5 / #818cf8	静谧深邃 · 蓝紫系

💾 持久化原理

• 内置偏好（light/dark/system）由 Harness 存于 $DSH_HOME/settings.yaml（跨浏览器同步）。
• 第三方主题选择没有 Host 设置命名空间可用：插件选择写入浏览器本地存储（带版本号 key dsh-aurora/settings/v1，读回校验、坏数据回退默认）——跨重启/跨刷新保留，但只对当前浏览器与 origin 生效。
• 想升级为"落盘 settings.yaml + 跨浏览器同步"？开发指南 §8.4 提供 Host 设置缝 + 私有 HTTP 路由 的完整方案（参考 dsh-theme-palettes 案例）。

📁 仓库结构

dsh-themes\
├── README.md                    # 本文档
├── docs\
│   └── DSH-PLUGIN-DEV-GUIDE.md  # 插件开发指南（800+ 行，含社区案例拆解）
└── plugins\
    └── dsh-aurora\              # 主题集插件
        ├── client.js            #   动态版（cordis_define -> code.client）
        ├── README.md            #   设计说明 + 安装/卸载 + token 对照
        ├── preview.html         #   8 套主题静态预览（双击打开）
        └── persist\             #   持久化安装包
            ├── package.json     #     npm 包形态（dsh.client / dsh.bundle）
            ├── index.js         #     Host 半区（空 apply）
            ├── client.js        #     浏览器 bundle（__ModuleLoader__.load 协议）
            ├── cordis.patch.yml #     bundle 补丁层
            ├── install.ps1      #     一键安装脚本（含 patch 去重）
            └── verify.mjs / verify8.mjs  # 契约自检（token 合法性 + 8 主题切换 + 持久化行为）

📖 开发指南

docs/DSH-PLUGIN-DEV-GUIDE.md —— 基于 @deepseek-ai/* 发布包第一手源码研究的 DSH 插件开发手册，核心章节：

章节	内容
§3 十分钟快速上手	最小 Host / Client 半区 + 安装循环
§5 Client 半区	闭包环境 · ctx 门面 · 插槽系统 · 设置行范式
§6 主题插件专项	Token 三层体系 · ThemeRuntime · register vs overrideTokens · 偏好持久化
§7 调试与故障排查	cordis_inspect · 常见错误速查表（含 overrideTokens 形状坑）
§8 发布与分发	正式插件形态 · 安装方式权威矩阵 · §8.3 dsh-theme 案例（localStorage + settings.section + 6 根色模型） · §8.4 dsh-theme-palettes 案例（Host 设置缝持久化 + 三家配色风格对比）
§9 最佳实践	Host / Client 半区踩坑清单

🔗 相关仓库

• deepseek-harness — DeepSeek Harness 主仓
• dsh-workspace — DSH 插件开发工作区
• dsh-one-click-launcher — ⚡ 一键启动器插件
• dsh-eye — 👁 eye 插件

---

本仓库通过 GitHub dsh-plugin topic 加入 DSH 社区插件生态；主题插件为独立社区项目，与 DeepSeek 无隶属或背书关系。