通义灵码连接Git仓库使用教程

通义灵码若要正常读取 Git 提交记录、生成周报、自动编写符合规范的 commit 信息，甚至重构跨文件逻辑，前提是它必须能够正确识别并加载项目中的 .git 目录。否则，所有依赖上下文的功能都会失效，这一问题需要特别关注。

首先确认 Git 仓库是否已初始化，并且通义灵码能正常识别。在 VS Code 或 JetBrains IDE 中打开项目根目录，检查是否存在 .git 文件夹。如果项目是新建的且尚未执行 git init，请在终端中依次运行：git init → git add . → git commit -m "init"。否则，通义灵码无法获取任何提交历史，后续操作也无法进行。

观察右下角状态栏：若显示“TONGYI Lingma: Ready”，说明上下文加载成功；若显示“Limited context”或无任何反应，则可能因内存不足导致索引中断。此时关闭所有非项目标签页并重启 IDE 即可解决。

此外，可在任意代码文件中按 Ctrl+I（Windows/Linux）或 Cmd+I（Mac），输入 @workspace test 并回车。若返回“Found 127 files in workspace”，说明代码库索引已完成；若提示“No indexed files”，则手动点击状态栏中的通义灵码图标，选择“重新构建代码库索引”。

用通义灵码读取本周 Git 提交记录

要生成周报，第一步需将本地分支与远程同步。在终端执行 git pull origin $(git rev-parse --abbrev-ref HEAD)。此步骤不可跳过，否则通义灵码只能看到本地未推送的 commit，周报内容会严重遗漏，导致后续工作无效。

第二步，运行 git log --since="7 days ago" --oneline，确认输出中至少包含三条以上非空记录，例如 e8f3a1b feat: 订单导出支持多币种。若输出为空，说明本周无有效提交，或时间范围设置存在偏差。

第三步，在 VS Code 中打开任意源码文件（如 src/main/java/App.java），按 Ctrl+I 调出通义灵码，粘贴指令：基于 git log --since="7 days ago" --pretty=format:"%h %s" 生成技术周报，分点列出新增功能、修复 Bug、优化项，每点不超过两行，不加 markdown。回车后，通义灵码会自动调用 shell 执行命令，将原始日志传入模型进行处理，效率较高。

右键生成符合规范的 Git Commit 信息

方法一：在 VS Code 的源代码管理面板中，找到“消息”输入框，右键选择“使用通义灵码生成提交信息”。注意：当前工作区必须已初始化 Git 仓库且存在 .git 目录，否则右键菜单中不会出现该选项。

方法二：若默认生成的 commit 不符合 Conventional Commits 标准（例如缺少 scope 或 type 写错），可在提交框中先输入前缀再触发补全。例如输入 fix(api): 然后按 Ctrl+Enter，通义灵码会续写具体描述，如 fix(api): 修复 /v2/order/list 接口未校验用户权限的问题。

方法三：使用自然语言精确约束。例如输入“本次修改了 src/utils/encrypt.ts 的 aesEncrypt 函数，将 base64 编码改为 hex 编码以兼容旧系统，生成一条 Angular 规范 commit”，按 Ctrl+Enter，模型会输出 refactor(utils): 将 aesEncrypt 输出格式从 base64 改为 hex。该方式灵活实用。

让通义灵码感知多分支与远程追踪

先查看远程分支情况：在终端执行 git branch -r，确认存在 origin/main、origin/dev 等远程分支。若仅显示本地分支，说明尚未执行 git push -u origin main，此时通义灵码无法访问 origin/ 分支下的提交记录。

再检查 upstream 设置：运行 git config --get branch.$(git rev-parse --abbrev-ref HEAD).merge，若返回 refs/heads/main，说明当前分支已正确绑定远程分支；若返回为空，则通义灵码调用 git log --oneline origin/main 时会报错“unknown revision”，导致操作无效。

如需手动指定远程分支，可在通义灵码指令中明确写出完整的 ref 名。例如：基于 git log --since="30 days ago" --pretty=format:"%h %s" origin/release/2.4.0 生成版本迭代总结。这样即可精准定位目标分支的历史记录。