前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构。对于开发者或使用者而言，自定义 DSH Web 的外观是一个常见需求。手动编写 CSS 变量或维护 ZIP 资产结构较为繁琐。dsh-skin-studio 提供了一个本地优先的、可视化的皮肤制作工作台，旨在降低皮肤定制的门槛，并确保导出资产的合规性。
这是什么¶
dsh-skin-studio 是一个由维护者 zhangguiping-xydt 开发的插件。它直接在 DSH Web 的设置面板中注册了一个一级的「Skin Studio」入口。插件运行在浏览器端，负责读取 Skin Center 的已安装主题，提取官方设计令牌，并提供可视化的编辑与导出功能。
安装与启用¶
安装该插件需要使用 DSH 的命令行工具。
dsh plugin --profile web add github:zhangguiping-xydt/dsh-skin-studio
安装完成后，重启 dsh web 服务，打开 Settings → Skin Studio 即可使用。
核心功能¶
该插件主要提供以下能力：
- 主题关联与令牌吸收：读取 Skin Center 的目录，关联已安装的主题。它会自动提取并吸收官方设计令牌（仅限于
--dsw-*颜色令牌），不复制主题的代码或远程资源。 - 可视化编辑：支持编辑浅色和深色调色板、语义表面半径、密度、面板不透明度以及减少运动配置文件。
- 实时预览与审查：提供实时预览样本，支持浅色/深色模式切换，并能审查文本对比度是否符合 WCAG 标准。
- 背景处理：接受本地 PNG、JPEG 或 WebP 格式的背景图（需验证 MIME 类型和魔术字节），并支持通过本地存储保存项目草稿。
- 资产导出：生成符合标准的 v2 皮肤 ZIP 资产归档，包含
skin.json、skin.css、双语文档、生成预览以及可选的本地背景图。
典型用法¶
完成安装后，可按以下步骤创建或修改皮肤：
- 填写身份信息：在插件界面中填写皮肤名称、ID 和作者字段。
- 关联主题：选择已安装的基础主题，并点击「关联并吸收调色板」。
- 优化配色：在检查实时样本和 WCAG 对比度结果的同时，调整浅色和深色调色板。
- 调整细节：可选地选择经过验证的本地背景，并调整表面半径、运动和背景控件。
- 应用皮肤：导出 ZIP 文件，将其目录提取到
$DSH_HOME/skins/，刷新 DSH Web，并在「设置 → 皮肤中心」中应用。
注意事项与限制¶
使用该插件时需注意以下事实：
- 本地存储：项目草稿保存在浏览器本地存储中，背景图像仅在当前页面内存中保存，刷新页面后需重新选择背景。
- 导入限制：导入的项目 JSON 最大为 128 KiB，背景图像最大为 8 MiB。
- 关联范围：主题关联仅复制识别出的
--dsw-*颜色令牌值，不复制钩子、自由选择器、字体、背景资源或远程 URL。 - 运行环境：插件没有主机端配置、API 路由、模型访问权限或文件系统写入权限。其安全模型完全依赖浏览器的沙箱机制。
结尾¶
dsh-skin-studio 为 DSH 生态提供了一套标准化的皮肤制作工具。它通过本地化的可视化操作，简化了皮肤开发流程，同时通过合约验证和令牌限制确保了导出资产的结构安全。此插件为社区贡献，相关目录与源码可访问下方链接。
