deepseek桌宠 怎么装：DeepSeek Harness 内嵌桌宠、鲸鱼挂件与不显示排查

deepseek桌宠 不是一个插件，而是三种形态：网页内嵌的小鲸鱼、独立窗口的状态桌宠、右下角的心情挂饰。 先选形态，再谈安装；装错形态，会出现「装上了但看不到」的错觉。

三种形态：内嵌、独立窗口、挂饰

三种形态的能力边界不同，适用场景也不同。

内嵌桌宠跟随页面，最轻。 它只在 DeepSeek Harness 界面里出现，可拖动、会呼吸眨眼，位置与开关状态会自动记住（来源）。

独立窗口能跨应用。 它单独开一个窗口显示 Agent 状态，适合一边用别的软件一边看进度；多会话同时运行时，还要处理优先级（来源）。

挂饰偏状态展示。 它在右下角显示心情或状态，按轮次记录时间线，不占独立窗口（来源）。

三种可以组合，但不必都装。 内嵌与挂饰都在右下角，可能互相遮挡；先装一个，确认位置与习惯再考虑加第二个。

装哪个：按平台与需求选

选型看三件事：平台、是否要跨应用、是否要状态记录。

1. 只在网页里用： 选内嵌桌宠，跟随页面，不额外开窗口。
2. 要跨应用看状态： 选独立窗口桌宠，但确认你的系统被支持。
3. 想看心情与时间线： 选挂饰，按轮次记录，界面占用小。
4. 同时装多个： 先看是否有位置冲突，再确认性能可接受。

平台支持要先看说明。 独立窗口类插件依赖桌面环境，Web 版或服务器环境通常无法显示；内嵌类不依赖系统窗口，兼容性更好。

不要把「桌宠」当成功能插件。 它主要影响界面与情绪反馈，不改变 agent 的能力；需要能力增强时，选工具类插件。

安装与开启

安装是普通插件流程，开启通常在界面设置里。 两步都做完才算生效。

1. 在「设置 → 插件市场」搜索插件名，核对 owner 与来源后安装；或用 dsh plugin --profile web add 安装。
2. 重启应用，让插件在启动阶段注册。
3. 打开插件设置或界面开关，启用桌宠；部分插件默认关闭。
4. 确认右下角或独立窗口出现桌宠。
5. 拖动到合适位置，确认重启后位置被记住。

装错 profile 仍然是最常见的「没显示」。 你在桌面端找桌宠，却装进了 web；换到对应 profile 再装一次。

默认关闭是设计，不是故障。 桌宠会持续占用一点界面与动画资源，插件通常让用户主动开启；先找开关，再怀疑安装。

位置、大小与状态记忆

桌宠的位置与开关状态通常存在本地配置里。 理解这一点，能解释大部分「怎么跑角落去了」。

1. 位置记忆： 拖动后位置写入本地配置，重启后恢复；窗口变小可能让桌宠落在可视区外。
2. 开关记忆： 关闭后重启仍保持关闭；找不到桌宠时先看开关，不要急着重装。
3. 大小与缩放： 系统缩放变化可能让桌宠比例异常；调回 100% 对照一次。
4. 多显示器： 独立窗口类桌宠可能在另一块屏出现；用系统窗口列表找一下。

「看不见」不等于「没运行」。 先查开关与位置，再看日志；顺序反了，会重复安装。

换机器不会带走状态。 位置与开关存在本地，迁移时需要复制配置目录；重装或清理配置后回到默认位置。

不显示排查：五类原因

桌宠不显示，按出现频率排，五类原因覆盖大多数情况。

1. 没启用开关。 插件装了但默认关闭；去设置里打开。
2. 装错 profile。 在另一个环境里找；用 list 确认包在哪个 profile。
3. 位置在可视区外。 窗口变小、缩放变化或多显示器导致；重置位置或换窗口大小。
4. 被其他挂饰遮挡。 右下角同时有多个组件；先关掉其他挂件再试。
5. 加载失败。 系统日志有加载或脚本错误；看第一处失败，不要只看界面。

五类原因的排查顺序是「开关 → profile → 位置 → 遮挡 → 日志」。 前三步不用看日志，能解决大部分问题。

日志里的第一处错误最有用。 后面的报错往往是连锁反应；定位从第一条开始。

性能与干扰

桌宠是持续运行的界面组件，性能影响取决于动画频率与窗口形态。

1. 内嵌桌宠影响最小。 只在页面内做少量动画；觉得卡顿时先关动画，再看输入延迟。
2. 独立窗口占用更高。 多一个窗口与渲染进程；长时间挂着时，注意内存占用。
3. 高频动画更明显。 呼吸、眨眼、状态切换都会触发重绘；降低频率能明显改善。
4. 多插件叠加。 桌宠加挂饰加主题，重绘叠加；先减到最少，再逐个加回。

性能取舍没有统一答案。 以「输入不卡、启动不变慢」为标准；超过这个标准，就关掉或降频。

卸载与清理

桌宠卸载后，位置与开关配置可能残留。 三类残留按顺序清。

1. 插件目录： 用 dsh plugin --profile web remove 移除，重启确认列表里没有。
2. 配置项： 检查 profile 配置里是否还有桌宠相关段，残留配置可能影响下一次安装。
3. 本地状态： 位置、开关与心情记录属于本地数据；需要保留时先导出，不需要再清。

卸载后重启一次再判断是否干净。 有些界面组件在运行时缓存，只有重启后才能确认移除。

心情与时间线数据要单独处理。 它属于内容数据，不只是界面配置；清理前确认是否还要保留。

下一步

先选形态，再装一个，最后按五类原因排查。 想看桌宠形态的完整对比，看《DeepSeek Harness 桌宠插件有哪些》；想装余额鲸鱼挂件，看《DeepSeek Harness 余额插件有哪些》；想了解界面类插件的整体分布，看《dsh theme 主题插件怎么换》。

来源：dsh-pet-indesktop 插件页、dsh-dafeiyu 插件页、dsh-feiyu-mood 插件页