安装本地应用

从本地目录、Git 仓库或远程 ZIP 包安装 Connector，并完成微信、企业微信的首次配置。

百积木客户端支持三种自定义安装来源：

本地目录：适合本机开发和调试。
Git 仓库：客户端临时克隆仓库后安装，可用 #分支或标签 固定版本。
远程压缩包：支持 .zip、.tar.gz 和 .tgz，适合不想在电脑上保留 Git 工作区的用户。

微信和企业微信不再通过本地应用市场分发，请使用本页提供的 Git 仓库或远程 ZIP 地址安装。

使用远程压缩包前，请先把百积木客户端升级到 0.1.115 或更高版本；该版本包含 Gitee 归档下载兼容处理。

开始安装

启动百积木客户端并完成设备授权。
打开“应用”页面，点击“安装应用”。
选择“自定义安装”。
粘贴本地目录、Git 仓库或远程压缩包地址。
阅读风险提示，确认来源可信。
点击“安装应用”，等待下载、校验、解压和服务注册完成。
在已安装应用列表中打开应用详情，按提示授予系统权限并启动应用。

安装包必须包含一个有效的 connector.json。压缩包可以直接以 Connector 目录为根，也可以只包含一个顶层目录；如果包内没有清单或存在多个 Connector 清单，客户端会拒绝安装。

从 Git 仓库安装

输入完整的 Git URL。建议使用标签固定版本，避免默认分支更新后在不同电脑上得到不同内容：

https://github.com/momoplan/wechat-bridge-collector.git#v0.7.0

https://gitee.com/zxflimit_admin/wecom-bridge-collector.git#v0.6.0

通过 Git 安装要求电脑上可以执行 git，并且网络可以访问对应仓库。私有仓库使用本机现有的 Git 凭证和 SSH 配置。

从远程 ZIP 包安装

直接输入以 .zip 结尾的 HTTPS 下载地址：

https://github.com/momoplan/wechat-bridge-collector/archive/refs/tags/v0.7.0.zip

https://gitee.com/zxflimit_admin/wecom-bridge-collector/repository/archive/v0.6.0.zip

ZIP 安装不依赖本机 Git。客户端会在临时目录下载并安全解压，安装完成后保留原始 URL 作为后续同步来源。请优先使用 HTTPS 地址和不可变的版本标签，不要安装来源不明的下载包。

从本地目录安装

输入包含 connector.json 的绝对路径，例如：

/Users/me/connectors/wechat-bridge-collector

本地目录适合开发调试。安装时客户端会把 Connector 复制到自己的应用目录；修改原目录不会自动修改已安装副本，需要在应用详情中执行同步或重新安装。

微信 Connector

微信 Connector 当前从下面的仓库分发：

https://github.com/momoplan/wechat-bridge-collector.git#v0.7.0

安装完成后：

在 macOS“系统设置 > 隐私与安全性 > 完全磁盘访问”中启用“百积木”，然后完全退出并重新打开百积木客户端。
保持微信已登录，打开百积木客户端中的“WeChat Connector”。
如果页面显示还没有密钥，点击“自动获取密钥”；也可以导入已有的 all_keys.json。
密钥验证成功后点击“启动应用”。
在应用页面确认最近会话、联系人或消息查询可以正常返回。

企业微信 Connector

企业微信 Connector 当前从下面的仓库分发：

https://gitee.com/zxflimit_admin/wecom-bridge-collector.git#v0.6.0

安装完成后：

在 macOS“系统设置 > 隐私与安全性 > 完全磁盘访问”中启用“百积木”，然后完全退出并重新打开百积木客户端。
保持企业微信已登录，打开百积木客户端中的“WeCom Connector”。
如果页面显示还没有密钥，点击“自动获取密钥”；也可以导入已有的 wxwork_keys.json。
密钥验证成功后点击“启动应用”。
在应用页面确认最近会话、联系人或消息查询可以正常返回。

微信发送与企业微信发送

发送 Connector 通过 macOS 辅助功能操作已经登录的本地客户端：

https://github.com/momoplan/wechat-sender-connector.git#v1.1.0

https://gitee.com/zxflimit_admin/wecom-sender-connector.git#v0.4.0

安装后，在“系统设置 > 隐私与安全性 > 辅助功能”中允许“百积木”，然后重新打开客户端。发送能力属于高风险操作；请先使用 dryRun 只打开会话并粘贴内容，确认联系人匹配正确后再执行真实发送。

统一 Python 3.12 环境

微信、企业微信、微信发送和企业微信发送四个 Connector 从上述版本起统一使用 Python 3.12.x。百积木客户端不内置 Python，也不会向客户的全局 Python 安装依赖。请先把百积木客户端升级到 0.1.117 或更高版本；旧客户端没有统一解释器选择和严格隔离能力。

首次安装前：

从 Python 官网安装 Python 3.12.x。不要选择 3.11 或 3.13。
打开百积木“设置 > 运行环境”。
点击“检测 Python”。如果自动检测到 3.12，点击“使用检测路径”；也可以手工填写 Python 3.12 可执行文件的绝对路径。
确认状态显示“Python 可用”，然后保存配置。
再安装或同步四个 Connector。

客户端只保存一个解释器绝对路径，但会在每个 Connector 安装目录中分别创建 .bridge-agent-python 虚拟环境。各 Connector 严格按自己的 requirements.lock 安装依赖，因此不会修改系统 Python、不会依赖全局 pip 包，也不会互相覆盖依赖。切换解释器路径后，客户端会在下一次同步时重建对应虚拟环境。

如果提示 Python 未就绪：