# dsh-skin-manager · 皮肤管理器

[English](README.md) | [中文](README.zh.md)

面向 DeepSeek Harness Web GUI 的轻量**皮肤管理器**：自动发现所有已安装的
皮肤（任何带 `skin.json` 且附带预构建 client bundle 的包），在独立的
**设置 → 皮肤** 页面列出全部皮肤，一键切换——互斥生效，热载入无需重启
`dsh web`。

## 特性

- **动态发现**：扫描 web profile 的 `node_modules`，找出所有带 `skin.json`
  和预构建 `lib/client.js` 的包；也能识别市场下载的**无 skin.json 主题**
  （带 client bundle 且 `cordis.patch.yml` 插入 theme/skin 行，例如
  `dsh-skin` / Codex 风格皮肤、`dsh-kimino-theme`）。新装的皮肤自动出现，
  无需重新生成清单、无需改代码。
- **独立设置页**：注册 `settings.section`（id `skins`，order 20），出现在
  设置侧栏，与「通用」「模型」平级。
- **一键应用**：选中皮肤点「应用」，profile patch 被重写，DSH 配置 watcher
  秒级热载入；刷新页面即生效。
- **互斥切换**：同一时刻只激活一个皮肤（激活者写 `insert` 行，其余写
  `disabled: true` 行）。
- **恢复默认**：「官方默认」关闭全部皮肤，回到 DeepSeek Harness 原生外观。

## 安装

```sh
dsh plugin --profile web add github:xiaoyangcheng84-svg/dsh-skin-manager
```

然后重启 `dsh web`（或走插件市场热安装）。刷新页面后打开
**设置 → 皮肤**。

> `github:` 源安装需要本机有 git；也可以本地 checkout 后用
> `dsh plugin --profile web add link:<路径>` 安装。

## 使用

1. 打开 **设置 → 皮肤**
2. 看到「官方默认」+ 所有已安装皮肤（如 深海女仆工坊 / maid-atelier）
3. 点某皮肤的「应用」→ 提示成功后点「刷新」→ 皮肤切换
4. 点「官方默认」的「应用」→ 恢复原生外观

## 皮肤包协议

任意包满足以下条件即被识别为皮肤并出现在列表：

- 位于 profile 的 `node_modules`（顶层或 `@scope/name`）
- 带 `skin.json`（`id`、`name`、`package`、`accent`、`bodyAttr`、
  `tagline`，可选 `wiring.id`——与 dsh-deep-whale / dsh-web-ui 皮肤字段一致）
- 带预构建 client bundle（`exports["./client"]` 或 `lib/client.js`）

没有 `skin.json` 的市场主题也会被识别，条件如下：

- 有 `dsh.client` 和 `dsh.bundle.patch`
- `cordis.patch.yml` 里是简单的 `insert` 行
- 包名、loader 行 id，或（immediately 加载的 client bundle）描述/关键词
  包含 theme/skin
- 带预构建 client bundle

## 与插件市场（dsh-market）的联动

安装 dsh-market 时，用本管理器应用皮肤会同时：

- 重写 `cordis.patch.yml` 的 managed 段（重启后仍生效）
- 更新 dsh-market 的 `.dsh-market/state.json`，防止它在下次启动时把刚
  选中的皮肤再禁用
- 卸载 dsh-market 残留的 hot mount，避免多个皮肤叠在一起
- 在改写 patch 前先同步 dsh-market 的内存禁用状态，防止市场的自愈逻辑
  把你刚应用的皮肤立刻又禁用掉——不需要再手动去市场里点“使用”

## 切换原理

切换 = 重写 profile 的 `cordis.patch.yml` 中由
`# --- dsh-skin-manager managed ---` 标记的 managed 段：

- 激活皮肤 → `- insert:` 行
- 其他皮肤 → `- id: <rowId>` + `disabled: true` 行

非皮肤的用户 patch 行（如 dsh-market）原样保留。

## API

host 半区在 `/api/skin-manager` 下挂三个路由：

| 路由 | 方法 | 用途 |
|---|---|---|
| `/api/skin-manager/list` | GET | 列出已装皮肤 + 当前激活 id |
| `/api/skin-manager/apply` | POST | `{ id }` 或 `{ id: "official" }` 切换 |
| `/api/skin-manager/bundle` | GET | `?id=<skinId>` 提供皮肤的 client bundle |

## 开发

client bundle 直接用 `__ModuleLoader__` bundle 格式手写（与官方 `ui-*`
包 tsdown 产物的形状一致），无需构建步骤。`lib/client.js` 只能
`require` 模块表实体（平台种子词如 `react`、已注册的 client bundle）。

## 许可

MIT