ac-teams

中文文档
0.0.9发布于 2026/11/03MITES Module构建来源已验证

小而持久的Pi团队

中文使用文档
文档目录5 节
  1. 安装
  2. 使用它
  3. 知道界限
  4. 指南
  5. 许可证

ac-teams

持久代理团队 π:共享任务、可搜索消息和可选的Git工作树。成员在分配任务之间保持活跃,并且可以在停止后恢复他们的本地Pi会话。没有工作流引擎或后台服务。

安装

需要Linux, Node 22.19或更新版本,以及经过身份验证的 pi 可执行文件在 PATH. 互动式团队还需要 tmux 在 PATH. 用Pi 1.4.0和1.5.0测试。

pi install npm:[email protected]

安装完成后重新启动Pi。使用π /trust 命令,在启动成员之前保存每个项目目录的批准;无头儿童无法回答最初的信任提示。

使用它

你的Pi会话是根;它的子代理是成员。让Pi委派一个有界的任务,例如:

启动一个成员来检查src/parser。不加编辑,让它把结果发回给我。

工具目的
team_agent启动、检查、停止和恢复成员;管理限制和工作树
team_task跟踪共享的工作、所有权和依赖关系
team_message发送通知,阅读或搜索团队历史记录

/teams 或者 /teams panel 打开任务、队友和活动。 /teams teammate <name-or-id> 直接开队友;子命令和队友名称自动完成。使用任务图或列表,发送反馈,并打开成员的完整实时Pi会话。

任务摘要位于输入的上方。代理选择器位于输入的下方,现有页脚的上方,并显示描述性名称、模型和上下文用法。Ac-teams发布一个紧凑的团队状态,而不替换其他扩展提供的页脚或编辑器。 /teams config 独立切换这些显示。

在空编辑器中,按“下”选择团队行,然后按“Enter”打开成员。一个红色的 需要输入 标签用开放问题标记成员。Ctrl+Shift+Left返回到Main,但不停止成员或解除其问题。 /teams stop 停止每一个成员;主会话继续运行。 /teams join 和 /teams leave 将此会话添加到另一个团队或将其删除。

默认值最多允许 10名现场成员 和 两级授权. 使用最少有用的代理。

知道界限

  • 成员共享您的文件系统访问权限,除非启动 执行访问一个可选的Docker沙盒,需要Docker和一个本地构建的成员映像。所有成员都可以阅读所有团队消息,包括直接消息。
  • 仅承保限额 team_agent,而不是其他委托工具。为并发写器使用单独的工作树。
  • Stop保留任务、会话和工作树。工作树的删除是明确的,需要干净、集成的工作。
  • 退出确认需要Pi session_before_exit 钩子,安装Pi 1.4.0缺乏。没有它,关机清理,但不能先问。信号总是绕过确认。

看到 操作指南 用于恢复保证、存储和Pi依赖项安全咨询。

指南

  • 使用:工具操作、任务规则、消息和配套工具
  • 操作:限制、停止/恢复、工作树和安全
  • 执行访问: docker强制读/写授权,出站代理和目的地策略,以及设置
  • 开发:源代码设置、验证和发布
  • 实现历史:设计决策和现有技术

许可证

麻省理工学院.

版本与发布记录

ac-teams 共发布 10 个版本,首次发布于 2026/10/25;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.9latest2026/11/03今天
0.0.82026/11/03今天
0.0.72026/11/03今天
0.0.62026/11/021 天前
0.0.52026/10/268 天前
0.0.42026/10/268 天前

关于 ac-teams 的常见问题

ac-teams 是什么?

小而持久的Pi团队

如何安装 ac-teams?

在项目目录运行 npm install ac-teams,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(^1.0.0)、@earendil-works/pi-tui(^1.4.0)、@earendil-works/pi-coding-agent(^1.4.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

ac-teams 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ac-teams 是否存在。

ac-teams 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

ac-teams 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

ac-teams 可以商用吗?

ac-teams 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

ac-teams 还在维护吗?

最新版本 0.0.9 发布于 2026/11/03(今天);至今共发布 10 个版本,其中过去 12 个月发布了 10 个;首次发布于 2026/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。