跳到主内容

deepseek-pet 使用指南

为 DeepSeek Harness Web 注入 Live2D 风格的桌宠伴侣:跟随任务状态、上下文占用、活跃会话切换表情与气泡,支持拖动缩放和动作组配置。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-pet

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add deepseek-pet

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 角色上方用与 Pet 等宽的气泡轮播状态短句,并以单行横向打字机效果跟随最新输出;无任务活动时 10 秒后自动隐藏;
  • 角色下方用横条显示聚焦会话并以亮边标记,正在执行的会话向下排列,超过三个时自动层叠收起;
  • 多个会话并行执行时进入“忙疯了”状态;
  • 根据分析、回答、编码、网络搜索、子 Agent、完成和失败等场景切换表情;回答阶段轮换敲电脑、思考和认真核对等工作形象,思考阶段轮换不同状态标签;
  • 工具等待批准时,可直接在气泡中允许或拒绝;

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

桌宠能做什么?

在 DSH Web 页面右下角挂一只 Live2D 风格的桌宠角色。它会跟随当前任务状态、工具调用、上下文占用和活跃会话自动切换表情;角色上方有等宽气泡轮播状态文字,并以单行横向打字机效果跟随最新回复/思考;角色下方展示聚焦会话和并发执行会话;空闲 10 分钟显示"肚子饿了",30 分钟显示"抱着枕头犯困",1 小时显示"已经睡着了"。src/client/DeepSeekPet.jsx:84-486 / src/client/pet-state.js:37-78 / README.md:11-32。

图片怎么"看"?为什么发图时显示"看不见"?

DeepSeek 模型本身不支持视觉输入,所以插件检测到最近一次人类输入含有图片附件时,会把桌宠切到"蒙眼"状态并显示"图片暂时看不见"。这是预期行为,不是 bug。src/client/pet-state.js:81-91 / src/client/pet-presentation.js:11。

数据存在哪里?删除插件会丢吗?

桌宠的所有偏好都存在浏览器 localStorage 里:位置(deepseek-pet:position)、缩放(deepseek-pet:scale)、最后活动时间(deepseek-pet:last-activity)、展示模式(deepseek-pet:display-mode)、动作图片启用集合(deepseek-pet:enabled-reactions)。卸载插件后这些键仍在,但插件重装后可立即接上;插件本身不写本地文件,不上传任何数据。src/client/DeepSeekPet.jsx:22-25、560-575 / src/client/pet-display.js:18-19、44-52 / src/client/pet-reactions.js:3-4、64-71。

怎么换桌宠的展示位置?和"页面置顶"是什么关系?

默认桌宠显示在页面右下角。设置面板(桌宠设置)提供"展示模式":默认 = 在当前应用界面层里渲染;页面置顶 = 固定在视口右下角、悬浮在页面所有内容(包括设置弹窗)之上。两种都是纯页面内呈现,不打开新窗口或新标签页。src/client/pet-display.js:21-32 / src/client/DeepSeekPet.jsx:482-486 / src/client/styles.js:29。

怎么自定义哪些动作图片会被随机到?

设置面板(桌宠设置 → 动作图片)按 8 个动作组(待机 / 思考 / 执行工具 / 回复 / 任务成功 / 等待交互 / 错误与道歉 / 干饭)勾选要启用的图片,每组至少保留一张。切换顺序由该动作的累计时长决定,不会因重渲染随机跳图;任何时刻都可以点"恢复默认"一键还原。src/client/pet-reactions.js:15-44、141-151 / src/client/DeepSeekPetSettings.jsx:48-83 / README.md:25。

怎么和桌宠交互?都能做什么?

拖动角色 = 调整位置;悬停角色滚动鼠标滚轮 = 在 65%~140% 范围缩放,尺寸会记住;单击 = 触发与当前状态相符的短句反馈;双击或点"−"按钮 = 最小化为右下角静止图标;点击下方会话横条 = 切换到该会话。src/client/DeepSeekPet.jsx:367-414、434-438、463-465 / README.md:111-117。

上下文快满时桌宠会提示吗?

上下文达到 62% 时显示"还可以再吃一点"(切到干饭组),达到 82% 显示"上下文吃饱了"(切到饱腹状态)。这两个阈值由源码硬编码,不可在 UI 里改。src/client/DeepSeekPet.jsx:500-501。

会不会"忙疯了"?怎么定义的?

当 3 个及以上会话同时在执行(含聚焦会话)时,桌宠切到"忙疯了"状态,表情在"工作"和"白米饭"两组图片之间按累计时长稳定交替;超过 3 个并发执行会话时下方的会话列表会自动层叠收起,超过 7 个时底部显示"+N 个会话"摘要。src/client/DeepSeekPet.jsx:499 / src/client/pet-presentation.js:15-17 / src/client/DeepSeekPet.jsx:471-474。

卸载后桌宠图片资源会被清掉吗?

本插件把全部 28 个表情图与 3 个帧图以 base64 WebP 直接嵌入 lib/client.js(约 1.5 MB),没有外部资源文件,不存在图片丢失问题;卸载插件后这些图片随 lib/client.js 一并移除。src/client/assets.generated.js / scripts/embed-assets.mjs:7-43 / README.md:121-129。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明(package.json 无 dsh.engines;peerDependencies 全部用 '*',仅 dsh.client.inject 声明需 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-layout,见 package.json:13-24、52-65)
  • Node: >=22.19(package.json:77-79 engines.node)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则