← 返回列表
⚠ 装前注意
DeepSeek Harness 主题体验插件：OKLCH 主题提案 + 主题设计器跨重启持久化
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/8/14 · 已提供中文文档
DeepSeek Harness 主题体验插件：OKLCH 主题提案 + 主题设计器（跨重启持久化）
综合分
35.3
GitHub 分
35.3
用户评分
—
★ Stars
11
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add suzike/freestyle-dsh-theme未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@linxin666/freestyle-dsh-theme（未发布到 npm，仅可源码安装）
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 02:57:35
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-settings@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-llm@deepseek-ai/dsh-settings用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
freestyle-dsh-theme
freestyle-dsh-theme 是 DeepSeek Harness (DSH) 的 Web GUI 主题体验插件：基于 OKLCH 色彩模型，提供「主题提案」与「主题设计器」两大能力，让用户一键换肤、自由调色。作为常驻 Web 插件热插拔安装，跨重启持久化。
✨ 特性
主题提案 · 6 套风格预设 + 智能提案，点卡片即应用
主题设计器 · 主色 / 副色 / 面板 三通道独立调节
- 🎨 OKLCH 配色模型 — 色相 / 彩度 / 明度三通道独立可控，直觉且色彩感知均匀
- 🧭 配色关系 — 邻近 / 互补 / 分裂互补 / 三角色 一键派生副色与面板色
- 🔒 通道锁定 — 锁定某通道后，随机与配色关系将跳过它
- ⚡ 快速变体 — 柔和 / 鲜明 / 提亮 / 压暗 / 主副互换
- 🤖 AI 命名 — 用默认模型为配色生成中文主题名 / 标签 / 介绍
- 📋 JSON 导入导出 — 主题令牌可复制、可分享、可迁移
- 🖥️ 设置面板放大 — 自动把设置弹框加宽到 1120px，显示更完整
- ♻️ 持久化 — 常驻 Web 插件，重启 DeepSeek Harness 后仍然存在
📸 实际界面
以下为软件内真实设置页面截图（设置 → 通用 → 主题 → 自定义…）。
主题提案 · 6 套风格预设 + 8 套智能提案，点卡片即应用
主题设计器 · 主色 / 副色 / 面板独立通道 + 实时预览 + 通道锁定 + JSON 导入导出
📐 架构
每套主题由三个通道的 OKLCH 值定义，映射到 DSH 的完整 --dsw-alias- / --dsw-specific- 设计令牌（约 85 个，明暗两套），实现全覆盖换肤——背景层级、文字层级、边框、按钮、交互态、状态色、侧边栏等全部随主题切换。
| 通道 | 含义 | 映射到 |
|---|---|---|
| 主色 th / c1 / l1 | 品牌强调色 | brand-primary、按钮、交互态 |
| 副色 th2 / c2 / l2 | 次要强调色 | 侧边栏选中态 |
| 面板 ths / sc / bg | 背景表面色 | 各级背景层级 |
| 文字 tx | 正文墨色 | label-primary 等 |
| 侧边栏 sb | 左侧栏明度 | sidebar-fill（默认与主区一体） |
📦 安装
本插件为「双面」Web 插件：Host 半（AI 命名路由）运行在 DSH 进程，Client 半（主题 UI）加载到浏览器。
1. 克隆并构建
git clone https://github.com/suzike/freestyle-dsh-theme.git
cd freestyle-dsh-theme
pnpm install
pnpm build
构建产物：lib/index.js（Host 半）、lib/client.js（浏览器半）。
2. 挂载到你的 DSH profile
在 ~/.dsh/profiles//package.json 的 dependencies 里加入：
{
"dependencies": {
"@linxin666/freestyle-dsh-theme": "link:../path/to/freestyle-dsh-theme"
}
}
在 ~/.dsh/profiles//cordis.patch.yml 末尾追加：
- insert:
- id: theme
name: '@linxin666/freestyle-dsh-theme'
然后：
cd ~/.dsh/profiles/
pnpm install
3. 重启 dsh web
重启 DeepSeek Harness（或 dsh web 进程），刷新浏览器即可。
🚀 使用
1. 打开 设置 → 通用 → 主题，点 「自定义…」
2. 主题提案 页签：点任意预设/提案卡片一键应用；「换一批」重新生成；「恢复默认」还原
3. 主题设计器 页签：切换主色/副色/面板通道，拖色相/彩度/明度滑杆（或点色相色块），实时预览；支持通道锁定、配色关系、快速变体、AI 命名、JSON 导入导出
4. 「应用主题」提交，「恢复默认」还原
🗂️ 目录结构
freestyle-dsh-theme/
├── src/
│ ├── index.ts # Host 半：/api/freestyle-dsh-theme/name AI 命名路由
│ └── client/
│ └── index.ts # Client 半：主题提案 + 设计器 UI
├── shared/ # 客户端打包预设（tsdown）
├── cordis.patch.yml # 插件行注册
├── package.json # 包声明（dsh.client / dsh.bundle）
├── tsdown.config.ts # 构建配置
├── docs/images/ # 可视化配图
└── README.md
🔢 版本管理
本项目遵循 语义化版本 SemVer。每个发布版本打一个 git tag：
git tag v0.1.0
git push --tags
版本历史见 Releases。
📄 License
BSD-3-Clause扫码进群