dsh-cerrda-theme

Readme

# dsh-cerrda-theme

DSH（DeepSeek Harness）Web GUI 的 cerrda 暗色主题——以部署级静态 web 插件发布，
**免审批、进程重启后自动加载**。

- rose/purple oklch 配色体系、Sora / Fraunces / JetBrains Mono 字体
- Liquid Glass 输入栏 / hero 面板 / 回到底部按钮（SVG 位移滤镜）
- Silk WebGL2 动态背景、CardSpotlight、Ripple、ShimmerBorder
- CSS 液态玻璃：侧边栏、详情列、会话头部、工具卡片、浮层

## 安装

在 DSH 环境里执行（需要 `pnpm` 在 PATH 上）：

```bash
dsh plugin --profile web add dsh-cerrda-theme
```

然后**重启 DSH 进程**（web profile 的 HMR 已禁用，bundle 层只在启动时应用）。
重启后主题自动生效，无需任何审批。

本地未发布版本（本仓库根目录就是包，在仓库根执行）：

```bash
dsh plugin --profile web add .
```

## 卸载

```bash
dsh plugin --profile web remove dsh-cerrda-theme
```

重启后即恢复默认外观。

## 验证

```bash
dsh --profile web --dump-config | grep dsh-cerrda-theme
```

浏览器 DevTools 网络面板应出现 `/plugins/dsh-cerrda-theme/client.js`。

## 工作原理

本包是一个 **bundle 包**（profile 层），与 `@deepseek-ai/dsh-base`、
`@deepseek-ai/dsh-web-app` 同一机制：

| 字段 | 作用 |
|---|---|
| `dsh.bundle.patch: ./cordis.patch.yml` | `dsh plugin add` 后自动把本包追加进 `dsh.profile.bundles` 层栈，`cordis.patch.yml` 在启动时参与组合 |
| `dsh.client: { platform: "web" }` | 声明浏览器 half，`dsh-client-modules` 把它收进 `window.__DSH_BOOT__` 名录，服务 `/plugins/dsh-cerrda-theme/client.js` |
| `main: lib/index.js` | 空宿主 half（carrier 行）——让 loader 行激活，名录只收录已激活的行 |
| `exports["./client"]: lib/client.js` | 浏览器 bundle：`window.__ModuleLoader__.load({id, factory})` 注册，`require("react")` 取 React，CSS 以 `data-plugin-css` 风格 style 标签注入 |

## 开发

开发循环：**改 `src/` → `npm run build` → 重启 DSH（或硬刷新页面）**。

1. `src/cerrda-theme-client.js` —— 动态插件版原始 Client half 源码（**单一事实来源**，
   所有样式/逻辑改动都写在这里）。
2. `npm run build`（即 `node scripts/vendor-number-flow.mjs && node scripts/build.mjs`）——
   `scripts/vendor-number-flow.mjs` 先把 `src/vendor/package/dist/` 里 vendor 的
   **number-flow**（[number-flow.barvian.me](https://number-flow.barvian.me/)，MIT）
   内联成 `src/vendor/number-flow.inline.js`（`window.__CERRDA_NUMBER_FLOW__`），
   再由 `scripts/build.mjs` 生成 `lib/client.js`（静态 bundle）：包一层
   `window.__ModuleLoader__.load`、`require("react")`、手动 CSS 注入、
   末尾 `return` 改为 `module.exports`。脚本对关键标记做存在性校验，
   `src` 结构变了会直接报错而不是生成坏包。
3. 生效：
   - **改的是 `lib/` 或 `src/`**：重启 `npx @deepseek-ai/dsh web`（推荐），
     或只做**硬刷新**页面（Ctrl+Shift+R）——bundle 以 no-cache 从磁盘实时读取，
     改 CSS/JS 内容通常不用重启即可看到；
   - **改了 `package.json` / `cordis.patch.yml`**（结构变化）：必须重启 DSH。
4. 发布前：升 `version`，`npm publish`（`prepare` 钩子会自动先跑 `npm run build`，
   保证发布内容与 `src/` 一致）。

本地安装（link 到本仓库，改完无需重装）：

```bash
dsh plugin --profile web add .
```

- `docs/` —— 设计（plan）、动态恢复说明（restore）、分享说明（share）。

## 发布

```bash
npm publish
```

## License

MIT