NBFish · INSTALL GUIDE
把鱼缸，
搬回家。
这份教程只做一件事：让你在最短时间内把 NBFish 装进 DeepSeek Harness。安装包在 QQ 群文件里，Stable 和 Beta 分开下载；安装包内也会附一份同样的教程。
开始之前
先确认这台机器已经能正常打开 DSH，并且你拿得到 NBFish 的安装包。
- 系统：Windows 10 / 11 x64。
- 宿主：DeepSeek Harness 已安装并能正常启动。
- QQ：需要一个 QQ 号；桥接使用 SnowLuma 本地包，安装包内已带。
- 网络：安装本身可以离线；模型、B 站、抖音等模块按你的配置联网。
安装包不包含你的聊天记录、记忆库、登录态或授权私钥。升级时也不会覆盖 %USERPROFILE%\.dsh\nbfish 里的数据。
全新安装
第一次安装按这四步走。不要直接把 zip 拖进 DSH，也不要把整个压缩包放进插件目录。
- 加群，拿对应通道的包 QQ 群 1131227518。Stable 用 NBFish-V1.0.0-Stable.zip；想尝鲜用 NBFish-Beta-V1.0.8.zip。两个包不要混装。
-
解压，把
nbfish文件夹放到插件目录 目标路径是 %USERPROFILE%\.dsh\plugins\nbfish。如果已经有旧版，先把旧目录改名备份，不要直接覆盖。 - 完全退出 DSH，再重新打开 不是刷新页面，是连托盘一起退出。Host 侧代码和客户端面板都要重新加载。
- 打开 NBFish 面板 Stable 直接可用；Beta 先到「授权」页激活。第一次打开后，先看桥和功能开关是否正常，再改其它设置。
%USERPROFILE%\.dsh\plugins\nbfish\index.js
确认路径最后是 nbfish\index.js，不是 nbfish\nbfish\index.js。多套一层是最常见的安装失败原因。
Beta 授权
Beta 构建启用了离线授权；Stable 构建不锁功能，不需要这一步。
- 打开「授权」分区未授权时桥和功能会被锁住，这是正常现象。
- 复制设备码和申请信息发给管理员，说明你要用的天数；默认一次 2 天。
- 粘贴授权串，点激活激活后重新打开面板，桥和功能才会恢复。
授权是离线签名：停用或删除授权后，已经发出去的 token 最晚仍会用到到期时间。不要把设备码、授权串或管理员私钥发给无关的人。
升级 / 回滚
升级只替换程序文件，不要删除数据目录。数据目录在 %USERPROFILE%\.dsh\nbfish，记忆、日记、登录态、音色素材都在里面。
- 完全退出 DSH含托盘，确认没有残留进程。
- 备份旧插件目录把 plugins\nbfish 改名为 nbfish-backup-日期。
- 放入新版本解压新包，把新的 nbfish 放回 plugins\nbfish。
- 重新打开并验收先看面板版本号、桥状态、记忆条数，再开自动任务。
回滚就是反向操作：退出 DSH，把新目录改名，把备份目录改回 nbfish。数据目录不动。
常见问题
打开 DSH 后看不到 NBFish
先确认路径是 %USERPROFILE%\.dsh\plugins\nbfish\index.js，再确认是完全退出 DSH 后重开的。只刷新页面不会加载新的 Host 代码。
桥一直起不来
先看面板里的桥状态和诊断信息；确认 QQ 号、SnowLuma 路径和端口没有被其它程序占用。升级后第一次启动会重新校准 DSH 地址，等几秒再刷新。
Beta 所有功能都是灰的
Beta 未授权会锁住桥和全部功能。先到「授权」页激活；Stable 不会出现这个锁定。
数据在哪？卸载会删吗？
数据在 %USERPROFILE%\.dsh\nbfish。删插件目录不会自动删数据；要彻底清理时再手动处理这个目录。
安装包里的教程和网页不一样？
以安装包内附的 INSTALL.md / UPGRADE.md 为准；网页是同一套步骤的精简版。版本号不一致时，先看包根目录的打包清单。