DSH Pet 智能体桌面伴侣与状态动效桌宠

DSH Pet 智能体桌面伴侣与状态动效桌宠

dsh-pet·v1.3.0·protocols

dsh-pet 是一款为 DeepSeek Harness 打造的开源透明动画桌面宠物插件。它与智能体运行状态实时联动,在模型思考、工具调用、代码重构或遭遇异常时展现丰富的专属动效与气泡互动。支持多宠同屏、自定义大小位置、物理交互与 DIY 素材拓展包。

桌面宠物 · AI状态联动 · 透明动效 · Harness插件 · 个性化交互

GitHub版本下载
快速安装与集成
bash
dsh plugin --profile desktop add https://github.com/PC2005-cloud/dsh-pet

项目简介

在大语言模型与智能体开发工具日益深化的今天,程序员与 AI 的协同早已由早期的单次问答交互,演进为长时程、自主式的连续任务执行。然而在漫长的模型思考(Reasoning)、跨文件检索与多步骤工具链调用过程中,开发者往往只能盯着冷冰冰的控制台终端字符或等待指示器,缺乏直观、生动且具温情的陪伴感知。

由开源开发者团队 PC2005-cloud 倾力打造的 dsh-pet 正是为破解这一人机协作单调困境而生的桌面伴侣插件。作为 DeepSeek Harness(dsh)生态中备受瞩目的创新交互组件,dsh-pet 借助透明动画引擎与事件总线,在操作系统桌面上呈现了一只鲜活灵动的虚拟小桌宠。它绝非单纯的闲置装饰物,而是深度接入了 Cordis 微内核事件总线,能够与智能体的运行生命周期形成全方位心跳共振。当大模型进入深度思考推演、并发调用外部沙箱、重构代码库或遭遇运行时异常时,小桌宠均会实时切换出对应的表情、动作与碎碎念气泡,让复杂的底层 Agent 运转过程变得可触可感、妙趣横生。

核心特性

实时 AI 运行状态深度联动与事件流感知

dsh-pet 原生对接 DeepSeek Harness 内核生命周期与事件发射器。插件对模型思考(Thinking)、工具派发(Tool Call)、网络检索、文件读写及异常阻断等关键状态进行高精度细粒度映射:

  • 当模型开启思维链推导时,小桌宠会进入托腮沉思或头顶冒出发条的专注动效;
  • 当智能体唤起终端执行命令或并发读写文件时,桌宠会挥动小锤子或快速翻阅书卷;
  • 当遇到任务超时或执行失败时,桌宠会做出困惑抓狂表情并弹出故障定位线索;
  • 当任务圆满完成或 PR 成功生成时,桌宠会欢呼跳跃并为你撒花庆祝。

极致轻量与透明通道动效引擎

系统基于硬件加速的透明渲染通道(支持透明 WebM 与原生 Canvas 粒子混合管线)开发,严格遵循低资源消耗准则。桌宠常驻于独立的浮动窗口层,支持全局鼠标穿透(Click-Through)配置,绝不阻挡开发者的代码编辑与快捷键触发。针对追求极致自由度的用户,插件原生支持同屏多开(可同时领养多只不同职能的宠物)、物理重力拖拽、桌面边缘自由停靠与自由平滑缩放(50% 至 300%)。

丰富的物理交互与情境化自主动态

在缺乏任务调度的闲暇空窗期,dsh-pet 绝不呆板静止。系统内置了上百种根据时间段自适应的情境动作:清晨伸懒腰、午后打瞌睡、深夜伴读打哈欠,甚至在桌面边缘溜达或调皮攀爬。用户可通过鼠标光标与桌宠进行丰富互动,支持轻戳、抚摸、长按拖拽抛掷与投喂动效,物理碰撞引擎保证其以自然的加速度平稳落回任务栏或窗口边缘。

开放式 DIY 宠物素材包与全流程创作链

为了让每位开发者都能拥有专属的数字桌宠,dsh-pet 构建了高度解耦的开放素材包(Pet Pack)规范。素材结构采用模块化 JSON 声明,所有动作序列支持由透明 WebM、GIF 动图或 APNG 逐帧动画构成。项目配套提供了基于开源 AI 视频工具的素材生成流水线,开发者只需提供几张角色原画,即可借助图生视频模型与背景抠像流程,全自动生成并打包出专属的自制桌宠模组。

快速上手

桌面客户端环境依赖与插件添加

dsh-pet 深度适配 DeepSeek Harness 官方桌面客户端与 DSHEAC 整合环境。请在终端中执行官方插件挂载指令:

bash
# macOS 与 Linux 环境通过 dsh CLI 安装插件包
dsh plugin --profile desktop add https://github.com/PC2005-cloud/dsh-pet

# Windows PowerShell 环境下执行安装
dsh plugin --profile desktop add https://github.com/PC2005-cloud/dsh-pet

若从源码目录手动挂载,请务必直接物理拷贝文件夹至宿主插件目录:

bash
# 拷贝至桌面端 profiles 插件目录
mkdir -p ~/.dsh/profiles/default/plugins/dsh-pet
cp -r /path/to/dsh-pet/* ~/.dsh/profiles/default/plugins/dsh-pet/

宿主重启与桌宠唤起配置

完成插件部署后,退出并重新启动 DeepSeek Harness 桌面端。在左侧导航“插件中心 → DSH Pet”中即可开启桌宠展示,或在终端输入控制指令:

bash
# 唤起默认桌面伴侣
/pet start

# 调整桌宠显示大小与桌面停靠位置
/pet scale 1.2
/pet dock bottom-right

# 临时切换鼠标穿透模式(避免阻挡窗口焦点)
/pet click-through on

配置文件参数自定义实战

开发者可在宿主配置文件中声明持久化宠物属性:

yaml
# ~/.dsh/profiles/default/cordis.patch.yml
pet:
  character: "default"
  scale: 1.0
  dock: "bottom-right"
  statusSync:
    thinking: true
    tools: true
    errors: true
  physics:
    draggable: true
    collision: true

常见问题

为什么在 macOS 或 Linux 上启动桌宠时背景没有完全透明

透明窗口渲染依赖操作系统底层 Compositor 的透明通道支持。在 macOS 环境下,请确保桌面客户端拥有屏幕录制或窗口辅助层级显示权限;在 Linux(X11 / Wayland)环境下,请确认当前桌面环境已开启合成器(Compositor,例如 Picom 或 Mutter)。若背景依然呈现黑色矩形底色,可在插件设置中将渲染后端由“WebM 透明通道”切换为“Canvas 逐帧着色模式”,系统将自动执行边缘色键去除,彻底恢复透明视觉。

如何关闭高频思考过程中的碎碎念提示气泡

在长周期代码重构或模型多轮深思场景中,高频弹出的状态气泡可能会对沉浸式写码造成干扰。开发者可通过界面设置或终端指令关闭提示气泡:在插件设置面板中取消勾选“显示状态气泡(Show Bubbles)”,或在聊天输入框发送 /pet bubbles off。关闭气泡后,桌宠依然会通过身体动作与微表情同步 AI 运转,但绝不再弹出任何文字卡片。

在多显示器环境中桌宠窗口跑出屏幕边界如何快速找回

当断开外接显示器或调整屏幕分辨率后,浮动窗口的坐标可能滞留在已失效的屏幕区域。此时无需删除配置文件,只需在终端中发送重置位置指令 /pet reset-position,桌宠窗口会自动以平滑飞入动效重置至主显示屏右下角的安全可见区域。

自制宠物素材包的最佳分辨率与透明格式规范

为了兼顾高画质与低内存占用,官方推荐宠物序列帧素材的分辨率控制在 256x256 至 512x512 像素之间,过高分辨率会成倍消耗显存。动画格式首选支持 Alpha 通道的 WebM(VP9 编码),其体积仅为传统透明 GIF 的十分之一且边缘更加平滑细腻;若使用逐帧图片,建议导出为经过无损压缩的 WebP 序列。详细打包规范与测试模板可查阅插件根目录下的 PET_PACK_GUIDE.md。