在 DeepSeek Harness Web GUI (dsh --profile web) 中开发智能体时,Agent 处于思考或等待状态时往往是静止的。dakeshui123/dsh-pet-frieren 插件在屏幕上增加了一个 Q 版《葬送的芙莉莲》桌面宠物,它会跟随 Agent 的状态变化做出相应的动作和气泡提示,为开发过程提供直观的视觉反馈。
插件介绍¶
dakeshui123/dsh-pet-frieren 是一个针对 DeepSeek Harness Web GUI 的桌面宠物插件。它通过 dsh.bundle.patch 和 dsh.client 机制集成,无需复杂的构建步骤即可运行。插件包含一个预构建的客户端包和一个资源服务器,负责在浏览器端渲染精灵动画。
核心功能¶
该插件主要提供以下功能:
-
状态跟随
宠物会根据 Agent 的运行状态切换动作和表情:- 空闲:默认待机状态。
- 思考:Agent 正在推理。
- 工具调用:Agent 正在执行工具。
- 流式输出:Agent 正在生成回复。
- 等待:等待用户审批或回答。
- 错误:Agent 报错时,宠物会定格在最后失败的帧上,直到错误清除。
-
自动交互
在空闲状态下,宠物会自动执行动作:- 每隔 12-30 秒自动挥手。
- 每隔 45-90 秒偶尔跳跃。
- 随机弹出气泡对话(约 20-40 秒)。
-
用户交互
- 点击:向宠物挥手一次。
- 双击:让宠物跳跃一次。
- 拖拽:移动宠物位置(位置会自动保存),拖拽时宠物会左右奔跑。
- 悬停:光标悬停在宠物上时,右上角会出现关闭按钮,点击可隐藏宠物。
- 隐藏后:点击隐藏标记或拖拽标记,可将宠物唤回。
-
兼容性
- 无障碍:尊重系统的
prefers-reduced-motion设置,该模式下只显示静态帧,无动画。 - 资源服务:所有资源通过 HTTP 路由
/dsh-plugin-assets/dsh-pet-frieren提供,无路径遍历风险。
- 无障碍:尊重系统的
安装与启用¶
安装该插件需要 DeepSeek Harness 的 Web GUI (dsh --profile web) 环境。
- 执行安装命令:
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren
插件会作为标准的 dsh bundle 安装到 `web` 配置文件中。
- 启动 DeepSeek Harness Web GUI:
dsh --profile web
启动后,Frieren 会出现在屏幕上。
常用命令¶
安装完成后,可以通过以下命令管理插件:
- 更新插件:
dsh plugin --profile web update dsh-pet-frieren
- 固定版本:
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren#v0.1.0
- 移除插件:
dsh plugin --profile web remove dsh-pet-frieren
- 从 Git 安装:
dsh plugin --profile web add git+https://github.com/dakeshui123/dsh-pet-frieren.git
技术与版权说明¶
- 构建方式:插件客户端包已预构建(prebuilt),无需
prepare或build步骤,兼容任意版本的 pnpm。 - 资源路径:遵循 dsh bundle 的 host-serves / client-reads 模式,资源通过 HTTP 读取,未嵌入打包文件中。
- 版权信息:插件基于 MIT 许可证开源。其中使用的“Frieren”角色形象源自《葬送的芙莉莲》,属于个人非商业用途的同人艺术。