dsh-photo-pet

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-photo-pet — 照片宠物插件

中文 | [English](README.en.md)

> 把任意一张照片变成 DeepSeek Harness(DSH)Web 界面里的浮动宠物。

上传你的照片,它就变成了住在浏览器角落的宠物:可以拖来拖去、可以 AI 一键抠图换干净背景、可以起名字、会悬停弹菜单,模型工作的时候还会冒泡说话。照片就是宠物本体——不加边框、不套模板,原样呈现。

![宠物效果](docs/screenshot.png)

## 这是什么?用在哪里?

**DeepSeek Harness(简称 DSH)** 是一个可扩展的 AI 助手运行时:一条 `dsh` 命令启动,用"profile + 插件"的方式组合出不同形态的应用。其中 `dsh web` 启动的是**网页版界面**(浏览器里的对话/任务/设置面板,默认地址 `http://127.0.0.1:3080`)。

**本插件就是装在这个网页界面里的**:装上之后,网页右下角会出现一只宠物 —— 它的形象是你上传的照片,模型工作时它会冒泡说话,鼠标悬停会弹出功能菜单。

```
浏览器(网页界面 127.0.0.1:3080)
└── dsh web profile
    ├── 对话 / 任务 / 设置(DSH 自带)
    └── 🐾 右下角浮动宠物 ← 本插件(dsh-photo-pet)
```

## 功能

| 功能 | 说明 |
|---|---|
| 照片即宠物 | 上传的照片原样作为宠物形象,宽度可调,高度按照片比例自动 |
| AI 自动抠图 | 上传照片后自动识别并抠出主体(去噪、去色边、自动裁剪);浏览器端加载开源模型,图片不出本机 |
| 智能修图 | 上传时自动去除照片四周的纯色边框 |
| 手动抠图编辑器 | 内置编辑器,橡皮擦/画笔手动修正,可重新自动抠图 |
| 拖拽移动 | 按住宠物拖动换位置,位置自动保存 |
| 命名 | 宠物有自己的名字,悬停名牌显示,可在设置中修改 |
| 工作话语 | 模型工作时宠物冒泡显示自定义话语(每行一句),轮换间隔可配置 |
| 点击话语 | 点击宠物时轮流显示自定义话语,每点一次换下一句,可配置 |
| 喂食 | 悬浮菜单 🍗 一键喂食:宠物弹跳 + 飘出💩(2~3 坨,越飘越小) + 轮换喂食话语,话语可配置 |
| 悬浮菜单 | 悬停弹出圆形功能菜单,菜单项可单独开关,支持一键全显/全隐 |
| 状态动画 | 空闲摇摆、点击弹跳、工作时左右摇摆 + 抽烟气泡(烟圈特效) |
| 隐藏/召唤 | 一键隐藏,隐藏后悬停宠物位置出现召唤按钮 |
| 设置面板 | 左侧导航"我的宠物":启用、显示、名字、大小、位置、修图/抠图开关、话语与菜单配置,改名实时同步到菜单 |

## 安装

### 第一步:安装 DeepSeek Harness

> 如果已经在用 DSH(能打开 `http://127.0.0.1:3080` 的网页界面),**跳过这一步**,直接看第二步。

```bash
# 需要 Node.js 20+(建议 22 或 24)
npm install -g @deepseek-ai/dsh

# 验证安装
dsh --version
```

### 第二步:启动 DSH 网页界面

```bash
dsh web
```

启动后浏览器打开 **http://127.0.0.1:3080** —— 这就是插件要"住进去"的界面。

> 端口默认 3080;如果被占用可指定 `dsh web --port 8080` 之类,后面插件操作不变。

### 第三步:安装本插件

**方式 A:npm 一条命令(推荐)**

```bash
dsh plugin --profile web add dsh-photo-pet
```

这条命令会替你完成全部接线:安装依赖、自动把插件写进 `web` profile 的 `dsh.profile.bundles` 注册表。装完**重启一次 Web 服务**再刷新浏览器:

```bash
kill $(lsof -ti :3080)     # 停掉旧服务
dsh web                    # 重新启动
```

> 提示:如果提示 `pnpm not found`,先装 pnpm:`npm install -g pnpm`。

**方式 B:从 GitHub 手动安装(可选,适合想改源码的)**

```bash
# 1. 克隆插件源码
git clone https://github.com/tangkui/dsh-photo-pet.git
cd dsh-photo-pet
npm install        # 安装 host 依赖
```

```bash
# 2. 把插件链接进 DSH profile
#    编辑 ~/.dsh/profiles/web/package.json:
```

```jsonc
{
  "name": "dsh-profile-web",
  "private": true,
  "dependencies": {
    // ...已有依赖
    "dsh-photo-pet": "link:/绝对路径/to/dsh-photo-pet"
  },
  "dsh": {
    "profile": {
      "bundles": [
        // ...已有 bundle
        "dsh-photo-pet"
      ]
    }
  }
}
```

```bash
# 3. 重启 DSH Web(杀掉 3080 端口进程,DSH 会自动拉起)
kill $(lsof -ti :3080)

# 4. 验证:浏览器刷新页面
#    - 页面右下角出现宠物(首次为内置默认形象)
#    - 控制台无报错;插件 bundle 可访问:
curl -s http://127.0.0.1:3080/plugins/dsh-photo-pet/client.js
```

### 第四步:把宠物变成"你的"

1. 刷新网页,右下角出现默认形象宠物
2. 左侧导航打开 **设置 → 我的宠物**
3. 点 **上传照片**,选择你的照片(AI 会自动抠图,图片全程不出本机)
4. 给宠物起个名字,拖到喜欢的位置 —— 完成 🎉

## 配置

左侧导航打开 **设置 → 我的宠物**:

- **启用宠物 / 显示宠物** —— 总开关与隐藏(隐藏后悬停可召唤)
- **宠物名字** —— 显示在名牌,同时左侧菜单名实时跟随
- **大小 / 距右边缘 / 距底部** —— 尺寸与位置
- **智能修图 / AI 自动抠图** —— 上传时的自动处理开关
- **工作状态下的话语 / 话语轮换间隔** —— 模型工作时的气泡文案与换句节奏
- **点击状态下的话语** —— 点击宠物时的气泡文案,每点一次换下一句
- **喂食时的话语** —— 点悬浮菜单 🍗 喂食时的气泡文案,每喂一次换下一句
- **悬浮菜单显示项** —— 悬停菜单项开关,一键全显/全隐
- **快捷操作** —— 上传照片 / 智能抠图 / 恢复默认形象,与悬浮菜单同款功能

## 数据与缓存

- 宠物照片与配置:`~/.dsh/photo-pet/`
- AI 抠图模型缓存:`~/.dsh/photo-pet/ai/<版本>/`(首次抠图时自动下载,约 44MB,之后离线可用)

## 卸载

```bash
dsh plugin --profile web remove dsh-photo-pet
```

宠物照片与模型缓存可手动删除(`rm -rf ~/.dsh/photo-pet`),不影响 DSH 本身。

## 工作原理

- **host 半区**(`lib/index.js`):注册 `photo-pet` 设置命名空间,提供 `/api/photo-pet/*` 路由(照片存取、活动状态轮询)与 AI 抠图代理(`/api/photo-pet/ai/*`,模型按需下载并缓存到 `~/.dsh/photo-pet/ai/<版本>/`)。
- **client 半区**(`lib/client.js`):浏览器端渲染宠物本体、动画、气泡、悬浮菜单与抠图编辑器;通过 `settings.section` 槽位把"我的宠物"注册为设置页一级导航。
- **安装形态**:profile 依赖 + `dsh.profile.bundles` 注册;插件的 `cordis.patch.yml`(`dsh.bundle.patch`)自动把插件行插入 Web 插件花名册。

## 开发

```bash
# 冒烟测试(jsdom 无头环境,覆盖挂载/菜单/上传/AI 路径/工作话语/设置卡片)
# 注意:测试环境需要 Node.js >= 22.19(jsdom 30 的 undici 依赖要求)
cd test
npm install
npm test
```

GitHub Actions 会在每次 push / PR 时自动跑同一套冒烟测试(`.github/workflows/ci.yml`)。**main 分支受保护:所有改动必须通过其他分支发起 Pull Request,至少 1 人评审、CI 通过后才能合并。**

仓库结构:

```
dsh-photo-pet/
├── lib/index.js        # host 半区:路由 / 设置命名空间 / AI 代理
├── lib/client.js       # client 半区:宠物本体 / 动画 / 菜单 / 编辑器
├── cordis.patch.yml    # bundle 补丁:插件行插入 Web 插件花名册
├── test/               # jsdom 冒烟测试
├── package.json
└── README.md
```

## 协议

[MIT](LICENSE)

DeepSeek Harness 生态插件,与 [deepseek-ai/dsh](https://github.com/deepseek-ai/dsh) 同协议。