FishAi Harness
DOCUMENTATION

从安装，到第一个任务。

把 FishAi Harness 加入你的工作流。这份文档会带你完成安装、账号连接和本地项目操作。

1. 安装桌面客户端

在官方下载页选择 Windows 或 macOS，下载对应平台的安装文件。只有通过发布校验的文件才会列在下载页。

Windows

下载 64 位安装包后双击运行，按安装向导完成安装。首次打开时，按操作系统提示检查发布来源。FishAi Harness 使用独立的应用标识与数据目录，与其它客户端互不影响。

macOS：安装与同版本修复包替换

  1. 在苹果菜单“关于本机”中确认芯片类型：Apple M 系列选择“Apple 芯片”，Intel 处理器选择“Intel 芯片”。
  2. 若安装过 2.0.1，先退出 FishAi Harness，并在访达侧栏推出旧的“FishAi Harness 2.0.1”安装盘。
  3. 回到官方下载页重新下载对应芯片的 DMG。2026 年 10 月 15 日的 macOS 修复包仍为 2.0.1，文件名相同，但文件大小和 SHA-256 已更新；请使用本次重新下载的文件。
  4. 双击新 DMG，将 FishAi Harness 拖入“Applications（应用程序）”。若提示已有同名应用，选择“替换”；然后推出安装盘，从“应用程序”打开 FishAi Harness。

覆盖安装只替换应用程序，不需要删除用户目录中的 .FishAiHarness 数据。重要项目与任务记录仍建议提前备份。

当前 macOS 修复包已完成本地完整性签名，但没有 Developer ID 分发证书，也尚未经过 Apple 公证。包内签名校验通过不等于系统自动信任，首次打开时仍可能出现安全提示。

macOS 提示无法验证开发者、无法检查或“已损坏”

请先确认安装包来自本页官方下载入口，并核对下载按钮提供的 SHA-256；摘要不一致时，重新下载后再安装。

  1. 完成上面的覆盖安装，并从“应用程序”尝试打开一次 FishAi Harness。
  2. 若系统因开发者身份或未公证而拦截，打开“系统设置 → 隐私与安全性”，向下滚动到“安全性”。
  3. 如果出现 FishAi Harness 对应的“仍要打开”，在确认来源后点击，并在随后的确认窗口选择“打开”。部分 macOS 版本可能要求验证设备密码或 Touch ID。

操作位置可参考Apple 官方的 App 安全打开说明。

没有“仍要打开”，重新安装后仍提示“已损坏”

只在确认已下载本站修复包、SHA-256 一致，且已安装到“应用程序”后使用。先退出 FishAi Harness，打开系统“终端”，复制以下命令并回车；此命令只移除这个应用的下载隔离标记，不会删除应用或任务记录：

xattr -dr com.apple.quarantine "/Applications/FishAi Harness.app"

命令执行成功通常没有文字输出，之后从“应用程序”重新打开。无需再次执行 codesign 签名，也无需关闭整个系统的安全检查。若终端报权限错误、系统明确提示恶意软件，或新包仍打不开，请保留错误信息，通过官方支持反馈。

开发者可用以下命令核对文件摘要，文件名替换为实际下载名称：

# macOS
shasum -a 256 "下载的文件"

# Windows PowerShell
Get-FileHash -Algorithm SHA256 -LiteralPath "下载的文件"

2. 连接 FishAI 账号

  1. 打开 FishAi Harness，选择“使用 FishAI 账号登录”。
  2. 客户端会在系统浏览器打开 FishAI 授权页面。如果网站尚未登录，先登录 FishAI，再回到授权页面。
  3. 确认是你刚刚发起的登录后，点击“确认登录 FishAi Harness”。
  4. 客户端会自动完成连接。浏览器页面显示成功后可关闭。

授权使用名称为“FishAi Harness 专属”的 API Key：已有有效 Key 时复用，没有时创建一个。网站登录凭据不交给桌面端；专属 Key 通过独立授权流程领取。

每个 FishAI 用户最多有 10 个有效 Key。如果已达到上限，请先在API 中心删除一个不再使用的 Key。若专属 Key 设置了 IP 白名单，客户端调用也需符合该限制。

3. 模型与计费

模型来源固定为 FishAI，客户端无需配置 Base URL、供应商或 API Key。你可以在任务中切换 FishAI 提供的 GPT、Claude 与其他文本模型；视频模型不进入客户端目录。

模型请求使用 FishAI 账号余额，按实际模型与 Token 用量计费。价格、余额和使用记录以FishAI API 中心为准。下载客户端不等于获得免费模型额度。

不同模型的上下文、图片理解和工具调用能力可能不同。选择模型后，以客户端显示的能力与实际返回结果为准。

4. 打开本地项目，开始任务

打开你要处理的本地文件夹，创建任务并说明目标。可以先要求 AI 阅读项目结构、说明修改方案，再开始改代码。任务过程中查看文件变更、工具调用和终端输出，重要结果应自己检查并运行项目测试。

为任务提供清晰的完成条件会更有效，例如“优化移动端导航，保留现有路由，完成后执行已有检查”。项目仍由你管理，建议使用版本控制保存重要变更。

本地扩展

可使用客户端保留的本地技能、MCP 与自动化设置扩展工作流。第三方工具可能有独立网络访问和数据规则，启用前检查其来源和权限。上游账号、套餐、云服务与遥测不属于 FishAi Harness 的功能。

5. 数据保存与权限

应用私有数据位于用户目录下的 .FishAiHarness，包括设置、任务历史、日志和运行状态。应用不会读取或迁移其他客户端的私有数据目录。

“本地保存”不意味着“离线推理”：你提交的提示词、任务上下文，以及工具选中的相关文件内容，会在调用模型时发送到 FishAI。终端或网络工具还可能产生你授权范围内的其他访问。

登录状态下，客户端还会向 FishAI 独立统计服务发送账号使用心跳，统计用户 ID、账号、累计在线时长、最近使用时间、版本和平台，不包含代码、提示词或文件内容。具体见隐私政策。

涉及写文件、执行命令等操作，请认真查看权限提示。需要彻底移除授权时，可在 FishAI API 中心删除专属 Key；清理本地数据前请备份需要保留的任务。

常见问题

macOS 安装后提示已损坏或无法验证开发者怎么办？

先退出应用并推出旧安装盘，从官网下载与芯片匹配的 2.0.1 修复包，核对 SHA-256 后拖入应用程序覆盖安装。当前包已完成本地完整性签名，尚未经过 Apple 公证；首次打开被拦截时，可在系统设置的隐私与安全性中查看仍要打开。若没有该按钮，按本文 macOS 安全提示一节，仅对已核验的 FishAi Harness 使用隔离标记移除命令。

授权页已经成功，软件为什么还没登录？

保持客户端开启并等待自动领取结果。授权有效期为五分钟；过期后在客户端重新发起登录。检查系统时间、网络连接与 FishAI 服务是否正常。

提示余额不足或 Key 无效怎么办？

在 FishAI 网站检查余额和专属 Key 状态。Key 被删除后，退出客户端账号并重新登录，完成新的授权。IP 白名单需要与当前网络匹配。

能填写自己的模型服务吗？

不能。FishAi Harness 的模型目录和请求地址固定为 FishAI；你可在目录内选择可用模型。

怎样更新？

客户端和官网从 FishAI 发布清单读取版本信息。请在更新日志查看版本号，从官方下载页获取对应平台的新版本；更新前备份重要项目。

支持与反馈

加入 FishAI 官方 QQ 群 1070686285，反馈系统版本、客户端版本、复现步骤和错误提示。请先遮盖 API Key、登录 Token、个人资料和项目机密。