English · 简体中文
Faber,取自拉丁文“工匠”。让 AI 不止于对话,而是完成实际工作。
首次使用请看 Faber 使用教程,可按步骤连接 ChatGPT 或 Claude、配置电脑控制,以及添加 MCP 服务和 Skill。
让网页 AI 通过 MCP 调用本地工具:网页 AI 负责思考,Pi Agent 负责本地执行。 本软件不运行本地模型。
- 文件与命令:读写工作目录内的文件,按权限策略执行 Shell 命令。
- 能力扩展:添加 MCP 服务和 Skills,接入 Pi 插件体系。
- 公网连接:通过 Cloudflare Tunnel 等网络方案连接网页 MCP 客户端,并提供 OAuth 认证和工具审批。
打开软件只加载配置;点击「启动」后才运行 MCP 和隧道。
- 网页 AI,本地执行:通过 MCP 将网页 AI 的推理能力与本地文件、命令和工具连接起来,无需部署本地模型。
- Computer Use 电脑控制:内置桌面与浏览器操作能力,在启用功能并授予所需系统权限后,让 AI 操作电脑。
- 灵活扩展能力:管理 MCP 服务、Skills 和 Pi 插件,为不同任务组合所需工具。
- 多种连接方案:支持 Cloudflare Tunnel、ngrok、FRP 和 Tailscale Funnel,通过 OAuth 授权连接兼容的网页 MCP 客户端。
- 操作权限可控:按需选择逐次审批、自动批准文件修改或完全访问模式;启动、停止由用户控制,并可查看运行状态和日志。
- 开箱即用,双语界面:提供 macOS 与 Windows 安装包,内置运行依赖;支持中英文切换、自动检查更新和手动确认安装。
前往 GitHub Releases,下载适合自己电脑的安装包:
| 平台 | 下载与安装 |
|---|---|
| macOS · Apple Silicon(M 系列) | 下载 aarch64.dmg,打开后将应用拖入「应用程序」 |
| macOS · Intel | 下载 x64.dmg,打开后将应用拖入「应用程序」 |
| Windows · x64 | 下载 *-setup.exe 或 .msi,运行安装程序 |
无需另装 Node.js、Rust 或 Python;Cloudflare 客户端已内置。Linux 桌面版暂不支持。
首次使用:
- 打开应用,配置工作目录、OAuth 密码和网络方案,保存后点击「启动」。
- 将显示的 MCP 地址添加到支持 CIMD OAuth 的网页 MCP 客户端,完成授权。
点击「启动」时,Faber 会在所选工作目录下创建或复用 .faber/。项目内的 Pi 数据目录为 .faber/pi/,项目记忆保存在 .faber/memory.jsonl。应用设置和凭据仍由原有本机配置管理。
「自动项目记忆」默认开启。Faber 会引导网页 AI 主动查找以前的项目约定、决定和接续事项,并保存已确认、以后有用的短摘要。记忆工具只访问当前项目。可以停止 Runtime 后在设置中关闭或重新开启这一功能,关闭会保留已有记忆。网页客户端是否采纳指引,以及是否需要确认工具调用,取决于客户端本身。
macOS 安装包使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。若系统阻止打开,请先确认下载来源,再按系统提示允许运行。
应用会自动检查更新,确认安装在「关于」页面操作。.app.tar.gz、latest.json 和校验文件用于更新或校验,不是首次安装入口。
「关于」页面还会显示当前实际使用的 Cloudflare Tunnel(cloudflared)版本,并可单独检查、安装官方正式版更新。更新前需停止 Runtime 与隧道;下载文件通过官方 SHA-256 和版本检查后才启用,下次启动隧道生效,无需重启应用。独立更新保存在运行配置旁的 components/cloudflared/ 目录,不改写已签名的应用包;下载或验证失败时继续保留原组件。自定义隧道程序路径需自行更新。
让 AI 不只读写文件,还能通过内置 Computer Use 操作桌面与浏览器。
- 停止 Runtime,在「插件」页面启用 Computer Use。
- macOS 用户点击「设置权限」,按提示授予辅助功能和屏幕录制权限,再点击「重新检测」确认状态;Windows 用户需在可交互的桌面会话中使用。
- 如需浏览器通道,展开「浏览器连接」,选择「使用当前浏览器(推荐)」及 Chrome / Edge,点击「准备浏览器扩展」,按界面说明加载解压扩展,扩展安装后自动连接,再保存配置即可。浏览器启动与意外断线后自动重连,工具栏扩展可查看状态和失败原因。此模式复用当前浏览器和登录状态,在目标标签页内后台操作,不移动系统鼠标或抢占其他窗口;浏览器原生提示及持续光标标明控制状态,扩展可随时停止或断开。首次加载需要手动操作,扩展尚未上架商店。
- 网站默认开放;需要限制时再开启「限制允许的网站」并填写名单。原有托管独立窗口与 CDP 模式继续可选;已保存的旧配置保持原模式。托管窗口使用应用私有目录保存独立登录态,保存配置或启动 Runtime 不会打开浏览器。
- 启动 Runtime 后,通过已授权的 MCP 客户端调用相关工具;控制动作受当前权限审批策略约束。
启用 Computer Use 不会自动启动 Runtime 或隧道。修改开关或浏览器配置前,需要先停止 Runtime。
停止 Runtime,在「插件 → Skills → 添加 Skill」选择本地目录或 SKILL.md,点击「扫描目录」,勾选后批量添加。每份文档会生成独立配置:ID 默认取文件夹名,Skill 名称保留文档中的 name,每项可单独启停或移除引用。无需为根目录手填一个统一的来源 ID。
重复文件(含已停用配置)会跳过,同名 Skill 冲突会在预览中标出;兼容性警告不会阻止其他文档导入。已有的整目录来源可以点击「拆分目录」,预览并确认后替换为所选的独立配置;取消不会改变原配置。导入只保存文件引用,不复制、删除或执行原文件,也不会自动加载未配置的全局目录。
在「插件 → 添加 MCP」填写名称、传输方式和服务地址,再按服务说明选择认证:无认证、Bearer Token、API Key 或 OAuth。API Key 可指定请求头名称,额外 Header 使用名称/值表格填写;地址和手填密钥均明文显示,保存后可重新编辑。连接 ID 自动生成,已有引用和 JSON 配置仍可在高级配置中使用。
远程服务支持 Streamable HTTP 和旧版 HTTP + SSE;本地 stdio 服务填写可执行程序、独立参数行及环境变量名称/值,无需提前设置系统环境变量。程序字段不接受整条 shell 命令。
「测试连接」使用当前草稿及凭据,仅连接并列出工具,不要求先保存,也不会执行业务工具或启动隧道。配置和凭据全部保存成功后才会显示保存成功;运行中的 Runtime 需要先停止再编辑或测试。
OAuth 优先使用用户提供的预注册客户端;支持服务声明的 CIMD 和允许的动态客户端注册(DCR),以及 none、client_secret_basic、client_secret_post。客户端详情可填写 Client ID、Client Secret、授权范围和固定本机回调地址;未填写回调时自动分配本机端口。CIMD 文档仍需提供与文档一致的固定回调。授权失败会显示发现/注册、回调或 Token 交换阶段;服务商拒绝注册时需按该服务的要求配置客户端,不保证所有服务都接受自动注册。
手填凭据继续由本机凭据库管理,不会作为工具参数或日志输出。关闭「在本机保存」后,凭据仅保留在当前进程;清除后保存会删除对应值,取消编辑会保留原值。
插件中的参数、地址和手填密钥使用明文;Runtime 的网络令牌和 OAuth 密码默认隐藏,可用眼睛按钮切换显隐。两处共用表单和输入框组件。
外部 MCP 意外断开后会撤销该服务的工具并按 1、2、4、8、16 秒的间隔尝试重连,最多 5 次。工具不会自动重放;也可直接点击「连接服务」,无需重启整个 Runtime。暂停单个服务或停止 Runtime 会取消待执行的重连。内置 Computer Use 不自动重启。子进程退出码、信号、无效 stdout 和过大响应会在状态及运行日志中给出诊断;stdio 单条响应沿用 SDK 的 10 MiB 上限,超过时应缩小请求范围。
capabilities_search 使用自然语言查找能力,默认同时搜索已配置的 MCP 服务和当前加载、允许模型调用的 Skill,例如:
{"query":"读取 Figma 设计稿并生成 Vue 页面"}也可用 kind: "mcp" 或 kind: "skill" 筛选。省略 query 可浏览目录;limit 默认 10,最多 25,使用返回的 next_cursor 继续同一查询。目录变化后旧游标失效,需要重新搜索。
结果包含类型化内部 ID、描述、实时连接状态、可用性、目录修订号和检查时间。Skill 命中会给出准确的 skills_read 参数;在线 MCP 会提供实际注册的原始工具名。离线工具描述仅作为明确标记的缓存用于匹配,不提供业务调用指引。启用且已授权的按需服务会返回 mcp_connect 及准确 ID;未授权、已停用或用户暂停的服务会提示在 Faber 处理。内部 ID 区分同名 MCP 和 Skill,不要求用户或 AI 预先知道 ID。
搜索只使用名称、描述和已发现的工具用途,辅以本地中英文分词及别名匹配,不依赖额外模型或联网服务;不扫描未导入的 Skill、不返回完整正文,也不索引密钥、地址、环境变量、启动参数或本地路径。disable-model-invocation 的 Skill 不提供给 AI。
服务器说明和工具描述会引导 AI 在首次使用能力前查询、先读取 Skill,并在目录变化或工具失效时重新发现。真正执行时仍校验当前注册表并沿用审批;搜索不会启动进程、执行工具或授予权限。
新建外部 MCP 默认「按需启动」,旧配置保持「随 Runtime 启动」。按需服务在 Runtime 启动时不连接,搜索也不会连接;AI 根据搜索结果调用 mcp_connect({"id":"mcp:服务ID"}) 后,才握手并发现工具。连接会复用,并发请求共享初始化。可填写「用途说明」,让首次连接前也能按任务找到服务;成功测试或连接后,工具摘要会缓存在配置旁的 .mcp-catalog.json 文件,应用重启后仍可搜索。缓存绑定连接身份,不保存凭据、完整参数定义或配置中的地址和启动参数;更改连接配置会使旧目录失效。
连接成功会保留原始工具名并发送工具列表变更通知。支持刷新工具的客户端可直接调用原始工具;无法刷新工具列表的客户端可使用固定入口 mcp_call,传入 mcp_connect 返回的服务 ID、原始工具名、schema_revision 和业务 arguments。统一入口仍校验实时归属、参数及定义版本,并按真实目标工具审批。它不会自动连接服务或重试业务调用。
Runtime 运行时可在插件页面连接、暂停或恢复单个外部 MCP,也可由 AI 调用 mcp_disconnect 暂停。暂停会立即撤销工具、关闭连接并取消重连;AI 不能自行恢复用户暂停的服务,需在 Faber 点击「恢复连接」。暂停只作用于本轮 Runtime,完整停止再启动后重新应用配置的启动方式。Skill 沿用摘要搜索与按需读取,内置 Computer Use 保持既有启动及权限流程。
外接 MCP 工具直接保留源服务的原始名称,例如 computer_act、lanhu_get_design_overview,不附加服务前缀、截断名称或添加哈希后缀。不同来源(包括内置工具)的名称必须唯一;重名时会明确报错,不覆盖其他工具。
从旧版本更新后,停止并重新启动 Runtime,再在 MCP 客户端刷新工具列表或重新连接现有插件。服务器 URL、OAuth 授权和外接工具本身无需修改;客户端中按旧工具名编写的固定调用需要改用原名。
默认使用中文。在侧边栏菜单下方的「界面语言」下拉框中选择 English,即可切换英文界面;选择会在本机记住。切换语言不会启动、停止 Runtime,也不会修改工作目录、密钥或权限设置。
语言切换仅影响界面文案;日志输出、第三方返回内容和用户填写的数据保留原文。
Faber 不再提供应用内 HTTP 代理、代理探活或授权连接测试设置。隧道、授权元数据和公网探活均使用各自的默认网络路径;实际出口由系统路由及用户的代理软件规则决定。仅打开系统 HTTP 代理不保证 cloudflared 或 Node.js 请求会进入代理;开启 TUN 时需在代理软件中配置相应分流与 DNS 规则。
启动失败提示会显示失败阶段。Cloudflare 建连失败时,可区分凭据认证、Fake-IP、DNS、证书验证、TLS 握手与连通性异常;HTTP/2 使用 TCP 7844,QUIC 使用 UDP 7844。请按日志检查所选协议和对应出口路径,不应只因单条 TCP/UDP 预检查失败就判断两种协议都不可用。
“隧道已连接,但公网服务验证失败”表示已进入后续验证阶段,需检查公网域名、源站转发地址与端口、访问策略或是否存在旧服务实例。详细原因保留在运行日志中。单次探活期限仍为 10 秒,运行中检查周期仍为 30 秒。
旧配置中的 outbound_proxy、health_route 及对应环境变量不再生效;下次保存时清除旧字段。External URL 方案仍已移除,旧配置加载为尚未启动的 Cloudflare 快速隧道草稿,清空原公网 URL 与方案专属参数;保存前不改写原配置文件。公网隧道仍需 OAuth 密码或静态令牌。
scripts/:构建、打包、发布及发行校验工具。diagnostics/:手动排障采样脚本。tests/:自动化测试,仅在本地保存,已被 Git 忽略;测试结果及取证数据也不提交。
npm run check 执行类型检查、前端构建和分发边界校验,不依赖本地测试文件。保有本地测试目录的开发机可运行 npm run test:local;该命令先构建服务再执行本地测试,新克隆的仓库不附带测试目录。CI 保留构建、发行来源、签名、分发边界与漏洞审计,不执行仅本地保存的测试。
根目录与 apps/daemon 同步固定 Computer Use 的版本,以保证 npm 对 workspace 依赖应用 Zod 安全覆盖规则。升级该包时需同步两处版本;发行边界校验会检查它们是否一致。
当前构建入口、CI 触发方式及必须保留的校验文件见 构建与发行校验。
Windows 无响应时,可在 Windows 上手动运行 powershell -NoProfile -File .\diagnostics\diagnose-windows-freeze.ps1 -DurationSeconds 1800。采样写入 .local/diagnostics/,不执行桌面输入、截图、终止进程或上传;采样本身不代表已经定位故障原因。