dsh-pet-dom

DeepSeek Harness Web 界面里的桌面宠物 —— 一只会在页面上自由跳跃、攀爬、奔跑的 Miku 桌宠。 由经典 uni-app「桌宠」项目与更早的 VB6「DeskTop Miku」纯浏览器移植而来。

它能做什么

• 在真实页面上跳跃：会自动察觉页面上的"可落脚区域"（消息、侧栏、按钮、悬浮挂件……），用真实的跳跃曲线跳来跳去
• 物理手感：跳跃弧线、重力下坠、快速飘落、落地吸附——像真有一只小东西在页面上活动
• 跟着页面走：页面滚动时它会"乘"着所站的区域一起走；区域被删除时自然坠落
• 两种玩法模式：
  • 默认（自动）：挂机看它自己玩 —— 待机、走路、跳跃巡视、突发小动作（蹦跳/胡桃摇/散步）
  • 游戏（键盘控制）：你可以接管它
• 可调的视觉效果：高亮显示"可跳跃边缘"（每个位置不同颜色），透明度、合并程度随心调
• 随界面换肤：自动跟随 DSH 页面的深色/浅色主题

游戏模式按键

按键	功能
← / A	左移（空中可向左调向）
→ / D	右移（空中可向右调向）
空格 / ↑ / W	跳跃（空中可连跳，踩空气上升）
↓ / S	快速下落（站在表面时＝摔落）
H	胡桃摇

与键盘翻页冲突？打开控制台 → 打开「禁用 ↑↓」。

控制台

页面右上角浮动面板（可拖动、可收起；双击宠物可以唤回）：

• 模式切换：默认（自动）/ 游戏（键盘控制）
• 高亮可跳跃边缘：开关 + 透明度滑块（5%~100%）
• 表面合并：把距离接近的区域合并成"大平台"（0~200px）
• 主题色：6 种预设 + 自定义取色（边缘高亮线随主题衍生出整条同色系）
• 禁用 ↑↓：防止与浏览器翻页冲突（跳/落改用空格与 S）

所有设置自动保存，刷新页面后恢复。

安装

# 发布后（推荐）
dsh plugin --profile web add dsh-pet-dom

# 本地开发安装
dsh plugin --profile web add link:<本插件包绝对路径>

安装完成后重启 dsh web，刷新页面即可看到桌宠。

开发提示

lib/mascot.js（桌宠本体）与 lib/console.js（控制台）、lib/brain.js（决策逻辑）在每次请求时实时读取 —— 本地修改后刷新页面即生效，无需重复重启服务。

文件结构

dsh-pet-dom/
├── package.json
├── cordis.patch.yml      # 插件挂载声明
├── README.md
├── assets/
│   └── miku.gif          # 角色精灵图
└── lib/
    ├── index.js          # 宿主侧（路由与注入）
    ├── mascot.js         # 客户端桌宠本体
    ├── brain.js          # 决策逻辑（纯函数，可测试）
    └── console.js        # 控制台 UI

许可

MIT