鱼鱼 Bot 安装说明

适用版本:0.5.1 · 专属网关版 · 支持 Windows / macOS / Linux 上的 DeepSeek Harness

下载安装包(约 10 MB,含全部依赖)

SHA-256 校验文件:fish-bot-0.5.1.tgz.sha256.txt

更省事:让你的 AI 助手帮你装
在 DeepSeek Harness 里新开一个会话,把下面这句话发给它:
请按 https://bot.a345.cn/install-agent.md 安装鱼鱼 Bot
助手会自动下载、校验、解压并安装,装完再让你填 Key。
如果助手没有安装权限,它会把解压好的目录告诉你,你按下面第 2 步手动选中即可。

1解压安装包

下载得到的文件是 fish-bot-0.5.1.tgz,这不是 Windows 安装程序,双击打不开属正常现象。

  1. Windows:用 7-Zip 或 Bandizip 右键解压,可能需要连续解压两次(.tgz → .tar → 文件夹)。
  2. macOS / Linux:在终端执行
    tar -xzf fish-bot-0.5.1.tgz
  3. 解压后会得到一个名为 package 的文件夹,里面包含 package.json、index.js、src 等文件。

2安装到 DeepSeek Harness

  1. 打开 DeepSeek Harness。
  2. 进入左侧的 插件(Plugins)页面。
  3. 点击 添加插件(Add plugin)→ 选择 本地目录。
  4. 选中解压出来的 package 文件夹(注意:选文件夹本身,不是里面的某个文件)。
  5. 等待安装完成,在插件列表里确认「鱼鱼 Bot」处于启用状态。
  6. 新建一个会话,插件才会完全加载。
选错目录的典型表现
如果提示找不到 package.json,说明选到了上一层或下一层目录。请确认所选目录下直接就能看到 package.json。

3配置专属网关

  1. 打开 设置 → 模型。
  2. 找到服务商 qpxxlla-api(本版本已内置,无需手动添加)。
  3. 在 API Key 一栏填入我们发给你的专属 Key。
  4. 点击保存,然后点击获取模型列表。

本版本只支持官方专属网关,无法添加其他服务商,也无法使用本地模型服务。

4验证是否安装成功

  1. 新建会话,发送一句「你好」。
  2. 能正常收到回复,说明插件和网关都已连通。
  3. 如果报错,把完整错误提示截图发给我们。

常见问题

Q:下载后双击没反应?
A:这是压缩包,不是安装程序,请按第 1 步解压。

Q:插件列表里看不到鱼鱼 Bot?
A:确认选中了 package 文件夹,并重启一次 DeepSeek Harness。

Q:提示 401 / 403?
A:Key 未填写、填错或已失效,请重新复制完整 Key(注意不要带空格)。

Q:提示 429 或额度不足?
A:账户额度已用尽,请联系我们充值。

Q:能否使用自己的 OpenAI / Claude Key?
A:不可以,本版本固定使用官方专属网关。

校验安装包完整性(可选):
certutil -hashfile fish-bot-0.5.1.tgz SHA256
结果应与 fish-bot-0.5.1.tgz.sha256.txt 中的值一致。