eduwxyz/tucano

项目介绍

Tucano 是一个 Electron 桌面应用，把多个 AI 编程代理组织成有名字、角色、指令和工具权限的团队成员。你不再需要在多个终端之间复制粘贴，而是创建频道、加入代理，用 @ 点名或交给路由自动决定谁回答。代理之间也用 @mentions 交接工作，例如一个排查问题、一个修复、一个审查，每一步的工具调用和 token/耗时记录都显示在对话里。

代理本身不带模型访问，而是调用你机器上已经安装的 harness：Claude Code、Codex、OpenCode 或 Pi，从而使用你已有的订阅、公司网关或已配置的服务商。每个代理可以单独选择 harness 和模型，因此一个团队可以混用不同模型。

主要功能

• MCP 连接器： 支持远程（OAuth 或 token）和本地 MCP 服务器，例如 Jira、GitLab、GitHub、Slack、Linear、Figma、Notion、Datadog、Sentry 或公司内部服务器；然后按代理、按工具设置无权限、只读或读写。
• 审批： 重要的写操作会暂停，展示确切的调用和参数；你可以批准、始终允许，或附上理由拒绝，代理会读到理由。审批还可以通过 Telegram 推到手机上。
• 记忆与技能： 代理会提出记忆和可复用的技能，由你审核、编辑或遗忘。
• 例行任务： 可以按日期时间或连接器事件（新 issue、监控告警等）调度任务。
• 独立电脑与浏览器： 可以给代理一个基于 Docker 的 Linux 环境或使用你自己的电脑，也可以分配一个可观看、可接管的 Chrome。
• 本地优先： 对话、记忆、登录信息和文件都留在本机，没有 Tucano 服务器；连接器密钥用操作系统钥匙串/密钥环中的密钥加密。

快速使用

准备条件：Apple 芯片 Mac、x64 或 ARM64 Linux PC，或 Windows 10/11 x64，并至少安装、登录一个 harness。Windows 还需要 Git for Windows。Docker 可选，用于给代理一台 Linux 电脑；Chrome/Chromium 可选，用于独立浏览器。

最短路径是 Claude Code：

curl -fsSL https://claude.ai/install.sh | bash
claude auth login

然后从最新发布页安装 Tucano：macOS 打开 .dmg 拖进 Applications；Ubuntu/Debian 用 sudo apt install ./tucano-linux-amd64.deb；其他 Linux 发行版用 AppImage（先 chmod +x）。Windows 可以运行 README 中的 PowerShell 安装命令，或下载 tucano-win-x64.exe，由于未代码签名，首次运行需在 SmartScreen 中点 More info → Run anyway。macOS 和 Linux 也提供 shell 安装脚本。

首次启动时选择英语或葡萄牙语，然后按步骤完成设置：你的名字、允许代理使用的 harness（每个都有 Test now 按钮）、负责路由和记忆的模型、代理需要了解的你的信息、可选的连接器和技能，以及第一个代理。设置结束后会进入 #general 频道，代理已经可以工作。

使用约束

• 必须至少有一个受支持的 harness，否则代理无法运行；Windows 上需要 Git Bash 来执行代理命令。
• 桌面端支持 Apple 芯片 macOS 和 Windows 10/11 x64；Linux 支持 x64 和 ARM64。README 中测试过 macOS 26 以及 KDE/Xfce 的 Ubuntu。
• Windows 安装包未代码签名，SmartScreen 会提示，公司管理的电脑也可能禁止未签名应用。macOS 构建已签名并公证。
• Ubuntu 24.04 及以上建议用 .deb，其中包含 Electron 沙箱所需的 AppArmor 配置。
• Linux 上连接器密码只能存入已打开的系统密钥环（GNOME Keyring 或 KWallet）；没有密钥环时不会保存密码。
• 在无界面服务器上运行并通过浏览器使用属于实验性功能。
• 采用 Apache-2.0 许可证；应用控制功能依赖 Vercel Labs 单独安装的 agent-desktop。

HotRepo 点评

这是一个新仓库，规模还小：2026-11-01 记录的日榜窗口显示 106 个 Star、19 个 Fork，单个一小时增长窗口增加 5 个 Star、Fork 无变化，尚未记录到 GitHub 日榜名次，因此不足以支持任何热度趋势判断。

资料中更值得关注的是架构而非发布数字：每轮代理通过 harness CLI 运行，使用带密钥的每轮 MCP 网关 URL，只暴露分配给该代理的工具；敏感调用在执行前转为审批。对于基于现有编程 harness 构建多代理桌面工具的人来说，这套设计值得阅读；至于权限边界在实践中是否成立，需要独立评估，现有记录无法提供结论。