Kodus 是一个开源代码审查平台，以名为“代理”的代理为中心 Kody。它分析拉取请求差异和上下文，应用内置和团队定义的规则，过滤建议并在 Git 提供程序中发布内联调查结果或摘要。当前项目材料列出了 GitHub、GitLab、Bitbucket 和 Azure Repos，目前 GitHub 和 GitLab 上的状态反应更加丰富。
Kodus 作为早期、可重复的审阅者很有用，而不是负责任的维护者、确定性静态分析器或更改安全的证明。它可能会发现错误、性能问题、安全气味和策略偏差，但它也可能会错过跨系统行为、误解意图或产生看似合理的误报。受保护的分支机构、测试、专业扫描仪和人员所有权仍然是必要的。
审查路径及其信任边界
PR活动/手动@kody命令
|
v
Git 提供程序应用程序 ---> diff + 选定的上下文
|
v
Kodus 控制平面/自托管服务
|
.------+----------------。
伏
选择LLM规则/内存/插件
| |
'--------发现------'
|
重复数据删除 + 严重性 + 保障措施
|
v
内嵌评论/摘要/可选审核状态
|
CI + 人工审核员 -> 合并决策
为所选版本绘制此流程。托管 Kodus、具有云模型的自托管 Kodus 和具有本地模型的自托管 Kodus 具有不同的数据路径。如果提示仍然发送到外部提供商，“自托管”并不意味着代码保留在网络内。
版本和成本模型
当前存储库比较列出了社区版、团队版和企业版。社区显示为免费、可用托管或自托管，使用客户自己的模型密钥时具有无限 PR、最多 10 条 Kody 规则和最多 3 个活动插件。 Teams 的定价为每位开发人员每月 10 美元，或每位开发人员每月 8 美元（按年度计费），另加模型/代币成本。 Enterprise 是自定义的，并添加了 SSO、RBAC/审核和支持等领域；由于包装发生变化，请验证实时比较。
| 选择 | 平台费 | 型号计费 | 经营所有权 |
|---|---|---|---|
| 社区托管 + BYOK | 目前免费上市 | 直接发送至选定的提供商 | 密钥、存储库权限和策略 |
| 社区自托管 + BYOK | 根据存储库条款免费列出的软件 | 直接提供商或本地基础设施 | 全面部署、存储、安全和升级 |
| 团队 | 每开发商费用 | BYOK/单独的代币费用 | 配置、提供者和审查治理 |
| 企业 | 定制 | 确认合约代币安排 | 根据合同与供应商共享 |
该存储库促进 BYOK 的模型成本零标记，但成本仍然取决于差异大小、上下文文件、跨文件分析、所选模型、重试和后续提交。定价文档称，超过 200 个更改的文件的 PR 未经过审核。计算每个已接受问题的成本，而不是每个 PR 的成本。
模型选择是审查策略的选择
Kodus 宣传与模型无关的支持，包括 Claude、GPT、Gemini、Llama、GLM、Kimi 和 OpenAI 兼容端点。在您的代码库上对确切的提供商和模型进行基准测试。更便宜的模型可能会产生如此多的误报，以至于审核者会忽略该机器人；一个强大的模型可能会暴露更多的背景和成本，而不会成比例地减少缺陷。
| 标准 | 测量 | 为什么这很重要 |
|---|---|---|
| 真阳性精度 | 接受的有效调查结果/所有调查结果 | 低精度破坏了审稿人的信任 |
| 召回种子缺陷 | 发现的已知缺陷/插入的缺陷 | 沉默并不代表安全 |
| 严重性校准 | 与人类的标准一致 | 阻塞取决于严重程度 |
| 纠正努力 | 验证和修复只需几分钟 | 冗长的正确注释仍然可能代价高昂 |
| 成本 | 提供商代币+平台+审核人工 | 显示到岸成本，而不是单独的 API 价格 |
| 延迟 | 公关更新以提供有用的反馈 | 缓慢的评论会中断流程 |
权限：仅查看机器人必须看到的内容
默认情况下，在选定的存储库而不是整个组织上安装 Git 提供程序应用程序。从对代码/元数据的读取权限和发布评论/状态的权限开始。除非单独合理的功能需要它们，否则不要授予管理、机密、环境、发布或直接写入权限。
存储库代码可能意外包含凭据、客户固定装置、专有算法和个人数据。即使仅发送差异和上下文，这些片段也可能是敏感的。查看提供商保留/培训条款、区域、加密、子处理者和删除。该项目表示，源代码不用于训练模型，并且在传输和静态时进行加密；验证所选托管和提供商路径的合同范围。
自托管不会消除架构工作
官方部署材料描述了 API、webhooks、worker 和 web 服务以及数据库/队列和 AST 图/跨文件分析沙箱。沙箱可以位于工作程序内部，也可以位于 E2B 内，这是一个付费远程选项。 Cloud Git 集成需要公共 Web 和 API 端点；内部 Git 加上本地模型可以在没有外部互联网的情况下运行。
| 自托管组件 | 风险 | 控制 |
|---|---|---|
| Webhook 端点 | 伪造/重播事件和拒绝服务 | 签名验证、重放防御和速率限制 |
| 工人 | 不受信任的代码解析和资源耗尽 | 容器/虚拟机沙箱、配额和限制出口 |
| 数据库/队列 | 代码/上下文和令牌泄漏 | 加密、身份验证、备份和保留 |
| 模型端点 | 提示/代码披露和成本滥用 | 范围内的密钥、列入白名单的端点和每个存储库的预算 |
| 网络应用程序 | 配置和回购接管 | SSO/MFA、RBAC、CSRF 保护和审核 |
| 遥测 | 意外的外部元数据 | 回顾匿名心跳；如果需要，通过记录的设置禁用 |
该存储库指出自托管实例每天发送一个匿名聚合心跳和文档 KODUS_TELEMETRY_DISABLED=true 选择退出。在固定版本上验证这一点并监控出站流量。
先建议，后阻止
Kody 默认为建议。文档允许对关键发现进行可选的“请求更改”，并在未发现问题时自动批准。开始咨询至少几周。仅对具有高测量精度、明确补救措施和覆盖路径的规则启用阻止。请勿将缺乏 AI 结果作为唯一的自动批准条件。
| 政策 | 适合初次使用 | 所需的伴随证据 |
|---|---|---|
| 仅供评论 | 所有试点存储库 | 跟踪接受/拒绝原因 |
| 请求对关键内容进行更改 | 稳定高精度的安全/性能规则 | 人工覆盖和确定性扫描仪/测试 |
| 自动批准 | 成熟基准测试后的低风险文档/测试 | 受保护的 CI 和另一个合并授权 |
| 所需的状态检查 | 管理良好的存储库 | 不能搁置紧急修复的超时/故障策略 |
规则即代码需要同样的审查
Kody 规则可以用范围、路径和严重性对团队标准进行编码。存储库规则可能存在于记录的目录下，而集中配置可以使一个存储库成为具有版本历史记录、PR 审查和回滚的组织事实来源。这比未记录的 UI 漂移更好，但恶意或错误的规则更改可能会影响许多存储库。
- 集中规则变更需要代码所有者批准。
- 在推出之前针对正负固定装置测试规则。
- Canary 存储库的子集并比较评论量。
- 为每条规则指定所有者、理由、示例、到期/审核日期和覆盖路径。
- 避免诸如“编写干净的代码”之类的模糊规则；指定可观察到的故障。
记忆和学习可以保留不良反馈
Kodus 将 Kody 定位为学习团队环境。记忆可以减少重复的误报，但审稿人的评论可能是错误的、讽刺的或针对特定项目的。记录所学指导的来源和范围，允许删除，并定期回顾陈旧/冲突的记忆。安全策略不应因为开发人员驳回一项调查结果而默默降级。
MCP 和插件扩大了审查范围
自定义插件可以通过 MCP 或其他集成获取动态标准。它们可能会向模型公开内部注册表、问题跟踪器或文档，并且可以成为提示注入路径。将工具和方法列入白名单，使用只读凭据，验证输出并防止插件内容覆盖系统审核策略。
社区比较目前限制活动插件，而更高级别的列表则不受限制。 “无限”不是一个设计目标；每个插件都应该证明其数据访问和维护负担的合理性。
大型且生成的拉取请求
保持 PR 较小并与规范相关联。文档称 Kody 审查更改的文件，可以执行 PR 级别/跨文件检查、过滤和删除重复建议，并记住上次分析的提交以进行增量跟进。非常大的差异会降低人工智能和人类的理解能力，并且可能会超出记录的 200 个文件的限制。
将生成的迁移、锁定文件和供应商资产与逻辑更改分开。配置忽略模式，但不隐藏其完整性影响部署的生成工件。需要跳过文件和审查限制的摘要，以便绿色状态不会被误读为完全覆盖。
如何验证研究结果
| 查找类型 | 权威验证 | 常见误报 |
|---|---|---|
| 错误 | 再现器/测试显示错误行为 | 审稿人在其他地方错过了一个不变量 |
| 安全性 | 威胁路径加上专业扫描仪/手动分析 | 输入已在可信边界验证 |
| 性能 | 真实数据的基准/配置文件 | 没有热路径证据的微观优化 |
| 风格/可维护性 | 版本化团队规则 | 主观偏好表现为缺陷 |
| 缺少测试 | 风险/行为覆盖图 | 另一层存在等效覆盖 |
| 重大改变 | API/架构兼容性检查 | 故意版本化中断 |
需要内联注释来命名受影响的行为、证据、严重性和有限的建议。以结构化原因驳回（不正确、不相关、重复、接受风险或推迟），因此调整数据是可行的。
不要让 AI 代理自我审查以收敛
存档的旧 Kodus CLI 促进了编码代理运行审查、修复问题和重复的循环。这可以在本地提供帮助，但同一模型可能会生成并随后批准自己的假设。它还可能削弱测试或产生振荡。设置迭代、令牌、时间和差异大小上限；使用不同的只读审阅者和最终的独立 CI。
请注意 kodutech/cli 已于 2026 年 4 月 28 日存档。在未检查当前 Kodus 文档和维护的包路径的情况下，请勿将新工作流程基于其安装程序或命令。
为期六周的推出
- 第一周： 安全/数据审查；以最低权限连接两个低风险存储库。
- 第 2-3 周： 仅提供咨询意见；标记每个发现结果并测量精度。
- 第 4 周： 添加五到十个具体规则，并根据历史 PR 对其进行测试。
- 第 5 周： 比较同一隐藏 PR 集上的两个模型并计算到岸成本。
- 第 6 周： 仅当精度和覆盖操作满足目标时，才启用一项狭义定义的阻止规则。
跟踪审阅者节省的时间、每 100 条评论接受的结果、逃逸的缺陷、第一响应延迟、提供商成本、公关准备时间和开发人员情绪。发布许多技术上合理的评论但降低合并吞吐量的机器人并不成功。
替代方案
| 选项 | 最适合 | 与 Kodus 的权衡 |
|---|---|---|
| Kodus/Kody | 模型选择、规则和托管/自托管灵活性 | 操作/配置表面和不断发展的包装 |
| GitHub Copilot 代码审查 | GitHub 原生团队已获得许可 | 提供商/托管灵活性较低 |
| CodeRabbit | 通过丰富的集成进行托管公关审核 | 商业托管依赖 |
| 科多合并 | PR 审查和面向测试的工作流程 | 不同的政策和定价模式 |
| Semgrep/声纳/Snyk | 确定性静态/安全规则 | 自然语言上下文更少，再现性更强 |
| 人类代码所有者审查 | 架构、业务意图和责任 | 专家时间稀缺；应该补充自动化 |
常见问题
Kodus 是开源的吗？
主存储库是公共的，描述社区自托管。查看您的部署的当前许可证文件和版本条款。
我可以使用自己的型号密钥吗？
是的，当前材料宣传 BYOK 和多个模型提供程序/OpenAI 兼容端点。
Kodus 是否根据我的代码进行训练？
该项目声明源代码不用于培训。验证合同和单独的基础模型提供商的条款。
Kody 可以阻止拉取请求吗？
它可以选择请求更改已配置的关键问题。仅在精确测试后启用并保持人工优先。
可以自动批准吗？
文档描述了可选的自动批准，但没有发现并不能证明正确性。需要独立的CI和合并授权。
支持哪些存储库？
当前材料列出了 GitHub、GitLab、Bitbucket 和 Azure Repos；一些界面行为有所不同。
是否支持非常大的 PR？
定价文档报告了超过 200 个已更改文件的硬性限制。较小的 PR 也可以提高审核质量。
主要来源
- 官方 Kodus 存储库、版本和架构
- 实时 Kodus 定价
- 官方代码审查流程
- 官方审查/屏蔽政策
- 集中配置指导
- 官方自托管指南
- 官方定价和限量说明
- GitHub App 安全最佳实践
- OWASP 应用程序安全参考
上次审核日期为 2026 年 7 月 26 日。Kodus 计划、模型支持、CLI 路径和功能快速发展。固定已部署的版本并验证隐私、权限、成本并在存储库中查找精度。
