zhangguiping-xydt/dsh-skin-studio

DSH 皮肤工作室

DSH 皮肤工作室是面向 DeepSeek Harness Web 的可视化、本地优先皮肤制作工具。它可以关联已安装主题、吸取其中可识别的官方设计令牌、预览浅色与深色模式、检查文字对比度，并导出可安装的 v2 皮肤资产包。

DSH Web 设置界面中的皮肤工作室

能力

- 在 DSH Web 设置中注册一级“皮肤工作室”分区。
- 从皮肤中心读取已安装目录并把项目关联到现有主题，不复制其代码或远程资源。
- 编辑浅色与深色调色板、语义表面圆角、密度、面板不透明度和低动效配置，并提供响应式实时样张。
- 可选导入本地 PNG、JPEG 或 WebP 背景，导入前检查大小、MIME 与文件魔数。
- 在浏览器本地存储中保存结构化项目草稿，并支持项目导入与导出。
- 生成标准 v2 ZIP，其中包含 skin.json、skin.css、双语说明、生成的预览图和可选本地图片。

安装

直接从公开 GitHub 仓库安装：

dsh plugin --profile web add github:zhangguiping-xydt/dsh-skin-studio

安装后重启一次 dsh web，然后打开“设置 → 皮肤工作室”。插件支持 DSH >=0.1.1-rc.2  标签和署名文字记录关联关系。

配置

插件没有 host 侧配置、API 路由、模型访问或文件系统写入。草稿使用浏览器键 dsh-skin-studio:draft:v1；导入项目 JSON 上限为 128 KiB，背景图片上限为 8 MiB。

所有制作过程都在客户端完成。唯一的 DSH 请求是只读获取 /api/skin-center/v2/catalog 和所选已安装皮肤的转换后样式表。皮肤中心不可用时，工作室仍可使用内置“官方默认”调色板。

安全模型

- host 半区为空实现：没有写路由、子进程、模型调用、凭据、遥测或 profile 修改。
- 导入项目会被规范化到固定结构；ID、版本、标签、颜色、数值范围和来源链接在导出前均按 fail-closed 或限幅方式处理。
- 上传资产只允许 PNG、JPEG 与 WebP，且 MIME 和文件魔数必须同时匹配；SVG、HTML、视频和远程媒体会被拒绝。
- 主题样式表按不可信文本处理。工作室只提取有界的 --dsw-* 声明，并且只接受十六进制颜色进入调色板；不会执行或重新导出来源样式表。
- 导出路径由工作室固定，导出皮肤不包含 hooks.mjs、patches.css、@import、协议 URL 或可执行内容。

安全问题请使用本仓库的 GitHub 私密漏洞报告，不要创建公开 issue。

已知限制

- 主题关联只导入官方颜色令牌子集；复杂美术、字体、结构补丁和运行时行为有意保留在来源主题中。
- 背景图片只在当前页面内存中保留，不写入本地存储；页面刷新后需要重新选择图片再导出。
- 实时样张模拟稳定的 DSH 语义表面，但不会逐像素复刻所有已安装 DSH 插件。
- 导出会验证工作室契约，但发布到官方市场仍需要经过 DSH 市场审查和预览流程。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run test:coverage
pnpm run build
pnpm run check

测试覆盖项目规范化、颜色与对比度、目录解析、令牌吸取、压缩包结构、资产校验、本地持久化、设置页注册和主要 UI 流程。

许可证

MIT