AI 智能体协作应用 Tucano 新增了将团队维基连接到 Git 仓库的功能，可定期拉取文档，并将保存的变更上传。在服务器或云端使用该应用的团队，可以像使用个人 Obsidian 库一样，将仓库中集中存放的文档作为维基的基准。

1. 连接仓库，将其作为维基的文档基准

维基所有者或管理员可在维基设置的文件夹菜单中输入仓库地址，开始连接。Tucano 会为该维基生成访问仓库所用的专用认证密钥，并将其保存在应用的机密存储中。

用户需将生成的公钥注册到仓库托管平台的部署密钥设置中。部署密钥用于授予应用访问该仓库的权限。选择仅允许读取，或同时允许读写，然后测试连接即可。测试时会连接仓库并创建独立克隆，统计页面以及 PDF、DOCX 文件的数量。连接完成后，该克隆会成为应用数据中的维基文件夹，原有文件夹则保留为备份。

对于已有页面的维基，可以用仓库内容替换，也可以合并现有文档。合并时，同名但内容不同的页面会添加表示 Tucano 版本的名称后缀，作为独立文档保留；首次邀请后为某人保留的页面则继续保持保留状态。

2. 拉取变更与发送到仓库的方式

根据发布说明，Tucano 会在启动时以及每隔 2 分钟拉取仓库变更，并在负责撰写维基内容的整理员开始工作前再次检查。在维基中保存页面后，应用会在几秒后尝试提交，即将变更历史记录到仓库，以及推送，即将记录发送到远程仓库。因此，仓库中的修改会进入维基，而维基中编辑的页面也会同步到远程仓库。

如果双方都修改了同一文档，仓库版本会保留在原位置，Tucano 版本则会改名后作为独立文档提交。这种方式会并列保留两个编辑版本，同时在维基管理界面显示冲突通知。

3. 公开范围与权限错误处理

首次邀请后为某人保留的页面以及来自私人对话的来源不会上传到仓库。Tucano 自身的文件 índice.md、registro.md，以及超过 50MB 的文件也不在提交范围内。即使将维基文件夹连接到仓库，这些项目也不会包含在发送到仓库的变更中。

首次推送时会检测到密钥缺少写入权限的情况，此时维基会转为只读，包括整理员在内的所有人都无法写入。未能传送的内容会保留在维基文件夹中。

启用仓库写入权限后，可通过重试写入功能进行确认。网络或密钥错误会与上次同步时间一起显示在设置界面中，同时还提供同步重试和立即执行功能。

4. 安装与连接前需考虑的运维负担

在 Mac 或 Linux 上，可使用以下官方命令安装最新版本并打开应用。要使用维基同步功能，计算机上还必须安装 Git。

curl -fsSL https://github.com/eduwxyz/tucano/releases/latest/download/install.sh | sh

连接使用 SSH 这一远程访问方式的认证密钥。密钥使用时存放在仅所有者可读写的临时文件中，并通过应用自身的主机记录，即记忆已连接服务器身份的信息，确认连接目标。

以仓库为基准，可以在维基中利用现有文档，并双向交换修改内容。相应地，团队需要同时管理仓库权限和共享文档的范围。连接前决定是否合并现有页面，并确认部署密钥是否允许写入，都是运维准备的一部分。

Tucano 0.2.20 让维基能够与 Git 仓库一同管理，但团队必须先确定编辑权限及上传到仓库的文档范围。