团队记忆与 Git 同步

团队记忆是默认关闭的共享层，位于仓库内 .qwen/team-memory/。开启后项目长期约定和共同参考可放这里，个人及短期笔记仍保留私有。

{
  "memory": {
    "enableTeamMemory": true
  }
}

QWEN_CODE_MEMORY_TEAM=1/0 可单次覆盖。默认使用普通 Git 流程拉取和提交分享，不自动推送。

可见性与写入

目录对有仓库访问权的人可见，应像其他要提交的代码一样检查。写入扫描 API Key、token、私钥等，命中会拒绝，但扫描不是敏感数据绝不会泄露的保证。

写入出现在 git status 和 PR diff；Ask Permissions（配置值 default）会请求批准，Auto-Edit/YOLO 可自动应用。这里的“default 模式”不是在宣称当前产品开箱默认值，审批详见模式说明。

避免被忽略

如果已有 .qwen/* 忽略规则，可重新包含：

!.qwen/team-memory/
!.qwen/team-memory/**

若忽略的是整个 .qwen/ 目录，Git 不会进入目录，子项否定规则不生效。应先调整父级忽略形式；启用团队记忆但目录被忽略或不在 Git 仓库时，Qwen 启动会警告。

可选自动同步

memory.enableTeamMemorySync 默认关闭，同时启用团队层与同步后，会话开始时尽力重建索引、先 fast-forward pull，再提交团队目录改动，最后以显式单分支 refspec 推这次同步提交。QWEN_CODE_MEMORY_TEAM_SYNC=1/0 可覆盖。

只暂存团队目录，不把其他工作区更改塞入该提交；Git 失败不阻塞会话。但 pull 快进作用于整个当前分支，不是按路径只更新记忆，因此其他远端代码也会进入 checkout。

本地已经领先 upstream 时只本地提交并跳过 push，不发布其他未推提交；分支分叉时保持不动，本次不做同步；没有 upstream 时可本地提交但不推送。

共享元数据迁移

/memory migrate-team 显式将团队文件升级到结构化元数据，在可信工作区、已启用团队记忆时运行。个人/项目迁移可后台进行，团队文件经 Git 共享，重写应审阅 diff，不能因为是记忆就跳过变更检查。