奶龙桌宠 · dsh-nailong-desktop-pet

English | 中文

一个以 奶龙 为核心角色与视觉符号、支持自定义角色的非官方 DeepSeek Harness 社区桌宠插件。除奶龙外，也预置 DeepSeek 小鲸鱼及其他陪伴角色。当前版本是用于收集反馈并持续迭代的早期 Alpha。

在 macOS 上，插件会启动透明、无边框的 AppKit 原生悬浮桌宠，可跨应用、跨桌面空间移动；在其他平台上，会降级为 Harness 窗口内的透明桌宠。插件同时会在 设置 > 插件 中增加“桌宠”页面。

安装

下载 Release 中的压缩包后，本地安装：

dsh plugin --profile web add ./dsh-desktop-pet-0.1.0-alpha.2.tgz

仓库公开并创建 tag 后，可按固定版本从 GitHub 安装：

dsh plugin --profile web add github:2002yxy/dsh-nailong-desktop-pet#v0.1.0-alpha.2

建议始终固定 tag，因为 DeepSeek Harness 和本插件都还在快速迭代。如果安装后没有立即出现，请重启 Harness。

卸载命令：

dsh plugin --profile web remove dsh-desktop-pet

安装前请先阅读 [COMPATIBILITY.md](COMPATIBILITY.md)。

已有能力

• 在插件页顶部通过高频开关显示或隐藏桌宠。
• 以奶龙作为项目主角色，并预置 DeepSeek 小鲸鱼、奶黄、鲸龙和奶鲸四个陪伴角色。
• 所有预置角色均为透明 Hatch v1 动画图集，包含待命、左右移动、挥手、跳跃、失败、等待、任务执行和审阅等 9 种状态，共 57 个有效帧。
• 支持每个角色独立设置大小与动态效果，并支持动态预览、左右拖动动效和位置记忆。
• 将 Harness 任务状态归纳为等待用户处理、未读完成、运行中和待命。
• 自定义制作支持 PNG、JPEG、WebP、GIF、AVIF 和 BMP。
• 包内提供 /create-desktop-pet Skill，以及用于检查、孵化并安装桌宠的三个 Host 工具。

macOS 原生桌宠只显示图形本身，没有方形卡片、选框、标题栏或窗口阴影，可拖到电脑桌面的任意位置；点击会唤回 Harness。Harness 内降级模式还可以打开最相关的 Session，并展示任务动态列表。

自定义桌宠流程

1. 点击“自定义桌宠”，选择图片并点击“制作桌宠”。 2. 插件用不可猜测的 draft id 暂存原图，新建一条空白 DeepSeek 任务，选中包内 Skill，预填可编辑的 /create-desktop-pet 请求，并自动关闭设置弹窗，让输入框直接呈现出来。 3. 用户检查后手动发送。 4. Skill 依次各调用一次 inspect_desktop_pet_draft、hatch_desktop_pet_draft 和 install_desktop_pet。 5. 如果配置了可选的图像生成凭据，Host 会生成统一的 3D 玩具风格动作母图，再编译为标准 Hatch v1 图集；没有该凭据时，会在本地自动抠出主体、去掉相连背景和周围无关内容，并制作多状态 2.5D 动画图集。 6. 安装完成的动态角色会自动回流到桌宠列表，可像预置角色一样选择并调整大小和动态。

原图不会作为模型附件进入消息，因此只配置 DeepSeek API Key、使用纯文本 DeepSeek 模型即可完成默认的本地 2.5D 流程；图片数据只在本地 Host 工作流中处理。图像生成凭据仅在用户希望使用生成式 3D 路径时才是可选项。

模型与隐私影响

普通展示、移动、选择和设置都不会增加模型输入或 token。只有用户明确发送自定义桌宠任务时，才会增加一条文本请求、包内 Skill 文本，以及两次本地工具调用和结果；原图本身不会进入模型上下文。

自定义角色和偏好保存在当前 Harness 浏览器 profile 中，不会自动上传或跨设备同步。安全问题反馈方式见 [SECURITY.md](SECURITY.md)。

兼容性与限制

• 原生 companion 面向 Apple Silicon 与 Intel 上的 macOS 13+，目前尚未签名或公证。
• 其他平台使用 Harness 内降级实现，不能把桌宠拖出 Harness 窗口。
• 生成式 3D 路径需要另行配置图像生成凭据；未配置时插件会自动产出可用的本地 2.5D 动画结果。
• 原生模式点击会唤回 Harness，但暂时不能深链到具体 Session。
• 偏好暂不跨设备同步。
• Alpha 包含预编译运行文件，因此 GitHub 安装不依赖仓库现场构建。源码随包提供用于审查，但当前还不是可独立开发的完整工作区。

社区发布清单

GitHub topic、tag、压缩包、校验值与全新 profile 验证步骤见 [RELEASING.md](RELEASING.md)，版本变化见 [CHANGELOG.md](CHANGELOG.md)。

许可证与名称说明

代码使用 [MIT License](LICENSE)。这是独立社区项目，不是 DeepSeek 官方发布。DeepSeek 名称与小鲸鱼标志归其各自权利人所有。公开发布前必须确认所有预置图片的来源及再分发权利，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。