# 安装指南（INSTALL.md）

本插件有两种安装方式：**标准安装**（`dsh plugin` 写入 web profile，长期生效，推荐）与**动态插件**（进程内运行，快速体验）。

## 方式一：标准安装（推荐）

纯 JS、零构建、即装即用。通过 `dsh plugin`（pnpm 转发）安装到 profile，并自动登记为 bundle 层（`package.json` 声明了 `dsh.bundle.patch`）：

```bash
dsh plugin --profile web add github:AKS1st/ikun-theme-skin
dsh web   # 重启 web 服务使 profile 生效
```

本地安装（clone 后直接指向仓库目录）：

```bash
git clone https://github.com/AKS1st/ikun-theme-skin.git
dsh plugin --profile web add /path/to/ikun-theme-skin
dsh web
```

卸载：

```bash
dsh plugin --profile web remove ikun-theme-skin
```

> 若 pnpm 提示需要执行构建脚本（`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` / `ERR_PNPM_IGNORED_BUILDS`），按提示把包加入 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds` 后重试即可（本插件无构建脚本，通常不需要）。

## 方式二：动态插件（进程内运行，无需安装）

动态插件只存在于进程内存，不写磁盘——重启后需重新运行（已授权的 Package 无需重复授权）。

1. 复制 [`src/client.js`](../src/client.js) 中的**函数体**（从 `return {` 到末尾的 `}` 整段，不含文件头注释）
2. 在会话中执行：

   ```
   cordis_define
   plugin: new，idPrefix: ikun
   name: IKUN 主题皮肤
   purpose: ikun 应援主题 + 全屏壁纸 + 发送音效 + 音乐盒
   code.client: <粘贴刚才复制的函数体>
   ```

3. 执行 `cordis_run`（首次运行 Client 插件需要你在界面中允许授权）
4. 完成后界面自动应用浅色主题、开始壁纸轮播、右下角出现小坤坤

## 使用

| 操作 | 效果 |
| --- | --- |
| 发送任意消息（回车或点发送） | 播放「你干嘛~哎哟」 |
| 点侧边栏底部「IKUN 音乐」 | 开关音乐盒 |
| 音乐盒 ▶ 播放 | 基尼太美音乐，坤坤跳舞转球 |
| 设置 → 通用 → 外观 | 系统主题列表已含 3 个 ikun 主题 |
| 设置 → IKUN 主题 | 主题切换 / 🖼 换一张 / 音乐控制 |

## 常见问题

- **标准安装后没有效果**：需要 `dsh web` 重启使 profile 生效；确认 `dsh plugin --profile web add ...` 成功且重启无 `Failed to load plugins` 报错。
- **发送没声音**：浏览器自动播放策略要求页面至少有一次用户交互；先点击一下页面任意位置即可。若仍无声，按 F12 查看 Console 中 `ikun:` 开头的日志。
- **壁纸没显示**：壁纸仅在 ikun 主题激活时显示（切回系统主题会自动撤下）；图片加载失败会落到渐变底色，属正常降级。
- **标准安装如何卸载**：`dsh plugin --profile web remove ikun-theme-skin`，然后 `dsh web` 重启；外观行、壁纸、主题全部自动还原。
- **动态方式重启后插件消失**：动态插件不持久化，属正常行为；重新 `cordis_run` 即可。

## 素材替换

所有外部资源在 `src/client.js` 顶部常量区与 `WALLPAPERS` 数组中集中管理，直接替换 URL 即可。