前言¶
在 DeepSeek Harness（DSH）里长时间写提示、调插件时，界面往往只有会话和工具面板，缺少一点「人在电脑前」的反馈。贴一张静态 PNG 可以装饰桌面，但不会动、不会记位置，也谈不上和窗口边缘的物理感互动。
下面介绍社区插件 dsh-lion-pet（维护者 rumpen233）：把校徽里的刑小狮做成 DSH 桌宠，待机呼吸、随机散步、拖拽甩动、点击回应，并支持 DSH 网页内与 Electron 桌面悬浮两种展示。插件不调用模型、不写会话、不产生 token 费用。社区目录分类为「趣味换装」，仓库当前版本 1.2.0，GitHub 星标 1（以目录页与仓库公开信息为准）。
这是什么¶
dsh-lion-pet 是 DSH 的第三方 bundle 插件，入口为 lib/index.js，浏览器侧通过 lib/client.js 注入桌宠 UI（纯 DOM + Shadow DOM）。一句话定位：在 DSH 页面和/或桌面透明小窗里养一只刑小狮——会呼吸、会溜达、被拖起来有惯性、点一下会弹跳并说话。
DeepSeek Harness 的生态思路是「一切皆插件」；插件列表站点 SkillHub 目录页 与 DeepSeek / 幻方无官方从属关系，安装前请自行阅读 GitHub 仓库 源码与许可证。
核心功能¶
网页与桌面上的行为¶
- 待机呼吸：轻微上下浮动和摆动。
- 随机散步：隔一段时间在窗口下方走一小段，自动切换正面 / 侧面朝向；桌面模式下主进程用缓动移动整个透明窗口，狮子可走到当前显示器工作区内，边缘会自动收住。
- 点击回应：单击「摸摸头」——弹跳、撒爱心和星星，并随机台词。
- 拖拽甩动：按住拖动；松手保留速度，碰窗口边缘轻微反弹。
- 右键菜单：摸摸头、散散步、转个圈、放大 / 缩小、锁定位置、回到右下角、隐藏。
- 隐藏与唤醒：隐藏后右下角留圆形小头像，点一下叫回。
- 记忆：网页端把位置、大小、锁定、隐藏存进浏览器
localStorage；桌面端窗口位置在用户数据目录；显示模式写在$DSH_HOME/dsh-lion-pet/config.json。 - 桌面悬浮：Electron 透明置顶小窗（约 280×390），鼠标移出窗口时自动点击穿透，不挡桌面操作。
- 无障碍：刑小狮可聚焦；Enter / 空格摸摸头，
M或菜单键打开右键菜单，Esc 关闭菜单。
显示模式与扩展¶
在 DSH 设置 → 插件 → 刑小狮 的「显示位置」可选：
| 模式 | 效果 |
|---|---|
| 两者都显示 | DSH 页面内和桌面悬浮窗同时出现 |
| 仅桌面 | 只保留透明置顶桌面窗口 |
| 仅网页 | 只在 DSH 网页界面里出现 |
| 关闭 | 全部收起，不启动桌面 helper |
桌面模式依赖本机 Electron。插件优先使用 $DSH_HOME/electron/electron.exe，也可用环境变量 DSH_LION_ELECTRON_PATH 指定。首次切换后若窗口未出现，重启一次 DSH；host 侧代码不会热重载。
仓库内 extension/ 是独立的 Chrome / Edge MV3 扩展：在任意 http(s) 网页右下角显示刑小狮，与 DSH 显示模式互不影响；扩展只申请 storage 与网页注入权限，不读取页面内容。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前请检查源码、MIT 许可证 以及 NOTICE（校徽与刑小狮插画不在 MIT 范围内）。要求 Node >= 20，peer 依赖 @deepseek-ai/cordis ^4.0.4。
从本地目录安装（README 推荐）¶
先把仓库放到本机某目录，再执行（路径换成你的绝对路径）：
dsh plugin --profile desktop add file:C:\path\to\dsh-lion-pet
Linux / macOS 示例：
dsh plugin --profile desktop add file:/home/you/dsh-lion-pet
当前 profile 若启用了 HMR，插件会热加载；否则重启 DSH 后生效。也可在 DSH「插件」页选择「安装第三方插件」，填入本地目录绝对路径。
手动安装¶
- 将整个
dsh-lion-pet目录复制到：
$DSH_HOME/profiles/desktop/node_modules/dsh-lion-pet
- 在 profile 的
package.json中加入依赖与 bundle：
{
"dependencies": {
"dsh-lion-pet": "1.2.0"
},
"dsh": {
"profile": {
"bundles": ["dsh-lion-pet"]
}
}
}
- 重启 DSH。
典型用法¶
| 操作 | 效果 |
|---|---|
| 单击刑小狮 | 摸摸头：弹跳、撒星星、随机台词 |
| 按住拖动 | 搬家；松手有惯性，碰到边缘会反弹 |
| 右键 / 菜单键 | 打开动作菜单 |
| 滚轮 | 不拦截页面滚动；请用菜单调大小 |
| 隐藏后点右下角头像 | 唤醒刑小狮 |
显示模式也可直接编辑配置文件（示例）：
{ "display": "both" }
display 可取 both / desktop / web / off。
网页端偏好示例键名为 dsh-lion-pet:v4，字段包括 x、y、size、hidden、locked、positioned。想恢复默认可右键选「回到右下角」，或在 DevTools 删除对应 localStorage 键后刷新。
网页通用版（Chrome / Edge）¶
- 打开
chrome://extensions（Edge 为edge://extensions），开启「开发者模式」。 - 「加载已解压的扩展程序」，选择仓库的
extension/目录。 - 打开任意 http(s) 网页，右下角出现刑小狮；扩展图标可关闭或恢复。
适用场景与注意¶
适合希望在 DSH 工作或浏览网页时有一点轻量陪伴、又不需要占用模型能力的用户。桌宠纯前端与本地 helper 逻辑，适合作为 DSH「趣味换装」类插件的体验向补充。
务必注意：
- 插件与 DSH 同进程权限；第三方 bundle 安装前请审阅
src/、runtime/desktop-helper/与cordis.patch.yml。 - 素材
assets/来自校徽插画，再分发须遵守原图权利人要求；代码 MIT，插画不在 MIT 授权范围内。 - 卸载：
dsh plugin --profile desktop remove dsh-lion-pet
再从 profile 的 dsh.profile.bundles 中移除 dsh-lion-pet 并刷新页面。
结尾¶
dsh-lion-pet 把刑小狮从静态校徽变成可呼吸、可散步、可拖拽的 DSH 桌宠，并可选桌面置顶与浏览器扩展两种延伸用法。进一步了解可访问 SkillHub 目录页 与 GitHub：rumpen233/dsh-lion-pet。
