dsh-k-on-pet
《轻音少女》五位角色的 DSH Web 桌宠：任意方位行走、待机/点击/双击动作、茶桌与自动回位。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:sunjay-lee/dsh-k-on-pet#0bf27d39774ae96f34ba4e2394e8e4eb93ac6a44
K On Pet 以 dsh-k-on-pet 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把《轻音少女》的五位角色请进 DeepSeek Harness 的 Web 界面：任意方位走动、出界回绕、 待机/单击/双击各有动作，茶桌可以拖动，角色在外溜达久了会自己走回座位。
素材取自 2012 年原版 Windows 桌宠《轻音! DTA》，行为按原版录像逐行校对。
localStorage，支持导出/导入 JSON要求：DSH 0.2.x 的 Web profile（桌面端或 dsh web）。
dsh plugin --profile web add github:<你的用户名>/dsh-k-on-pet
装完把 "dsh-k-on-pet" 加进 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles，重启 DSH。
桌面端用的是
desktopprofile，把命令里的web换成desktop即可。
git clone https://github.com/<你的用户名>/dsh-k-on-pet.git
dsh plugin --profile web add file:<仓库绝对路径>
同样需要把包名加进 dsh.profile.bundles，然后重启。
设置 → K-ON! 桌宠：
| 分组 | 项 | 说明 |
|---|---|---|
| 显示角色 | 五人开关 / 全部显示 / 全部隐藏 | 可同时显示，各自独立坐标 |
| 桌子 | 显示桌子 | 茶桌开关；关掉同时清空座位 |
| 自动回位 | 0–30 分钟；在外超过这个时长会自己走回座位，0 = 不回位 | |
| 重置桌子位置 | 桌子回到默认位置并清空座位 | |
| 外观与行为 | 大小 | 1.0–2.4×，统一缩放 |
| 语音 | 点击/双击是否播放原版语音 | |
| 随机闲聊 | 待机时每 2.5–5 分钟说一句 | |
| 溜达 | 是否自己走动（待机 2–5 秒就走） | |
| 朝向反转 | 走路时脸和前进方向相反就打开，切换左右步态素材 | |
| 关怀提醒 | 每 50 分钟提醒喝水/休息 | |
| 备份与恢复 | 导出 / 导入 | 偏好存为 JSON，可跨浏览器迁移 |
| 位置与重置 | 初始化 | 清空位置、座位、桌子位置，朝向复位，运行状态归零 |
| 重置所有位置 | 只清坐标 | |
| 恢复默认设置 | 回到只显示唯、1.5×、右下角 |
右键角色：隐藏这只 / 回到右下角。
lib/index.js）：把 assets/ 挂到只读路由 /dsh-k-on-pet/*，GET/HEAD，
做了 resolve + startsWith 的目录穿越防护，不读写工作区、不联网。lib/client.js）：通过 shell.overlay 挂浮层、settings.section 挂设置页；
每个角色一块 Canvas，自绘精灵图；所有角色共享一条 requestAnimationFrame 时间线。src/core.cjs）：走路规划、出界回绕、抛物线物理、设置归一化、动画帧推进都放在这里，
可以在 Node 里直接单测，不依赖 DOM。dsh-k-on-pet/
├── package.json # DSH bundle patch + 客户端注入声明
├── cordis.patch.yml # 把插件挂进 profile
├── src/
│ ├── core.cjs # 纯逻辑：走路/回绕/物理/设置
│ └── client.js # 浏览器半：React 浮层 + Canvas + WebAudio
├── lib/
│ ├── index.js # 宿主半：只读静态资源路由
│ ├── client.js # 由 scripts/build-client.mjs 生成，勿手改
│ └── types/ # 类型声明
├── assets/
│ ├── characters/ # 5 套图集 + meta.json（含 actions 行号表）+ 语音
│ └── table/ # 茶桌与坐姿
├── scripts/
│ ├── build-client.mjs # 把 core.cjs 内联进 lib/client.js
│ └── check.mjs # 静态自检
└── test/
└── core.test.mjs # 纯逻辑单测（node:test）
npm run build # 重建 lib/client.js（改完 src/ 必须跑）
npm run check # 静态自检：清单、素材、行号、构建同步
npm run test:unit # 纯逻辑单测
npm test # build + check + 单测
改了 src/ 却忘了 npm run build，DSH 读到的还是旧的 lib/client.js —— 自检会直接报错。
| 项 | 说明 |
|---|---|
| DSH | 0.2.0-rc.1 / 0.2.0-rc.2 / 0.2.1-rc.2 |
| profile | web（桌面端或浏览器） |
| 平台 | 依赖 Canvas 2D、WebAudio、Pointer Events、localStorage |
| 不适用 | TUI / headless profile |
THIRD_PARTY_NOTICES.md，不可商用LICENSETHIRD_PARTY_NOTICES.md本项目是非官方同人作品，与京都动画、芳文社、原作者及原版程序作者均无关联。