Gord DSH Saber Theme
DeepSeek Harness 的 Saber 主题，参考 Codex Saber Theme 的 Saber Ice Atelier 风格：冰蓝、通透面板与 Saber 主视觉。
当前版本：0.3.1 · 发布版本
使用 DSH 原生客户端插件，支持 macOS / Windows，以 Desktop 桌面版为主，兼容 dsh web，保留官方浅色/深色切换、字号设置、会话与窗口操作。终端 TUI 不在本主题范围内。
预览
以下为隔离 DSH 0.2.0-rc.2 实例的实际截图。
macOS 原生桌面版：
Web 浅色与深色：
安装与恢复
版本要求
| 依赖 | 当前要求 | 说明 |
|---|---|---|
| DeepSeek Harness | 0.2.0-rc.2 或 0.2.1-rc.2 |
Web 已验证前者，macOS 桌面已验证后者；CLI 与桌面内置版本需分别确认 |
宿主主题服务 @deepseek-ai/dsh-client-ui-theme |
0.2.0-rc.2 或 0.2.1-rc.2 |
由 DSH 提供；声明为可选对等依赖，不自动安装第二份组件 |
| Node.js | 22+ |
运行源码安装器和 dsh CLI 时需要；桌面市场安装可使用应用内置运行时 |
| 系统 | macOS / Windows | macOS 原生桌面与 Web 已验证；Windows 安装器已通过自动测试，桌面视觉待真机验收 |
package.json 同时声明 engines.dsh 和主题服务的 peerDependencies。兼容范围暂不扩大到未经测试的宿主版本。命令行用 dsh --version 查询；桌面版请查看应用的“关于”，不能用全局 npm 安装的 CLI 版本代替桌面版本。
从插件市场或预构建包安装
dsh-market 通过 awesome-dsh-plugin 目录收录主题；收录申请已合并，可在市场的“主题”中搜索 gord-dsh-saber-theme。目录使用 GitHub 最新 Release 的预构建包，市场同步时间以实际显示为准。
也可先下载 Release 中的 gord-dsh-saber-theme.tgz，由插件管理器导入。Web CLI 可直接安装预构建包：
dsh plugin --profile web add "https://github.com/nightosong/gord-dsh-saber-theme/releases/download/v0.3.1/gord-dsh-saber-theme.tgz"
这是标准 npm 包格式的 GitHub 发布资产，不需要发布到 npm，也不需要在用户机器上构建。市场安装与以下手动安装方式二选一。
从旧版手动安装迁移到市场时，先执行 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"。安装后从原有 DeepSeek Harness 图标或 dsh web 启动，刷新和新窗口会自动加载主题。
默认安装到已初始化的 desktop / web 配置；不会创建尚未初始化的配置环境。命令行可指定目标：
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。Windows 图形入口若没有继承终端的环境变量，应通过命令行传入同一目录。
| 配置/文件 | macOS | Windows |
|---|---|---|
| 默认 DSH 数据目录 | ~/.dsh |
%USERPROFILE%\.dsh |
| 主题副本 | <DSH_HOME>/themes/gord-dsh-saber-theme/<版本>-<安装ID>/ |
同左 |
| 配置补丁 | <DSH_HOME>/profiles/<profile>/cordis.patch.yml |
同左 |
| 备份 | 配置文件旁的 *.saber-backup-* |
同左 |
恢复仅移除本主题配置块，保留其他设置；主题副本与备份保留供回退，可在关闭 DSH 且恢复后手动清理。本主题通过原生插件加载，无需调试端口。
聊天右侧任务关注
参考 gord-dsh-worktree 的任务关注设计，入口位于聊天右侧轮次索引下方。主数字为任务总数，角标为待处理与已结束未查看的数量；无任务时自动隐藏。
- 鼠标移入展开，移出 200ms 后收起；也可点击或用键盘操作，Escape 收起。
- 展示运行中、等待输入/审批、已结束未查看的其他会话；“已结束”不代表执行成功。
- 点击打开已有会话，确认切换成功后才移除本轮提醒；新的运行或请求可以再次出现。
- 支持拖动并记住当前设备上的位置，↺ 恢复到索引下方；窄窗口自动限制位置并避开输入区。
- 跟随浅色/深色与中英文；同时启用
gord-dsh-worktree且其任务入口可见时，主题入口自动隐藏。
直接订阅 DSH 的会话摘要和统一状态，不轮询、不读取聊天正文、不保持额外会话引用；收起时不渲染列表，展开每页最多 20 条。缺少宿主状态接口时隐藏任务入口，主题及轮播继续工作。提醒属于当前窗口，不提供独立的跨窗口通知记录。
开发与验证
npm ci
npm run build
npm test
npx playwright install chromium
npm run test:browser
npm run preview
preview 是组件测试页面，不是 DSH 本体。可修改 theme/saber.css、theme/tokens.json 和 src/client.js，然后重新安装主题并重启 DSH。图片包含在离线插件包中，不请求远程图片。聊天背景默认每 5 分钟随机切换一次，共 30 张，连续两次不重复；首页保留固定插画。
为减少占用，轮播素材使用 DSH 原生分块按需加载，不预加载全部图片；解码成功后直接替换，不常驻双层动画。插件最多保留当前图和待切换图两个 Blob URL，旧 URL 随即释放。窗口隐藏时暂停计时并取消待切换图片，恢复后重新等待 5 分钟；图片失败或 10 秒超时时保留原图，下个周期重试。首页只做每 5 分钟一次的状态检查，不加载轮播素材；没有监听消息变化的观察器。禁用或卸载插件会清理计时器、监听器与全部自建 Blob URL。DSH 会缓存已请求的压缩图片分块，浏览器也会自行管理解码缓存，因此这不是整个桌面应用的内存上限。
轮播间隔可在源码 theme/rotation.json 的 intervalMinutes 中修改（1–1440 分钟），构建并重新安装后生效。两平台及 Desktop/Web 使用相同实现。
已安装 dsh 时可运行隔离集成测试：
node scripts/dsh-smoke.mjs
node scripts/desktop-smoke.mjs
前者使用临时 DSH 数据目录启动真实 Web 界面；后者使用独立的 DSH 目录、Electron 用户目录和空闲后端端口启动已安装的桌面应用。两者均检查原生插件并截图，再通过加速时钟和临时移除首页布局标记验证实际分块加载及两次轮播，不创建会话、不调用模型。桌面测试默认定位 macOS 应用，也可用 SABER_DESKTOP_APP 指定可执行文件。测试范围与平台验收记录见 验证说明。Windows 的原生桌面应用视觉效果仍需真机验收。
版本与发布
VERSION 是版本源；package.json、package-lock.json、README 和 CHANGELOG 必须同步更新。标签使用 v<版本> 格式，后续版本按语义化版本递增。
npm run check
npm run package
node scripts/release.mjs macos
node scripts/release.mjs windows
本地 ZIP 打包另需 Python 3。GitHub Actions 在 macOS 与 Windows 上分别运行测试，并校验 .tgz 只包含运行产物、说明与许可；推送 v* 标签后，测试通过才会把两平台 ZIP 和插件 .tgz 发布到 GitHub Release。npm run package 仅打包，不会执行 npm publish。
打包安装的隔离验证：
SABER_PACKAGE=dist/gord-dsh-saber-theme.tgz node scripts/dsh-smoke.mjs
SABER_PACKAGE=dist/gord-dsh-saber-theme.tgz node scripts/desktop-smoke.mjs
No comments yet. Be the first to write one.