计划要求： 关联仓库适用于 Teams 和 Enterprise 计划（试用作为预览包含在内）。Free 计划不包含跨仓库上下文。这与跨代码库共享编码标准（组织级规则与继承）不同。关联仓库共享的是审查用的源码上下文，而不是审查规则。
它做什么
对正在审查的仓库，你可以在同一组织中声明最多 3 个关联仓库。审查过程中：- Kody 用确定性边界门控（无 LLM）查看 PR diff。
- 若 diff 看起来触及契约表面（DTO、export、字符串字面量、状态键、类 API 路径等），则启用跨仓库工具。
- 仅当 Kody 真正需要读取或搜索时，才懒克隆关联仓库。
- 发现仍只锚定在当前 PR 的行上——关联代码是证据，不是第二个审查目标。
在控制台中配置
关联仓库是按仓库的，不是全局的。关系是有方向的：frontend 上的关联仅在审查 frontend 的 PR 时生效。
- 打开代码审查设置。
- 选择具体仓库（不是 Global）。
- 打开该仓库菜单中的 Linked Repositories 页面。
- 在 Linked repositories 中添加已连接到组织的兄弟仓库。
- 可选设置：
- Instructions — 给 Kody 的自由文本提示（例如：“此前端消费的 REST API”）。
- Ref — 可选的 branch/tag 固定。留空则使用自动 ref 级联（见下）。
- 保存。
在 kodus-config.yml 中配置
也可以在仓库配置文件中声明关联：
repository（必填）：已连接到组织的仓库全名（owner/repo）。instructions（可选）：简短说明关联原因。ref（可选）：固定 branch、tag 或 commit。省略时 Kody 使用 ref 级联。
linkedRepositories: [] 表示功能关闭。
如何选择 ref
对每个关联仓库，Kody 按以下顺序尝试 ref，并使用第一个成功克隆的：- 该仓库的 PR 描述覆盖（见下）
- 配置中的
ref固定（若已设置） - 关联仓库上 head 分支与 PR head 分支匹配的打开中的 PR
- 关联仓库上的 PR head 分支名
- 关联仓库的默认分支
- 回退：
main，然后master
通过 PR 描述覆盖 ref
对于一次性审查（例如对照某个后端 PR 审查），在正在审查的 PR 的标题或描述中提及已关联的仓库。覆盖仅适用于配置中已经关联的仓库。 支持的形式：
示例：
何时激活跨仓库上下文（边界门控）
即使已配置关联，Kody 也不会总是打开兄弟仓库。廉价、确定性的门控扫描 PR diff 中的新增行，仅在发现边界表面时激活，例如：- 字符串字面量（路径片段、代码、事件名等）
- export（
export function、类型、类等） - enum / type / interface
- 对象或 payload 字段键
- status / state / error-code 类标识符
- 类契约路径（
dto、schema、api、client、openapi、proto等）
Kody 对关联仓库能做什么、不能做什么
可以：- 在门控开启时搜索并读取关联仓库中的文件
- 使用你的 instructions 理解关系
- 在当前 PR 的发现中将关联代码作为支持证据引用
- 对仅存在于关联仓库中的文件发布审查评论
- 把整个关联仓库当作 PR 来审查
- 关联组织外或未连接到 Kodus 的仓库
- 超过每个审查仓库 3 个关联仓库的软上限
审查结束时的透明度
当关联仓库参与了运行时，审查元数据会记录配置了哪些仓库、解析了哪些 ref（以及来源：描述、固定、打开的 PR、head 分支或默认分支），以及边界门控是否激活。失败或跳过的关联会以警告形式呈现，而不会使整次审查失败。推荐设置
优先使用窄、有方向的关联（消费者指向生产者），而不是把所有仓库互相连起来。
相关指南
- 如何跨代码库共享编码标准 — 组织级规则与继承（不是源码上下文）
- 如何使用项目特定上下文审查 PR — 记忆、文件引用、自定义提示、MCP
- 如何减少代码审查噪音 — 增加上下文时仍保持审查聚焦