平台 - 文档 - 安装 - 示例 - 报告 Bug

Reflektor - 强力加持的代码审查
Reflektor 是一个面向编码 agent 的技能和强力工具,能把一个分支变成浏览器里的审查报告。
功能
在你自己的机器上运行,或在云端运行。可以单干,也可以与团队协作。
- 技术无关:适用于任何语言、框架或数据库
- 审查循环:在你的分支上反复迭代,每次提交都生成一份新报告,直到完美
- 协作:在 reflektor.dev 上把报告分享给团队,让你的改动得到审查
- 自动项目检查:在报告生成的同时,你的项目自带的测试、linter 和类型检查器在后台运行,结果一出来就显示在报告里
- 带截图的 E2E UI 测试:UI 的每一部分都通过截图进行测试,结果包含在报告中
- 工作原理:请求从 UI 到数据库的流转可视化,包括它新增、修改或删除的类型、接口、枚举和常量
- 数据库变更:数据库变更的可视化,包括 migration 和 schema 变更
- 测试覆盖率:测试的汇总,包括指标和建议
- Hooks:添加 pre-action hooks,用于运行报告生成的 pipeline 和任务
- Daemon:Reflektor 以一个小型本地 daemon 的形式运行,把所有审查集中在一个收件箱里,在你的 agent 工作时实时更新已打开的报告,并把你的评论交还给 agent
快速开始
需要 Node.js 18 或更高版本,以及 git。
npx skills add bashovski/reflektor#skill -g
它会询问要为你的哪些 agent 安装:Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 等。然后在一个有改动的分支上、于仓库中开启新会话,在 Claude Code 中运行 /reflektor,或在 Codex 中运行 $reflektor。在其他 agent 中,请求生成一份审查报告。Reflektor 会在新版本发布时通知你;用 npx skills update reflektor 更新。完整指南见 reflektor.dev/install。
Codex 的默认沙箱会拦截 reflektor 需要的三件事:
- 写入仓库的 .git 文件夹:.git/reflektor、.git/objects 和 .git/refs/reflektor
- 写入 ~/.reflektor
- 在 127.0.0.1 上运行本地服务器,用于提供审查页面
要么以完全访问权限运行 reflektor,要么给 Codex 一个允许这些操作的权限配置。下面这个在我们的测试中有效(Codex CLI 0.169)。把它放进仓库的 .codex/config.toml,并先在 Codex 中信任该项目:Codex 会忽略它不信任的项目的配置。
default_permissions = "reflektor-local"
[features]
network_proxy = true
[permissions.reflektor-local]
extends = ":workspace"
[permissions.reflektor-local.filesystem]
"~/.reflektor" = "write"
[permissions.reflektor-local.filesystem.":workspace_roots"]
".git/reflektor" = "write"
".git/objects" = "write"
".git/refs/reflektor" = "write"
[permissions.reflektor-local.network]
enabled = true
allow_local_binding = true
[permissions.reflektor-local.network.domains]
"127.0.0.1" = "allow"
"localhost" = "allow"
当你在浏览器中审查时,Codex 会在当前回合里等你。如果该回合已结束,输入 $reflektor resume,Codex 就会接上你的评论。
安装器会在安装前校验发行版的签名,之后 reflektor 会从审查页面自我更新。
curl -fsSL https://reflektor.dev/install.sh | sh # Claude Code
curl -fsSL https://reflektor.dev/install.sh | sh -s -- --target agents # Codex 以及读取 ~/.agents/skills 的 agent
curl -fsSL https://reflektor.dev/install.sh | sh -s -- --target <skills folder> # 任何其他 agent
在 Windows 上,使用 PowerShell:
文章标题:Show HN: Reflektor——把 AI 提交的 PR 变成人类可以审查的东西
正文:
irm https://reflektor.dev/install.ps1 | iex
& ([scriptblock]::Create((irm https://reflektor.dev/install.ps1))) -Target agents
文档
完整文档位于 reflektor.dev/docs:
- 你的第一份报告
- 审查轮次
- reflektor 标志
- 向团队发布报告
示例
我们为你构建了一个庞大的示例库,供你探索。你可以在 Examples 中找到它们。
贡献
虽然反馈和 bug 报告非常受欢迎,但我也欢迎外部帮助。你可以挑选任何未解决的问题,并在 GitHub 上交流。
许可证
Reflektor 基于 MIT 许可证授权。你可以根据许可证条款自由使用、修改和分发本软件。
作者
Anur Basic - anurbasic.com