前言¶
DeepSeek Harness（DSH）把客户端界面、会话与插件能力拆开，日常开发里界面长时间开着，默认皮肤容易显得单调。社区里「趣味换装」类插件，目标是在不改动业务逻辑的前提下，给 Desktop 或 Web 客户端换一套视觉与少量交互增强。
下面介绍维护者 nightosong 发布的 gord-dsh-saber-theme：一套面向 DSH 的 Saber（Fate）主题，参考同作者 Codex Saber Theme 的 Saber Ice Atelier 风格——冰蓝配色、通透面板与 Saber 主视觉。插件以 macOS / Windows 原生桌面版为主，兼容 dsh web；终端 TUI 不在本主题范围内。
这是什么¶
gord-dsh-saber-theme 是 DSH 原生客户端主题插件（npm 包名 gord-dsh-saber-theme，当前版本 0.3.1）。它通过 DSH 的 Cordis 配置补丁与客户端注入，替换界面样式与部分前端行为，并保留官方浅色/深色切换、字号设置、会话与窗口操作。
分类上属于社区目录中的「趣味换装」；GitHub 仓库：nightosong/gord-dsh-saber-theme。插件目录页：SkillHub 插件页。
版本与环境要求¶
安装前请对照 README 中的依赖表，确认本机 DSH 与主题服务版本在声明范围内：
| 依赖 | 当前要求 | 说明 |
|---|---|---|
| DeepSeek Harness | 0.2.0-rc.2 或 0.2.1-rc.2 |
Web 已验证前者，macOS 桌面已验证后者 |
@deepseek-ai/dsh-client-ui-theme |
同上 | 由 DSH 提供，可选对等依赖 |
| Node.js | 22+ |
源码安装器与 dsh CLI 需要；市场安装可用应用内置运行时 |
| 系统 | macOS / Windows | Windows 安装器有自动测试，桌面视觉待真机验收 |
命令行用 dsh --version 查询；桌面版请看应用「关于」，不能用全局 npm 安装的 CLI 版本代替桌面内置版本。
核心功能¶
视觉与平台范围¶
主题实现冰蓝、通透面板与 Saber 主视觉；README 提供在 DSH 0.2.0-rc.2 隔离实例下的 macOS 桌面、Web 浅色与深色截图。图片资源打包在离线插件包内，不请求远程图片。
聊天背景默认每 5 分钟随机切换，共 30 张素材，连续两次不重复；首页保留固定插画。轮播使用 DSH 原生分块按需加载；间隔可在源码 theme/rotation.json 的 intervalMinutes 中修改（1–1440 分钟），构建并重新安装后生效。
聊天右侧「任务关注」¶
参考 gord-dsh-worktree 的任务关注设计，入口在聊天右侧轮次索引下方：主数字为任务总数，角标为待处理与已结束未查看数量；无任务时自动隐藏。
- 鼠标移入展开，移出 200ms 后收起；支持点击、键盘操作，Escape 收起。
- 展示运行中、等待输入/审批、已结束未查看的其他会话；「已结束」不代表执行成功。
- 点击打开已有会话，确认切换成功后才移除本轮提醒。
- 支持拖动并记住位置，↺ 可恢复到索引下方；窄窗口会限制位置并避开输入区。
- 跟随浅色/深色与中英文；若同时启用
gord-dsh-worktree且其任务入口可见，本主题入口自动隐藏。
实现上直接订阅 DSH 的会话摘要与统一状态，不轮询、不读取聊天正文。缺少宿主状态接口时隐藏任务入口，主题与轮播仍可用。
安装与启用¶
插件以当前 dsh 进程权限运行，安装前建议浏览仓库源码与 MIT 许可；角色美术与商标不包含在软件许可内，见仓库 NOTICE.md。
从插件市场或预构建包安装¶
dsh-market 通过 awesome-dsh-plugin 目录收录；可在市场的「主题」中搜索 gord-dsh-saber-theme。也可下载 Release 中的 gord-dsh-saber-theme.tgz 由插件管理器导入。
Web CLI 可直接安装 v0.3.1 预构建包（标准 npm 包格式，无需在用户机器上构建）：
dsh plugin --profile web add "https://github.com/nightosong/gord-dsh-saber-theme/releases/download/v0.3.1/gord-dsh-saber-theme.tgz"
市场安装与手动 ZIP/脚本安装二选一。若从旧版手动安装迁移到市场，先执行 node scripts/manage.mjs uninstall --profile desktop（Web 用户改为 web），再由市场安装，避免重复注册主题实例。
手动安装与恢复¶
先启动过一次要用的 Desktop 或 Web profile，然后关闭 DSH。从 Release 下载对应平台 ZIP 完整解压，或下载仓库源码；不需要执行 npm install 即可安装。
| 平台 | 安装 | 恢复官方外观 |
|---|---|---|
| macOS | 双击 macos/Install Saber Theme.command |
双击 macos/Restore Default Theme.command |
| Windows | 双击 windows/Install Saber Theme.cmd |
双击 windows/Restore Default Theme.cmd |
macOS 若提示无执行权限，可在终端执行：
bash "macos/Install Saber Theme.command"
安装后从原有 DSH 图标或 dsh web 启动；刷新与新窗口会自动加载主题。默认写入已初始化的 desktop / web 配置，不会创建未初始化的配置环境。
命令行可指定 profile 与数据目录：
node scripts/manage.mjs install --profile desktop
node scripts/manage.mjs install --profile web
node scripts/manage.mjs status
node scripts/manage.mjs uninstall
自定义数据目录时传 --home "/path/to/dsh-home"，或设置环境变量 DSH_HOME。默认数据目录：macOS 为 ~/.dsh，Windows 为 %USERPROFILE%\.dsh；主题副本位于 <DSH_HOME>/themes/gord-dsh-saber-theme/<版本>-<安装ID>/，配置补丁在 <DSH_HOME>/profiles/<profile>/cordis.patch.yml。恢复仅移除本主题配置块，备份文件 *.saber-backup-* 会保留供回退。
典型用法与注意¶
- 日常使用：安装并重启 DSH 后，照常使用浅色/深色与字号；聊天区背景按设定间隔轮播，任务关注在有多会话任务时从右侧入口查看。
- 卸载或换肤：优先通过市场禁用/卸载；手动安装用户用各平台
Restore Default Theme或manage.mjs uninstall。 - 开发与改样式：维护者流程为
npm ci、npm run build、npm test；改theme/saber.css、theme/tokens.json、src/client.js后重新安装主题并重启 DSH。npm run preview仅为组件测试页，不是 DSH 本体。 - 兼容性：兼容范围未扩大到 README 未测试的宿主版本；Windows 原生桌面视觉效果 README 标明仍需真机验收。
社区插件目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，主题类插件只影响客户端呈现与文档中列出的前端能力，不改变模型或工具链本身。
结尾¶
若你希望在 DSH Desktop 或 Web 上获得 Saber Ice Atelier 风格，并顺带使用右侧任务关注，可按上文任选市场、.tgz 或平台安装脚本一种方式安装 gord-dsh-saber-theme。更多细节与验证说明见 GitHub README 与 插件目录页。
