返回目录

deepseek-harness-skin

维护状态: 活跃

heigeai/deepseek-harness-skin

DeepSeek Harness 换肤系统:21 套内置皮肤 + 一张图生成整套配色的自定义皮肤。数据源驱动,保对比度推导,构建期校验可读性。

前往 GitHub
$ git clone https://github.com/HeiGeAi/deepseek-harness-skin.git

52

星标

4

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-09-23

最近推送

MIT 许可、构建期注入的 DeepSeek Harness 换肤包:21 套内置皮肤 + 一张图自定义皮肤,保对比度配色推导,一键切回原生界面。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-09-01

许可证

MIT

01它能帮你完成什么?

  • 用 21 套内置皮肤或一张图自定义皮肤,给 DeepSeek Harness(dsh)Web 界面换肤

    一套换好主题的 DeepSeek Harness Web 界面(侧栏/输入框/会话列表重新配色),在「设置 → 通用设置 → 皮肤」里一键切换,保对比度配色推导,随时切回原生界面

    想个性化 Web 界面、又不想丢掉原生控件与功能的 DeepSeek Harness 用户

  • 用一张图给 DeepSeek Harness 界面生成一整套配色

    从单张 PNG/JPG/WebP 推导出的自定义皮肤——本机解码、提取四个色种、自动调蒙版、重编码 WebP 存到 ~/.dsh/skins/

    想用自己的图片做专属 DSH 主题、又不希望原图传出本机的人

02如何接入 DeepSeek Harness?

前置条件

  • 一份 `0.1.0-rc.5` 版本的 deepseek-harness 源码检出
  • Node.js 22.19 以上
  • pnpm
  • 不能从 npm 用 `npx @deepseek-ai/dsh` 直接装——这套皮肤要跟着前端一起构建

安装步骤

  1. 01

    $ git clone https://github.com/HeiGeAi/deepseek-harness-skin.git

  2. 02

    cd deepseek-harness-skin

  3. 03

    bash scripts/install.sh /path/to/deepseek-harness

  4. 04

    cd /path/to/deepseek-harness && pnpm install && pnpm run build && pnpm dsh web

  5. 05

    打开 http://127.0.0.1:3080 → 设置 → 通用设置 → 皮肤,点一下就换

验证接入成功

  • 浏览器打开 `http://127.0.0.1:3080`,左下角**设置 → 通用设置 → 皮肤**,点一下就换。

回滚

  • bash scripts/uninstall.sh /path/to/deepseek-harness

03DSH 适配与能力边界

DSH 适配原生运行时

Build-time skin injection into the DeepSeek Harness web UI (patches ui-theme + host, rebuild required)

  • 内置皮肤库(21 套)

    src/styles/skins/themes/ 下的内置主题 JSON 文件→21 套换好主题的 DeepSeek Harness 界面(浅色/深色,flat/glass/neon)

  • 一张图自定义皮肤

    一张 PNG / JPG / WebP 图片→一套自定义皮肤:提取四个色种、自动调蒙版浓度、重编码 WebP 存到 ~/.dsh/skins/

    上传图片只在本机处理,压缩后的 WebP 落在 ~/.dsh/skins/
  • 保对比度配色推导

    四个种子色(accent / secondary / surface / text)→完整 73 级色阶,保持原生对比度关系(OKLab 计算,sRGB 色域外色度二分拉回)

  • 构建期可读性校验

    皮肤 JSON 文件→21 套皮肤 × 8 项对比度契约任一不达标就直接构建失败

04适合谁?何时不该用?

适合

  • 想个性化 Web 界面、又不想丢掉原生控件与功能的 DeepSeek Harness 用户
  • 想用自己的图片做专属 DSH 主题、又不希望原图传出本机的人

不适合

  • 这是源码级改动:install.sh 覆盖 packages/client/ui-theme 并打一个 8 文件的宿主补丁,之后需要重新 `pnpm run build`。不是运行时注入,也不劫持任何进程。
  • 基线版本是 `0.1.0-rc.5`。DSH 还在 developer preview,上游改动界面结构时补丁可能打不上,脚本会明确报错而不是装出一半。

05兼容性、维护与安全提示

  • 这是源码级改动:install.sh 覆盖 packages/client/ui-theme 并打一个 8 文件的宿主补丁,之后需要重新 `pnpm run build`。不是运行时注入,也不劫持任何进程。
  • 基线版本是 `0.1.0-rc.5`。DSH 还在 developer preview,上游改动界面结构时补丁可能打不上,脚本会明确报错而不是装出一半。
  • 上传路由只认 WebP 魔数,超过 4MB 的请求会被直接掐断而不是缓存进内存。
  • 本项目与 DeepSeek 官方无隶属关系。
2026-08-132026-08-30v1.0.0

MIT · 最新发布 v1.0.0(2026-08-13);皮肤系统 v1.0.0 对应 DSH 0.1.0-rc.5;最近推送 2026-08-30

06常见问题

怎么安装 DeepSeek Harness Skin?

克隆本仓库,然后对着 `0.1.0-rc.5` 版本的 deepseek-harness 源码执行 `bash scripts/install.sh /path/to/deepseek-harness`。脚本会先把要覆盖的文件整份备份到 `~/.dsh-skin-backups/`,注入皮肤包并打上 8 个文件的宿主补丁,再随前端 `pnpm install && pnpm run build && pnpm dsh web` 重建,最后打开 http://127.0.0.1:3080。

能用一张图做自己的皮肤吗?

可以。皮肤选择器第一项就是「自定义(选图)」:选一张 PNG/JPG/WebP,剩下全自动——浏览器本地解码、提取四个色种、自动调蒙版浓度、重编码成 WebP 存到 `~/.dsh/skins/`。原图不出本机。

它会影响 DeepSeek Harness 的功能吗?

不会。它只改样式,侧栏、输入框、会话列表仍是 DSH 原生控件,功能一点没动。所有规则挂在 `body[data-dsh-skin]` / `body[data-skin-chrome]` 下,切回「默认」就把属性一摘,界面立刻回到原生外观,没有残留。

需要哪个版本的 DeepSeek Harness?

需要 `0.1.0-rc.5` 版本的 deepseek-harness 源码(Node.js 22.19 以上、pnpm)。从 npm 直接跑 `npx @deepseek-ai/dsh` 装不了,因为皮肤要跟着前端一起构建。DSH 还在 developer preview,上游改了界面结构时补丁可能打不上——脚本会明确报错,而不是装出一半。

怎么卸载或切回原生界面?

执行 `bash scripts/uninstall.sh /path/to/deepseek-harness`。也可以随时在「设置 → 通用设置 → 皮肤」里选「默认」切回;`~/.dsh/skins/` 里的自定义图卸载脚本不动,不要可以自己删。

08数据与来源

  • 作者声明github.com238d114d1e5b…

    Reskin the DeepSeek Harness web UI. 21 built-in skins plus one-image custom themes, with contrast-preserving color deriv…

  • 作者声明github.com238d114d1e5b…

    装进 DSH 源码,换肤就是设置面板里的一次点击,随时切回原生界面。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-01。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。