Unblocked Code Review

什么是 Unblocked Code Review？

Unblocked Code Review 是一款由 AI 驱动的代码评审助手，设计初衷是按照你团队的真实工作方式来协同工作。它并不只依赖通用最佳实践或表面的风格检查，而是从你组织在真实世界中的决策、约定和系统架构中学习，在每一个 Pull Request 上提供高质量、具备上下文感知的反馈。

通过连接你的代码库、沟通记录、文档和规划工具，Unblocked 会构建一个反映系统如何运作以及为何如此设计的“活的知识图谱”。基于这种理解，它能够给出有价值的评审意见、为 CI 失败提出修复建议，并以丰富的上下文总结变更内容。最终结果是：更少的细枝末节纠结，更高的信号质量，更快速且更有信心的代码评审。

关键特性

• 团队记忆与上下文感知评审
  Unblocked 会记住你团队随着时间积累下来的各类决策。它会引用真实的 Slack 讨论、过去的 PR 和已记录的架构或产品决策，使反馈方式与团队一贯的工作偏好保持一致，而不是套用抽象的、千篇一律的规则。

• 感知系统的架构理解能力
  该工具能够理解你系统的模式和约束。它不会去标记那些对你的技术栈并不适用的理论性问题，而是基于你的真实架构、设计模式和运行现实提出合理的关注点。

• CI 失败分析与可执行修复建议
  当 CI 失败时，Unblocked 不只是展示日志，而是会解析 CI 输出，并在 Pull Request 中直接给出可执行、具体的修复建议，把失败转化为清晰的待办事项。

• 高质量的 PR 行内评论
  Unblocked 会在 PR 中留下行内评论，标记诸如逻辑错误、竞争条件、安全风险以及不安全模式等问题。关注重点是正确性、健壮性和可维护性，而非表面化的代码风格问题。

• 用于交互式评审的 PR Chat（@unblocked）
  开发者可以在 PR 讨论中提及 @unblocked，以提出追问、请求更深入的解释、索要示例或测试，或就特定代码片段进行多轮迭代。你也可以让它生成图表，以可视化数据流或系统变更。

• 具备上下文的丰富 PR 总结
  Unblocked 会生成更高层次的 PR 总结，并将相关工作、团队历史讨论以及关联工单纳入考量。这有助于评审者快速理解变更的意图和影响，而不仅仅是阅读 diff。

• 由你现有工具驱动的知识图谱
  通过摄取代码仓库、Slack、文档及规划系统（如 Jira）中的数据，Unblocked 会构建一张关于你代码与协作行为的知识图谱。它会在 Issue、PR、聊天与文档之间穿梭关联，根据新近程度和权威度对信息进行排序，并在不同来源发生冲突时进行裁决。

• 持续同步与始终最新的上下文
  Unblocked 会持续与你的代码库和已连接工具进行同步，跟进最新的变更、决策和架构演进，确保反馈能够反映系统当前的真实状态。

• 安全与合规（SOC 2 Type II）
  该平台通过了 SOC 2 Type II 审计与认证，在安全性、可用性和保密性方面符合要求。它采用企业级权限管理与细粒度访问控制，保障你的数据安全。

• 基于权限感知的访问控制
  Unblocked 会尊重你现有数据源的权限与安全边界。它能在公有和私有仓库中无缝工作，并且不会超出用户现有权限去访问额外数据。

• 面向企业的特性
  对 SSO、审计日志和基于角色的访问控制（RBAC）的支持，使 Unblocked 适用于各种规模的团队和组织，包括对合规要求严格的企业环境。

• 快速配置与免费试用
  你可以通过 21 天免费试用 快速上手（无需信用卡）。大多数团队可以在 10 分钟内完成搭建，仅需快速安装和极少的配置。

如何使用 Unblocked Code Review

1. 注册并开启免费试用
   访问 Unblocked Code Review 网站，开启 21 天免费试用。无需信用卡，便于在团队内部快速评估。

2. 连接代码仓库
   使用安全的 OAuth 集成，将 Unblocked 连接到你的 Git 托管平台（例如 GitHub、GitLab 或类似平台）。Unblocked 会遵循仓库既有权限设置，同时支持公有与私有仓库。

3. 导入对话、文档与规划工具数据
   连接 Slack、文档系统以及 Jira 等问题追踪工具。这样 Unblocked 就能学习你们真实的决策历史、架构讨论以及项目上下文。

4. 让 Unblocked 构建知识图谱
   连接完成后，Unblocked 会持续同步你的数据，并构建一张关联下列内容的知识图谱：

   • 将 Jira Issue 关联到相关的 PR
   • 将 Slack 线程关联到具体的代码决策
   • 将文档关联到特定组件与模块
     它会根据新近程度和权威度对信息进行排序，并对相互矛盾的信息进行整合。

5. 像平常一样发起 Pull Request
   开发者继续沿用现有的 Git 工作流。当 PR 被创建或更新时，Unblocked 会结合已收集的上下文知识来分析 diff。

6. 审查行内评论与建议
   当检测到逻辑问题、潜在的竞争条件、安全隐患或不安全模式时，Unblocked 会在代码中留下行内评论。像审阅资深工程师的反馈一样查看这些评论，并选择接受、修改或进行讨论。

7. 借助可执行指导处理 CI 失败
   当 CI 失败时，Unblocked 会解析日志，并在 PR 中给出清晰、可执行的建议。开发者无需反复翻查日志，就能快速定位根因并完成修复。

8. 使用 PR Chat 进行深入讨论
   在 PR 讨论中提及 @unblocked，可以用来：

   • 请求对某个问题进行更详细的解释
   • 索要示例实现或测试用例
   • 澄清某项变更对系统其他部分的影响
   • 生成图表以可视化数据流或架构变更

9. 利用 PR 总结加快评审节奏
   使用 Unblocked 生成的上下文丰富的总结，让评审者快速进入状态。总结会突出关键变更、相关工单以及历史背景，从而缩短评审周期并提升理解深度。

10. 自定义评审规则与反馈级别
    通过配置来精细调整 Unblocked 的行为，包括指定需要评审的内容、排除特定模式或文件，以及调整反馈的详尽程度与风格，使之契合你团队的偏好。

使用场景

1. 需要扩展代码评审能力的工程团队
   随着团队成长，PR 数量往往激增，容易导致评审瓶颈和匆忙的审查。Unblocked 可作为一个高信号、具备上下文感知的“虚拟评审者”，在早期就捕获关键问题，让人工评审者把精力集中在更深层次的设计和产品问题，而不是重复性的检查。

2. 分布式或远程优先的组织
   在远程或全球分布式团队中，上下文信息往往分散在不同的时区和工具中。Unblocked 会把来自 Slack、文档和工单的知识整合到评审流程里，减少反复沟通，使即便不在同一时区的团队成员也能进行高质量的代码评审。

3. 架构复杂、约束丰富的系统
   采用微服务、事件驱动架构或严格领域边界的系统需要更细致的评审。由于 Unblocked 能感知系统并了解实际架构和历史决策，它可以标记那些违反既有模式、引入高风险依赖或与既定设计选择相冲突的变更。

4. 对安全与合规敏感的代码库
   处理敏感数据或受监管约束的团队需要严格、一致的代码评审。凭借对安全风险、不安全模式和策略违规的检测能力，再加上 SOC 2 Type II 合规和基于权限的访问控制，Unblocked 非常适合这类环境。

5. 新工程师加入大型代码库的场景
   新同事往往不了解各种模式、决策或技术债背后的历史背景。将 Unblocked 嵌入到 PR 流程后，新工程师收到的解释和建议会体现资深团队成员的经验，从而加速融入并降低上手难度。

常见问题（FAQ）

1. Unblocked 是如何访问我的代码的？
Unblocked 通过安全的 OAuth 连接集成到你现有的工具中。它遵循你在 Git 托管平台及其他数据源中已配置好的权限设置。除为分析所必需的内容外，你的代码不会被长期存储，所有访问都受制于你组织的安全策略。

2. 它支持私有仓库吗？
支持。Unblocked 同时适用于公有和私有仓库，并完全遵从你组织的访问控制与权限配置，确保只有获授权的用户与服务可以访问敏感代码。

3. 我可以自定义 Unblocked 评审的内容和评论方式吗？
可以。你可以根据团队标准配置评审规则，排除特定模式或文件（例如生成代码、遗留模块），并调整反馈的详细程度——从高度细致到更加简洁。这样你就能让 Unblocked 的行为更加贴合你的工作流和偏好。

4. Unblocked 与其他 AI 代码评审工具有什么不同？
多数 AI 代码评审工具只查看 diff 或本地文件，并应用通用最佳实践。Unblocked 则会基于整个代码库、对话、文档以及历史决策构建知识图谱。借助这些丰富的上下文，它能生成真正有价值、具备上下文感知的评论，并理解你的具体系统，而不是假设一个通用架构。

5. Unblocked 支持哪些编程语言？
Unblocked 支持所有主流编程语言，包括但不限于 JavaScript、TypeScript、Python、Go、Java、Ruby、PHP、C++ 和 C#。这种广泛支持非常适合多语言代码库和现代全栈团队。

6. 搭建需要多长时间，前置条件是什么？
大多数团队可以在 10 分钟内完成部署。你只需开启免费试用，通过 OAuth 连接代码仓库和常用协作工具，Unblocked 就会立即开始学习你的代码库与决策历史。无需复杂配置，即可快速获得价值。

7. Unblocked 安全且适用于企业环境吗？
是的。Unblocked 通过了 SOC 2 Type II 审计与认证，在安全性、可用性和保密性方面达到企业级要求。它支持 SSO、审计日志和基于角色的访问控制，并且会尊重所有已连接数据源的既有权限配置。