README
dsh-gui-customization — DeepSeek Harness 时装工坊
中文 | English
dsh-gui-customization
DeepSeek Harness Web UI 的主题定制插件：Nous 蓝默认配色（明暗双模式）、四套预设与 13 色自定义、氛围光（光晕/呼吸/位置实时可调）、动态背景（图片/视频，原生文件选择 + 内置预设「deepseek娘01」+ 背景透明度滑块 + 侧边栏透明开关）、配色导入/导出，中英双语、设置持久化、跨重启保留。配置入口：设置 → 界面设定。
成品展示
| 能力 | 说明 |
|---|---|
| 配色 | Nous 蓝默认主题（明暗双模式）+ 系统默认/Nous 蓝/靛紫/翡翠绿四预设 + 13 色自定义 |
| 氛围光 | 角落光晕随主题主色联动；强度、呼吸幅度、位置（5 模式）实时可调 |
| 动态背景 | 图片（原生选文件 + 预设「deepseek娘01」）与视频（静音循环）双模式，互斥切换；主区透出 + 明暗自适应遮罩；背景透明度滑块 + 侧边栏透明开关；IndexedDB 持久化 |
| 导入/导出 | 配色方案一键导出 JSON（自动复制剪贴板）、粘贴导入即应用 |
| 双语 | 中 / 英文案随 DSH 语言设置即时切换 |
| 持久化 | localStorage + IndexedDB，刷新页面与重启 DSH 后完整恢复 |
| 正式形态 | 组合插件，跨重启存在，出现在「设置 → 插件」区 |
快速安装
GitHub 直装（推荐，国内网络最快，免等 npm）：
dsh plugin --profile web add github:LAN-TINA-WS/dsh-gui-customization#path:packages/dsh-gui-customization
# 重启 dsh web，打开「设置 → 界面设定」开始配置
npm 安装（一条命令）：
dsh plugin --profile web add dsh-gui-customization
Release ZIP 安装：
- 从 Releases 下载
dsh-gui-customization-v*.zip并解压 dsh plugin --profile web add link:<解压目录>/dsh-gui-customization-v0.5.2- 重启
dsh web，打开「设置 → 界面设定」开始配置
从源码构建安装（开发者）：
pnpm install && pnpm build # 产出 packages/dsh-gui-customization/lib/
dsh plugin --profile web add link:<仓库>/packages/dsh-gui-customization
配置指南
「设置 → 界面设定」内：
| 区块 | 内容 |
|---|---|
| 预设配色 | 系统默认 / Nous 蓝 / 靛紫 / 翡翠绿，一键应用 |
| 自定义颜色 | 13 个主题色字段（取色器 + 文本），点「应用配色」生效 |
| 导入/导出 | 导出配色 JSON（自动复制剪贴板）；粘贴 JSON 导入即应用 |
| 氛围光 | 开关、强度、呼吸幅度、位置（5 模式），实时生效 |
| 背景图 | 选图片文件 / 预设「deepseek娘01」/ 选视频文件（静音循环）；背景透明度滑块；侧边栏透明开关 |
反馈
问题、需求、配色分享：提交到 issue #1（欢迎反馈）。
贡献者
| 贡献者 | 贡献 |
|---|---|
| LAN-TINA-WS | 项目作者与维护者 |
| QinYun165 | 大量 BUG 反馈 |
| FuturePioneer-3 | 深色主题背景图修复（PR #2） |
License
本项目采用 MIT License。仓库内 build/ 下的 tsdown 构建 preset 源自 dsh-web-ui（BSD-3-Clause，© zhu1090093659），其许可声明保留在各文件头部。
开发者文档
开发工艺（编写规范、DSH 能力清单、动态插件原型 → 组合插件转正流程）见 docs/：
| 文档 | 内容 |
|---|---|
| conventions.md | 插件编写规范与常见失败速查 |
| capabilities-client.md | DSH Client 槽位/服务/事件/主题令牌清单 |
| capabilities-host.md | DSH Host 服务/事件/Builtin 清单 |
| roadmap-composition.md | 组合插件转正施工记录 |
| packages/dsh-gui-customization/README.md | 插件包档案（功能/安装/版本台账） |
仓库结构：packages/（插件本体）、plugins/（开发轨动态原型，历史档案）、templates/、build/、docs/、scripts/。
更多「介面與體驗」外掛
dsh-web-ui
作者 zhu1090093659
DeepSeek Harness Web UI 的外掛與皮膚合集，涵蓋任務看板、Git 圖譜、側邊面板、移動端介面、寵物與即時 Token 統計。
dsh-better-sidebar
作者 omdsh-dev
開放的側邊欄底座，支援三方拓展註冊新側邊欄頁面。內建檔案渲染編輯/終端/Git/子代理頁面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公眾號收錄的 TUI 補位外掛：Claude Code 風，鯨魚頂欄/即時狀態/流式思考/雙擊 Esc 回滾/上下文進度+TPS。npm 一鍵裝。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
openpets
作者 alvinunreal
本地優先的桌面陪伴平臺，提供動效寵物、外掛 SDK 與編碼智慧體整合。