奶龙桌宠 · 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.1.tgz

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

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

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

卸载命令：

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

安装前请先阅读 COMPATIBILITY.md。

已有能力

• 在插件页顶部通过高频开关显示或隐藏桌宠。
• 以奶龙作为项目主角色，并预置 DeepSeek 小鲸鱼、奶黄、鲸龙和奶鲸四个陪伴角色。
• 支持每个角色独立设置大小与动态效果，并支持透明背景、Hover 动效、左右拖动动效和位置记忆。
• 将 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，再基于安全默认参数调用一次 install_desktop_pet。
5. Host 修正图片方向，按需仅移除与画面边缘连通的背景像素，裁去透明边界、补安全留白，并归一化为 512 像素透明 PNG。
6. 成品自动回流到桌宠列表，可像预置角色一样选择并调整大小和动态。

原图不会作为模型附件进入消息，因此纯文本模型也可完成该流程；图片数据只在本地 Host 工作流中处理。

模型与隐私影响

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

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

兼容性与限制

• 原生 companion 面向 Apple Silicon 与 Intel 上的 macOS 13+，目前尚未签名或公证。
• 其他平台使用 Harness 内降级实现，不能把桌宠拖出 Harness 窗口。
• 每个自定义角色目前生成一张静态 PNG；动态成品和多状态精灵包暂未实现。