牛马力桌宠 chenyuan1251/dsh-pet-niumali

dsh-pet-niumali · 牛马力

DSH 界面里的常驻桌宠。右下角浮着一只小牛，点开是「牛马力 · 替你活」——一套双打卡生活闭环：开工 / 收工打卡、专注计时、待办、手帐、旅行、探宝。

牛马力桌宠主界面

它做了什么

- 常驻浮球：注册在 DSH 的 shell.overlay 插槽上，浮在整个界面之上，可拖动、可收起，位置与展开状态记录在 localStorage。
- 浮窗内是完整页面：展开后用一个 iframe 载入插件自己的 /pet-niumali/ 页面。首次展开才挂载，之后收起只是隐藏 —— 所以专注计时不会被打断。
- 徽标显示路费：浮球上的小徽标实时读同一份存档，显示当前路费；当天开工与收工都打过卡时变成 ✓，外圈转绿。
- 设置页一栏：在设置的 settings.section 插槽里加一栏「牛马力桌宠」，用来开关浮球与单独打开页面。
- 一条静态资源路由：/pet-niumali/，直接访问就是完整页面（也可以在新标签页里打开）。

插件不带后端、不发起网络请求、不读文件、不执行命令；全部存档都在浏览器 localStorage 的 niumali.v9 键下。

安装

从 DSH 插件市场（推荐）

在 DSH 的插件市场里搜索「牛马力 / dsh-pet-niumali」安装即可，装完重启 DSH。

手动安装

在你所用配置档的 package.json 里加一条依赖，并把包名加进 dsh.profile.bundles：

// ~/.dsh/profiles/desktop/package.json
{
"dependencies": {
"dsh-pet-niumali": "github:chenyuan1251/dsh-pet-niumali#main"
},
"dsh": {
"profile": {
"bundles": [
"dsh-pet-niumali"
]
}
}
}

然后在同一目录 pnpm install，重启 DSH。

从源码/Git 安装时，DSH 可能提示一次构建授权；这是下载整仓源码的常规行为。

独立桌面宠物（可选，不需要 DSH）

想不打开 DSH 也能看见它：

cd dsh-pet-niumali
npm install
npm start # 等价于 npx electron electron/main.mjs

会开一个 420×720 的透明、无边框、置顶小窗。鼠标移到顶部会浮出拖动 / 置顶 / 最小化 / 关闭控制条。
这条路径与 DSH 里的浮球互不影响，两者各自用各自的 localStorage。

目录结构

dsh-pet-niumali/
├── package.json # 插件元数据（dsh.bundle / dsh.client） ├── cordis.patch.yml # 把本插件挂进插件树 ├── index.mjs # 服务端半边：注册 /pet-niumali/ 静态资源路由 ├── client.js # 客户端半边：shell.overlay 浮球 + settings.section ├── web/ # 页面本体 │ ├── index.html │ ├── desktop-pet-bridge.js # 在 Electron 小窗里显示标题与拖拽控制 │ └── assets/ # 样式、脚本与图片 ├── electron/ │ ├── main.mjs # Electron 主进程 │ └── preload.mjs # contextBridge 暴露的最小 API ├── assets/screenshots/ # 市场截图 └── README.md

已知限制

- 图片资源约 7 MB，首次打开那一页会慢一点；之后走强缓存。
- 页面按竖版布局设计，浮窗宽度固定 400px、高度在 420–660px 之间自适应。
- 存档在 localStorage，所以「浏览器里」和「Electron 独立窗口里」是两份互不相通的数据。

License

MIT