Repository navigation
Releases
Releases · HideInMatrix/Faber
Faber v1.8.1
Faber v1.8.1
工具名称变更
- 外接 MCP 工具直接使用源服务的完整原名,例如 computer_act、lanhu_get_design_overview,不再附加 mcp__服务ID__ 前缀、截断名称或追加哈希后缀。
- 工具原名未变化时,重新连接、刷新或重启 Runtime 后名称保持一致。工具参数、执行逻辑、源服务配置和 OAuth 授权无需修改。
- 不同来源的工具必须保持名称唯一。启动时重名会明确报告工具名和两个来源;运行中刷新发生冲突时撤销该服务工具,保留其他来源,避免覆盖或错误路由。
升级后操作
- 安装更新后重启 Runtime,并在 MCP 客户端刷新工具列表或重新连接现有插件。
- 旧的带前缀和哈希名称不再注册;固定脚本、提示词或调用若写死了旧工具名,需改用工具原名。服务器 URL、登录授权及外接工具本身不需要变更。
验证
- 类型检查、前端和服务构建、包来源及发行边界校验通过,依赖安全审计为 0 漏洞。
- 22 项相关本地测试通过,覆盖真实 SDK/Pi 的原名注册与转发、完整长名称、错误/图片/结构化结果保留、跨来源重名、动态刷新撤销、重启名称一致以及相邻权限与 Skills 回归。测试仅保留本地。
- 验证使用隔离的内存 MCP 服务,未连接用户外接服务、启动实际隧道或执行桌面输入。三平台安装包与更新签名由版本标签 CI 生成并校验。
兼容与已知限制
- 继续固定 Computer Use 0.9.0 与既有原生资源、RDP 运行时和签名策略。本次仅调整 Faber 的 MCP 注册名称,不修改电脑控制组件的执行行为。
- 沿用已有 Blender 中文输入法下未修饰 B 快捷键的兼容性限制;本次不涉及该问题。Windows/Intel 真实 GUI 的既有验收限制仍保留,构建和签名检查不代表实机操作验收。
- 保持应用标识、更新公钥和长期 macOS 签名证书兼容。macOS 13 或更高版本,未经过 Apple 公证;Windows x64 安装包未做 Authenticode 签名。
Faber v1.8.0
Faber v1.8.0
通用电脑控制
- Computer Use 精确依赖升级至 0.9.0,MCP 保持 12 个工具、原生协议保持 3。Faber 负责接入与生产签名,不新增第二套桌面执行器。
- Windows 使用本机 FreeRDP peer/client,安装包携带审核过的 RDP DLL 和 FreeRDP/OpenSSL/zlib 许可证;Mac 使用真实 TLS/RFB 本机 VNC 连接解码像素和传递输入。不会启用系统远程桌面/屏幕共享或创建新登录会话,也不提供应用原始绘图指令或自动文字识别。
- 统一 desktop.window(...) JavaScript 接口,保留 AX/UIA 语义观察。输入仍需显式选择目标,并检查前台、窗口焦点、真实接收窗口和安全内容。
- macOS 文字输入可显式选择临时 ASCII 输入源并检查恢复原输入法,默认不切换;无剪贴板替代、自动回退或输入重放。进程被强杀或恢复未确认时可能需要手动恢复输入法。
- 修复 Unicode 字母按下/释放配对及拖拽时限,提示层不再随捕获/命中检测反复隐藏、刷新不重复置顶;Dev 验收包独立命名与旧包清理,生产应用及授权不在清理范围内。
验证与已知限制
- 组件 236 项 Node 回归、104 项原生自检、3 轮每轮 236 项 TLS/RFB 合成检查通过。Computer Use 0.9.0 的三平台标签构建、同一 tgz 打包及安装门禁均已通过并发布;原始制品与 registry 字节/完整性一致,三个平台从 registry 安装复核通过。Faber 本地 check、服务构建、29 项诊断回归及依赖漏洞检查通过(0 漏洞)。
- Mac ARM64 七组实机总验收通过。Blender 中文/emoji 弹窗确认/取消、内置菜单框选、拖拽精确选择及释放后的单击通过;另验证 SCIM → US → SCIM 的恢复及已有 ASCII 不切换路径,提示层自有窗口自检 15 项通过。
- Blender 5.2.1 恢复中文输入法后,未修饰 B 快捷键仍有 IME 兼容性失败;明确走 Select 菜单的完整流程通过,不代表该快捷键已修复。Windows/Intel 真实 GUI 尚未验收,编译、合成、安装或签名检查不代表实机部署通过。
- 安装包、签名更新、版本与校验和由三平台标签 CI 生成并校验,不从局部构建手动发布。
更新与使用
升级前停止 Runtime,安装后重新启动。浏览器扩展需重新准备并在扩展管理页重新加载,以同步 0.9.0 资源;已有连接方式、登录状态及网站策略保持兼容。
沿用既有应用标识、更新公钥和固定长期 macOS 签名证书;macOS 13 或更高版本,未经过 Apple 公证;Windows x64 安装包未做 Authenticode 签名。若系统要求权限,应授权实际安装的正式 helper,不要混用旧 Dev 验收 app。
Faber v1.7.0
Faber v1.7.0
自动连接与对话恢复
- 浏览器扩展安装、更新及浏览器启动后自动连接 Faber;意外断线后退避重连,无需每次打开扩展点击连接。
- 扩展弹窗及工具栏显示连接状态,失败时提示未准备本地桥接、启动失败、超时、策略拒绝或其他浏览器资料占用,并显示自动重试时间。Faber 设置页同步显示可用的状态原因。
- 移除浏览器“继续”按钮。用户主动停止、取消调试或接管目标页后,工具向 AI 返回“用户已停止控制”;AI 必须停止操作,等待用户在对话中说继续,再调用会话恢复并重新读取页面和核验业务状态。
- 恢复需要当前停止标识,旧标识无效;运行中的脚本不能解除停止。自动重连不重放旧输入。主动断开并停用自动连接的选择跨浏览器重启保留。
- Computer Use 升级至 0.8.1,MCP 保持 12 个工具,原生协议保持 3;computer_session 新增对话恢复操作,因此该工具不再标记只读。是否收到新的对话指令由连接的 AI 客户端判断,宿主不读取聊天记录。
更新与使用
升级后停止 Runtime,在 Computer Use 的浏览器连接中重新点击“准备浏览器扩展”,再在浏览器扩展管理页重新加载 Faber 扩展;新增 storage / alarms 权限用于本机连接状态与后台重试。首次安装仍需手动加载解压扩展,加载后自动连接。
已保存的浏览器连接方式、登录状态及默认开放的网站策略保持兼容。主动停止后只需在 AI 对话中说“继续”,无需操作浏览器恢复按钮。
验证
- 组件 163 项 Node 回归、8 项 CLI/library/MCP/WASM smoke 和 101 项本机 macOS 原生自检通过。
- 隔离 Chrome for Testing 验证自动连接、当前测试宿主意外退出后的自动重连、后台填写/点击、业务计数不重复、用户输入停止、对话恢复、旧页面保护及无弹窗错误。
- Faber 类型检查、编译包边界、服务构建与 122 项回归通过;三平台安装包与更新文件由标签 CI 生成并校验。
- Windows / Edge 及 macOS Intel 未新增本地 GUI 实机验收。
兼容与安装
- 保持应用配置、Bundle ID 和更新签名兼容;内置 cloudflared 2026.10.7。
- macOS 13 或更高版本;Windows x64。macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
Faber v1.6.0
Faber v1.6.0
更新内容
- 浏览器连接新增“使用当前浏览器(推荐)”。通过 Faber 扩展连接已打开的 Chrome / Edge,复用现有标签页和登录状态,无需调试端口或重新启动浏览器。
- 网页动作在指定标签页内执行,不移动系统鼠标、不主动抢占其他窗口;新标签页在后台创建,只允许关闭本任务创建的页面。原有托管独立窗口和 CDP 连接继续可用。
- 浏览器采用约 24 CSS px 的黑色圆角光标、白描边和轻阴影,整个会话持续显示。动画不再阻塞输入,移除一次重复状态采集,同时保留动作前校验及独立后置状态。
- 修复已加载标签页的偶发等待超时;操作已发送而结果未确认时明确要求重新核验,避免重复输入。停止时优先释放调试器,无响应页面不会阻塞控制权释放。
- 扩展支持连接、停止、继续和断开;用户取消调试或操作目标页后暂停,需要显式继续。会话退出断开调试器、清理光标并保留用户原有页面。
- Computer Use 同步升级至 0.7.1,包含三平台原生助手、编译后的扩展资源和受认证的本地消息桥接;MCP 保持 12 个工具,原生协议保持 3。网站限制默认关闭,只有主动开启后才校验名单。
首次安装浏览器扩展
- 在 Faber 的 Computer Use → 浏览器连接选择“使用当前浏览器(推荐)”,选择 Chrome 或 Edge,点击“准备浏览器扩展”。
- 按界面给出的地址进入浏览器扩展管理页,开启开发者模式,加载已解压的扩展,选择 Faber 显示的扩展目录。
- 打开浏览器工具栏中的 Faber 扩展,点击“连接 Faber”,再保存 Faber 中的浏览器连接。
解压扩展尚未上架浏览器扩展商店,首次需要手动加载;后续更新扩展资源后需要重新加载。旧浏览器配置按原模式保留,可在设置中切换。同种浏览器一次连接一个个人资料。
验证
- 组件 157 项 Node 回归、8 项包 smoke 和 101 项本机 macOS 原生自检通过。
- macOS ARM64 的隔离 Chrome for Testing 实际加载扩展,验证 Native Messaging、后台填写与点击、业务结果、保持当前用户标签页、持续光标、输入暂停、手动恢复、原有页面保护和断开重连。
- Faber 122 项 Node 回归与类型检查通过,服务包构建成功。
- Faber 打包后的服务入口通过真实 Native Messaging 全链路测试,桌面资源包含精确版本的 5 个扩展运行文件。
- Faber 真实 Vue 设置页验证默认扩展入口、安装说明、连接状态、Edge 选择、网站限制、刷新恢复及旧模式切换;无新增浏览器错误。
- 三平台安装包、应用签名和更新文件由版本标签 CI 构建与校验。Windows/Edge 及 macOS x64 未做本地 GUI 实机验收;系统弹窗、受限网页与同页并行输入仍受浏览器限制。
兼容与安装
- 保持应用配置、Bundle ID 和更新签名兼容,继续使用内置 cloudflared 2026.10.7 及其独立更新入口。
- macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.5.0
Faber v1.5.0
更新内容
- 浏览器默认可访问任意 HTTP/HTTPS 网站,无需填写允许的网站。设置页新增默认关闭的“限制可访问的网站”开关,开启后才要求填写并校验网站名单;托管窗口和附加 CDP 两种连接方式一致。
- 未填写起始地址或网站时,可直接保存托管浏览器配置,首次使用打开独立空白标签页,由 AI 决定访问地址。
- Computer Use 升级至 0.6.0,同步三平台原生助手、依赖锁文件及发行校验。集成选定的 B 款圆角蓝紫色光标,整个电脑控制会话持续显示,AI 结束使用或连接关闭时清理。
- 点击链接或按键触发页面跳转后等待文档加载,再读取新状态;新增 computer_session 工具管理会话结束,MCP 共 12 个工具,原生协议保持 3。
验证
- 前后端类型检查、真实 Vue 表单和隔离 Chrome 跨站访问测试通过;包含默认空名单保存、开启后的空名单拒绝、设置持久化、关闭限制、跨站链接与重定向。
- Faber 完整 118 项本地测试、前后端类型检查、前端和服务构建、源码及发行边界校验通过,依赖审计为 0 漏洞;MCP 集成验证实际 12 个工具与组件版本。
- 组件本地 149 项 Node 检查、101 项 macOS 原生自检及 7 项包 smoke 检查通过。
- 三平台编译、安装包与更新签名由标签 CI 验证;Windows 及 macOS x64 未进行本地实机操作验证。
兼容与安装
- 旧浏览器配置未设置新开关时默认开放网站访问;需要限制时在设置页主动开启并保存名单。
- 保持应用配置、Bundle ID 和更新签名兼容,继续使用内置 cloudflared 2026.10.7 及其独立更新入口。
- macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.4.1
Faber v1.4.1
更新内容
- Computer Use 升级至 0.5.2,同步更新 macOS ARM64、macOS x64 和 Windows x64 原生助手,以及依赖锁文件和发行包校验。
- 集成该版本的浏览器 DOM 操作反馈、可见的验证与结果状态、macOS/浏览器结果显示时长调整,以及 macOS 局部像素新鲜度检查。
- 保持现有 11 个 MCP 工具和原生协议 3,沿用 Faber 的审批流程、系统权限及原生助手签名身份。
验证
- 类型检查、前端与服务构建、包来源及发行边界校验通过;115 项本地测试通过,依赖安全审计为 0 漏洞。
- JS/MCP 集成验证通过,覆盖 JSON 文档观察、只读约束、QuickJS 批处理运行时和 Playwright 资源加载;自动化测试仅保留本地。
- 本机 macOS 原生助手经标准私有 IPC 握手验证为组件 0.5.2、协议 3,并包含 control_feedback_v2、pointer_region_guard_v1;未执行桌面输入或请求系统权限。
- 三平台安装包与发行签名由版本标签 CI 构建和验证,Windows 及 macOS x64 未进行本地实机操作验证。
兼容与安装
- 保持应用配置、Bundle ID 和更新签名兼容,继续使用内置 cloudflared 2026.10.7 及其独立更新入口。
- macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.4.0
Faber v1.4.0
更新内容
- Computer Use 升级至 0.5.0,同步更新 macOS ARM64、macOS x64 和 Windows x64 原生助手。桌面操作新增 AI 光标、点击波纹、目标窗口边框和控制标记;继续保留现有审批和系统权限边界。
- 内置 Cloudflare Tunnel(cloudflared)升级至 2026.10.7。
- 「关于」页面显示当前实际使用的 cloudflared 版本,新增检查更新和独立更新按钮,支持中英文显示、更新状态、失败提示和重试。
- cloudflared 独立更新仅使用 Cloudflare 官方 GitHub 正式版资源,按平台选择文件,验证官方 SHA-256、文件大小和可执行文件版本后才启用。更新保存在运行配置旁的 components/cloudflared/ 目录,不改写已签名的应用包。
- 运行中的 Runtime 或隧道禁止替换 cloudflared;成功更新在下次启动隧道时生效,无需重启应用。下载或验证失败保留原组件;未来应用内置版本更高时优先使用新内置版本。自定义隧道程序路径需自行更新。
- 固定 minimatch 11.0.4,修复 GHSA-g3hv-75wg-m249 模式膨胀拒绝服务漏洞,消除其自身及上层 Pi 依赖的两条关联审计报告。
验证
- 类型检查、前端与服务构建、包来源和发行边界校验通过;依赖安全审计为 0 漏洞。
- 115 项本地测试通过,包含 cloudflared 更新校验、失败保留、平台资源、生命周期和模式膨胀限额检查;1,088 组文件和模型匹配兼容性用例与旧版结果一致。自动化测试和截图仅保留本地。
- 在隔离目录实测从官方源下载、校验并启用 cloudflared 2026.10.7,未启动实际隧道或修改用户配置。浏览器夹具验证了版本显示、运行中禁用、失败重试及中英文显示。
- Computer Use JS/MCP 集成通过;本机 macOS 原生助手握手验证为组件 0.5.0、协议 3,并包含 control_feedback_v1。未执行桌面输入;Windows 和 macOS x64 安装包由版本标签 CI 构建和验证。
兼容与安装
- 保留主分支已有的 OAuth 异常 DNS 恢复修复;不恢复应用内 HTTP 代理配置。独立更新仍要求能够访问 GitHub 官方 API 和下载源。
- 保持应用配置、Bundle ID 和更新签名的兼容性。macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.3.2
Faber v1.3.2
更新内容
- 修复 OAuth CIMD 客户端发现被本机异常 DNS 响应阻断的问题:域名解析为空、返回私网/保留地址,或 A/AAAA 混合异常时,通过固定公共 DoH 服务重新解析,不再仅为已识别的 fake-IP 提供恢复路径。
- 仅连接重新校验后的公网地址,固定连接目标并保留原始 Host/SNI 和 TLS 证书验证;继续拒绝私网 IP 字面量、非公网 DoH 结果及未验证的目标,不放宽 SSRF 防护。
- 公共 DNS 重查失败时返回暂时不可用,错误信息包含元数据域名和有限的本地 DNS 结果,便于定位 DNS、代理/TUN 路由及 DoH 连通性问题。
- 本次发布不包含另行保存的 UI 布局改动,不恢复应用内代理配置,也不更改现有系统路由选择。
验证
- 干净依赖安装、完整
npm run check、前端与服务构建、包来源及发行边界校验通过;依赖安全审计为 0 漏洞。 - 29 项本地 CIMD 回归测试通过,覆盖 fake-IP、混合 A/AAAA、无解析结果、私网地址拒绝、DoH 失败、取消和 HTTPS 目标固定。自动化测试仅保留本地。
- 独立诊断进程模拟本地 DNS 返回
0.0.0.0和::,经真实 DoH 与正常 TLS 成功读取 ChatGPT 客户端元数据,未修改系统 DNS 或完成 OAuth 授权。 - 三平台桌面安装包及发行签名由版本标签 CI 构建和验证。
兼容与安装
- 保持应用配置、Bundle ID 和更新签名的兼容性。macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- 异常 DNS 的恢复仍要求能够通过系统网络访问
cloudflare-dns.com(固定公网引导地址1.1.1.1)及客户端元数据站点;本次更新不保证受限网络自动恢复。 - macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.3.1
Faber v1.3.1
更新内容
- 移除应用内 HTTP 代理、代理探活连接方式和授权连接测试入口,同步删除对应 API 与 CONNECT 转发实现。网络出口由系统路由及用户代理软件的规则决定。
- 兼容已有配置:旧
outbound_proxy、health_route及对应环境变量不再生效,下次保存时清除旧字段;保留其他隧道参数和凭据。 - 启动失败提示显示失败阶段,区分配置检查、隧道程序检查、MCP 工具加载、本地 MCP 服务启动、隧道建连和公网验证。
- Cloudflare 错误区分凭据认证、Fake-IP、DNS、证书验证、TLS 握手与连通性异常,并给出协议及代理/TUN 分流检查建议。按当前协议分析 TCP/UDP 预检查,避免将单条失败笼统判断为全部不可达。
- 公网验证保留错误证据,分别提示域名指向其他实例、HTTP 异常、错误页面或登录页、无效 JSON、网络失败及超时;启动等待期限不再覆盖先前检测到的具体原因。
- 页面分行展示启动失败原因和处理建议,并在运行日志中记录失败阶段。
验证
- 类型检查、前端与服务构建、包来源及编译产物边界校验通过。
- 105 项本地测试通过,覆盖旧配置清理、代理入口移除、Cloudflare 分类诊断、公网验证证据、取消与超时、MCP 集成等路径。测试与截图仅保留本地。
- 实际 Runtime 启动夹具验证了失败阶段、页面错误与日志记录一致;浏览器验证了代理控件移除及新版提示显示,未启动实际隧道或执行桌面输入。
- 依赖安全审计为 0 漏洞。继续固定 Computer Use 0.4.1、Undici 8.12.2 和 Zod 4.6.7。
- 三平台桌面安装包及发行签名由版本标签 CI 构建和验证。
兼容与安装
- 公网探活仍核对服务实例身份,单次期限保持 10 秒,运行中检查周期保持 30 秒。External URL 方案继续保持移除。
- 仅打开系统 HTTP 代理不保证 cloudflared 或 Node.js 请求会进入代理;使用 TUN 时,请在代理软件中配置适合当前网络的分流及 DNS 规则。本次更新改善诊断,不保证受限网络的隧道自动恢复。
- 保持应用配置、Bundle ID 和更新签名的兼容性。macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。
Faber v1.3.0
Faber v1.3.0
更新内容
- 新增所有隧道共用的出站 HTTP 代理设置,用于 OAuth 客户端元数据与经过校验的公共 DNS 查询,并提供独立的授权连接测试。
- 公网探活可选择直连或出站代理,继续核对服务实例身份;单次探活期限保持 10 秒,运行中检查周期保持 30 秒。
- 移除 External URL 方案。旧配置加载为尚未启动的 Cloudflare 快速隧道草稿,清空原公网地址与方案专属参数,保存前不改写原文件。
- Computer Use 编译包精确升级到
@hideinmatrix/computer-use@0.4.1,纳入组件的 Windows 资源管理、待处理操作数量与截图分配限制改进;保持 11 个 MCP 工具与原生 ABI 3。 - 更新 Undici、Zod 及其他受影响的间接依赖,清除此前 9 项依赖安全审计告警。
- Runtime 设置卡片铺满主内容区,修复宽窗口右侧大面积留白。
- 整理开发目录:构建与发布工具保留在
scripts/,手动排障工具放入diagnostics/,自动化测试与采集结果仅保留本地,不再提交。
验证
- 干净安装、类型检查、前端与服务打包、包来源及编译产物边界校验通过。
- 100 项本地测试通过,覆盖网络取消与超时、代理 CONNECT/TLS、公共地址校验、配置迁移、浏览器配置及权限显示。
- MCP 宿主集成验证通过:11 个工具、ABI 3、JSON 观察、QuickJS 与 Playwright 资源加载;验证过程不执行桌面输入。
- 依赖安全审计为 0 漏洞;Windows 原生交互与长时间运行仍需实机验证,不能将组件更新等同于已确认解决整机卡死反馈。
- 三平台桌面安装包及发行签名由版本标签 CI 构建和验证。
兼容与安装
- 保持应用配置、Bundle ID 和更新签名的兼容性。
- 已使用网络兼容启动脚本的用户,应退出旧实例并使用普通 Faber 入口,在 Runtime 内配置 HTTP 代理;当前不支持代理账号密码或 SOCKS URL。
- macOS 主应用要求 macOS 13 或更高版本;Windows 仅支持 x64。
- macOS 使用长期自签名证书,未经过 Apple 公证;Windows 安装包未进行 Authenticode 签名。
- Release 提供桌面安装包、更新归档、更新清单和校验文件。