用途:生成专业的 PDF 进度报告,适合向利益相关者、投资人或团队汇报。
主要能力:支持三种范围——全项目(架构、安全、数据库结构、路线图、工程指标、仪表盘截图)、单功能/阶段、冲刺/周报;自动从代码库收集指标(LOC、源文件数、Git 提交与 diff、测试结果、数据库表、仪表盘页面、API 路由等),并通过 agent-browser 抓取实时仪表盘截图。
使用方式:先确定报告范围,再运行指标收集命令(如 wc -l、git log、测试命令),然后用 agent-browser 打开页面截图,基于 assets/report-template.html 的 CSS 模板构建 HTML 报告,最后用 agent-browser pdf 生成 PDF,保存到 docs/reports/ 目录并以日期命名。
限制与注意:模板要求使用硬编码十六进制颜色,不可用 CSS 变量,否则 PDF 中文字会不可见;图片用相对路径 screenshots/ 引用;必须用 agent-browser pdf 而非 weasyprint(字体渲染问题会导致文字不可见);截图后等待 2 秒加载数据;模板中 CSS 类与各组件 HTML 片段需参考 assets/report-template.html 与 references/sections-guide.md。