fufankeji/deepseek-harness-plugin-image-skin

DeepSeek Harness 插件图像皮肤

给一张图片，生成一个可安装、可卸载、自动适配明暗模式的 DeepSeek Harness Web 皮肤插件。

▶ 查看 12 秒真实演示

[!IMPORTANT]
这是由 赋范空间 独立开发的社区项目，不是 DeepSeek 官方项目，也不代表官方认可或合作。项目基于 DeepSeek Harness 公开的 Bundle、Client Module、ThemeRuntime 与 Profile 扩展点实现，不修改 Harness 源码。

效果

浅色模式背景、侧栏、输入区、边框和品牌色同时生效。

深色模式同一插件跟随 Harness Appearance 自动切换深色 Token。

它做了什么

- 在浏览器本地读取 PNG、JPG 或 WebP，不上传原图；
- 使用 Canvas 按 cover 规则生成 1920 × 1080 WebP；
- 从图片像素提取主题色，并生成 Light / Dark 两套 Token；
- 生成 Harness Client Module、ThemeRuntime 覆盖和卸载清理逻辑；
- 创建 Bundle patch、追溯信息与 MIT License；
- 真实执行 npm pack，输出可由 dsh plugin add 安装的 .tgz。

快速开始

要求：

- Node.js 22.19.0 或更高版本；
- 已安装可用的 DeepSeek Harness dsh CLI；
- Chromium、Chrome 或其他现代浏览器。

git clone https://github.com/fufankeji/deepseek-harness-plugin-image-skin.git
cd deepseek-harness-plugin-image-skin
npm start

打开 ：

1. 选择一张图片；
2. 调整主体纵向位置和玻璃层强度；
3. 点击“生成插件”；
4. 在 output/ 中取得源码目录和 .tgz 安装包。

安装生成的插件：

dsh plugin --profile web add ./output/harness-image-skin-1.0.0.tgz
dsh web

卸载：

dsh plugin --profile web remove harness-image-skin

工作方式

本地图片
→ Canvas 1920×1080 WebP
→ 主题配色与 Light / Dark Tokens
→ Client Module + ThemeRuntime
→ Bundle patch + npm pack
→ harness-image-skin-1.0.0.tgz
→ DeepSeek Harness Web profile

生成出的插件包含：

harness-image-skin/
├── assets/background.webp
├── client.js
├── cordis.patch.yml
├── generation.json
├── index.js
├── package.json
├── README.md
└── LICENSE

examples/generated-plugin/ 保留了一份由示例猫咪图片真实生成的插件源码，方便直接查看最终结构。

版本边界

本项目在以下环境完成真实生成、安装、浅色显示、深色切换与卸载恢复：

- DeepSeek Harness CLI 0.1.0-rc.6；
- DeepSeek Harness 官方仓库提交 47f943859bef60e4160492346772ded9b24f765a；
- Node.js 24.16.0。

DeepSeek Harness 当前仍处于 Developer Preview，后续版本可能调整插件接口。相关一手来源：

- 插件开发基础
- Bundle 打包与安装
- Client Modules
- ThemeRuntime 源码

项目结构

deepseek-harness-plugin-image-skin/
├── .github/assets/readme/  # README 图片和演示视频
├── examples/               # 示例图片与真实生成插件
├── public/                 # Skin Studio 前端
├── server.mjs              # 本地服务、源码生成、打包和可选安装
├── package.json
└── LICENSE

贡献与安全

欢迎提交可复现的问题和范围明确的改进。参与前请阅读 CONTRIBUTING.md；安全问题请按 SECURITY.md 私密报告，不要在公开 Issue 中提交 API Key、个人路径或未脱敏运行日志。

License

MIT

DeepSeek、DeepSeek Harness 及相关标识归其权利人所有。本仓库仅描述独立测试的兼容性，不暗示官方关联或背书。

@赋范空间 独立开发