前言¶
DSH 生态强调“一切皆插件”,社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。对经常使用 DeepSeek Harness 的开发者来说,插件不只是扩展模型能力,也可以扩展工作界面和任务反馈。dsh-nailong-desktop-pet 就是这类轻量界面插件:它把 Harness 任务状态、自定义角色和桌面陪伴放到一个可配置的宠物形态里。
这是什么¶
dsh-nailong-desktop-pet 是一个非官方、可自定义的 Nailong(奶龙)桌面宠物社区插件,用于 DeepSeek Harness。维护者是 2002yxy,代码许可证为 MIT。项目资料称其为 early Alpha,面向反馈和迭代发布。
它主要解决两个问题:一是提供一个可显示、可调整、可自定义的桌面宠物;二是把 Harness 任务状态汇总为更直观的等待、运行、未读完成或空闲状态。
核心功能¶
平台表现¶
在 macOS 上,插件会启动透明、无边框的 AppKit companion,可以跨应用和 Spaces 移动。该原生宠物为纯美术展示,没有方形卡片、焦点环、标题栏或窗口阴影。宠物可以拖拽,点击可将 Harness 带到前台。
其他平台回退到 Harness 窗口内的透明宠物。该回退可以打开最相关 Session 并显示活动托盘,但无法把宠物移出 Harness 窗口。
预设与状态¶
插件内置 Nailong(奶龙),并提供四个额外预设:DeepSeek whale、Naihuang、Jinglong、Naijing。
每个预设以透明 Hatch v1 atlas 提供,包含九个语义状态和 57 个活动帧。插件支持每个角色独立的大小设置、运动设置、动画预览、方向拖拽动画和保存位置。
它还可以汇总 Harness 任务状态,显示为等待输入、未读完成、运行中或空闲。
自定义宠物¶
插件支持从 PNG、JPEG、WebP、GIF、AVIF 或 BMP 创建自定义宠物。默认路径可以在本地构建多状态 2.5D atlas。若配置了可选的图像生成凭证,可生成一致的 3D-toy pose sheet,并编译为 Hatch v1 atlas。
自定义流程打包了 /create-desktop-pet Skill,以及三个 host tools:inspect_desktop_pet_draft、hatch_desktop_pet_draft、install_desktop_pet。
安装与启用¶
安装前建议检查源码、许可证和发布文件。该 Alpha 附带预构建运行时文件,包含源码供审查,但还不是独立开发工作区。
使用本地 archive 安装:
dsh plugin --profile web add ./dsh-desktop-pet-0.1.0-alpha.2.tgz
如果从 GitHub 安装,建议使用固定 tag:
dsh plugin --profile web add github:2002yxy/dsh-nailong-desktop-pet#v0.1.0-alpha.2
安装后如果插件未立即出现,重启 Harness。
如需移除:
dsh plugin --profile web remove dsh-desktop-pet
典型用法¶
1、进入 Settings > Plugins,打开 Desktop Pet 页面。
2、使用插件页顶部的高频控制显示或隐藏桌面宠物。
3、选择一个预设,调整大小、运动、动画预览、方向拖拽动画,并保存位置。
4、在 macOS 上,把宠物拖到合适位置;点击宠物可将 Harness 带到前台。
5、在其他平台,使用 Harness 窗口内回退,打开最相关 Session 或显示活动托盘。
创建自定义宠物时,先选择 Custom pet,选择图片并点击 Create pet。然后审阅并手动发送预填的 /create-desktop-pet 请求。Skill 会调用 inspect_desktop_pet_draft、hatch_desktop_pet_draft 和 install_desktop_pet。安装完成后,动画角色会回到宠物库,可以选择并像预设一样调整大小或运动。
适用场景与注意¶
适合想要轻量桌面陪伴、需要把 Harness 状态放在可见位置、或希望用自己的图片生成角色动画的开发者。
需要注意:
- 项目为 early Alpha,用于反馈和迭代发布。
- macOS 原生 companion 面向
macOS 13+的 Apple Silicon 和 Intel,尚未签名或公证。 - 其他平台使用 Harness 窗口内回退,无法将宠物移出 Harness 窗口。
- macOS 原生点击可激活 Harness,但尚不能深链到特定 Session。
- 偏好设置不在设备间同步。
- 生成 3D 渲染需要单独配置的图像生成凭证;否则自动生成本地 2.5D 结果。可选图像生成凭证仅用于生成的 3D 路径。
- 普通显示、移动、选择和配置不增加模型输入或 tokens;自定义宠物任务仅在用户明确发送时增加请求和工具调用。
- 图片本身不进入模型上下文;自定义角色和偏好保留在当前 Harness 浏览器 profile。
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。该项目为独立社区项目,不是 DeepSeek 官方发布;预设美术来源和再分发权利在公开发布前需要确认。
结尾¶
dsh-nailong-desktop-pet 把桌面宠物、预设动画、任务状态和自定义角色流程放进同一个 DSH 插件。适合先在小范围环境中试用,并根据 macOS 原生体验、自定义宠物流程和当前 Harness 版本持续验证。
GitHub:https://github.com/2002yxy/dsh-nailong-desktop-pet
社区目录线索:https://www.skillhub.cn/plugins/2002yxy/dsh-nailong-desktop-pet(该目录地址来自线索,未作为已抓取事实确认)