1. troubleshoot
Hifox Docs
  • HiFox 帮助中心
  • 快速开始
    • 创建第一个任务
    • 安装桌面端或 命令行
    • 邀请团队成员
    • 连接代码仓库
  • 日常使用
    • 把任务交给 Agent
    • 用任务跟踪工作
    • 使用项目和视图
    • 处理收件箱提醒
    • 和 Agent 对话
    • 在评论里 @ Agent
    • 使用自动化触发重复工作
  • 管理团队
    • 配置仓库和密钥
    • 管理团队、成员和小队
    • 创建和管理 Agent
    • 管理机器
    • 个人偏好和通知
    • 配置任务工作流
    • 管理个人访问令牌
  • troubleshoot
    • 机器离线或检测不到
    • 任务或 Agent 运行失败
    • 仓库或密钥访问失败
    • Agent 没有开始运行
    • 命令行 或桌面端异常
  • 参考
    • 术语表
    • 设置入口索引
    • 命令行 参考
    • Agent 运行状态说明
  • 服务与隐私协议
    • HiFox 服务协议
    • HiFox 隐私条款
  1. troubleshoot

仓库或密钥访问失败

你会看到什么#

Agent 提示无法访问仓库、找不到密钥、没有权限,或在运行中因为认证失败停止。

先检查这几项#

1.
仓库是否已在 设置→Git 仓库 中添加。
2.
Agent 是否配置了该仓库。
3.
运行机器是否能访问仓库地址。
4.
需要的密钥是否已在 设置→密钥 中创建。
5.密钥名称是否和 Agent 或任务中预期一致。

处理步骤#

1.
打开仓库设置,确认地址和权限。
2.
打开密钥,确认敏感配置存在且未过期。
3.
打开 Agent 设置,确认它能使用这些资源。
4.
如果使用本地机器,确认本地网络和凭据可用。
5.
修复后在任务评论中让 Agent 继续。

常见问题#

我可以把密钥粘贴给 Agent 吗?#

不建议。请把敏感值放到密钥中,不要写在评论、任务描述或对话里。

本地仓库和Git 仓库有什么关系?#

Git 仓库告诉 HiFox 哪些仓库允许被使用。本地目录还需要本机机器能访问对应路径。

下一步#

配置仓库和密钥
把任务交给 Agent
修改于 2026-06-16 06:38:50
上一页
任务或 Agent 运行失败
下一页
Agent 没有开始运行
Built with