前言¶
用 DeepSeek Harness（下称 DSH）跑任务时，一个常见的麻烦是：任务在后台执行，你得切窗口、刷页面才能知道它是在等你输入、出了错，还是已经跑完。dsh-nba-pets 用另一种方式解决这个问题：在 DSH 页面上放一只篮球主题的桌面宠物，用不同的动画直接表达任务状态，需要输入时它会等你，出错时它显示受阻动作，空闲时它就在那里练习投篮。
下面介绍这个插件的定位、功能和安装方法。
这是什么¶
dsh-nba-pets 是由 lijian-888 维护的篮球桌面宠物合集，专为 DSH 打造，许可证为 MIT，仓库 package.json 中标注的版本号为 0.1.2。它是非官方粉丝项目，与 NBA、任何球队或球员本人无隶属或背书关系。
它不会替换 DSH 的会话、侧栏或输入区，只是在 Web 界面上增加一个能表达任务状态、可交互的浮动宠物。
核心功能¶
- 两个可切换角色：Curry 30 与原创致敬形象 King 23，一键切换。
- 任务状态一目了然：需要输入、受阻、已就绪、执行中、待机分别使用不同动画。
- 点击查看任务：点击宠物即可查看活动任务，并直接进入对应的 DSH 会话。
- 桌面宠物的基本能力：自由拖动、角色与位置记忆、收起和唤醒。
- 丰富的动画：待机投篮、跑步、招手、跳跃、等待、受阻、工作、审阅，以及 16 向光标追踪。
- 尊重系统设置：开启系统“减少动态效果”后，自动改用静态帧。
- 构建时嵌入素材：两套 1536×2288 RGBA WebP v2 动画图集在构建时嵌入 DSH 客户端包，安装后不依赖本地素材路径，也不需要额外的 HTTP 服务。
状态规则¶
任务状态的优先级遵循 Codex Pets 的状态语义，同一时刻多个状态并存时，按优先级从高到低取第一个：
| DSH 状态 | 宠物表现 | 优先级 |
|---|---|---|
pendingInteraction |
等待用户输入 | 1 |
lastAgentError |
显示受阻或错误动作 | 2 |
completed |
显示已就绪或审阅动作 | 3 |
running |
显示任务执行动作 | 4 |
| 无活动 | 投篮待机或看向光标 | 5 |
也就是说，只要任务出错或需要你输入，宠物一定会优先表现出来，不会被“执行中”的动画掩盖。
安装与启用¶
环境要求：Node.js 22+、DeepSeek Harness 0.1.0-rc.5 至 <0.2.0、DSH web profile（首次安装时会自动创建）。
方式一：npm 安装（最简单，推荐）¶
已经有 dsh 命令的用户，直接执行：
dsh plugin --profile web add dsh-nba-pets
这会从公共 npm 仓库安装已构建、已测试的版本。
如果 npm 镜像尚未同步该包，可指定官方源：
dsh plugin --profile web add dsh-nba-pets --registry=https://registry.npmjs.org
方式二：从 DSH 源码目录安装（适合 DSH 开发者）¶
如果你直接从 DSH 源码仓库运行、没有全局 dsh 命令：
cd /path/to/deepseek-harness
corepack pnpm dsh plugin --profile web add dsh-nba-pets
方式三：从 GitHub 安装最新源码¶
dsh plugin --profile web add github:lijian-888/dsh-nba-pets
GitHub 安装会在本地构建源码。pnpm 10 及以上版本首次可能要求放行构建，需要在 profile 的 pnpm-workspace.yaml 中加入：
allowBuilds:
dsh-nba-pets: true
然后重新执行安装命令。如需稳定复现，建议固定可信提交：
dsh plugin --profile web add github:lijian-888/dsh-nba-pets#<commit-sha>
启动与验证¶
安装后先重启 DSH，让它重新读取 profile，再启动 Web profile：
dsh --profile web
刷新 DSH 页面后，Curry 30 会作为浮动宠物出现。点击宠物即可切换角色或查看任务动态。
要确认插件已写入配置，执行：
dsh --profile web --dump-config
输出中应包含 # == dsh-nba-pets 和 id: nba-pets。
卸载¶
dsh plugin --profile web remove dsh-nba-pets
本地开发¶
如果你想改代码或参与贡献，从源码跑起来：
git clone https://github.com/lijian-888/dsh-nba-pets.git
cd dsh-nba-pets
npm install
npm run check
dsh plugin --profile web add .
常用开发命令：
npm run build
npm test
npm run check
适用场景与注意¶
适合的场景：长期在 DSH Web 界面工作、经常同时跑多个任务、希望不切窗口就能掌握任务进度的用户。它也适合想要一点陪伴感的开发者，但状态表达是它的核心价值，不只是装饰。
使用前注意几点：
1、这是浏览器内插件，宠物只能浮动在 DSH Web 应用窗口内，无法创建跨操作系统窗口的全局置顶宠物。
2、这是非官方粉丝项目，不包含 NBA 或球队标志；King 23 是原创致敬形象，并非真人精确肖像，详细说明见仓库的 THIRD_PARTY_NOTICES.md。
3、和其他 DSH 插件一样，插件以当前 dsh 进程的权限运行。安装前建议检查源码与许可证（本项目为 MIT），从 GitHub 安装时可固定可信提交。
结尾¶
dsh-nba-pets 做的事情很集中：把 AI 任务状态翻译成一眼能看懂的宠物动画，同时给 DSH 工作区增加一点篮球味。如果你已经在用 DSH 的 web profile，一条命令就能装上试试。
