deepseek-harness-desktop/packages/skins/dragon-heir

一句话定位

「龙的传人」是 dsh web GUI 的主题皮肤插件，以中国风双面对照设计：亮色主题走「不屈龙魂」（水墨龙 + 朱砂印 + 暖纸调色板），暗色主题走「万里长城」（墨蓝群山 + 鎏金印 + 苍茫暮色）。它只改变 DOM 外观，不影响模型请求和对话数据。

核心能力

• 在浏览器全视口挂载主题龙背景图（两幅 WebP 画作，以内嵌 base64 data URL 形式随 bundle 携带，无需联网下载）
• 把 dsh 主题色板重映射为「纸 + 墨 + 朱砂」与「青黛 + 金晖」双套
• 让主面板、侧边栏、菜单、输入框等大面积表面变为半透明磨砂，背景透光
• 注入「龙」印章 favicon（亮色朱砂方印、暗色鎏金方印），替换浏览器标签页图标
• 跟随宿主基础主题实时切换画作、遮罩、滤镜与印章，无需重新挂载
• 关闭（dispose）时完整撤回：移除 body 属性、移除背景层、移除注入的 favicon
• 适配 aionui 右侧面板（文件树、Git Graph、Preview）以及 git-graph 提交图车道与对话框

技术实现

• 语言: TypeScript + CSS Modules
• 关键依赖: @deepseek-ai/cordis（仅类型导入，effect 生命周期）、lightningcss（CSS 编译）、tsdown（构建）
• 架构模式: DSH 客户端半区插件；apply(ctx) 通过 ctx.effect(...) 注册 disposer，关闭时按 ThemePresenter 规范撤回所有写入；不注入任何 cordis 服务、不发事件
• 入口文件: src/index.ts（host 侧空壳）+ src/client/index.ts（核心逻辑，96 行）

适用场景

喜欢中国风主题或龙图腾的普通用户，把 dsh web GUI 换成更具东方韵味的视觉风格。安装并激活后，整个界面背景变成水墨龙或万里长城画作，面板变成带磨砂感的半透明，朱砂 / 鎏金强调色贯穿按钮、链接、Toast；不影响任何对话和模型行为。适合日常长时间使用、把品味延展到工作桌面、或者节日氛围（春节、龙年）想换换心情的人群。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/skins/dragon-heir

安装完成后还需要激活：

dsh-skin use dragon-heir

配置项

本插件无需额外配置。apply() 内部通过 ctx.effect(...) 自动注册 disposer，无需用户手动维护生命周期。

常见问题

Q: 这个皮肤影响我的对话记录和模型请求吗？

A: 不影响。它只修改浏览器 DOM（背景图、面板颜色、favicon），不注入任何 cordis 服务、不发请求、不触碰模型 API，也不会修改 KV Cache 行为。

Q: 一次能同时启用多个皮肤吗？

A: 不能。同一时刻只激活一个皮肤，切换时新皮肤接管、旧皮肤完整卸载；切换用 dsh-skin use dragon-heir。

Q: 关闭后会留下痕迹吗？

A: 不会。effect disposer 会撤回它写入的所有内容：移除 body 属性、移除背景层、移除注入的 favicon，原页面样式完整恢复。这点由 tests/apply.spec.ts 的"retracts everything on dispose"用例守护。

Q: 装了之后为什么界面没变？

A: 仅安装到 profile 不等于已激活。还需要执行 dsh-skin use dragon-heir 才会套用该皮肤。

Q: 第一次安装需要先本地构建吗？

A: 不需要。通过 git 链接安装时 prepare 脚本会自动构建 lib/；但 pnpm ≥10 首次安装 git 依赖可能需要把打印的包键加入 pnpm-workspace.yaml 的 allowBuilds 列表再重试。

Q: 支持深色模式吗？

A: 支持。皮肤会跟随宿主基础主题实时切换：亮色走水墨龙 + 朱砂印 + 暖纸调色板（brightness 1.5），暗色走万里长城 + 鎏金印 + 墨蓝石色板（brightness 1.42），画作遮罩与滤镜同步切换（CSS 中以 body[data-dsh-dragon-heir][data-ds-dark-theme] 选择器分别定义）。

Q: 跟 aionui 右侧面板和 git-graph 提交图会冲突吗？

A: 不会。皮肤自带 aionui 面板的 --aion-* token 重映射段（CSS 中专列章节），并给 git-graph 提交图车道上色为朱砂/青黛/金晖系徽章，对话框、菜单、Toast 加上磨砂玻璃效果，整体视觉一致。

Q: 跟其它皮肤比有什么不一样？

A: 这个皮肤的核心卖点就是中国风双面龙画作（不屈龙魂 + 万里长城）与朱砂 / 鎏金叠加色板；同仓库还有 blue-fantasy、miku、minecraft 等其它皮肤可选，每个都有不同的背景画作与配色。

上手难度

入门 — 一条命令安装、一条命令激活，没有任何配置项，普通用户即可上手。

已知问题与限制

• 同一时刻只能激活一个皮肤；切换会完全卸载当前皮肤
• 故意不使用 backdrop-filter 模糊祖先元素：会破坏 fixed 定位覆盖层（如设置面板）的包含块，使其被锁在父容器内；仅在 composerSeat::before 处使用
• 两幅龙画作（WebP base64）随 bundle 内嵌，约 400KB+，会增加少量 bundle 体积
• 当前源码内未发现 TODO / FIXME / HACK 等显式已知问题