桌面宠物狗夜官 zzhi191/dsh-plugin-night-dog

dsh-plugin-night-dog

一只住在 DSH Web 界面角落里的土黄色小狗，名字叫 夜官 🐕。

它是纯客户端插件：不做任何宿主侧工作、不碰网络、不访问模型。所有颜色都取自 DSH 实时主题令牌（--dsw-，主体用琥珀色系），因此会自动跟随用户当前皮肤（浅色/深色/任何第三方主题）。

造型

正面坐姿小狗，按真实犬类解剖绘制：突出的吻部（奶油色口鼻伸出头部下方）、狗鼻子 + 人中线、胡须点、下垂的长耳朵、右眼眼罩斑块（比格犬风）、眉弓、可见的前腿和爪子、卷起的尾巴。

功能

| 交互 / 状态 | 效果 |
| 点击夜官 | 开心地蹦一下 + 吐舌头 + 冒泡（左键绝不会隐藏它） |
| 按住拖动 | 跟手 1:1 跟随鼠标，移动到任意位置（记住位置，刷新后还在；窗口级监听 + 坐标守卫，杜绝跳变） |
| 双击夜官 | 复位位置（回到右下角默认位置） |
| 右键（macOS 双指点按/control+点击）夜官 | 隐藏到右下角小圆点（仅本次会话，刷新页面即召唤回来） |
| 点击小圆点 | 唤醒夜官 |
| 悬停夜官 | 头顶浮现名字「夜官」 |
| 空闲时 | 缓慢呼吸、眨眼、摇尾巴、偶尔吐泡泡 |

周期性自动动作（全部只从空闲态触发，互不打断，也不会让自己忘记睡觉）：

| 动作 | 节奏 | 表现 |
| 张嘴吐舌 | ~9s | 张大嘴哈气 + 舌头伸出 + 眯眼笑 + 尾巴狂摇 |
| 双脚站立 | ~26s | 站立姿势 SVG：身体竖直、前爪作揖、弹跳入场 |
| 歪头 | ~32s | 歪着脑袋卖萌，微微左右晃 |
| 站起来走动 | ~52s | 站立姿势 左右踱步（前爪交替迈步 + 身体起伏），原地走出一个小来回 |
| 打哈欠 | ~42s | 大张嘴 + 眯眼，一副困困的样子 |
| 凶叫 | ~45s | 怒眉 + 怒视 + 龇牙 + 抖动 +「汪！」气泡 |
| 追尾巴转圈 | ~60s | 原地转一整圈 |
| 委屈呜咽 | ~78s | 水汪汪的狗狗眼 + 撇嘴 |

| 其它状态 | 效果 |
| 长时间无操作（20s） | 趴下睡觉：侧卧、头枕在前爪上、闭眼、打呼噜（冒出 Zzz）、身体随呼吸轻轻起伏 |
| 连接重置时 | 吓一跳（X 眼 + 抖动） |
| 执行斜杠命令时 | 开心庆祝（眯眼 + 吐舌头） |

注意：隐藏状态不持久化。右键隐藏后，点击右下角呼吸光晕的小圆点，或直接刷新页面，夜官都会回来；重新启动 DSH 也会恢复显示。
位置持久化带版本号和视口校验（dsh.night-dog.state.v6）：任何越界/损坏的位置数据都会被丢弃，夜官始终从右下角开始。

注意：隐藏状态不持久化。右键隐藏后，点击右下角呼吸光晕的小圆点，或直接刷新页面，夜官都会回来；重新启动 DSH 也会恢复显示。
位置持久化带版本号和视口校验（dsh.night-dog.state.v6）：任何越界/损坏的位置数据都会被丢弃，夜官始终从右下角开始。

情绪状态机：idle → thinking / tool / error / cheer / sleep → idle（thinking / tool 状态已实现动画，等待下一步接上真实 agent 信号触发）。

它在 DSH 里是怎么工作的

DSH 的客户端插件体系（已对照源码验证）：

1. 插件是一个 npm 包，package.json 声明：
- dsh.client.platform: "web" —— 告诉 web 前端这是浏览器侧插件；
- exports["./client"] —— 指向浏览器 bundle，webserver 把它服务为 /plugins/dsh-plugin-night-dog/client.js；
- dsh.bundle.patch —— 指向一个 YAML overlay 补丁（cordis.patch.yml），把插件行插入当前 Profile。
2. cordis.patch.yml 的 name 必须等于 npm 包名：加载器以 entry.options.name 为键做增量扫描，解析 package.json → dsh.client → exports["./client"]。
3. 浏览器端 bundle 是 window.__ModuleLoader__.load({ id, factory }) 格式（与所有官方插件一致），factory 里的 require("react") 由启动图物化解析，无需打包器、无需 JSX。
4. UI 注册进 shell.overlay 槽位（root 级 list 槽，官方文档指定给浮层/提示用），通过 ctx.get("slots") + slots.inject + slots.register 挂载，生命周期由 ctx.effect 的 disposer 管理。

目录结构

dsh-plugin-night-dog/
├── package.json # 插件契约（dsh.client / dsh.bundle.patch / exports） ├── cordis.patch.yml # Profile overlay：插入 night-dog 行 ├── lib/ │ ├── index.js # 宿主侧入口（v0.1 为空操作，仅为让加载器可激活） │ └── client.js # 浏览器 bundle（由脚本生成，勿手改） ├── src/ │ └── client-source.cjs # 桌宠源码（唯一真源，CommonJS 便于直接嵌入） └── scripts/ ├── build-client.mjs # 把 src 包装成 __ModuleLoader__ 格式的 lib/client.js └── smoke-test.mjs # 零依赖冒烟测试：包契约 + patch + bundle 信封 + apply 导出

本地开发循环

改代码：编辑 src/client-source.cjs 重新生成 bundle 并跑冒烟测试
node scripts/build-client.mjs && node scripts/smoke-test.mjs

把包装进你自己的 DSH（任选其一）：
- 社区市场：发布到 npm 并上架目录后，在 DSH 设置 → 插件市场里一键安装（见下）；
- DSH CLI：dsh profile plugin add dsh-plugin-night-dog（等价路径）；
- 手动：在 Profile 的 node_modules 里 pnpm add dsh-plugin-night-dog，并把 cordis.patch.yml 的 insert 行合入 Profile 的 cordis.patch.yml，重启。

开发期改 bundle 后，web 前端通过 bundle 内容哈希（?rev=）感知变化，配合 pnpm run dev:web 的热更可免刷新迭代；正式包则重新 npm publish。

发布到插件市场

1. 发布到 npm

npm login
npm version patch && npm publish

市场安装时只接受 npm 官方 latest 的精确稳定版本，并校验 dsh.bundle.patch 是合法、安全的相对路径。包名不能是 dsh-plugin-desktop 或 dsh-community-market。

2. 上架目录（二选一）

A. 提交到合作目录：DSH 内置了 DSH 1024Store（deepseek1024.com）与 dsh-marketplace（qilewl.net）两个合作提供方，向它们提交收录申请（各自有审核流程）。

B. 自建标准目录源（零门槛，自主可控）：目录契约（v1）明确允许任何个人/社区发布符合规范的来源，用户添加 manifest URL 即可使用。最小实现 = 一个静态 JSON endpoint，例如：

// https://your-domain.example/catalog-source.json
{
"manifestVersion": "1.0.0",
"providerId": "org.example.nightdog-catalog",
"name": "Night Dog Catalog",
"transport": {
"kind": "https-json",
"endpoint": "https://your-domain.example/v1/plugins",
"method": "GET"
},
"query": { "supported": ["q", "category", "cursor", "limit"], "defaultLimit": 50, "maxLimit": 50, "sorts": [] }
}

// https://your-domain.example/v1/plugins?limit=50
{
"schemaVersion": "1.0.0",
"generatedAt": "2026-01-01T00:00:00Z",
"revision": "2026-01-01T00:00:00Z",
"items": [
{
"id": "night-dog",
"name": "dsh-plugin-night-dog",
"displayName": "Night Dog 夜官", "summary": "A cute tan DeepSeek dog named 夜官 that lives in the corner of the DSH GUI.", "latestVersion": "0.1.0", "license": "MIT",
"categories": ["fun"],
"keywords": ["pet", "dog"],
"package": { "registry": "npm", "name": "dsh-plugin-night-dog" },
"publisher": { "name": "Your Name", "url": "https://github.com/your-name" },
"media": { "icon": { "url": "https://your-domain.example/dog.png", "alt": "Night Dog icon" } }
}
],
"page": { "total": 1 }
}

用户在 DSH 设置 → 插件市场 → 来源 里添加 https://your-domain.example/catalog-source.json 即可浏览、一键安装你的插件。

路线图

- [ ] agent 状态感知：注册一个会话级"传感器"组件（如 conversation.chat.turnTail），读取会话快照/投影，把"思考中 / 正在调工具 / 报错 / 完成"转发给桌宠——真正让鲸鱼与你一起工作
- [ ] 皮肤联动包：同名主题包（--dsw- 令牌），鲸鱼外观随皮肤整体换装
- [ ] 进化系统：与 goal/job 数据联动，完成任务解锁新形态（帽子、围巾、颜色）
- [ ] 音效（默认关闭，可配置）
- [ ] 设置项：注册 settings.general.item 做显示/隐藏、尺寸开关

安全与边界

- 纯客户端插件：无宿主执行、无网络、无模型访问，符合 DSH 插件安全模型
- 所有副作用（事件监听、定时器、localStorage）都在 ctx.effect disposer 内，卸载/更新可完全回收
- 不依赖任何未声明服务（slots 用 ctx.get 可选获取）