Slymaster/dsh-theme-lab

DSH 主题实验室

非官方社区项目——与 DeepSeek 无关联，亦未获其认可。

一个模块化主题合集与入门套件，适用于 DeepSeek Harness 的预览版本。主题实验室新增了原生设置选择器、持久化选择、语义化浅色/深色调色板，以及仅在首条消息之前出现的响应式插画。

| 事件视界 | 赛博樱花 |
| --- | --- |
| 深色背景上的紫色黑洞 | 带有粉色花朵的霓虹夜景花园 |
| 黑曜石金 | 数字雨 |
| 带有金色传送门的黑色建筑空间 | 黑色背景上的抽象绿色数字雨 |

界面预览

赛博樱花聊天

应用于 DeepSeek Harness 聊天的赛博樱花

主题选择器

在 DeepSeek Harness 设置中选中的赛博樱花

赛博樱花显示在原生 Harness 主题选择器中，其匹配的聊天调色板在设置界面背后处于激活状态。

功能特性

- 四个自定义主题，外加未经改动的 DeepSeek Harness 默认主题。
- 一个数据驱动的注册表，用于卡片、调色板、插画和资源路由。
- 每个自定义主题恰好包含 16 个经过检查的语义化令牌，并带有浅色和深色值。
- 通过 Harness 连接服务实现原生设置持久化——没有 localStorage 回退。
- 响应式 WebP 主视觉插画仅限定于 [data-phase='hero']。
- 可逆的令牌覆盖，并在选择默认主题或卸载时进行完整清理。
- 一个小型 Creator 回退方案，用于在没有插画或设置的情况下试用事件视界调色板。

兼容性与先决条件

主题实验室 1.0.0 面向 DeepSeek Harness 0.1.1-rc.2 和 Node.js 22。Harness 目前是预览软件：其插件 API 可能会在不另行通知的情况下发生变化，因此在升级任一项目之前，请先查看兼容性说明。

你需要：

- 一个现有的本地 DeepSeek Harness 安装；
- 通过 Corepack 使用 Node.js 22 和 pnpm；
- 对当前活动的 Harness 配置文件目录及其 cordis.patch.yml 的访问权限。

从源码安装

git clone https://github.com/Slymaster/dsh-theme-lab.git
cd dsh-theme-lab
corepack enable
pnpm install --frozen-lockfile
pnpm bundle
pnpm link --global

从当前活动的 DeepSeek Harness 配置文件目录链接该包：

pnpm link --global dsh-theme-lab

将 cordis.patch.yml 中的单行内容合并到配置文件补丁中：

- insert:
- id: dsh-theme-lab-live
name: dsh-theme-lab

确保只保留一行主题实验室条目。包清单会自动暴露 Web 客户端。

更新正在运行的配置文件

Harness 可能会发现已禁用的客户端模块，因此不要在新的主题实验室别名旁边留下旧的别名。要进行安全的热更新：

1. 完全移除现有的主题实验室条目，并等待 Harness 启动图中不再包含任何主题实验室模块。
2. 重新构建/链接新包，插入上面的单行，然后等待 HMR。

这个两阶段流程可避免过期的 Host ESM 缓存和重复的客户端注册。加载了旧启动图的浏览器可能需要刷新一次。如果你的 Harness 构建不会通过 HMR 应用 Host 更改，请遵循其当前的重新启动指南，而不要假设支持热替换。

选择主题

打开 Settings → General → Interface theme，然后选择 DeepSeek original、Event Horizon、Cyber Sakura、Obsidian Gold 或 Digital Rain。所选内容存储在原生 dsh-theme-lab Settings 命名空间中，并且应在页面重新加载后保留。

创建你自己的主题

请遵循创建主题。一个新主题就是一个注册表条目、一张优化后的 WebP 和一套完整的 16 个 token 的调色板。无需控制器分支。

创建者回退方案

client.js 是有意受限的：它仅应用 Event Horizon token 调色板。它没有主视觉图稿、主题选择器或持久化功能。请使用可安装包以获得完整体验。

卸载

1. 在 Settings 中选择 DeepSeek original。
2. 从 profile 补丁中移除 dsh-theme-lab-live 行。
3. 使用 pnpm unlink dsh-theme-lab 从 profile 中取消链接该包。
4. 可选：使用 pnpm unlink --global 从克隆的项目中移除全局链接。

卸载时会调用 token、hero、slot 和 subscription 的清理函数。保存的 dsh-theme-lab 偏好可以无害地保留在 Harness Settings 文档中。

故障排除

| 症状 | 检查 |
| --- | --- |
| 没有主题卡片 | 确认 profile 中有一个 dsh-theme-lab 依赖项和一行 Host，然后检查启动图。 |
| 选择会更改但重新加载后重置 | 确保 package.json 和 src/client/index.ts 中的两个 connection 注入仍然存在。 |
| 图稿返回 404 | 重新构建并检查 /plugins/dsh-theme-lab/.webp；路由是精确且区分大小写的。 |
| 重复卡片或过期样式 | 移除所有旧别名，使用上面的两阶段更新，然后刷新一次。 |
| 主题覆盖了活动对话 | 确认自定义 CSS 仍然仅针对 [data-phase='hero']。 |

报告问题时，请包含 Harness 版本、Node 版本、浏览器控制台错误以及经过脱敏的启动图摘录。切勿发布机密或私有 profile 数据。

开发

pnpm bundle
pnpm test
npm pack --dry-run --json

验证器会检查注册表、settings 命名空间、持久化接线、清理、对比度、精确路由、包内容和确定性 bundle。

项目链接

- DeepSeek Harness 上游
- Theme Lab 问题
- 贡献指南
- 安全策略
- 图稿来源
- 第三方声明

路线图

- 针对未来 Harness 预览版本的兼容性检查。
- 社区主题库与可复用调色板验证。
- 主题定义的导入/导出格式。
- 当上游提供稳定测试框架时，进行自动化浏览器级冒烟测试。

许可证

MIT © Slymaster。参见 LICENSE。DeepSeek Harness 仍受其自身许可证约束；参见 THIRD_PARTY_NOTICES.md。