前言¶

在 DeepSeek Harness（DSH）的工作流中，智能体通常在终端或后台静默运行，缺乏一种持久且直观的交互载体。为了增强用户的感知存在感，桌面宠物插件应运而生。

这是什么¶

DeepSeek Harness 3D 猪槽鱼（鲸鱼）桌面宠物插件是一个为 DSH 环境设计的 3D 桌面宠物组件。

该插件由维护者 rongzi5 开发，旨在为智能体会话提供一个可视化的交互窗口。它不仅是一个静态模型，更集成了 LLM 聊天、记忆管理、会话进度查询以及子代理任务调度功能，解决了单一终端交互缺乏上下文延续性和视觉反馈的问题。

核心功能¶

1. 3D 渲染与行为
   使用 three@0.147.0 程序化渲染鲸鱼模型，不依赖外部 CDN 或 iframe。宠物会停留在视口边缘休息，并在随机长间隔下进行巡逻。它具有形状感知的拖拽能力，支持惯性释放，并会跟随鼠标指针。

2. 交互与控制
   - 点击 Recap：点击身体可循环显示名称、共同天数及最近会话事件。
   - 右键菜单：提供聊天（LLM）、记忆管理、重命名、调整大小、角吸附等功能。
   - 角吸附与快捷键：开启后，拖拽松手会自动吸附至最近角落。使用 Ctrl/Cmd + Alt + W 快捷键可随时隐藏或显示宠物。
   - 拖拽眩晕：快速或长时间拖拽会导致宠物眩晕（翻肚皮），暂停交互。

3. 智能集成
   - LLM 聊天与记忆：通过右键菜单“和鲸鲸聊天”进行对话，记忆存储于 localStorage。对话气泡有 60 字符限制，但 [记住] 行不受此限。
   - 会话进度查询：询问“进度如何了”时，宠物会主动探测并报告当前会话状态。
   - 子代理任务调度：当需要执行代码或运行命令时，宠物会触发真实的子代理任务。

安装与启用¶

目前未提供具体的安装命令。该插件需要配合 DeepSeek Harness 3D 猪槽鱼（鲸鱼）环境 使用。

仓库地址：github.com/rongzi5/dsh-whale-pet

典型用法¶

1. 开始对话
   右键点击宠物，选择“和鲸鲸聊天…”。在弹出的输入框中发送消息（支持 Enter 发送，Esc 关闭）。宠物会通过气泡回复，支持 SSE 流式输出。

2. 管理记忆
   右键点击“鲸鲸记得什么…”查看或删除持久化记忆，或直接输入 [记住] <事实> 来添加新记忆。

3. 查看状态
   点击宠物身体，查看名称、共同天数以及最近的会话事件（如工具运行结果、里程碑）。

4. 调整大小与隐藏
   在右键菜单中拖动滑块调整大小（50%-150%），或使用快捷键 Ctrl/Cmd + Alt + W 快速隐藏。

适用场景与注意¶

• 适用场景：需要长期跟踪用户上下文、通过视觉反馈增强智能体存在感、或需要宠物代理协助处理后台任务的开发者。
• 注意：
• 大小调整仅改变渲染缩放，不影响宠物在边缘的休息位置和巡逻路径。
• 对话气泡有 60 字符限制，但 [记住] 标记的行不受此限。
• 记忆与状态通过 localStorage 持久化（注意私有模式下的兼容性）。
• 需确保 DeepSeek Harness 3D 环境正常运行。

短结尾¶

这是一个功能完备的桌面宠物插件，通过将 LLM 能力与 3D 交互结合，为 DSH 用户提供了更丰富的会话体验。更多细节请参考项目主页。