用途:为当前分支的 PR 生成一个本地静态 HTML/CSS/JavaScript 走查站点,帮助评审者快速定位和理解改动。它不是代码评审技能,不产出新的评审结论或批准建议。
主要能力:输出四个可切换的 D3 画布视图——系统概览(独立于 PR 的子系统架构卡片,不含 diff 链接或评审评论)、数据流图、代码依赖图、用户操作图;每个视图带引导式导览,支持缩放、平移、搜索、节点详情、适配视图。站点按 PR 规模缩放,小 PR 保持精简。
使用方式:先确定仓库根、当前分支与比较基线,可用 gh pr view --json baseRefName,headRefName,title,body,url,state,reviewRequests,reviews,files 获取 PR 信息;无 PR 时用 git symbolic-ref --short refs/remotes/origin/HEAD 推断基线。收集 diff 与日志后,结合完整代码库、PR 描述、变更的 spec 和已有评审评论构建视图。输出到 .warp/pr-walkthrough/index.html,须能通过 file:// 直接打开,无需开发服务器或构建步骤。D3 从固定版本 CDN 加载:https://cdn.jsdelivr.net/npm/d3@7.9.0/dist/d3.min.js。可复用 scripts/d3_canvas_runtime.py 生成渲染器,并用 scripts/validate_d3_canvas.py 验证画布。
适用场景:需要可缩放 PR 地图、图形化 PR 定位或替代幻灯片式说明时。
限制:不生成评审发现或批准建议;系统概览视图不得包含 PR 专属内容;外部图片需下载到本地 assets 或内嵌,不得热链;若浏览器环境不可用,画布渲染应报告为未验证。品牌样式与更多细节以官方资料为准,部分内容暂未提供。