dsh-genshin-skin

中文 | English

一款面向 DeepSeek Harness (dsh) Web UI 的 原神（至冬 / Snezhnaya）主题皮肤：用提瓦特金配色重着色界面， 并加上雪国宫殿壁纸背景。装上之后，原本很"素"的对话界面会变成暖金配色 + 雪国壁纸的 氛围。

纯表现层。 本皮肤只改外观，不触碰会话、模型、工具、沙箱或网络。它完全通过 DeepSeek Harness 公开的 ctx.theme 服务和一层 CSS 生效；卸载后界面干净还原， 不会留下任何副作用。

非官方粉丝项目，与 HoYoverse / 米哈游及 DeepSeek 无任何隶属、赞助或背书关系。 美术版权见 ASSET_LICENSE.md——随附图片仅供个人非商业演示。

效果

• 提瓦特金色的品牌色、按钮、边框点缀；
• 半透明毛玻璃面板，透出背景壁纸；
• 铺满整屏的雪国宫殿壁纸，带一层可读性遮罩保证文字清晰；
• 浅色 / 深色底主题下都可用。

---

它是怎么工作的（一句话）

本仓库是一个 DeepSeek Harness 的 bundle（插件包）。你用 dsh plugin add 把它装进某个 profile，dsh 启动 Web UI 时会自动扫描并加载它——完全不用改 DeepSeek Harness 的源码。卸载就是 dsh plugin remove。

关于 profile：dsh 用 "profile" 来隔离不同的配置/插件组合。Web UI 默认用名为 web 的 profile。dsh plugin --profile web ... 就是对这个 profile 增删插件。 profile 的实际目录在你的用户目录下（不在项目里），所以给它装插件不会污染 DeepSeek Harness 的源码仓库。

---

环境要求

• 已经能跑起来的 DeepSeek Harness：
  • 要么装了全局 dsh 命令；
  • 要么是源码检出（monorepo），用 pnpm dsh 运行。
• Node.js >= 22.19 与 pnpm（DeepSeek Harness 本身就需要这些）。

---

用法一：本地源码检出（重点，比如你的 deepseek-harness）

如果你是 clone 了 DeepSeek Harness 源码在本地跑（例如目录 ~/Desktop/github_test/deepseek-harness，用 pnpm dsh web 启动），按下面来。

下面假设两个项目是平级目录：

你的工作目录/
├── deepseek-harness/     # DeepSeek Harness 源码检出（用 pnpm dsh 运行）
└── dsh-genshin-skin/     # 本皮肤项目

步骤 1：把皮肤装进 web profile

在 deepseek-harness 目录里执行（pnpm dsh 就是本地源码的 dsh 命令）：

cd deepseek-harness

# 从 GitHub 安装（推荐）：
pnpm dsh plugin --profile web add github:bupianlizhugui/dsh-genshin-skin

# 或者，如果你已经把 dsh-genshin-skin clone 到了本地，用本地路径安装：
pnpm dsh plugin --profile web add ../dsh-genshin-skin

dsh plugin add 本质是在 profile 目录里帮你跑 pnpm add，然后自动把声明了 dsh.bundle 的这个包登记为该 profile 的一层。相对路径会按你当前所在目录解析， 所以上面的 ../dsh-genshin-skin 是相对 deepseek-harness 的。

步骤 2：首次可能要放行构建（git 安装时）

从 GitHub / git 安装时，pnpm 会从源码构建这个包（走 prepare 脚本）。pnpm ≥ 10 出于安全，首次会拦下这个构建并让 add 失败，同时打印出需要放行的包名 key。

按提示，把这个 key 加到 web profile 的 pnpm-workspace.yaml 里 （dsh 的报错信息会告诉你这个文件的确切绝对路径，通常在 ~/.deepseek-harness/profiles/web/pnpm-workspace.yaml 或 $DSH_HOME/profiles/web/ 下）：

allowBuilds:
  dsh-genshin-skin: true

然后重跑一遍刚才那条 add 命令即可。 （用本地路径 ../dsh-genshin-skin 安装时，通常不需要这一步。）

安全提示：只为你信任的源码放行构建。想更稳，可把安装源固定到某个提交： github:bupianlizhugui/dsh-genshin-skin#<commit-sha>，避免以后仓库更新悄悄改变 你本地运行的内容。

步骤 3：启动 Web UI 看效果

cd deepseek-harness
pnpm dsh web

浏览器打开 http://127.0.0.1:3080，就能看到原神至冬皮肤了。

卸载

cd deepseek-harness
pnpm dsh plugin --profile web remove dsh-genshin-skin

依赖和配置层会一起移除，界面还原为默认样子。

---

用法二：全局 dsh 命令

如果你装的是全局 dsh（不是源码检出），把上面的 pnpm dsh 换成 dsh 即可：

# 安装
dsh plugin --profile web add github:bupianlizhugui/dsh-genshin-skin
# 启动
dsh --profile web
# 卸载
dsh plugin --profile web remove dsh-genshin-skin

---

自定义（换壁纸 / 改配色）

皮肤全是表现层，改完源码用 pnpm build 重新构建即可。如果你是用本地路径装的， 重新构建后重启 dsh web 就生效；如果是从 GitHub 装的，改完记得 push，再让使用者 重装/更新。

先在 dsh-genshin-skin 目录里装好开发依赖：

cd dsh-genshin-skin
pnpm install     # 会自动跑一次 build

换壁纸

把你想要的图片放到 src/client/assets/：

• 最简单：保持文件名为 genshin-snezhnaya.jpeg（直接覆盖原图）；
• 或者用别的文件名，然后改 scripts/build-wallpaper.mjs 里的 WALLPAPER_ASSET 常量为你的新文件名（支持 .jpeg / .png / .webp）。

然后重新构建：

pnpm build

构建会把图片以 base64 data: URI 内联进 client bundle（client bundle 没有单独 的文件路由，这是 DeepSeek Harness 的既定做法）。建议用 1500×850 或更大的横图； 文件太大（比如 2MB 的 PNG）会明显撑大 bundle、拖慢首屏，建议先压成质量合适的 JPEG/WebP（一般几百 KB 足够）。

改配色

编辑 src/client/theme-tokens.ts。里面每一项把一个 DeepSeek Harness 的公开主题 变量（--dsw-alias-* / --dsw-specific-*）映射到一对 { light, dark } 颜色 （分别对应浅色底和深色底）。改完 pnpm build。

想换成别的地区/角色配色（如蒙德清新绿、稻妻紫电、须弥翠绿），直接改这些颜色值即可。

调壁纸遮罩 / 面板透明度

• 遮罩浓淡（壁纸上盖的那层暗色/亮色，决定文字是否够清晰）：改 src/client/wallpaper.template.css 里 linear-gradient(...) 的 alpha 透明度值。
• 面板透明度（面板透出多少壁纸）：改 theme-tokens.ts 里的 --dsw-alias-bg-* 这几个值的 alpha。

---

工作原理（进阶）

• package.json 声明了 dsh.bundle（一个 cordis.patch.yml 配置层）和 dsh.client（platform: web）。装进 profile 后，它就进入该 profile 的依赖闭包。
• dsh web 启动时，宿主扫描 loader 树里声明了 dsh.client 的包，组成 window.__DSH_BOOT__，并在 /plugins/dsh-genshin-skin/client.js 提供本皮肤的 浏览器 bundle。
• 浏览器半用 inject = ['theme'] 拿到主题服务，调用 ctx.theme.overrideTokens(...) 叠加一层 --dsw-* 令牌覆盖；再通过两个 CSS Module 注入壁纸和边缘微光。ctx.effect 注册这层覆盖，插件卸载时自动移除。

---

开发

pnpm install      # 会自动跑 prepare -> build
pnpm build        # build:wallpaper（内联图片）+ tsdown（构建 node 半 + client 半）
pnpm typecheck    # 类型检查

构建产物（不纳入版本库）：

• lib/index.js —— node 半（空的表现层插件，仅用于让宿主发现 client 半）。
• lib/client.js —— 浏览器半，包裹在 shell loader 的交接格式里，含内联壁纸。

---

许可

• 代码：MIT。
• 美术 / 图片素材：见 ASSET_LICENSE.md——非 MIT。原神 相关美术版权归米哈游所有；随附图仅供个人非商业演示，若要 fork/发布请替换为你有权 使用的图片。