dsh-muyu

Readme

# dsh-muyu

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
[![npm version](https://img.shields.io/npm/v/dsh-muyu)](https://www.npmjs.com/package/dsh-muyu)
[![npm downloads](https://img.shields.io/npm/dm/dsh-muyu)](https://www.npmjs.com/package/dsh-muyu)

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

Harness 还是 preview 版本，最近算力不够，感觉api也有点降速，loop 有时说断就断。等loop的过程有时候好几分钟，我这个气呀，做了个右下角不争气的小肥鲸，敲一下记一功德，等待的时候敲敲她吧，希望deepseek算力中心早点建起来，梁叔叔再把模型价格打下来吧。
它忙的时候自己也会敲，挂机加功德了，没事摸摸鱼吧。

位于 Web 客户端右下角的电子木鱼：敲头记功德；模型在思考和流式输出时她会自己敲。功德只在本机浏览器，不进对话记录，也不会有额外请求。可以自己换喜欢的图。

| 手动敲 | 自动敲 |
| --- | --- |
| ![木鱼手动敲演示](docs/tap.gif) | ![木鱼自动敲演示](docs/auto-tap.gif) |

## 玩法

- 点角色头部：+1 功德。被敲多了会起包。
- 点右上角小锁可解锁拖动位置，再点锁定；解锁后可用滚轮或 −/+ 缩放；设置里可隐藏小锁。
- 当前会话忙碌时：自动轻敲，也记功德，默认大约每秒 1 功德。
- 换会话：功德只会记录当前会话的敲击次数与自动消耗，切换会显示当前会话的。
- 计数有香炉和木牌两种，默认香炉；9999 以内显示原数，再大显示 `Nk`。
- 系统开了「减少动态效果」时会跳过跳动和飘 +1。

手感与图源在 **设置 → 木鱼** 里改（开关、锁定按钮、香炉/木牌、自动敲快慢、起包连击数、图源）。**本地制作** 用来做图对齐；**图库** 存放导入或存入的多个包，可随时切换；URL 给在线托管。

社区图包 / 二创皮肤见 **[dsh-muyu-skins](https://github.com/liuwenji007/dsh-muyu-skins)**（导入 zip → 图库「用这套」）。

## 安装

前提：本机已能跑 `dsh web`（DeepSeek Harness）。

**需要 dsh ≥ 0.1.0-rc.8（建议 0.1.1-rc.2）。** `dsh-muyu` **0.1.5+** 依赖宿主模块表里的 `@deepseek-ai/dsh-client-store`。

版本要成对升，市场不会拦不匹配的升级：

| 宿主 | 本插件 | 结果 |
| --- | --- | --- |
| 新（有 `dsh-client-store`） | ≥ 0.1.5 | 正常 |
| 新 | ≤ 0.1.4 | 报 `dsh-client-runtime/client` missed the module table |
| 旧（只有 `dsh-client-runtime/client`） | ≤ 0.1.4 | 正常 |
| 旧 | ≥ 0.1.5 | 报 `dsh-client-store` missed the module table |

**老 dsh 上别只升木鱼到 0.1.5**——先升宿主，再升插件；暂时不升 dsh 就钉住 `dsh-muyu@0.1.4`。

先确认宿主版本：

```bash
dsh --version
# 过旧则：npm i -g @deepseek-ai/dsh@latest
```

### 从 npm 安装（推荐）

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

已安装要升级：市场里一键更新，或 `dsh plugin --profile web add dsh-muyu@latest`，再重启 Web。包内已带构建产物，一般不用 `allowBuilds`。

### 从 GitHub 安装

```bash
dsh plugin --profile web add github:liuwenji007/dsh-muyu
dsh --profile web
```

pnpm ≥10 可能拦截 git 依赖的 `prepare`：第一次失败后，把 pnpm 打印的包名写进该 profile 的 `pnpm-workspace.yaml`：

```yaml
allowBuilds:
  dsh-muyu: true
```

再执行一次 `add`。建议钉 commit：`github:liuwenji007/dsh-muyu#<sha>`。

### 本地链接（开发调试）

```bash
cd /你的路径/dsh-muyu
pnpm install
dsh plugin --profile web add link:/你的路径/dsh-muyu
dsh --profile web
```

### 验证与卸载

- 生效：右下角出现木鱼；或 `dsh --profile web --dump-config` 里能看到本包。刷新页面不够，要重启 `dsh web` / `dsh --profile web`。
- 卸载：`dsh plugin --profile web remove dsh-muyu`，再重启。卸载**不会**删除浏览器里的功德与图库；重装后会恢复。若要彻底清除，请到 **设置 → 木鱼 → 数据** 使用「清除全部木鱼数据」。

### 排障

| 碰到 | 怎么处理 |
| --- | --- |
| `dsh-client-runtime/client` 或 `dsh-client-store` missed the module table | 宿主与插件版本错配：新宿主配 **≥ 0.1.5**，旧宿主先升 **dsh ≥ 0.1.0-rc.8** 再升插件（或旧宿主钉 `dsh-muyu@0.1.4`）；市场更新或 `add dsh-muyu@…` 后重启 Web |
| 右下角出现两只 | 组合包可能已有内置 `ui-muyu`。在 profile 的 `cordis.patch.yml` 里加 `- id: ui-muyu` / `disabled: true` |
| git 安装卡在 `allowBuilds` | 见上文「从 GitHub 安装」 |
| 也可用 `.tgz` | `pnpm pack` 后：`dsh plugin add ./dsh-muyu-0.1.0.tgz` |

## 设置

| 项 | 默认 | 说明 |
| --- | --- | --- |
| 显示浮层 | 开 | 关掉只藏角色，设置页还在 |
| 功德牌 | 香炉 | 香炉或木牌 |
| 忙碌后第一次自动敲 | 1000 ms | |
| 自动敲间隔 | 1000 ms | |
| 大包连击阈值 | 5 | 达到后松手先大包，有消包图则消包再笑脸，否则小包 |
| 自定义图源 | 内置 | **当前图源** 可选内置 / 本地制作 / 图库 / URL |
| 图库 | （空） | 导入的 zip / 存入的制作包；可切换、重命名、删除 |
| 本地制作 | （空） | 选文件夹或 PNG 对齐；可导出对齐包或存入图库 |
| 图包 URL | （空） | 别人托管的目录或 `.zip` 地址；可附带 `layout.json` |
| 导出对齐包 | — | 在制作工作台下方；按对齐裁切姿势图并写入 `layout.json` |

图源目录或 zip 里需要这些文件名：`idle.png`、`auto-hit.png`、`manual-hit.png`、`bump.png`、`bump-big.png`、`stick.png`、`board.png`、`censer.png`、`add.png`。`bump-recover.png` 与 `layout.json` 可选。对齐包会把姿势裁进 PNG（同尺寸），`layout.json` 主要带敲击区/木棍/飘字/功德牌摆位。改完即时生效，不用重新安装插件。

在 **设置 → 木鱼 → 导出模板** 可下载官方文件名 zip；对齐完成后用工作台下方的 **导出对齐包** 分享。zip 的 URL 需要对方站点允许跨域。

制作工作台与图库分槽：导入 zip 会进图库列表，不会冲掉你正在改的制作文件。

起包停留、自动敲姿势时长仍跟默认图绑在一起，改 [`src/config.ts`](src/config.ts) 里的 `ART_TUNABLES` 后重新 `pnpm run build`。木棍热点与敲击区等已可在工作台 / `layout.json` 里改。

## 注意

- 功德记在本机 `localStorage`（`dsh.muyu.merit`），最多 100 个最近敲过的会话；删掉的对话不会跟着清。制作草稿与图库包记在 IndexedDB（`dsh.muyu.art`），与 URL 分开。隐私模式或配额满了，只是本页不再保存。重装后若检测到**有意义的**旧数据（敲过功德、改过偏好或图库非空），会弹窗询问是否继续使用；选「继续使用」后记录在 `dsh.muyu.dataPrompt`。
- 不能拖拽，以免挡住侧栏。
- 也可以直接改仓库里的 `src/client/assets/` 再 build，适合做成新默认皮肤发布。

## 改这个仓库

```bash
pnpm install
pnpm test
pnpm run build
```

MIT