Holon

在自己的电脑或服务器上创建和运行开源 AI 助手。分配任务、查看进展、持续跟进工作。面向个人和团队。
跳到正文
浏览文档
本页提纲

与团队共用 AI 助手

当你已经在个人电脑上跑通了 Holon 之后，下一步往往是把它分享给团队。与其让每位同事都在本地各配一套环境、互相复制 Prompt，不如在一台常开的服务器上部署 Holon，相当于全组共雇一位常驻待命的 AI 同事：它记住项目的长期上下文与协作规范，团队成员都可以交办任务，离开电脑后它继续跟进，并在完成后交付清晰的结果简报。

本指南介绍实现团队协作的三步落地路径，以及日常协同的最佳实践。

为什么要与团队共用 AI 助手？

相比各自在个人电脑上运行孤立的对话工具，团队共用 AI 助手有三个核心优势：

  1. 共享上下文与项目规范： 助手常驻在团队的 canonical 代码库或共享工作区中，读取统一的 AGENTS.md 规则与知识库，不再出现“某人在本地调通、别人问就答错”的环境与指令偏差。
  2. 交办明确任务与审计可溯： 任何团队成员都可以为助手创建带有明确验收标准的独立任务（WorkItem）。通过接入企业 OIDC 单点登录，Holon 会精准记录每项任务和指令是由哪位同事发起的。
  3. 离线自动跟进与交付： 当任务需要等待耗时的 CI 构建、测试运行、外部下载或人工审批时，同事可以随时关机离开。助手在依赖就绪后会自动唤醒继续执行，并在最终交付时提供提炼好的简报（Brief）。

第 1 步：部署到团队共享服务器

挑选一台全组均可网络访问的机器——例如云服务器、办公室固定工作站或 NAS。

安装 Holon 后，根据团队现有的网络架构启动守护进程：

  • Cloudflare Named Tunnel（--access cloudflare）： 使用预配置的专用隧道、域名与 connector token 提供公网 HTTPS。
  • Tailscale（--access tailnet）： 适合团队成员已加入同一私有虚拟网格的场景。
  • 局域网或反向代理（--access lan）： 适合已有自建机房，前端挂载 Nginx、Caddy 或 Kubernetes Ingress 的场景。
# 先配置 Named Tunnel ingress 指向 http://127.0.0.1:8787。
holon daemon start --access cloudflare --port 8787 \
  --advertise https://holon.example.com \
  --cloudflare-token-file ~/.cloudflared/holon-connector.token \
  --token-file ~/.holon/remote.token

有关详细的网络配置与服务管理说明，请参阅连接到远程 Holon 运行时。

第 2 步：接入团队单点登录（OIDC）

在团队成员之间私下分发固定的控制 Token 无法做到安全审计。对于团队环境，建议配置 OpenID Connect（OIDC），让成员直接使用公司现有的账号系统登录（如 Google Workspace、GitLab CE、Keycloak、Okta、Authentik 或 Microsoft Entra ID）。

开启 OIDC 后：

  • 成员在浏览器中直接使用工作邮箱或单点登录凭据登录 Web GUI；
  • Holon 精确记录发起提示词与交办任务的具体用户身份；
  • 成员离职或权限变更时，在企业 IdP 侧一键撤销即可生效。
# 切换为 OIDC 认证模式并配置基础参数
holon config set auth.mode "oidc"
holon config set auth.oidc.issuer_url "https://auth.example.com/realms/team"
holon config set auth.oidc.client_id "holon"
holon config set auth.oidc.client_secret_env "HOLON_OIDC_CLIENT_SECRET"

完整的分步注册与会话超时调整指引，请参阅配置 OIDC 认证，或直接参考针对 Google Workspace、自托管 GitLab CE 与自托管 Keycloak 的专项配置指南。

第 3 步：通过 Web GUI 展开日常协同

部署与认证就绪后，在浏览器中打开服务端对外地址即可进入 Web GUI：

  1. 选择专属 Agent： 挑选专职负责该项目的常驻 Agent（例如负责日常发布协调的 Release Manager、维护文档规范的 Docs Steward 或专职代码审查的 Code Reviewer）。
  2. 交办任务（WorkItem）： 新建一个有独立生命周期的工作项，写清目标和验收边界（例如：“排查并修复 issue #123” 或 “核对本周发布版本的依赖兼容性”）。
  3. 查看进度与接力协作： 全组成员都能在任务列表中看到当前正在进行的工作项、执行日志与中间产物，其他同事可以在此基础上补充输入或接力推进。
  4. 审阅完成简报： 任务闭环后，助手会生成结构化完成简报，列出核心结论、已核验项及需要人工最终确认的决策点。

如需了解实际研发团队在真实项目中如何与 AI 助手协同工作，建议阅读博客实录： 一个小团队如何与长期 AI 助手协同工作——131 天真实实践。