前言¶
在 DeepSeek Harness(DSH)里跑任务时,工具调用、会话切换和上下文占用都在后台发生,界面往往只呈现文本流。长时间盯着输出,很难一眼看出当前是在思考、等批准,还是多个会话并行执行。
DeepSeek Pet 是 maintainer keleus 为 DSH Web 做的交互式桌宠插件。它把任务状态映射成角色表情和短句反馈,并支持拖动、缩放和最小化,让网页端的使用过程更直观。下面介绍它的定位、功能、安装方式和日常操作。
这是什么¶
DeepSeek Pet 是一个嵌入 DeepSeek Harness 网页的交互式桌宠插件,分类为「趣味换装」。插件简介是:在你的 deepseek-harness 上养一只吃白饭的大蓝鲸。
它跟随当前任务、工具调用、上下文占用和活跃会话自动切换 DeepSeek 表情,并通过呼吸、弹跳、倾斜、视差和淡入动画呈现 Live2D 风格效果。角色使用完整表情图切换,不拆分头部、手脚或五官图层,避免部件错位和表情突变。
维护者:keleus
GitHub:https://github.com/keleus/deepseek-pet
社区目录:https://www.skillhub.cn/plugins/keleus/deepseek-pet
许可证:MIT
核心功能¶
状态展示与交互¶
- 角色上方用与 Pet 等宽的气泡轮播状态短句,并以单行横向打字机效果跟随最新输出;无任务活动时 10 秒后自动隐藏。
- 角色下方用横条显示聚焦会话并以亮边标记,正在执行的会话向下排列,超过三个时自动层叠收起。
- 多个会话并行执行时进入「忙疯了」状态。
- 根据分析、回答、编码、网络搜索、子 Agent、完成和失败等场景切换表情;回答阶段轮换敲电脑、思考和认真核对等工作形象,思考阶段轮换不同状态标签。
- 工具等待批准时,可直接在气泡中允许或拒绝。
- 用户问题支持选项、自定义输入、提交和拒绝。
- reasoning 中疑问较多时显示困惑或压力表情。
- 用户指出回答有误时显示道歉表情。
上下文与输入感知¶
- 上下文达到 62% 时提示「还可以再吃一点」,达到 82% 时显示「吃饱了」。
- 图片输入时显示蒙眼状态。
待机与时间问候¶
- 无任务 10 分钟显示饿了,30 分钟抱枕犯困,1 小时后睡觉。
- 待机、思考、回复、成功、等待、错误和干饭等动作按累计时间稳定轮换,不会因重渲染随机跳图。
- 根据本地时间显示早上、中午、下午和晚上的问候,23 点后犯困,凌晨进入睡觉状态。
布局与设置¶
- 鼠标移入角色时,在角色脚下显示「−」最小化按钮。
- 支持拖动角色、单击互动、双击折叠;鼠标悬停角色时可用滚轮缩放,并记住位置和尺寸。
- 支持窄屏布局和
prefers-reduced-motion。 - 设置面板新增「桌宠设置」页,可配置动作图片,并提供两种展示模式:
- 默认:保持当前展示方式不变。
- 页面置顶:桌宠固定在视口右下角,悬浮在当前网页所有内容(包括弹窗)之上。
- 设置页可按动作组启用或停用具体图片,每组至少保留一张;思考和执行工具时会在工作与白米饭动作间稳定交替。
安装与启用¶
安装需要 Node.js 和 pnpm。如果已经全局安装 dsh,运行:
dsh plugin --profile web add github:keleus/deepseek-pet
没有全局 dsh 命令时,直接通过 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
卸载:
dsh plugin --profile web remove deepseek-pet
没有全局 CLI 时:
npx @deepseek-ai/dsh plugin --profile web remove deepseek-pet
典型用法¶
安装并刷新页面后,桌宠会随 DSH 任务状态自动变化。日常操作如下:
- 拖动角色:调整显示位置。
- 鼠标停在角色上滚动滚轮:在 65%~140% 范围内调整 Pet 尺寸。
- 单击角色:触发与当前状态相符的短句反馈。
- 双击角色或点击「−」按钮:最小化为右下角静止图标。
- 点击活跃会话:将该会话切换为聚焦会话。
- 出现批准或提问卡片时:可直接选择、输入、允许或拒绝。
如需自定义展示,打开设置面板的「桌宠设置」页,按动作组启用或停用图片,或切换「默认」与「页面置顶」模式。
适用场景与注意¶
适合在 DSH Web 端长时间使用、希望从界面直接感知任务状态的用户。桌宠会响应工具批准、多会话并行、上下文占用等运行时事件,也能在空闲时段展示待机动画。
安装前请注意:
- 插件以当前
dsh进程权限运行,安装前应检查源码与 MIT 许可证。 - 社区目录 SkillHub 是独立站点,与 DeepSeek / 幻方无官方从属关系。
- 开发环境要求 Node.js 22.19 或更高版本,以及 Python 3 和 Pillow;本地修改素材可执行
npm run assets,构建产物在lib/目录。
结尾¶
DeepSeek Pet 把 DSH 网页里的任务状态转成可见的表情、短句和会话条,同时保留拖动、缩放和最小化等桌宠交互。需要安装或查看更新时,可访问社区目录页或 GitHub 仓库:
- https://www.skillhub.cn/plugins/keleus/deepseek-pet
- https://github.com/keleus/deepseek-pet