Browy 中国开发者安装指南

这一页针对从中国大陆使用 Browy 的特殊情况补充安装指南。 Browy 本身在世界各地的行为完全一致，主要的麻烦来自从大陆访问 GitHub Releases 和 GitHub Copilot 的网络质量。

Browy 在中国能用吗？

能用，但有两个现实层面的注意点。

GitHub 访问

本地主机安装脚本从 GitHub Releases 拉取二进制。下载速度因运营商和时段不同。如果完全无法访问 release-assets.githubusercontent.com，可以用别的办法拿到发行文件（Windows 是 .zip，macOS 和 Linux 是 .tar.gz），再用这个文件安装（见下文）。

Copilot 访问

Browy 使用你自己的 GitHub Copilot 订阅。GitHub 的贸易管制页面没有把中国列入 Copilot 不能销售的地区。实际能不能用，要看你的网络。从大陆到 api.githubcopilot.com 的延迟比香港 / 新加坡高一些。

如果 GitHub 下载完全不可达

安装脚本没有可以指定镜像地址的设置，但可以直接用你手上已有的文件安装。需要的文件都在 GitHub 发行页面上：对应你系统的发行包，加上安装脚本。

系统	发行包	安装脚本
Windows（x64）	`Browy-<版本号>-win-x64.zip`	`install.ps1`
macOS（Apple 芯片）	`Browy-<版本号>-darwin-arm64.tar.gz`	`install.sh`
macOS（Intel 处理器）	`Browy-<版本号>-darwin-x64.tar.gz`	`install.sh`
Linux（x86_64）	`Browy-<版本号>-linux-x64.tar.gz`	`install.sh`
Linux（arm64）	`Browy-<版本号>-linux-arm64.tar.gz`	`install.sh`

最稳妥的做法是在一台能访问 GitHub 的机器上下载这两个文件，再拷贝过来。网上也有第三方的 GitHub 镜像和下载代理，但都不是我运营的，我也没法检查它们给你的文件，用不用风险自负。

把两个文件放进同一个文件夹，在那里运行安装脚本。下面的例子用的是 Downloads 文件夹和 0.1.13 版本，请换成你实际下载的版本和文件名。

Windows
macOS / Linux

cd $HOME\Downloads
$env:BROWY_LOCAL_ZIP = "$PWD\Browy-0.1.13-win-x64.zip"
Get-Content .\install.ps1 -Raw | iex

设置了 BROWY_LOCAL_ZIP 之后，脚本会跳过向 GitHub 查询版本这一步，直接用这个 zip 安装。

cd ~/Downloads
BROWY_VERSION=0.1.13 BROWY_LOCAL_TARBALL="$PWD/Browy-0.1.13-linux-x64.tar.gz" bash install.sh

BROWY_VERSION 也要一起设置。不设的话，脚本仍然会去 GitHub API 查询最新版本，查不到就直接退出。

延迟说明

Browy 在正常使用中会发起两类网络调用。

调用	端点	延迟来源
模型推理	`api.githubcopilot.com`	从你的机器到 GitHub Copilot 最近区域的往返时间。从大陆出去通常是一跳到太平洋，具体会多出多少延迟取决于你的网络。
工具执行	你的本地机器	没有网络。智能体直接在你眼前的页面上执行工具。

大多数提示词的耗时主要来自模型调用本身。连续触发三四次工具调用的对话会比从香港、新加坡或欧洲发起的稍微慢半拍，但智能体循环不会因为网络卡住而停下来。

源码镜像

我们目前没有维护源码的大陆镜像。 GitHub 主仓库在大陆通常可以正常浏览代码，即使 Releases 的 CDN 偶尔慢。如果一个大陆镜像对你的团队真的有用，欢迎提一个 issue告诉我们你打算具体用它来做什么。我们在跟踪这个需求。

哪些功能依赖外部服务

少数功能有硬性的外部依赖，能不能用的情况和任意其他用户一样。

Chrome Web Store 安装。 如果无法访问 chromewebstore.google.com，可以走未打包扩展的旁加载方式，参见安装指南里的提示。
博客里的 YouTube 嵌入。 嵌入失败不影响文本，博客的内容是完整的。
崩溃和遥测上报。 Browy 不发送遥测，所以这一项不存在问题。

怎么联系到我们

在 GitHub 上提 issue。安装问题和 bug 反馈都可以发在那里。