前言¶
DeepSeek Harness（下面简称 dsh）把模型、工具、会话和 UI 都做成插件，官方的说法是「一切皆插件」。开发者预览版开放之后，网页界面成了很多人跑智能体的主入口：左边对话，中间轨迹，右边工具调用，任务一多，状态全挤在文字和进度条里。
社区里很快出现一类「趣味」插件：不给模型加新工具，只在网页上叠一层桌宠，让当前任务、思考、报错能用表情说出来。deepseek-pet 走的就是这条路，角色不是通用小猫小狗，而是 DeepSeek 那只会吃白饭的大蓝鲸。
需要先说清楚：本文介绍的安装入口来自社区插件目录 deepseek-harness-plugin.com，这是独立站点，和 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。插件本身由 GitHub 用户 keleus 维护，仓库地址是 keleus/deepseek-pet，MIT 许可证，当前包版本为 0.1.0。截至 2026-08-17，GitHub 显示 28 个 star；社区目录页当时仍写 11，星标以仓库页面为准。
这是什么¶
deepseek-pet 是一个嵌在 DeepSeek Harness 网页界面里的交互式桌宠插件。目录页上的一句话是：「在你的 deepseek-harness 上养一只吃白饭的大蓝鲸。」
它不改 dsh 内核，也不给模型注册新工具。package.json 里声明了 dsh.client.platform 为 web，客户端注入 @deepseek-ai/dsh-client-runtime 和 @deepseek-ai/dsh-client-ui-layout，入口把角色注册到网页的 shell.overlay 槽。Host 侧几乎是空实现，看得见的行为都在浏览器里完成。
解决的问题很具体：智能体在分析、调工具、等你批准、写回答、失败或闲置时，网页上缺一个不挡操作、又能跟着状态变的视觉锚点。这只蓝鲸会读当前会话快照，切换表情和短句；动画是呼吸、弹跳、倾斜、视差和淡入，README 写成「Live2D 风格」，实现上并不是拆图层的 Live2D 模型，而是整张表情图切换，再把运动加在整张图上，避免头手脚对不齐、表情跳变。
核心功能¶
仓库 README 和客户端源码（src/client/pet-state.js、pet-presentation.js）对得上的能力，可以分成下面几组。
1、状态跟着任务走。角色会根据当前任务、工具调用、上下文占用和活跃会话换表情。分析、回答、编码、网络搜索、子 Agent、完成、失败各有对应形象；回答阶段会在敲电脑、思考、核对之间轮换，思考阶段会换不同状态标签。源码里工具名还会映射成短句，例如 bash / exec_command 显示「正在敲终端」，web_search 显示「正在查找资料」。
2、气泡和会话条。角色上方有一条与宠物等宽的气泡，轮播状态短句，并用单行横向打字机效果跟上最新输出；没有任务活动时，约 10 秒后自动隐藏。角色下方用横条显示聚焦会话，亮边标记当前项；正在执行的会话向下排，超过三个会层叠收起。多个会话并行时进入 README 所说的「忙疯了」状态。
3、批准和提问可以点在宠物上。工具等待批准时，气泡里可以直接允许或拒绝。用户问题支持选项、自定义输入、提交和拒绝。点活跃会话，可以把该会话切成聚焦会话。这些交互走的是网页 overlay，不是另开窗口。
4、上下文和空闲也有表情。上下文占用到 62% 时提示「还可以再吃一点」，到 82% 时显示「吃饱了」，源码用的是 contextRatio >= 0.62 / 0.82。带图片输入时切到蒙眼。无任务约 10 分钟显示饿了，30 分钟抱枕犯困，1 小时后睡觉。还会按本地时间做早上、中午、下午、晚上问候，23 点后犯困，凌晨进入睡觉。reasoning 里疑问较多时显示困惑或压力；用户指出回答有误时显示道歉。
5、位置和尺寸可调。支持拖动、单击互动、双击折叠；鼠标移入角色时，脚下出现「−」最小化按钮，点它或双击会收到右下角静止图标。悬停时滚轮缩放，范围约 65%～140%，位置和尺寸会记住。窄屏和 prefers-reduced-motion 也有处理。
安装与启用¶
社区目录页给出的安装命令是：
dsh plugin add github:keleus/deepseek-pet
这是目录页原文。该插件只作用于 Web 界面，维护者 README 要求装到 web profile。已经全局安装 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
README 写明：安装需要 Node.js 和 pnpm；两种命令效果相同，都会从 GitHub 拉取插件并装进 Web profile。目录页还提示，若要可复现安装，可固定 commit 哈希，例如：
dsh plugin add github:keleus/deepseek-pet#287414d31c9a8fe4122109e85d8fe9dc0299cdc4
上面的哈希是 2026-08-15 仓库 main 分支当时的最新提交，只作示例；实际使用前请到 GitHub 再核一次。
装完后启动或重启网页。全局 CLI：
dsh web
npx：
npx @deepseek-ai/dsh web
网页已经打开的话，刷新即可。更新方法是再跑一遍安装命令，然后重启网页进程并刷新。卸载：
dsh plugin --profile web remove deepseek-pet
没有全局 CLI 时，把前面换成 npx @deepseek-ai/dsh。
如果要改源码再装，README 给出的流程是：
git clone https://github.com/keleus/deepseek-pet.git
cd deepseek-pet
npm install
npm run build
dsh plugin --profile web add .
本地安装会链接当前目录，改完重新构建就能继续调试。开发构建还要求 Node.js 22.19 或更高版本，以及 Python 3 和 Pillow，用来从源图生成透明 WebP 表情并嵌入客户端；日常只按 GitHub 安装、不改素材的话，走上面的 dsh plugin add 即可。
典型用法¶
安装并打开 dsh web 之后，宠物会出现在网页 overlay 上。README 里的操作可以按这个顺序试：
1、拖动角色，放到不挡对话和轨迹的位置。
2、鼠标停在角色上滚动滚轮，把尺寸调到 65%～140% 之间舒服的一档。
3、发一条普通任务，看气泡是否跟上输出、表情是否切到思考或敲电脑。
4、并行开多个会话，看下方会话条和「忙疯了」是否出现；点击某条活跃会话，确认聚焦会切换。
5、遇到工具批准或提问卡片时，直接在气泡里允许、拒绝、选择或输入。
6、暂时不需要桌宠时，双击角色或点脚下的「−」，收到右下角；单击角色会触发和当前状态相符的短句。
这些步骤都不需要额外配置文件。插件读的是 Harness Web 当前会话快照，没有独立的宠物服务器，也没有要求填 API Key。
适用场景与注意事项¶
适合已经在用 dsh web、希望界面上有一个跟任务状态同步的视觉提示的人。它是趣味插件，不提供新的模型能力，也不替代 Trajectory、工具面板或通知类插件。终端 TUI、无网页的运行方式装了也看不到这只鲸，因为客户端明确标了 platform: web。
使用前有几条需要单独看：
1、插件以当前 dsh 进程的权限运行，安装时可能执行代码。目录页和仓库都建议先检查源代码和许可证。本仓库许可证是 MIT，版权声明为 Copyright (c) 2026 keleus。
2、表情图是完整切换，不是可换装的 Live2D 部件。想自己换角色，需要按仓库的素材流程（npm run assets）重新生成 WebP，而不是丢一个 .moc3 进去。
3、图片输入会显示蒙眼，这是插件根据会话内容做的表现，不代表它给模型补上了视觉能力。
4、社区目录和 GitHub 的元数据可能不同步（星标、最近推送时间都出现过滞后）。安装命令、profile、commit 哈希以你打开的仓库 README 和 GitHub 提交为准。
5、DeepSeek Harness 仍处于开发者预览，核心插件和 API 会变。这个宠物挂在 shell.overlay 上，以后槽位或会话快照字段若调整，表情映射可能要跟着改。
小结¶
deepseek-pet 做的事情很窄：在 DeepSeek Harness 网页上放一只吃白饭的大蓝鲸，用整张表情图和 CSS 动画，把任务、工具、上下文和空闲翻译成能看懂的样子。维护者是 keleus，MIT 开源，装到 web profile 后刷新即可用。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-pet/
GitHub：https://github.com/keleus/deepseek-pet
