连接代码库

如果你希望 Agent 处理代码相关任务，需要先把 Git 仓库连接到 HiFox。

连接代码库后，Agent 在执行任务时可以 clone 对应仓库，在已连接的机器上读取代码、修改文件、运行命令，并把结果写回任务。

什么时候需要连接代码库？

当任务涉及这些工作时，就需要连接代码库：

阅读项目代码；

修复 Bug；

修改文案或 UI；

补充测试；

运行构建、测试或 lint；

分析代码结构；

让 Agent 生成可 review 的代码变更。

如果任务只是讨论需求、整理计划、总结文档，可能不需要代码库。但只要 Agent 需要进入项目目录执行工作，就应该先连接对应仓库。

空间代码库和 Agent 代码库

HiFox 中常见的代码库配置有两类：空间代码库和 Agent 代码库。

空间代码库：这个空间中的任务默认使用哪些仓库；

Agent 代码库：某个 Agent 明确绑定哪些仓库。

如果 Agent 没有单独绑定 Git 仓库，通常会默认使用空间里设置的 Git 仓库。这样你可以在空间层面配置常用仓库，再让空间里的任务自然使用这些仓库。

如果某个 Agent 只应该处理特定仓库，也可以在 Agent 设置里单独绑定仓库。

添加 Git 仓库

在空间设置或 Agent 设置中找到代码仓库，添加目标仓库。

通常需要填写：

仓库 URL；

仓库描述；

这个仓库绑定到哪个空间或 Agent。

仓库 URL 可以是 HTTPS 或 SSH 地址，取决于你团队的 Git 访问方式。填写后，建议用一个低风险任务测试 Agent 是否能成功 clone 并读取仓库。

访问凭证如何工作？

HiFox 本身记录仓库配置，但真正访问仓库的是 Agent 所在的机器。

也就是说，Agent 会通过它所在机器上的 Git 凭证访问仓库。你需要确保这台机器已经配置好对应的 Git 权限，例如：

已登录 GitHub、GitLab 或内部 Git 服务；

SSH key 已配置并有仓库访问权限；

HTTPS token 或凭据可用；

私有仓库对这台机器可访问。

如果机器无法 clone 仓库，Agent 也无法完成代码任务。

代码托管凭据和密钥

对于需要统一提供的凭据，可以在密钥中添加代码托管凭据或环境变量。

密钥会加密保存，保存后不会再次显示。不要把 token、API Key、部署凭据或内部服务令牌写进任务描述和评论。

如果配置了 GitHub 代码托管凭据，它也可以作为 GH_TOKEN 注入 Agent 运行环境，方便 Agent 使用 GitHub 相关命令。

绑定代码库到空间

空间代码库决定这个空间中的任务默认使用哪些仓库。

例如：

研发空间绑定主应用仓库；

文档空间绑定文档仓库；

客户交付空间绑定私有部署仓库；

移动端空间绑定 iOS / Android 仓库。

当你把任务安排给 Agent 时，Agent 可以根据任务所属空间找到默认仓库。

如果一个空间没有绑定仓库，而 Agent 也没有绑定仓库，Agent 可能可以看到任务，但无法进入代码目录完成工作。

绑定代码库到 Agent

Agent 也可以单独绑定 Git 仓库。

适合这样做的情况包括：

这个 Agent 只处理某个仓库；

这个 Agent 需要访问多个空间共用的仓库；

空间默认仓库不适合这个 Agent；

你希望明确限制 Agent 的代码访问范围。

如果 Agent 绑定了仓库，它会优先使用自己的仓库配置；如果没有绑定，则使用空间里的 Git 仓库设置。

用任务测试连接是否正常

添加仓库后，建议创建一个低风险任务测试连接，例如：

请读取这个仓库的 README，确认项目使用的主要语言、包管理器和测试命令。不要修改文件，把结论写回任务评论。

这个任务可以验证：

Agent 能否 clone 仓库；

机器上的 Git 凭证是否有效；

Agent 是否能读取代码；

Agent 是否能把结果写回任务。

如果这个任务成功，再开始让 Agent 修改代码或运行更复杂的检查。

常见问题

Agent 说无法访问仓库怎么办？

先检查任务所在空间或 Agent 是否绑定了这个仓库。然后检查 Agent 所在机器是否有 Git 访问权限，能否手动 clone 这个仓库。

仓库已经添加，为什么 Agent 还是找不到代码？

可能是任务所在空间没有绑定仓库，或者 Agent 没有绑定仓库。检查空间设置和 Agent 设置中的 Git 仓库配置。

需要把密钥写进任务描述吗？

不要。密钥应该通过密钥配置提供，任务描述只写目标、上下文和验收标准。

删除仓库会删除代码吗？

不会。删除 HiFox 中的仓库配置只会让 Agent 不再通过这条配置使用该仓库，不会删除 Git 服务中的代码仓库。

什么时候需要连接代码库？#

空间代码库和 Agent 代码库#

添加 Git 仓库#

访问凭证如何工作？#

代码托管凭据和密钥#

绑定代码库到空间#

绑定代码库到 Agent#

用任务测试连接是否正常#

常见问题#

Agent 说无法访问仓库怎么办？#

仓库已经添加，为什么 Agent 还是找不到代码？#

需要把密钥写进任务描述吗？#

删除仓库会删除代码吗？#