一个 PAT 跑通自建 GitLabTeamAI CLI 团队 AI 资产同步完整实录【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cliTeamAI CLI 是把 skills、rules、agents 等资源放进一个 Git 仓库自动分发的团队 AI 资产同步工具。如果你维护自建 GitLab 实例希望团队的 AI 知识库完整留在内网这篇实录演示完整链路从安装 CLI 到自动建仓、创建 MR 与拉取只需 2 个配置项后续 push / pull 全部由一个 Personal Access Token 驱动。先看效果跑通后三条命令长什么样配置完成后的日常形态就是两条命令来回$ teamai push ✔ Pushed 3 resources ✔ Pull Request created: https://git.example.com/yourgroup/your-teamai/-/merge_requests/7 $ teamai pull ✔ Synced: 12 skills, 4 rules, 2 agents背后由 PAT 驱动的操作面如下全部走 GitLab REST API v4不需要安装任何平台 CLI操作实现方式克隆仓库git clonetoken 经http.extraHeader注入不落盘到.git/config自动建仓POST /api/v4/projects按路径解析 Group解析不到直接报错创建 MRPOST /merge_requestsreviewer 用户名自动解析为 ID导入 MR 数据标题 提交 diff截断 50KB用于知识沉淀列出 Group 仓库include_subgroupstrue覆盖子组供批量导入动手前检查依赖、权限和唯一手动环节项目要求确认方式Node.js≥ 20node -vGit任意可用版本git --versionGitLab 账号目标 Group 成员可推分支、可建仓浏览器打开 Group 确认PATapiscope见下一节全程唯一需要登录 Web 界面的环节就是去 GitLab 后台签发那个 token其余步骤全部在终端完成。如果要看实现细节源码在 src/providers/gitlab/也可以git clone https://gitcode.com/GitHub_Trending/te/teamai-cli本地阅读。如何拿到带 api 权限的 token为什么是它GitLab provider 的所有写操作建仓、MR都靠PRIVATE-TOKEN请求头里的这一个凭据它是 API 的唯一入口。不配会怎样init阶段就会提示GitLab authentication unavailable。打开实例 → 头像 →User Settings → Access Tokens勾选api设好有效期创建后立即复制形如glpat-xxxxexport GITLAB_TOKENglpat-xxxxxxxx验证 token 与实例可达性curl -s -H PRIVATE-TOKEN: $GITLAB_TOKEN $GITLAB_URL/api/v4/user | head -c 120返回你的账号 JSON 即通过。token 有三个名字按优先级生效GITLAB_TOKENGITLAB_PRIVATE_TOKENGITLAB_PAT空串和纯空白视为未设置自动顺延下一个兼容已有 CI 的命名习惯。⚠️scope 只勾read_api不行克隆能过但自动建仓和建 MR 会在第一次 push 时直接失败。实例地址怎么配才不会指错地方为什么需要它GITLAB_URL决定 API 调用与克隆 URL 的落点不配时默认回落到gitlab.com自建实例的 token 会被发往公网所以 CLI 对自建场景要求显式配置。export GITLAB_URLhttps://git.example.com配置时记住这四条规则规则说明必须带 scheme只写gitlab.example.com会报错退出而不是静默指向公网实例内网 http、非标端口原样保留http://10.0.0.5:8929会原样进入克隆 URL支持子路径部署挂在https://example.com/gitlab下的实例写完整 base URL网关改写了 API 路径加export GITLAB_API_PREFIXapi/gitlab否则请求默认打到/api/v4验证配置落点正确curl -s -H PRIVATE-TOKEN: $GITLAB_TOKEN $GITLAB_URL/api/v4/version返回 JSON 版本信息即正确。多实例场景可用TEAMAI_GITLAB_HOST直接指定 host 覆盖解析顺序是TEAMAI_GITLAB_HOSTGITLAB_URL推导 默认gitlab.com逻辑见 src/providers/gitlab/repo-url.ts。⚠️TEAMAI_GITLAB_HOST与GITLAB_URL指向不同 host 时CLI 会直接报错拒绝猜测 token 属于哪个实例——这是防凭据外发的设计不是 bug。如何跑通第一条 teamai init背景init从仓库 URL 的 host 判断 providerhost 命中GITLAB_URL就进 gitlab provider。如果 host 完全未知它会匿名请求该站登录页做一次探测3 秒超时不发送 token、不跟随重定向确认是 GitLab 就停下来提示你补配置绝不带着凭据盲试。这个设计很贴心探测只是配置提示不构成把 PAT 发往该地址的许可。teamai init https://git.example.com/yourgroup/your-teamai成功后 provider 被写入团队仓库的teamai.yaml此后所有人的push/pull都跟随这个值。验证初始化结果teamai doctor # 每一行都应通过 teamai status⚠️早期初始化为provider: git的仓库有小坑光补环境变量不生效必须手动把teamai.yaml里的provider改成gitlab。push失败后的诊断会打印这条修复提示但不会替你自动切换。一个 PAT 解锁的其余能力能力说明 凭据不落盘克隆时 token 用oauth2:基本认证经-c http.extraHeader临时注入远程 URL 保持干净建仓不跑偏创建 project 时按 URL 编码的完整路径查 Group ID查不到就报错不会悄悄建到你的个人空间MR 导入防伪造MR 链接的 host 必须与已配置实例严格匹配含端口、去www.否则拒绝请求子组全覆盖列 Group 仓库默认带include_subgroupstrue子组下的项目不会漏日常循环就剩teamai push # 资源推送并自动开 MR teamai pull # 拉取团队最新共享资源自检清单交付团队前逐条过一遍☐GITLAB_URL以http(s)://开头host 与浏览器地址栏完全一致含端口与子路径☐ PAT 勾选的是api而不是read_api☐ token 值首尾无多余空白或换行CI 里$(cat token)记得 trim☐ 你的账号在目标 Group 有建仓权限否则init的自动建仓一步必挂☐ 团队仓库teamai.yaml的provider字段是gitlab而非git☐ 网关改写过 API 路径时已设置GITLAB_API_PREFIX☐ 多实例场景下TEAMAI_GITLAB_HOST与GITLAB_URL指向同一台实例收尾从签发 PAT 到第一条push/pull跑通通常只需 10~15 分钟。更完整的 Provider 检测与命令细节见 docs/usage-guide.zh-CN.md 和 docs/guide/zh-CN/getting-started.mdGitLab provider 全部实现在 src/providers/gitlab/。【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考