前言¶
DSH（DeepSeek Harness）插件化架构允许用户自定义工具链。在 Agent 交互过程中，输出通常仅限于文本，缺乏视觉反馈。nattocb/dsh-plugin-petdex-market 插件解决了这个问题：它将宠物市集集成到 DSH 的 Settings 界面中，允许用户浏览、安装并渲染一个原生 macOS 桌面宠物，使其成为 Agent 的视觉伙伴。
核心功能¶
该插件提供了一套完整的宠物管理工具，核心能力包括：
- 实时市集：直连 petdex.dev，提供约 4,500 只宠物的目录。支持按名称、种类或作者搜索，支持分页和多种排序方式。
- 宠物管理：支持安装、启用、重命名和删除宠物。系统采用单活跃伙伴模型，启用一只宠物会自动禁用其他已安装的宠物。
- 同源贴图代理：服务端转发贴图请求，避免 WebView 出现 CORS 问题。
- 原生桌面宠物：使用 Swift/AppKit 构建的透明窗口。宠物可以自主行走、被拖拽，并支持右键菜单操作。
- 感知 Agent 状态：订阅 DSH 的 session/event 事件。当 Agent 开始工作时，宠物会奔跑；当 Agent 结束回复时，宠物会挥手并显示气泡。
- 配置热加载：所有设置保存在
petdex-market命名空间下，修改即时生效，无需重启服务。
安装与启用¶
安装过程分为三步：
- 安装插件
使用官方安装命令将插件添加到webprofile：
dsh plugin --profile web add github:NattoCB/dsh-plugin-petdex-market
- 配置启用
在~/.dsh/settings.yaml中开启插件与桌面宠物功能：
petdex-market:
enabled: true
desktopEnabled: true
- 重启服务
重启dsh web，在 Settings 界面中会出现 Petdex 页签，选择一只宠物即可开始使用。
注意事项¶
- 系统依赖：桌面宠物渲染器为 Swift/AppKit 原生二进制，仅支持 macOS 系统。
- 数据流向：目录数据直连 petdex.dev 获取，贴图经过服务端同源代理转发。
- 进程管理：渲染器进程由服务端管理。若进程崩溃，系统会在 2 秒后自动重启。
