快速安装

需要已经安装 DeepSeek Harness（DSH），并使用它的 Web 界面。当前 npm 版本为 0.5.3（体验版）；本版的配置与空闲轮转优化见 设置审查，动画与文案改进见 0.5.2 说明。完整原生安装已验证 DSH 0.1.5-rc.1 / 0.1.5-rc.2。Node 要求 ^22.19.0 || >=24.0.0。

直接从 npm 安装到你使用的 Web profile，无需下载源码或手动构建：

dsh plugin --profile web add dsh-bigfish
dsh --profile web

打开或刷新 dsh-web，右下角就能找到她。web 请换成你的实际 profile 名称。

插件里还附带 dsh-bigfish-pet-maker Skill，可用来制作、替换和扩展角色包。 想启用它，再执行一次：

npx --yes dsh-bigfish install-skill

安装后新建 DSH 会话，即可让 Agent 使用 $dsh-bigfish-pet-maker 制作新角色或扩展动作，再从「完整设置 → 角色库」导入生成的 .dshpet。详见角色制作示例。

详细安装、升级与卸载 · 常见问题 · npm 包页面

动画展示

本节 GIF 和下面的录屏来自插件自带预览：使用实际宠物渲染与动画，任务和速度由演示数据驱动。只录制宠物区域，不包含聊天内容。社区独立项目，非 DeepSeek 官方产品。

她会做什么？

当你……	大肥鱼会……
还没开始工作	按所选频率举牌、喝茶或休息；支持安静陪伴和自定义间隔
提交任务、等待首段输出	立即切换到工作准备状态，不再举着“我在等哦”
看着模型输出	敲键盘、思考，跟随当前模型的相对速度调整节奏
让 Agent 读文件、搜索、执行工具	切换相应动作，在气泡里显示工具状态和可自定义的台词
需要确认或补充输入	停下来等你，不再催促输出
完成、取消或遇到错误	给出不同反馈；完成演出后回到休息

不喜欢鞭策？关掉就好。 齿轮里取消「启用鞭策动作」，鞭子及配套躲闪会一起关闭，正常工作动画继续。开启时只做非接触空挥，不会打到角色；默认静音。

先看看她

下面是宠物区域的使用截图，气泡、状态和控制按钮都是实际插件界面。

我在等哦 按你的频率举牌与休息	认真开工 气泡、速度和状态放在一起
工具也有动作 执行期间暂停空挥	夜里也陪着你 跟随明暗主题，鞭策可以关闭

▶ 观看 / 下载完整 MP4 录屏：举牌 → 工作 → 速度变化 → 调用工具 → 等待确认 → 完成 → 关闭鞭策 → 深色模式。无需声音也能看懂。

不止是一张会晃的贴纸

内置大肥鱼有 29 类动作、72 个绘制姿态、6 个场景、5 种举牌演出。阅读、工具操作、打字、等待确认等使用连续图像帧；部分动作结合程序位移与场景道具。72 个姿态不等于 72 套独立动画。

最近精修了喝茶、擦汗和伸懒腰，让动作有准备、过程和收尾：

动作可以在「完整设置 → 角色库」逐个预览，内置大肥鱼也支持。

按你的习惯陪伴

• 想让她多说几种话：内置 20 类 × 8 句，共 160 句可编辑台词，覆盖思考、输出、各类工具、等待确认和任务结束。支持 {task}、{tool}、{file} 等变量；已有自定义内容优先，想用新版可在该类别点“恢复这一类默认”。完整台词库
• 想看更多互动：默认「活泼陪伴 + 活泼」，每次动作展示 12 秒后休息 5–10 秒；气泡最多 6 秒，举牌会在举稳时停留再放下。工作空挥后保持恢复姿态 2.5 秒。旧模式选择保留，0.5.3 的频率按新的休息间隔计算。
• 想安静一点：选择「安静陪着」，首次问候后不反复举牌、换台词。空闲互动、动作表现和说话频率分别控制。
• 想热闹一点：选择「持续活动」，或自定义 1–600 秒休息间隔；可选「多举牌／均衡轮换／不举牌」，每次展示时长可调 5–30 秒。浮层设置显示当前状态和下一次互动倒计时。
• 不喜欢鞭策：关闭「启用鞭策动作」。设置会保存，刷新或换角色后继续生效。
• 挡住内容了：拖动宠物或气泡换位置；点 − 收起为图标，图标同样可以拖动。支持调整大小和透明度。
• 想换句台词：在「自定义台词与工具」编辑工作、等待、完成等台词，给工具名称或前缀配置专属规则。
• 想换设备：「完整设置 → 备份与恢复」导出角色、偏好、台词和编排。导入时先检查并预览，再确认恢复。

不同模型，不用同一把尺子。 自动模式按 provider、model、推理配置和统计通道分别学习速度，适配约 20～400 tok/s 等不同量级。显示的 ≈ tok/s 是估算值；工具等待、首段等待不会简单算成“输出太慢”。可选择“慢了催一催”或“跟着输出节奏动”，也可手动设定目标。

多个会话同时工作时，跟随你当前打开的会话。 不叠加后台速度，后台完成不会抢走前台状态；当前会话空闲时，宠物也保持空闲。刷新历史记录不会重播庆祝。

陪伴与设置说明 · 台词与工具扩展 · 备份与恢复

做一只属于你的宠物

Bigfish 支持可替换的 .dshpet 角色包。角色包可以有比内置大肥鱼更多的动作，自定义动作 ID、标签、连续帧、台词和道具，不需要修改插件代码。

1. 在「完整设置 → 角色库」导入 .dshpet 或兼容 ZIP。
2. 先预览角色和每个动作，再安装并使用。
3. 切换角色时保留你的陪伴偏好；已安装版本可保留并切换。

Release 另附 大肥鱼 · 成年版：沿用原始鲸鱼女仆形象，保留尾巴与围裙标志，包含 8 组动作。

用一个 Skill 和 Agent 一起做角色

npm 包已经包含完整 Skill，不必另下 ZIP：

npx --yes dsh-bigfish install-skill

默认安装到 $DSH_HOME/skills/dsh-bigfish-pet-maker；未设置 DSH_HOME 时使用 ~/.dsh/skills/dsh-bigfish-pet-maker。已有相同内容会跳过，不同内容会保留并提示，不会覆盖你的修改。安装 Skill 后请新建 DSH 会话；宠物插件本身的安装不会自动修改技能目录。

其他 Agent 可使用 npx --yes dsh-bigfish install-skill --skills-dir /absolute/path/to/agent/skills 指定技能目录。也保留 独立 Skill ZIP 供手工安装。具体宿主的技能目录和发现方式请以其配置为准。

然后直接和 Agent 说：

用 $dsh-bigfish-pet-maker 做一只蓝色小狐狸。平时安静，工作时认真。设计打字、读书、搜索、执行工具、等确认、举牌和完成庆祝，再加一些狐狸自己的小动作。交付能导入 DSH 的角色包和预览。

也可以给现有角色加动作：

用 $dsh-bigfish-pet-maker 扩展这个角色包，增加喝茶、整理文件和测试完成的动作。保持角色外观一致，保留原有动作，升级角色包版本。

Skill 包含模板、校验器、素材组装、离线预览和打包工具。生成新美术需要 Agent 自身具备图像生成能力；也支持使用已有素材。角色包遵守文件、像素和帧数量上限，加载时不会执行包内脚本或请求远程素材。

角色包使用指南 · 角色包协议 · Skill 源码

从源码运行

git clone https://github.com/gosomea/dsh-bigfish.git
cd dsh-bigfish
pnpm install --frozen-lockfile
pnpm build
pnpm preview

打开 http://127.0.0.1:4178。构建也会生成 dist/preview.html 和成年版角色包。

检查与打包：

pnpm check
pnpm test
pnpm exec playwright install chromium
pnpm test:browser
pnpm pack --pack-destination dist
python3 scripts/package-release.py

Node ^22.19.0 || >=24.0.0，pnpm 11.7.0。原生接入探针需要另行准备已构建的 DSH 源码；详情见 兼容性与验证。录屏复现方法见 媒体说明。

验证与边界

0.5.0 已完成 macOS 的 108 项单元测试和 28 项浏览器回归；Linux arm64 的 Node 22.19.0 / 24.21.0 干净安装、构建和单元测试，Node 24 另跑了浏览器回归。两版 DSH 完成原生安装、实时任务、多会话、备份恢复及卸载检查；另有约 30 分钟、180 轮切换的渲染生命周期检查。

这不代表所有平台都已支持：Windows、x86、Safari / Firefox、网络共享文件系统及跨天运行尚未完成验证。共享同一 DSH_HOME 的多个实例需要全部升级到支持跨进程锁的版本。备份恢复包含冲突保护与回滚，但跨 Host 和浏览器存储不构成一个整体原子事务。

验证范围 · 五项优化审查 · 架构 · 动作设计 · 速度自适应

许可与素材

代码采用 MIT。角色美术和标志另见 NOTICE 与 素材来源：原始参考图作者尚未确认，代码许可不代表对第三方角色或商标权利的授权。本仓库不包含用户原始参考截图、聊天记录或模型凭据。