dsh-skin-studio

为 DeepSeek Harness Web UI 创建、管理和分享可移植皮肤。

dsh-skin-studio 保留 DSH 原生的浅色、深色和跟随系统行为，并通过官方 --dsw-* Theme Token 叠加用户皮肤。每套皮肤可包含两套可编辑配色、一份主图片或循环视频背景、任意可见组件类型的媒体背景、界面/代码字体，以及受限制的高级颜色 Token 覆盖。

安装

dsh plugin --profile web add dsh-skin-studio
dsh web

打开 设置 → 通用 → 自定义皮肤。

功能

• 多皮肤库：新建、复制、编辑、启用、删除和恢复 DSH 默认。
• 浅色/深色各有六个易懂的语义颜色。
• “界面组件”按输入框、按钮、侧边栏、消息、代码、边框和状态色分组编辑。
• “全部 DSH Token”覆盖运行时公开颜色和插件验证过的组件颜色白名单。
• 用 OKLCH 生成另一模式，生成后仍可独立微调。
• 整页实时预览，并明确区分“应用”和“取消”。
• PNG、JPEG、WebP、MP4、WebM 背景，可分别调整浅深模式的背景透明度、界面遮盖强度和明暗遮罩；视频始终静音并自动循环。
• 背景媒体使用居中覆盖裁切，并跟随右侧主对话区域自适应，不会铺到左侧会话列表下方。
• 支持鼠标和键盘操作的组件点选器可选择侧边栏、输入框、按钮、消息气泡、菜单、面板或任何其他可见 DSH 组件类型；每类可使用独立图片或静音循环视频，并分别调整浅深模式的透明度和遮罩。
• 组件视频仅在可见时播放，同时播放数量有上限；系统启用“减少动态效果”时会停在静态帧。遮罩过弱时必须确认可读性后才能应用。
• 可选 WOFF2 界面字体与代码字体。
• 高级模式只开放 DSH Theme Runtime 可接受、且插件明确列入白名单的颜色 Token。
• 内置更明亮的 Bright Studio 默认皮肤，同时保留较有色彩倾向的示例皮肤。
• IndexedDB 版本化存储、轻量启动快照和同源标签页同步。
• .dshskin 皮肤包完整携带 manifest.json 与经过校验的本地资源。
• 中英文界面。

皮肤包安全

导入采用严格拒绝策略：必须符合 v3 schema、使用安全资源路径、声明正确大小，并通过文件签名和 SHA-256 校验。组件目标只保存点选器生成的标签、角色和类名结构，不接受任意 CSS 选择器。SVG、GIF、网络 URL、CSS、HTML、JavaScript 和路径穿越都会被拒绝。单包上限 128 MB，图片上限 15 MB，视频上限 100 MB，每个字体上限 5 MB；已有 v1、v2 皮肤会自动迁移。

应用前会报告低对比度问题；如果是有意设计，用户仍可确认后应用。

开发

pnpm install
pnpm check
pnpm pack

插件的 Host 半部为空实现，功能位于浏览器 Client bundle。运行时只使用 DSH 官方 Theme 与 Slot API，不需要自定义 Host 设置命名空间或服务器路由。

兼容性与边界

测试基线为 @deepseek-ai/dsh 0.1.0-rc.6。配置只保存在当前浏览器 origin。v3 不包含跨浏览器 Host 同步、在线市场、任意 CSS/JS、布局修改或全局圆角修改。

许可证

MIT。请只导出你有权分享的背景媒体和字体文件。