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

[English](README.md) | 中文

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

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

## 安装

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

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

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

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

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

卸载命令：

```sh
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)。