dsh-pet

English | 中文

面向 DeepSeek Harness 的社区 DeepSeek Pet 插件。它让 DeepSeek 小鲸鱼固定显示在 Web 视口中原地游泳，跟随当前会话生命周期，并展开紧凑的 API 统计面板。

提供的能力

• 固定在视口中的 overlay 和原地游泳鲸鱼；使用帧大小的 atlas 视口逐帧切换，并加入 1px 垂直起伏，不会水平移动或旋转。
• 当前会话的待机、运行、等待、失败和完成状态，并提供英文与简体中文词典。
• 点击打开面板，显示当前聊天标题、最近一次 provider／model 身份，以及 sessionStats、tokenUsage 和 contextPressure projection 提供的 API 统计。
• 主指针拖动、抓取点跟随、8px 视口边距、浏览器本地位置持久化和视口约束。
• 展开面板会选择空间更大的一侧，与所有视口边缘碰撞；视口高度不足时只在卡片内部滚动。
• 根级 overlay 在没有当前会话时仍保持显示；会话数据通过桥接进入全局宠物，不会为每个会话重复渲染一只鲸鱼。
• Host 命令 /pet 和 /pet-game：可以从 DSH 正常命令输入中切换全局宠物和小游戏。
• 宠物主题的贪吃蛇小游戏：小鲸鱼作为蛇头，得分方块使用多彩玻璃高亮；支持方向键／WASD、空格、连续按两次空格、Escape 和重新开始。每局打开后先倒计时 3 秒再自动开始，并保存浏览器本地个人最佳分数，且只在结算时写入。10 分以内优先把得分方块放在中心 8×8 区域，之后在棋盘内广泛随机并降低最外圈偏置。游戏以贴着宠物的非模态毛玻璃悬浮卡片呈现，移动间隔从 240ms 起步，分数越高越平滑地加速，并与视口边缘碰撞。
• 使用 Codex v2 8×11 sprite atlas，并将 WebP 资源内嵌到 client bundle。

集成状态

本仓库是 Web 客户端包 @deepseek-ai/dsh-client-ui-pet 的源码发布。该包向 DSH Web composition 提供浏览器 entry；它目前还不是独立的 dsh.bundle。

当前构建和测试依赖匹配的 DeepSeek Harness checkout，因为本包使用 DSH workspace 依赖和 TypeScript project references。在该 checkout 中，将本目录放到 packages/client/ui-pet，保留下面的 Web patch 行，并从 monorepo 根目录运行聚焦检查：

- id: ui-pet
  name: '@deepseek-ai/dsh-client-ui-pet'

rsync -a --exclude .git --exclude lib --exclude node_modules /path/to/dsh-pet/ packages/client/ui-pet/
pnpm install
pnpm exec vitest run packages/client/ui-pet/tests
pnpm exec tsc -p packages/client/ui-pet/tsconfig.json --noEmit
pnpm --filter @deepseek-ai/dsh-client-ui-pet bundle

直接执行 dsh plugin --profile add github:Vulcan626/dsh-pet 激活被有意暂缓。本包没有声明 dsh.bundle，当前 workspace:^ 引用也不是 Git 安装所需的自包含依赖。官方 DSH 插件发布指南 说明了公开 Git 包在支持这种安装方式前需要自包含的 构建或预构建产物。