dsh-skins — DSH Web 多皮肤插件

为 DeepSeek Harness Web 换上可热切换的品牌皮肤，随时一键回到官方界面。

OpenBMC 暗色

30 秒上手

本节回答：怎么装上、怎么换皮肤。

dsh plugin --profile web add github:iasiv5/skins#main

执行上面的安装命令。
重启 DSH Web（例如 systemctl restart 对应的服务，按你的部署方式而定）。
刷新页面。
点击侧栏底部的「皮肤切换」，挑选皮肤。

首次安装且没有已保存选择时，默认使用 OpenBMC 皮肤。需要可复现安装时，请使用 Releases 中的 tag，或固定到经过审核的 40 位 commit SHA：

dsh plugin --profile web add github:iasiv5/skins#<commit-sha>

更新与卸载：

dsh plugin --profile web update dsh-skins    # 更新
dsh plugin --profile web remove dsh-skins    # 卸载

把安装交给 Agent（提示词安装法）

把下面这段整体复制给 DSH Web 里的 Agent：

帮我安装 DSH 皮肤插件 dsh-skins：
1. 执行 dsh plugin --profile web add github:iasiv5/skins#main；
2. 安装成功后重启 DSH Web（若由 systemd 管理，重启对应服务即可）；
3. 最后提醒我刷新页面。
若安装失败，把命令输出原样发给我，最多重试一次。

三款外观

本节回答：有哪些皮肤、各是什么气质。

选择 ID	类型	描述
`official`	内置选项	还其正印 · 素卷玄青 · 一如本貌
`openbmc`	正式皮肤	绶带凌风 · 风雷入画 · 缥碧盈卷
`uefi-harness`	占位皮肤	赤玺凝方 · 流霞渐染 · 绀青成韵

official 恢复 DeepSeek Harness 官方品牌、背景与 favicon，并保留皮肤切换器与官方明暗配色。
openbmc 是默认皮肤。「官方」只表示恢复官方界面，不是首次加载的选择。
每套皮肤明暗各一套配色，跟随「外观配色」自动切换：

OpenBMC 亮色

uefi-harness 是占位皮肤：架构与交互先行，品牌位用 UEFI Forum 官方标志，背景铺鎏金电路板原画，等待正式设计接手。

皮肤切换器

本节回答：切换器里有什么、怎么用。

皮肤切换器

侧栏底部的「皮肤切换」弹层包含两个区块：

外观配色：浅色、深色、跟随系统。它调用官方 theme service，与「设置 → 通用 → 外观」同步。
选择皮肤：第一项为 DeepSeek Harness（官方），其后是扩展皮肤。点击立即切换并持久化，弹层保持打开，方便连续预览。

侧栏收起时，入口显示为圆形调色盘图标。选择「官方」只撤销扩展皮肤，不改动明暗偏好。多个 sidebar.footer.action 入口会纵向排列，避免重叠。

URL 也能切皮肤：/?skin=official、/?skin=openbmc、/?skin=uefi-harness。选择保存在 localStorage["dsh-skins:active"]。

控制台调试 API：

__DSH_SKINS__.list();                  // 列出扩展皮肤，不包含 official
__DSH_SKINS__.select("official");      // 恢复官方界面
__DSH_SKINS__.active();                // 当前选择 ID
__DSH_SKINS__.themePreference();       // 浏览器保存的配色偏好；可能为 null

一键更新与安全设计

本节回答：怎么更新、为什么敢让它自己装。

打开皮肤切换器时，Host 会检查本仓库的最新正式版 Release。发现新版本后，更新栏显示当前/最新版本与 Release 说明链接：

点击「更新」，下载、安装、校验自动完成；
点击「立即重启」（或选「稍后」），新版本重启后生效；
有 Agent 正在运行时阻止重启，任务结束后再试。

为什么敢装——每一步都有代码校验，不靠信任：

只接受严格的 vX.Y.Z 正式版 tag，并解析到完整 40 位 commit SHA；
校验远端包名、仓库与 package.json 版本一致；
实际安装固定到该 SHA，不跟随分支漂移；
安装后复验 profile 与已安装包，失败自动恢复原版本；
systemd 等服务管理器下，重启交回服务的 Restart 策略，不硬杀进程。

更新模块从 v0.4.0 起提供。更早版本请先手动执行一次 dsh plugin --profile web update dsh-skins，之后即可在弹层一键更新。

工作原理

本节面向想读源码的人：插件怎么构成、更新事务怎么落地。

双端结构。客户端负责皮肤与切换界面，Host 负责 Release 检查、安全安装与重启。esbuild 产出 lib/client.js 与 lib/index.js，产物随仓库提交——GitHub 安装不在目标机器上构建。

更新事务（Host）：

检查结果缓存在 $DSH_HOME/dsh-skins/update-cache.json，有效期 1 小时并跨 DSH 重启保留。已是最新时不显示更新栏；网络失败时可在弹层底部手动重试。
更新开始前重新检查安装来源。只有从官方 GitHub 仓库安装的版本允许一键更新：link: 安装显示「本地开发模式」并禁用在线更新，file:、tar 包与其他仓库来源不会被覆盖。
安装完成后校验 profile 依赖固定、bundle 注册与已装包元数据；任何一步失败，自动恢复更新前的 GitHub 安装。
重启安全：检测运行中的 Agent 并阻止；服务管理器环境（探测 INVOCATION_ID/NOTIFY_SOCKET）以非零码退出，把重启交回 Restart 策略；脱离服务管理器运行时才使用内置的脱离重拉助手。

明暗持久化。非 loopback 浏览器中，插件监听官方 theme/change 事件，把浅色/深色/跟随系统存入 localStorage["dsh-skins:theme-preference"]，启动时经官方 theme.setTheme() 恢复。loopback 浏览器不启用这一回退，直接使用 DSH 自身的 Host 持久化。

报错本地化。所有会显示在界面里的 Host 报错都带稳定错误码与模板参数，客户端据此渲染中英文文案；未知错误码回退为 Host 原始消息。

自建一套皮肤

本节回答：怎么加一套自己的皮肤。

在 src/client/skins/<id>/index.js 中导出创建函数：

export function createMySkin({ jsx }) {
  function Mark({ size = 24 }) { /* 返回图标 */ }
  function Name() { /* 返回品牌名 */ }

  return {
    id: "my-skin",
    label: "My Skin",
    description: { zh: "一句话描述", en: "One-line description" },
    bodyAttr: "dshMySkin",
    Mark,
    Name,
    favicon: "data:image/svg+xml,...",
    faviconMime: "image/svg+xml",
    title: "My Skin",
    css: `body[data-dsh-my-skin] { /* DSH tokens */ }`,
    art: "",
    scrimLight: "",
    scrimDark: "",
    placeholderLight: "linear-gradient(...)明色",
    placeholderDark: "linear-gradient(...)暗色",
    slogans: { zh: "中文标语", en: "English slogan" },
  };
}

然后：

在 src/client/index.js 中加入对应的 import 与 runtime.register(...)；
删除皮肤时反向操作；
保留 ID official 与兼容别名 default，不要用于扩展皮肤。

label 与 description 接受语言中立的字符串（如品牌名）或 { zh, en } 映射，解析顺序为当前语言 → en → zh。皮肤卡片与 __DSH_SKINS__.list() 始终返回解析后的字符串，中英词典由 tests/dicts.test.mjs 强制键与占位符双向对齐。

title（可选）改写浏览器标签页的品牌段，接受与 label 相同的字符串或 { zh, en } 形式。官方 DocumentTitle 投影器会把标签页维护为「会话名 — DeepSeek Harness」，皮肤挂载期间只替换其中的品牌段、保留会话名；选择官方外观或插件卸载时换回官方品牌。

每个皮肤目录自持品牌标识、favicon、CSS、背景与标语，不从其他皮肤目录导入视觉资源；runtime.js 与 sidebar-switcher.js 只承载通用机制。

本地开发与验证

本节回答：怎么跑起来、怎么保证不弄脏产物。

pnpm install
pnpm run check     # 构建 + 语法检查 + 冒烟测试 + 全部单测
pnpm run watch     # 监听 src/，分别重建 lib/client.js 与 lib/index.js

客户端 bundle 经 DSH HMR 热更新；Host 源码、package.json、cordis.patch.yml 或依赖变化后需重启 DSH Web。
提交前同时提交源码与重新生成的 lib/ 两个产物。CI 会复查构建、产物无差异与安装包内容。
文档截图用 node scripts/capture-previews.mjs 重拍。脚本内置隐私规程：折叠全部工作区、新建空会话取景、界面强制中文，不泄露任何会话内容。
两份 README（中/英）由校验脚本做内容配对；改动任一侧须同步另一侧，详见 README.i18n.yaml。

开发模式安装（本地源码直连，客户端改动即改即见）：

dsh plugin --profile web add link:<本仓库路径>

FAQ

怎么彻底回到官方界面？ 在皮肤切换器中选择「DeepSeek Harness（官方）」，或访问 /?skin=official。它撤销扩展皮肤的品牌、背景与 favicon，保留皮肤切换器与官方明暗配色，也不会改动你的浅色/深色/跟随系统偏好。

更新失败会怎样？ 更新事务先备份再安装。任何校验失败都会自动恢复原版本，弹层显示失败原因（中英双语）。仍失败时可用 dsh plugin --profile web update dsh-skins 手动更新。

支持哪些 DSH Web 版本？ 已使用 DSH Web 0.1.1-rc.2 验证。同系列 rc 版本理论上兼容，未经验证的版本不作承诺。

外观偏好在不同的浏览器间同步吗？ 在 DSH 所在机器的浏览器（loopback）上，偏好由 DSH Host 持久化，天然共享。其他远程浏览器由插件将偏好存入本地 localStorage，各浏览器独立、互不覆盖。

已知边界

OpenBMC 用户气泡描边使用版本相关类 .gdEzaW_bubble；该类变化只影响描边，token 配色不受影响。
标签页品牌段替换依赖官方 DocumentTitle 投影器的固定文案「DeepSeek Harness」与「 — 」分隔符；投影器实现变化时只影响标签页品牌段，其余界面不受影响。
品牌标语经当前 DSH locale 字典接口替换，皮肤卸载时恢复；升级 DSH locale 实现后需要复核。
其他皮肤插件也可能修改 body 背景、品牌位或 favicon；应避免同时启用多个视觉皮肤插件。
uefi-harness 的标志为 UEFI Forum 官方商标（红色立方体，源自 uefi.org 发布的 uefi_logo_red.gif，经 Wikimedia Commons「Logo of the UEFI Forum.svg」矢量描摹嵌入），仅作标识用途，权利归 UEFI Forum 所有。

License

MIT

dsh-skins — DSH Web 多皮肤插件

English · 中文

为 DeepSeek Harness Web 换上可热切换的品牌皮肤，随时一键回到官方界面。

OpenBMC 暗色

30 秒上手

本节回答：怎么装上、怎么换皮肤。

dsh plugin --profile web add github:iasiv5/skins#main

执行上面的安装命令。
重启 DSH Web（例如 systemctl restart 对应的服务，按你的部署方式而定）。
刷新页面。
点击侧栏底部的「皮肤切换」，挑选皮肤。

首次安装且没有已保存选择时，默认使用 OpenBMC 皮肤。需要可复现安装时，请使用 Releases 中的 tag，或固定到经过审核的 40 位 commit SHA：

dsh plugin --profile web add github:iasiv5/skins#<commit-sha>

更新与卸载：

dsh plugin --profile web update dsh-skins    # 更新
dsh plugin --profile web remove dsh-skins    # 卸载

把安装交给 Agent（提示词安装法）

把下面这段整体复制给 DSH Web 里的 Agent：

帮我安装 DSH 皮肤插件 dsh-skins：
1. 执行 dsh plugin --profile web add github:iasiv5/skins#main；
2. 安装成功后重启 DSH Web（若由 systemd 管理，重启对应服务即可）；
3. 最后提醒我刷新页面。
若安装失败，把命令输出原样发给我，最多重试一次。

三款外观

本节回答：有哪些皮肤、各是什么气质。

选择 ID	类型	描述
`official`	内置选项	还其正印 · 素卷玄青 · 一如本貌
`openbmc`	正式皮肤	绶带凌风 · 风雷入画 · 缥碧盈卷
`uefi-harness`	占位皮肤	赤玺凝方 · 流霞渐染 · 绀青成韵

official 恢复 DeepSeek Harness 官方品牌、背景与 favicon，并保留皮肤切换器与官方明暗配色。
openbmc 是默认皮肤。「官方」只表示恢复官方界面，不是首次加载的选择。
每套皮肤明暗各一套配色，跟随「外观配色」自动切换：

OpenBMC 亮色

uefi-harness 是占位皮肤：架构与交互先行，品牌位用 UEFI Forum 官方标志，背景铺鎏金电路板原画，等待正式设计接手。

皮肤切换器

本节回答：切换器里有什么、怎么用。

皮肤切换器

侧栏底部的「皮肤切换」弹层包含两个区块：

外观配色：浅色、深色、跟随系统。它调用官方 theme service，与「设置 → 通用 → 外观」同步。
选择皮肤：第一项为 DeepSeek Harness（官方），其后是扩展皮肤。点击立即切换并持久化，弹层保持打开，方便连续预览。

侧栏收起时，入口显示为圆形调色盘图标。选择「官方」只撤销扩展皮肤，不改动明暗偏好。多个 sidebar.footer.action 入口会纵向排列，避免重叠。

URL 也能切皮肤：/?skin=official、/?skin=openbmc、/?skin=uefi-harness。选择保存在 localStorage["dsh-skins:active"]。

控制台调试 API：

__DSH_SKINS__.list();                  // 列出扩展皮肤，不包含 official
__DSH_SKINS__.select("official");      // 恢复官方界面
__DSH_SKINS__.active();                // 当前选择 ID
__DSH_SKINS__.themePreference();       // 浏览器保存的配色偏好；可能为 null

一键更新与安全设计

本节回答：怎么更新、为什么敢让它自己装。

打开皮肤切换器时，Host 会检查本仓库的最新正式版 Release。发现新版本后，更新栏显示当前/最新版本与 Release 说明链接：

点击「更新」，下载、安装、校验自动完成；
点击「立即重启」（或选「稍后」），新版本重启后生效；
有 Agent 正在运行时阻止重启，任务结束后再试。

为什么敢装——每一步都有代码校验，不靠信任：

只接受严格的 vX.Y.Z 正式版 tag，并解析到完整 40 位 commit SHA；
校验远端包名、仓库与 package.json 版本一致；
实际安装固定到该 SHA，不跟随分支漂移；
安装后复验 profile 与已安装包，失败自动恢复原版本；
systemd 等服务管理器下，重启交回服务的 Restart 策略，不硬杀进程。

更新模块从 v0.4.0 起提供。更早版本请先手动执行一次 dsh plugin --profile web update dsh-skins，之后即可在弹层一键更新。

工作原理

本节面向想读源码的人：插件怎么构成、更新事务怎么落地。

更新事务（Host）：

检查结果缓存在 $DSH_HOME/dsh-skins/update-cache.json，有效期 1 小时并跨 DSH 重启保留。已是最新时不显示更新栏；网络失败时可在弹层底部手动重试。
更新开始前重新检查安装来源。只有从官方 GitHub 仓库安装的版本允许一键更新：link: 安装显示「本地开发模式」并禁用在线更新，file:、tar 包与其他仓库来源不会被覆盖。
安装完成后校验 profile 依赖固定、bundle 注册与已装包元数据；任何一步失败，自动恢复更新前的 GitHub 安装。
重启安全：检测运行中的 Agent 并阻止；服务管理器环境（探测 INVOCATION_ID/NOTIFY_SOCKET）以非零码退出，把重启交回 Restart 策略；脱离服务管理器运行时才使用内置的脱离重拉助手。

报错本地化。所有会显示在界面里的 Host 报错都带稳定错误码与模板参数，客户端据此渲染中英文文案；未知错误码回退为 Host 原始消息。

自建一套皮肤

本节回答：怎么加一套自己的皮肤。

在 src/client/skins/<id>/index.js 中导出创建函数：

export function createMySkin({ jsx }) {
  function Mark({ size = 24 }) { /* 返回图标 */ }
  function Name() { /* 返回品牌名 */ }

  return {
    id: "my-skin",
    label: "My Skin",
    description: { zh: "一句话描述", en: "One-line description" },
    bodyAttr: "dshMySkin",
    Mark,
    Name,
    favicon: "data:image/svg+xml,...",
    faviconMime: "image/svg+xml",
    title: "My Skin",
    css: `body[data-dsh-my-skin] { /* DSH tokens */ }`,
    art: "",
    scrimLight: "",
    scrimDark: "",
    placeholderLight: "linear-gradient(...)明色",
    placeholderDark: "linear-gradient(...)暗色",
    slogans: { zh: "中文标语", en: "English slogan" },
  };
}

然后：

在 src/client/index.js 中加入对应的 import 与 runtime.register(...)；
删除皮肤时反向操作；
保留 ID official 与兼容别名 default，不要用于扩展皮肤。

每个皮肤目录自持品牌标识、favicon、CSS、背景与标语，不从其他皮肤目录导入视觉资源；runtime.js 与 sidebar-switcher.js 只承载通用机制。

本地开发与验证

本节回答：怎么跑起来、怎么保证不弄脏产物。

pnpm install
pnpm run check     # 构建 + 语法检查 + 冒烟测试 + 全部单测
pnpm run watch     # 监听 src/，分别重建 lib/client.js 与 lib/index.js

客户端 bundle 经 DSH HMR 热更新；Host 源码、package.json、cordis.patch.yml 或依赖变化后需重启 DSH Web。
提交前同时提交源码与重新生成的 lib/ 两个产物。CI 会复查构建、产物无差异与安装包内容。
文档截图用 node scripts/capture-previews.mjs 重拍。脚本内置隐私规程：折叠全部工作区、新建空会话取景、界面强制中文，不泄露任何会话内容。
两份 README（中/英）由校验脚本做内容配对；改动任一侧须同步另一侧，详见 README.i18n.yaml。

开发模式安装（本地源码直连，客户端改动即改即见）：

dsh plugin --profile web add link:<本仓库路径>

FAQ

支持哪些 DSH Web 版本？ 已使用 DSH Web 0.1.1-rc.2 验证。同系列 rc 版本理论上兼容，未经验证的版本不作承诺。

已知边界

OpenBMC 用户气泡描边使用版本相关类 .gdEzaW_bubble；该类变化只影响描边，token 配色不受影响。
标签页品牌段替换依赖官方 DocumentTitle 投影器的固定文案「DeepSeek Harness」与「 — 」分隔符；投影器实现变化时只影响标签页品牌段，其余界面不受影响。
品牌标语经当前 DSH locale 字典接口替换，皮肤卸载时恢复；升级 DSH locale 实现后需要复核。
其他皮肤插件也可能修改 body 背景、品牌位或 favicon；应避免同时启用多个视觉皮肤插件。
uefi-harness 的标志为 UEFI Forum 官方商标（红色立方体，源自 uefi.org 发布的 uefi_logo_red.gif，经 Wikimedia Commons「Logo of the UEFI Forum.svg」矢量描摹嵌入），仅作标识用途，权利归 UEFI Forum 所有。

License

MIT

iasiv5/skins

dsh-skins — DSH Web 多皮肤插件

30 秒上手

三款外观

皮肤切换器

一键更新与安全设计

工作原理

自建一套皮肤

本地开发与验证

FAQ

已知边界

License

Community comments

iasiv5/skins

dsh-skins — DSH Web 多皮肤插件

30 秒上手

三款外观

皮肤切换器

一键更新与安全设计

工作原理

自建一套皮肤

本地开发与验证

FAQ

已知边界

License

Community comments