桌宠大蓝鲸 keleus/deepseek-pet

DeepSeek Pet 插件

DeepSeek Pet 是一个交互式桌宠插件，嵌入 DeepSeek Harness 网页。它会跟随当前任务、工具调用、上下文占用和活跃会话自动切换 DeepSeek 表情，并通过呼吸、弹跳、倾斜、视差和淡入动画呈现 Live2D 风格效果。

角色使用完整表情图切换，不拆分头部、手脚或五官图层，避免部件错位和表情突变。

功能

- 角色上方用与 Pet 等宽的气泡轮播状态短句，并以单行横向打字机效果跟随最新输出；无任务活动时 10 秒后自动隐藏；
- 角色下方用横条显示聚焦会话并以亮边标记，正在执行的会话向下排列，超过三个时自动层叠收起；
- 多个会话并行执行时进入「忙疯了」状态；
- 根据分析、回答、编码、网络搜索、子代理、完成和失败等场景切换表情；回答阶段轮换敲电脑、思考和认真核对等工作形象，思考阶段轮换不同状态标签；
- 工具等待批准时，可直接在气泡中允许或拒绝；
- 用户问题支持选项、自定义输入、提交和拒绝；
- reasoning 中疑问较多时显示困惑或压力表情；
- 用户指出回答有误时显示道歉表情；
- 上下文达到 62% 时提示「还可以再吃一点」，达到 82% 时显示「吃饱了」；
- 图片输入时显示蒙眼状态；
- 无任务 10 分钟显示饿了，30 分钟抱枕犯困，1 小时后睡觉；
- 待机、思考、回复、成功、等待、错误和干饭等动作按累计时间稳定轮换，不会因重渲染随机跳图；
- 设置页可按动作组启用或停用具体图片，每组至少保留一张；思考和执行工具时会在工作与白米饭动作间稳定交替；
- 根据本地时间显示早上、中午、下午和晚上的问候，23 点后犯困，凌晨进入睡觉状态；
- 鼠标移入角色时，在角色脚下显示「−」最小化按钮；
- 支持拖动角色、单击互动、双击折叠；鼠标悬停角色时可用滚轮缩放，并记住位置和尺寸；
- 支持窄屏布局和 prefers-reduced-motion；
- 设置面板新增「桌宠设置」页（界面样式与页面设计系统一致），可配置动作图片，并提供两种展示模式：
- 默认：保持当前展示方式不变；
- 页面置顶：桌宠固定在视口右下角，悬浮在当前网页所有内容（包括弹窗）之上。

兼容性

本插件面向当前的 DeepSeek Harness Web 客户端（DSH 0.1.7 系列及以上）。
Harness 把会话数据拆到了多个客户端面上，插件按新的分工读取：

- 聚焦会话 = 会话列表里被主视图保留的那一行（retainedBy.mainView），不再读取已移除的 sessions.list.current；
- 会话正文（用户消息、assistant 流式输出、执行中的工具调用）来自 Conversation 的 chat 目标：uiConversation.binding(id).target('chat') 的 legacy 切片；
- 等待确认 / 提问来自 uiSession.sessionStatus 的 pendingInteraction（approval / plan-review / question）；
- 点击会话改用 uiWorkspace.openSession(id)，不再调用已移除的 sessions.open。

服务不可用时会自动降级（例如没有 uiConversation 时只显示状态、不显示正文），不会抛错。
升级 Harness 后请重新安装本插件，确保拉到的是匹配当前客户端 API 的版本。

包清单按当前 DSH 插件规范声明：engines.dsh 为 >=0.1.7-0，低于该版本的 Harness 会在安装时直接给出不兼容提示；react / react-dom 由网页端共享模块表提供，不再作为 peer 依赖；插件管理器中的标题、简介来自 locale/en.json，图标为 icon.webp（由 scripts/build_assets.py 从立绘裁剪生成）。Web 与桌面版（--profile desktop）使用同一套插件加载方式，安装命令只需替换 profile 名。

安装

安装需要 Node.js 和 pnpm。如果已经全局安装 dsh，运行：

dsh plugin --profile web add github:keleus/deepseek-pet

没有全局 dsh 命令时，无需额外安装 CLI，直接通过 npx 执行：

npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet

两种命令效果相同，都会从 GitHub 拉取插件并安装到 Web profile。

安装完成后启动或重新启动网页。全局 CLI：

dsh web

npx：

npx @deepseek-ai/dsh web

如果网页已经打开，请刷新页面。

拉取源码后安装

git clone https://github.com/keleus/deepseek-pet.git
cd deepseek-pet
npm install
npm run build
dsh plugin --profile web add .

如果没有全局 CLI，将最后一条命令替换为：

npx @deepseek-ai/dsh plugin --profile web add .

本地安装会链接当前目录，修改代码并重新构建后即可继续调试。

更新

重新执行安装命令即可拉取并安装远端最新版本：

dsh plugin --profile web add github:keleus/deepseek-pet

或者：

npx @deepseek-ai/dsh plugin --profile web add github:keleus/deepseek-pet

随后重新启动网页进程并刷新页面。

从 0.2.1 起，插件的包名由 deepseek-pet 改为 @keleus/deepseek-pet （npm 上的 deepseek-pet 属于另一个无关项目，同名会导致插件市场装错包而安装失败）。
如果之前装过旧版本，请先移除旧包名再重新安装，避免同时加载两份：

dsh plugin --profile web remove deepseek-pet

卸载

bash
dsh plugin --profile web remove @keleus/deepseek-pet

没有全局 CLI 时： bash
npx @deepseek-ai/dsh plugin --profile web remove @keleus/deepseek-pet

使用

- 拖动角色：调整显示位置；
- 鼠标停在角色上滚动滚轮：在 65%～140% 范围内调整 Pet 尺寸；
- 单击角色：触发与当前状态相符的短句反馈；
- 双击角色或点击“−”按钮：最小化为右下角静止图标；
- 点击活跃会话：将该会话切换为聚焦会话；
- 出现批准或提问卡片时：可直接选择、输入、允许或拒绝。

开发

环境要求：Node.js 22.19 或更高版本，以及 Python 3 和 Pillow。
bash
npm install
npm run build

- npm run assets：从源图生成透明 WebP 表情并嵌入客户端代码；
- npm run build：生成 lib/index.js 和 lib/client.js。

主要目录： text src/host/ 插件 Host 入口 src/client/ 网页入口、组件、状态逻辑和动画样式 public/assets/ 表情源素材 scripts/ 素材处理和构建脚本 lib/ 可安装的构建产物

许可证

MIT © 2026 keleus