TeamAI learnings双层隔离共享根目录与项目私有经验详解【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli本文详解TeamAI面向团队的 AI 经验共享 CLI 工具make every team AI native中 learnings双层隔离机制通过共享根目录与项目私有经验两层目录设计让多项目团队的teamai recall知识检索既统一又互不干扰。无论你的团队仓库承载多少个项目成员都能只看到「该看的经验」。为什么需要双层隔离多项目团队的经验污染问题 一个团队仓库常常同时服务多个项目。在 learnings 隔离能力出现之前所有经验文档都扁平地写入同一个learnings/目录由此带来一个典型痛点项目 A 的排障经验会出现在项目 B 成员的teamai recall检索结果里——项目越多信噪比下降越明显。更棘手的是单纯切换工作目录并不能解决它多个目录克隆的是同一个团队仓库learnings/依然是同一堆文件。TeamAI 的双层隔离设计正是针对这个问题根目录承载全团队共享经验项目子目录承载项目私有经验两层各司其职。双层目录结构详解一图看懂 learnings 布局隔离后的团队仓库目录结构如下team-repo/ ├── manifest/projects.yaml # 声明逻辑项目及其命名空间 └── learnings/ ├── team-general-2026-03-15.md # 第一层根目录全团队共享 ├── hai-inference/ # 第二层项目私有经验推理平台 └── billing/ # 第二层项目私有经验计费系统层级位置可见范围典型内容共享层learnings/根目录全团队所有人跨项目通用规范、团队级排障经验私有层learnings/project-id/仅该项目激活的目录项目特有的部署坑、接口约定、业务踩坑记录核心不变量只有一条根目录下的.md文件对所有人永远可见子目录则按激活项目精确过滤。一键配置步骤三步启用项目私有经验第一步管理员声明项目manifest/projects.yaml团队管理员在团队仓库中声明逻辑项目learnings字段让命名空间真正生效version: 1 projects: - id: hai-inference name: HAI Inference resources: knowledge: [hai-inference] skills: [hai-inference] learnings: [hai-inference]第二步成员按工作目录激活项目项目身份跟着工作目录走模式与--role完全一致cd ~/work/hai-inference teamai init 团队仓库地址 --project hai-inference cd ~/work/billing teamai init 团队仓库地址 --project billing第三步零手动操作自动同步此后每次启动 AI 会话时SessionStart hook 自动执行teamai pull各目录只同步自己项目的资源与 learnings——无需任何手动同步。隔离如何生效recall 检索与 contribute 落地规则 ✅recall 检索只看「根目录 自己的项目」teamai recall构建搜索索引时采用命名空间感知的收集逻辑始终索引learnings/根目录共享经验再叠加本目录激活项目的子目录任何未激活项目的子目录都会被跳过因此成员永远不会在检索结果里看到别的项目的私有经验。该逻辑源码见 src/utils/search-index.ts。contribute 落地经验自动归档到正确位置当会话结束时/teamai-share-learnings或teamai contribute推送经验时落地位置由激活项目数自动决定激活项目数经验落地位置理由恰好 1 个learnings/project-id/隔离只对该项目可见0 个未激活任何项目learnings/根目录共享属于通用经验多个learnings/根目录安全默认宁可全可见也不猜测归属落地优先级规则见 src/contribute.ts。向后兼容零迁移平滑升级 无manifest/projects.yaml的仓库行为与之前完全一致所有项目相关代码路径自动短路存量的扁平learnings/*.md继续留在根目录、对所有人共享零迁移不会自动激活项目与「唯一 role 自动选中」不同唯一的项目也不会被自动选中——成员可以不属于任何项目仍能获得common资源与共享的根目录经验避免私有经验被误推送给基础设施类成员。常见问题 FAQQ1一个目录可以同时激活多个项目吗可以。--project支持逗号分隔多个 idmonorepo 或跨项目职能人员适用此时 contribute 会落到共享根目录保持安全默认。Q2如何事后修正本目录激活的项目使用低频修正命令teamai projects set hai-inference覆盖语义留空清除teamai projects members hai-inference可查询项目名册。Q3未做任何配置会受影响吗不会。没有项目声明时learnings 完全保持原有扁平共享行为升级无感。延伸阅读 想深入了解完整用法与设计细节可参考仓库内的文档官方使用指南多项目章节docs/usage-guide.zh-CN.md多项目管理设计文档隔离机制全貌docs/designs/multi-project-management.md数据目录布局设计docs/designs/data-directory-layout.md项目数据模型源码src/projects.ts拉取同步逻辑src/pull.ts【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考