研枢:研发交付

排查与边界

日志在哪,常见问题怎么处理,以及目前做不到的事。

日志与排查

研枢模块的运行日志用 docker compose -f deploy/nexus/compose.yaml logs engineering 查看。控制台操作和 Agent 调用记录在「系统设置 › 审计日志」里。Webhook 的接收情况在「接入中心 › 入站事件」的「收件记录」里,被拒收或投递失败的事件可以在那里看到原因,修正后重新投递。任务的详细经过在「研发(研枢) › 任务与结果记录」。开发者本机的过程记录可以用 /nexus dev task <任务编号> 查看。

现象说明和处理
面板提示「研枢暂不可用」,或模块显示离线面板和 Agent 调用暂时不可用,已有授权保持不变。先在「概览 › 系统状态」检查模块状态。模块离线时,到审计日志里查模块注册的版本和被拒绝的原因,按部署流程核对运行版本和注册信息,处理后点「重新检查」。
测试连接提示拒绝了凭据服务账号或令牌无效,或已过期。重新填写凭据。
测试连接提示「凭据有效,但服务账号没有读取权限」补足令牌的权限。各系统的要求见「接入研发系统」里的凭据表。
提示「没有找到研发系统的接口」地址可以访问,但路径不对。检查服务地址,含子路径。GitHub、Gitee 要填接口地址,不是网页地址。
提示出站策略拒绝了该地址内网地址需要由运维加入 ECHOMIND_EGRESS_ALLOW。
提示 TLS 握手失败、连接超时、无法连接、返回了重定向依次检查研发系统的证书、网络和地址。重定向时填最终的地址,例如带上 https:// 或子路径。
云效提示须填写组织 IDopenapi-rdc.aliyuncs.com 是中心版,必须填组织 ID。Region 版填组织专属域名并留空组织 ID。
云效读不到流水线运行记录,或答 403令牌所属的用户要是该流水线、代码库和项目空间的成员。
GitLab 采纳时创建合并请求失败读数据只需 read_api,创建合并请求需要 api 权限,账号还要有开发者及以上角色。
绑定时提示 Gitee 不能用作 CI 流水线Gitee 不开放 Gitee Go 的接口。CI 改绑 Jenkins、GitLab CI、GitHub Actions 或云效 Flow。
发起任务被拒绝检查研发项目的写授权。只有读授权的 Key 不能发起任务。
助手说本机没有可用的编程工具装好工具后执行 /nexus dev tools rescan。电脑上别的工具有使用记录、而这个工具没有时,要先启用它。
「指派给我」是空的多半是人员目录里没有登记对应的外部 ID。助手会指出缺哪个体系编码,按「接入研发系统」里「外部 ID 体系编码」的说明补充登记。
采纳后 CI 迟迟不更新没有收到 Webhook 时靠轮询,最长要等几分钟。检查入站事件的收件记录里有没有被拒收的事件,常见原因是令牌不对。
工具报告没有写权限,任务判为未通过多半是无界面模式。给工具装 ACP 适配器,或在工具自己的启动参数里调整权限。

目前的边界

  • 服务器上不执行代码,也没有执行集群。执行只在发起任务的那台电脑上。研枢不做多 Agent 编排,任务怎么拆、子 Agent 怎么协作由工具自己决定。
  • 研枢只管到创建合并请求,并只读地读回结局。不合入,不审批,不关闭合并请求,采纳满 30 天仍未合入的不再跟踪。
  • 不做细粒度的权限约束和审批,不做代码出域控制和秘密屏蔽,不做采纳率这类管理统计。工具的权限请求由开发者本人回答,研枢不自动应答。
  • 不托管代码,不保存需求和缺陷的副本,不接厂商的云端 Agent。已列出的六类以外的研发系统,例如 Jira、TAPD,暂不支持。
  • GitHub Enterprise Server 可以配置地址,但没有在实际的实例上验证过。Gitee 企业版和私有部署、云效专有云不支持。云效只在中心版上验证过。
  • GitHub、Gitee 和云效 Codeup 上,从 fork 发起的合并请求没有验证过。GitHub 的「请我评审」提示没有用真实的第二个账号验证过。Gitee 没有 CI 的接口。
  • 用真实模型完成过任务的工具和只验证过发现、启动的工具,见「开发者的电脑」。Windows 电脑上没有实机验证过。IDE 领取只在 VS Code 加 Codex 扩展上验证过。
  • 云效 Flow 的任务日志一次只能读到最多 1000 行,超长日志的结尾读不到,需要在云效界面查看。
  • 冲突预检依赖较新的 git。本机 git 低于 2.38 时走回退路径,这条路径只有自动化测试,没有用旧版 git 实际跑过。
  • 已有 AGENTS.md 或 CLAUDE.md 的仓库上,整理注意事项修改已有文件的情况,只有自动化测试覆盖,真实工具验证时都是新建文件。权限模式目前通过命令或让助手传参选择,面板里没有选择入口。

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。