SuperAPI AI 工具集

pr-review-canvas

编程与开发

查看项目

更新于 10-16 09:58

技能介绍

用途:为 GitHub Pull Request 生成一份交互式 HTML 审查页面,把变更像同事讲解一样呈现给审查者。

主要能力:通过 gh api 并行获取 PR 元信息、文件列表与评论;读取 diff 并直接编写 <body> HTML 内容;将文件分为核心改动与机械/样板改动(后者默认折叠);支持伪代码摘要、内联 SVG 或 mermaid 图、流程图、对照表、提示框等自定义结构;底部提供审查清单。内置 styles.css 与 renderer.js 提供暗色主题组件(.header、.pill、.file-card、.bp-section、.verdict 等)和 JS 工具(toggle、toggleBP、renderDiff、esc)。renderDiff 会自动过滤 import 行、合并纯空白改动、识别被移动的代码块。

使用方式:先运行资料中的 gh api 命令获取数据,并用 jq 将 patch 保存为 /tmp/pr-patches-{number}.json;将正文 HTML 写入 /tmp/pr-review-{number}-body.html;再用 Python 脚本把 CSS、JS、正文与安全转义后的 patch JSON 注入 template.html;最后通过 cd /tmp && python3 -m http.server 8432 --bind 127.0.0.1 启动本地服务并访问 http://127.0.0.1:8432/pr-review-{number}.html。端口被占用时可改用 8433、8434 等。

限制与注意:patch 字符串可能包含 </script> 等序列,禁止手动把 patch 直接嵌入可执行 script 标签,须按资料中的 jq + Python 方式安全嵌入;后台 shell 无 TTY,需使用固定端口而非端口 0。具体依赖版本、兼容范围与许可证等资料暂未提供。