前言¶

在 DeepSeek Harness（DSH）里长时间和智能体对话时，界面往往只有输入框、状态行和滚动内容，缺少「会话正在进行」的轻量反馈。VS Code 在官方 chat pet 文档里提供了 Blobby：会盯光标、会在思考时冒气泡、会在回合结束时庆祝。社区插件 vscode-pet（维护者 96274zxc）把同一套官方雪碧图、帧时序和交互规则移植到 DSH Web 输入框上方，而不是另画一个相似形象。下面介绍它是什么、能做什么、如何安装，以及使用时需要注意的差异。

这是什么¶

vscode-pet 是 VS Code 官方聊天宠物 Blobby 在 DSH Web Composer 上的非官方移植，npm 包名 vscode-pet，当前版本 1.2.27（MIT 许可证）。素材与逻辑来自 microsoft/vscode 中 chat pet 实现，上游 commit 锁定为 ce233327f26ef7791b7fff0143c24e81a8126bd2；完整派生文件清单见仓库 NOTICE.md。它不是 Microsoft 或 DeepSeek 官方产品。

插件通过 Cordis patch 注入 Web 客户端，依赖 DSH >=0.2.1-rc.1，在 SkillHub 社区目录中归类为「趣味换装」：96274zxc/vscode-pet。SkillHub 是独立社区站点，与 DeepSeek / 幻方无官方从属关系；安装插件仍走 DSH 自身的 profile 与 bundle 机制。

核心功能¶

聊天与状态反应¶

宠物浮在输入框（composer）上方，随会话变化：

• 目光跟随指针；你在输入时播放打字动画；智能体处理中显示思考气泡（气泡顶部锚在「深度求索」状态行上方的分隔线，布局或缩放变化时会重算）。
• 需要用户确认时鼓掌；空闲约 20 秒后睡觉；单轮请求完成时播放按红色按钮的庆祝动画。

拖拽、投掷与物理¶

• 可拖拽；带速度松手会投掷；Shift+← / Shift+→ 朝两侧墙投掷；← / → 沿输入框跳跃。
• 下落过程中用指针接触或 Enter / 空格可弹跳；掉出落脚区会走官方风格的传送门消失/重生。
• DSH 窗口可见时，落脚范围以输入卡片上沿为界，重生下落高度也限制在卡片上方，而不是从整页聊天顶部落下。

装扮与小游戏¶

• 右键菜单：帽子、颜色、跳跳乐、跑路 / 回来，以及内联的缩小/放大与恢复大小。
• 官方 13 顶帽子，加上「颜色自定义」与 DSH 专属的「不戴帽子」，共 15 个卡片、3 列布局；计数文案沿用 VS Code 的 “14 of 14 unlocked”，但 DSH 移植版不追踪成就，所有帽子默认解锁，初始为 Insiders 配色 + 牛仔帽，不显示解锁条件与「新」标记。
• 颜色支持稳定版/预览版、8 个官方纯色预设与自定义十六进制；偏好写入本地 localStorage['dsh.vscode-pet.prefs.v1']，不跨设备同步。
• 跳跳乐：空格蓄力起跳，左右瞄准，Esc 退出；含平台、计分与本地最高分。

桌面显示（仅 Windows 桌面端）¶

在 Windows 的 DSH 桌面应用中，右键可勾选 桌面显示 与 智能隐藏。DSH 最小化、隐藏或被其他窗口遮住时，宠物可通过传送门切到任务栏上方活动；重新聚焦 DSH 则回到窗口内。双击桌面上的 Blobby 可唤起 DSH 窗口。Web 版与非 Windows 环境不显示相关菜单项，Host 也不会启动桌面 helper。

与 VS Code 原版的差异（移植说明）¶

README 明确列出：DSH 版 不追踪成就；VS Code 专属的 painting/searching 状态与键盘跳不适用；跳跳乐在 DSH 内打开。目录简介里若提到 achievements，应以仓库说明为准——此处无成就进度，只有装扮与反应玩法。

安装与启用¶

仓库说明：当前 npm 包因发布账号 2FA 安全冻结暂未发布，优先从 GitHub 安装。

先做 Web profile 安装（命令来自 README.zh.md）：

dsh plugin --profile web add github:96274zxc/vscode-pet

npm 恢复发布后，同一 profile 可改为：

dsh plugin --profile web add vscode-pet

Electron 桌面端可在 插件 → 添加插件 中填写 vscode-pet，或在允许管理 desktop profile 的环境中使用相同 CLI 并指定 --profile desktop。安装后把 bundle 启用并刷新页面；部分桌面端若未热加载新 Loader，需重启一次应用。

典型用法¶

宠物启用后，多数操作在输入框区域完成。Slash 命令与常用键位如下（摘自官方使用表）：

单击、Enter 或空格可触发随机反应或唤醒睡觉中的 Blobby；约 1% 的点击会触发 yapping（摔倒张嘴），属于官方 sprite 设计，不是缺图。

适用场景与注意¶

适合谁：希望在 DSH 对话界面保留 VS Code 同款 Blobby 反馈、并愿意用右键菜单换装或玩跳跳乐的用户；Windows 桌面用户若常最小化 DSH，可评估「桌面显示」是否值得开启 helper 进程。

运行与权限：插件以当前 DSH 进程及其 Host 权限运行。窗口内功能仅使用客户端 API（如 conversation.input.dock）；桌面显示在 Windows 上会通过 Host 鉴权路由 /api/blobby/desktop/* 启动本地 PowerShell/.NET WPF helper，不注册模型工具，helper 只接收本地生成的帧与几何信息、不访问网络。安装前应阅读 GitHub 源码 与 MIT 许可证，确认可接受本地 helper 与 localStorage 持久化。

生态：DSH 理念是「一切皆插件」；本插件不修改 DSH 核心或其他插件。调试时可加 ?blobbyDebug=1 或使用 localStorage["dsh.vscode-pet.debug"]="1"，通过 window.__dshBlobby.memory() 查看客户端内存诊断（详见 README）。

结尾¶

vscode-pet 把 VS Code 官方 Blobby 的 sprite、物理和聊天反应接到 DSH 输入框上，并在此基础上提供帽子、颜色、跳跳乐与（Windows 桌面端）任务栏旁驻留。若要从社区目录跳转说明页，见 SkillHub：96274zxc/vscode-pet；源码、NOTICE 与中文 README 见 GitHub：96274zxc/vscode-pet。