RemoraFish

Русский · 简体中文

面向智能体的框架，可将您已授权的 ChatGPT、DeepSeek、Kimi、Grok 以及外部提供商的 Web 会话转换为 OpenAI 兼容 API、Anthropic Messages 和 MCP 工具。它附带无头运行时、提供商 SDK、账户控制平面、内置参考提供商和参考 Web UI。

[!IMPORTANT] 您对自己的账户以及使用 RemoraFish 执行的每一项操作负全部责任。 仅将其用于您拥有或明确获授权操作的账户和浏览器配置文件。您负责凭据安全、遵守提供商条款和适用法律，以及由此产生的后果，包括账户限制、暂停或丢失。项目作者不运营您的账户，也不保证其可用性。

RemoraFish v0.2 是框架预览版。它使用 Web 会话而非官方开发者 API 密钥。提供商可能会更改其私有协议或限制账户；请勿使用您无法承受损失的账户。公共仓库不包含任何用户凭据。浏览器会话和令牌缓存是本地运行时数据，默认存储在项目目录树之外。

使用 RemoraFish 的三种方式

捆绑的 UI 有意设计为参考应用，而非框架边界。智能体、API 客户端、自定义前端和产品分支都使用相同的无头运行时。

Related MCP server: codex-web-bridge

快速开始

1. 安装

git clone https://github.com/howdeploy/remorafish.git
cd remorafish
uv sync --extra dev

2. 连接编码智能体

编码智能体应首先阅读 AGENTS.md。如果智能体需要跨会话持续获取 RemoraFish 项目上下文，请安装并配置 choirboy-prompt 作为可选的指令传输。将其捆绑的演示资料替换为 RemoraFish 项目指南；请勿原样使用演示传记。

3. 启动智能体控制平面

推荐的工作流程是让本地编码智能体通过独立的 Admin MCP 编排账户设置。RemoraFish 本身会扫描用户的浏览器，将原始凭据排除在智能体上下文之外，返回掩码候选，并且只导入明确确认的选择：

uv run remorafish admin-mcp \
  --allow-browser-scan \
  --allow-account-mutations

直接使用 CLI 和参考 UI

CLI 和参考 UI 仍可直接操作：

# Browsers may stay open. Scan live snapshots, validate, and save valid accounts.
uv run remorafish accounts scan --browser all --check --save --yes

# Or choose several browsers and get agent-friendly JSON.
uv run remorafish accounts scan -b brave -b firefox --check --json

uv run remorafish serve

服务器默认监听 http://127.0.0.1:8787。打开 设置 → 账户 可添加任意数量的提供商账户，并支持按账户配置代理。RemoraFish 可以打开隔离的本地浏览器，提交存储的登录名/密码，等待 MFA 或验证码，捕获生成的运行时令牌，并在无需重启的情况下将账户添加到实时路由池。

curl http://127.0.0.1:8787/v1/responses \
  -H 'Content-Type: application/json' \
  -d '{"model":"deepseek/chat","input":"Hello"}'

# MCP over stdio
uv run remorafish mcp

智能体可以通过 web_chat 附加本地文件。调用必须包含 attachments: [{"path":"./report.pdf"}] 和显式的 confirm_file_access: true；RemoraFish 会验证路径和限制，通过所选提供商的原生 ChatGPT、DeepSeek、Kimi 或 Grok Web 流程上传字节，并将本地路径排除在提供商适配器之外。HTTP 客户端可以使用内联 base64 图像/文件部分。参见 HTTP API 和 MCP。

可用功能

浏览器导入支持 Linux、macOS 和 Windows 上的 Chrome、Chromium、Edge、Brave、Vivaldi、Opera、Firefox 和 LibreWolf。原始密钥在终端和 JSON 输出中会被掩码；保存的凭据存储在 ~/.remorafish/accounts.json，权限为 0600。登录名/密码和经过身份验证的代理 URL 单独存储在加密的 ~/.remorafish/account_vault.json 中；其本地密钥和持久登录配置文件也使用仅所有者权限。

ChatGPT 以 chatgpt/auto 形式暴露；chatgpt/auto-search 启用 Web 搜索功能。可通过 设置 → 账户 → ChatGPT 使用访问令牌、导入现有浏览器会话或交互式浏览器登录进行连接。ChatGPT Web 协议包含不断变化的反机器人层，因此上游前端更改后仍需进行实时账户冒烟测试。

文档

• 系统工作原理

• 提供商框架和正式契约

• 智能体优先的账户控制平面

• 参考 UI 边界

• 浏览器凭据提取

• 多账户管理和路由

• OpenAI、Anthropic 和 MCP 接口

• 测试真实 Web 订阅

• 原始设计契约 和 协议研究

开发

uv run pytest -q
uv run remorafish providers check

官方 Agentation 工具栏以仅限 localhost 的 React 岛形式捆绑，以便主 Web UI 保持无框架。依赖更改后重新构建：

npm install
npm run build:agentation

Agent Sync 使用 http://localhost:4747。将其 MCP 服务器注册到 Codex：

codex mcp add agentation -- npx -y agentation-mcp server

更改 MCP 配置后重启 Codex。RemoraFish 源码采用 MIT 许可。捆绑的 Agentation 组件仍受 PolyForm Shield 1.0.0 保护；其必需声明以 remorafish/webui/agentation.LICENSE.txt 形式提供。协议实现归属和所有许可边界参见第三方声明。