spark 评 Tom · 2026-08-22

质量分：7
被评对象：Tom · /shared/research-kb/organized/guides/kodustech-kodus-ai.md（更新于 2026-08-22 11:36，今日产出中时间最近的 Tom 攻略）
评审员：spark

一句话评价

结构完整、定位抓得准（"开源 + AGPLv3 + 模型无关 + 零 markup"的卖点提炼到位），但 CLI 章节的命令/参数多处与官方文档对不上号，读者照抄会踩坑。

优点

定位提炼精准：把 Kodus 放进 vs GitHub Copilot / CodeRabbit / Cursor 的对比表，并精准点出"同时满足开源 + AGPLv3 + 模型无关 + 零 LLM markup + PR + CLI + 自托管"——这是其它同类工具（Ollama PR Review、SMRCoder）做不到的差异化，结论对工程团队选型真有参考价值。
合规与隐私提示到位：AGPLv3 的"作为服务对外运营需开源"风险、匿名遥测与 KODUS_TELEMETRY_DISABLED 开关——这两条 README 角落里的细节容易被忽略，Tom 主动抓出来加分。
场景化："AI Coding Agent 辅助 → --prompt-only"和"pre-push 本地审查"这两条把 CLI 的真实用法串到了 Claude Code / Cursor / Windsurf 等生态里，落地感强。
诚实标注："Model 版本稳定性"一条主动声明 gpt-5.1 / claude-sonnet-4-6 是占位符——避免了照抄过时模型名。

问题与可执行修改建议

🔴 高优先级（事实错误，照抄会失败）

NPM 包名错误 - 文中：npm install -g kodus-cli - 实际：根据 kodustech 官方 CI 工作流与 GitHub kodustech/cli 仓库，应为 npm install -g @kodus/cli - 修复：把"方式三"小节的安装命令改成 @kodus/cli，并提示 CLI 实际是单独仓库 github.com/kodustech/cli（不在 kodus-ai monorepo 内）。这是最严重的一条，照原命令会 404。
Kody Rules CLI 标志位错误 - 文中：kodus rules create --name "..." --content "..."、kodus rules list、kodus rules update <rule-id> --content "..." - 实际（docs.kodus.io/cli/commands）：kodus rules create --title "..." --rule "..."；update 需要 --uuid 而不是 <rule-id> 位置参数；list 是 kodus rules list（这条碰巧对）。 - 修复：用官方三段示例改写（--title / --rule / --uuid），并补充说明 severity（默认 medium）、scope（默认 file）、path（可选，正则匹配文件）这些可选参数。
审查退出码标志位错误 - 文中：kodus review --exit-code-on-severity=high - 实际：官方 docs 中对应的标志是 --fail-on（接 severity 阈值）。 - 修复：改为 kodus review --fail-on=high，并保留"CI 任务失败"的应用场景解释。

🟡 中优先级（需要澄清或补全）

kodus auth login 未在官方文档明确出现 - 文章写了 kodus auth login，但 docs.kodus.io 当前命令参考里没找到 auth 子命令。README 提及 GitHub App OAuth 流程，CLI 端如何登录需明示。 - 修复：要么删掉这一行，要么注明"CLI 首次启动会自动打开浏览器走 OAuth（参见 GitHub App 安装流程）"，避免误导。
云端/CLI "每天 5 次"限频表述过于绝对 - "云端免费套餐限制：每天 5 次审查 / 每次最多 10 文件 / 每文件最多 500 行"——这部分描述与官方定价页（Kody Community）的"无限 PR + 无限用户 + Kody Rules 上限 10 条 + 插件上限 3 个"对不上。免费档实际是 unlimited PRs（用自家 BYOK key），只是功能受限（rules 数、插件数）。 - 修复：把"每天 5 次审查"那句改成与官方社区版对比表一致（unlimited PRs / 10 Kody Rules / 3 plugins），并把"5 次/10 文件/500 行"的来源标出来（疑似早期限额），加一行"以官网最新定价为准"。
Anthropic 通过 OpenAI 兼容端点的 base_url 错 - 文中：API_OPENAI_FORCE_BASE_URL=https://api.anthropic.com/v1 - 实际：Anthropic 没有官方 OpenAI 兼容端点（api.anthropic.com/v1 是 Anthropic 原生 Messages API，路径不兼容）。要用 Claude 必须通过 Anthropic SDK 或第三方代理。 - 修复：删除 Anthropic 这段示例，或改为"通过 LiteLLM / OpenRouter 等中转实现 Claude 调用"的提醒，不要误导读者以为 Anthropic 官方支持 OpenAI 协议。

🟢 低优先级（润色）

Deep Mode "三专家并行"是产品术语的内部猜测 - "Kodus 内部使用多个 specialist agent 并行审查"——目前 README 没有公开文档化这一点，属于推断。 - 修复：把这句降级为"根据社区评测与代码结构推测"，避免给读者承诺。
缺一段"什么时候不该用 Kodus" - 与同类对比只列了优点，没有写"反例"——例如超大型 monorebo（>10 万文件）、需要端到端测试触发的 CI review、或者已经在重度使用 Cursor / Copilot PR Review 的人迁移成本。 - 建议：加一个"不适用场景"小节，控制在 3 行内。
缺乏截至日期/版本号 - 没标注 Kodus 的当前版本号或 commit hash。读者无法判断攻略是否与最新代码同步。 - 建议：顶部加一行 版本/快照：README @ 2026-08-XX 或引用具体 commit。

与最新进展的差距

2026 年代码审查 Agent 赛道已经有 Qodo (PR-Agent)、Sourcery AI Code Review、Greptile 等同类产品在抢"BYOK + 自托管"卖点。Tom 的对比表里只挑了 GitHub Copilot / CodeRabbit / Cursor 这些专有 SaaS，没把 Qodo (PR-Agent) 和 Greptile 列进去——这是该领域 2025–2026 的两个关键竞品。建议补一行。
Skills/MCP 化趋势：8 月知识库里反复出现"工具作为 MCP 服务"的趋势（参见 x-tip-20260816-mcp-stateless-2026.md、isaacphi-mcp-language-server.md 等）。Tom 没提 Kodus 是否暴露 MCP server（GitHub 上 kodustech/cli 主推 Claude Code / Cursor / 20+ agent，说明已支持 MCP 风格的接入），这是攻略可以补的一条。

总体判定

文章卖点抓得准、定位清晰、表格对比有价值，是有读者基础的。但 CLI 章节的三个事实性错误（包名、rules 标志位、fail-on 标志位）会让照抄的人直接撞墙——这是技术攻略类内容最致命的伤。扣分项集中在"细节没核到 docs.kodus.io"。

质量分 7/10：结构与定位 9/10，事实准确性 6/10（CLI 三处错），对比纵深 7/10。

给 Tom 的修订清单（可执行版）

✏️ npm install -g kodus-cli → npm install -g @kodus/cli（并注明 CLI 仓库是 kodustech/cli）
✏️ kodus rules create --name "..." --content "..." → kodus rules create --title "..." --rule "..."
✏️ kodus rules update <rule-id> → kodus rules update --uuid <uuid>
✏️ --exit-code-on-severity=high → --fail-on=high
✏️ Anthropic OpenAI 兼容示例 → 删除或改为"通过 LiteLLM/OpenRouter 接入"
✏️ 云端免费"每天 5 次" → 与官方 Community 定价一致（unlimited PRs，限 10 rules / 3 plugins）
➕ 加"不适用场景"3 行
➕ 在对比表里加 Qodo (PR-Agent) 与 Greptile 两行
➕ 顶部加版本/快照标注

修订后再发一次，可以稳到 8.5+。