在 AI 编程场景里，模型完成一轮修改后，常见回复是“改好了，测试通过”。但开发者往往还要翻聊天记录：哪些文件被改动、哪些测试运行过、哪些验证还没做。开源项目 ask-report-html 尝试把这一收尾动作标准化：让 AI 在任务结束时生成一份 HTML 报告，把交付结论、文件变化、验证证据和未完成事项整理成可审查、可归档的页面。项目基于 answer-me-with-html 改造，安装入口为 npx askreport。
从“模型说改好了”到一份可核对的交付页面
ask-report-html 的重点不是让 AI 多输出一段总结，而是把任务结果整理成结构化报告。开发者可以先看交付结论，再查看文件职责和验证记录；如果某项验证没有运行，报告需要明确标出，而不是用模糊说法带过。
素材中的演示样例包含 4 个逻辑模块和 1 个测试文件，7 项 Node 逻辑测试实际通过，5 个文件做了语法检查。由于样例没有界面，也不连接业务服务，浏览器交互和业务接口集成被写为“未运行”。项目方也说明，演示报告不能当作生产项目验收记录，HTML 生成成功也不等于业务全部完成。
报告触发有门槛：默认改动 5 个文件
改造版保留了主动生成 HTML 解释的能力，并把主要场景放在开发任务收尾。主动调用时，用户可以直接让 agent 解释某个技术问题，不需要填写“改了哪些文件”。自动报告则默认要求改动 5 个文件，安装时可改成任意正整数。默认配置下，改动 1 到 4 个有效文件用文字交付；达到 5 个文件，也要等任务准备收尾，且用户没有要求纯文本，才会生成报告。
文件数只计算本任务实际新增、修改或删除的源码、业务文档和配置文件。同一个文件无论改了多少行，都只算一次。原本已有的改动、其他会话的改动不算；计划、日志、缓存、截图和报告本身也不算。多人或多个 agent 共用工作区时，不能把整个工作区的 diff 都算给当前任务。门槛会保存到共享 skill 的 auto-report.json，示例为 { “minChangedFiles” : 5 }，配置缺失或值不合法时回退到 5。文件计数仍由 agent 按规范完成，工具没有后台进程监控文件，也不代替 agent 判断改动归属。
安装、兼容与安全边界
ask-report-html 的安装入口是 npm 包 askreport，需要 Node.js 22 或更新版本。终端可运行 npx askreport，中文提示可使用 npx askreport –lang=zh_CN；也可以运行 npx askreport web，通过本地网页配置，默认地址通常为 http://127.0.0.1:7331。目前安装器覆盖 Pi、Claude Code、Codex、OpenCode、Grok Build、Antigravity CLI、Kimi Code 和 Cursor。Cursor 的 User Rules 需要用户自行复制到官方设置页，工具不写 Cursor 的非公开数据库。
报告和草稿放在 ~/.ask-report-html/
AI 编程交付的关键不是“生成”，而是“可验收”
ask-report-html 想解决的不是让 AI 写更多代码，而是让 AI 完成任务后留下可检查的记录。开发者不必在收尾时重新翻工具输出，也不必从聊天记录里摘说明给同事。看过报告后，可以带着具体问题查看 diff：为什么改这里、哪项检查没跑、哪里还需要人工验收。
它的边界同样明确：自动报告依赖 agent 遵循指令，没有安装强制的任务结束监听器；不同模型、版本或会话都可能漏报。文件数门槛用于控制报告频率，不代表任务风险；只改一个重要文件，也可以主动要求 HTML 报告。报告中的“通过”“失败”“未运行”仍需逐项查看，合并前也要照常进行代码评审、测试和业务验收。
目前，项目已开源在 jerrywu001/ask-report-html，npm 包为 askreport。原始 skill 和 HTML 渲染器来自 QingYunA/answer-me-with-html，改造版保留了来源声明与 MIT 许可。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/ai-xie-wan-dai-ma-hou-bu-neng-zhi-liu-xia-yi-ju-gai-hao-le
