Optimize 视图是针对单个项目的健康报告。它会扫描项目,从多个质量维度打分,衡量测试对代码的覆盖程度,并且在需要时让 AI 阅读结果,建议优先改进哪些方面。
Optimize 视图:项目健康度与 AI 深度分析
界面内容
打开一个项目,点击 Optimize 子标签页(位于 Develop、Testing、Archive、Setting 旁边)。如果该标签页包含多个项目,顶部的一排项目按钮可用于选择要查看的项目。首次扫描之前,该视图只显示 No scan data available for this project,并提供 Scan Now 按钮。
Overall Score
一条进度条,显示所有已扫描维度的加权平均值、上次扫描的时间,以及两个按钮:Scan Now 和 AI Deep Analysis。
Sections
每个已扫描的维度(Contracts、测试、代码指标、项目结构…)各占一行,带有各自的得分条和关键数字。点击某一行即可展开详情。
Testing section
Coverage by Directory、Worst Covered Files(覆盖率最低的 20 个文件)、High Risk Files(带红色 HIGH RISK 徽章)以及 Zero Coverage。Download HTML Report 会把明细保存为独立的 HTML 文件。
AI Deep Analysis
运行后显示在各 Section 下方:AI 给出的按优先级排序的建议列表,并附有生成时间。
Code Coverage
位于底部:Run Coverage、Run Tests、带有 HTML Report 链接的最新结果,以及历史记录表(日期、百分比、状态、趋势)和 Clear History。
使用方法
- 打开项目的 Optimize 子标签页,点击 Scan Now。扫描属于静态分析,不会更改项目中的任何内容。结果会保留到下一次扫描;每当有 Task 合并后,AITM 也会自动重新扫描。
- 先查看 Overall Score,然后展开得分最低的 Section,了解是什么拉低了分数。
- 点击 Run Coverage,在测量覆盖率的情况下运行项目测试。大型项目会分批处理,运行可能需要一段时间,并在后台继续进行。Run Tests 则在不测量覆盖率的情况下运行测试。
- 展开测试 Section,从 High Risk Files 和 Zero Coverage 入手,这些位置一旦改动,最容易在不知不觉中引入问题。
- 点击 AI Deep Analysis,让 AI 把这些数字转化为按优先级排序的改进列表。这需要已配置的 AI 提供商,并且与其他请求一样会消耗 AI 用量。
- 需要在 AITM 之外分享覆盖率结果时,使用 Download HTML Report / HTML Report。
AI Deep Analysis
AI 会接收完整的扫描输出(得分、高风险文件、各项指标明细),并返回按优先级排序的改进列表。结果显示在操作按钮下方,并保留到下一次 Deep Analysis 运行。该分析只负责报告:Optimize 本身绝不会修改代码或设置。
覆盖率无法运行时
如果某次覆盖率运行被 skipped(跳过)或 failed(失败),原因会以橙色显示,最常见的情况是项目未安装覆盖率工具,或没有 AITM 可用的测试命令。此时会出现 Configure with AI 按钮:它会打开一个对话框,由 AI 检查项目并提出覆盖率配置方案。如果某次运行在多次尝试后放弃,失败提示框会显示已完成到哪一步,并提供 Discuss in chat 和 Resume after fix。
Summary Model & Provider
在运行 Deep Analysis 之前,可以选择由哪个 AI 模型和提供商生成优化摘要,而不必总是使用默认值。这样可以直接掌控成本与质量之间的取舍:快速浏览时选用更快、更便宜的模型,需要最全面的结论时选用更强的模型;同时也可以把摘要交给已偏好或已配置凭据的任一提供商处理。
从发现问题到修复
为某条建议创建 Task,即可将其转化为实际工作(参见创建 Task)。随后 12 步 Pipeline(branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit,参见 Pipeline)会实现该建议、测试并将其合并到 dev。由于 AITM 在每个 Task 合并后都会重新扫描,因此可以看到得分随修复而变化。
提示
- 得分只是参考,而非评级—某个 Section 得分偏低,说明应当重点关注那里,并不意味着已经出了问题。
- 扫描既快速又免费;AI Deep Analysis 和 Run Coverage 分别消耗 AI 额度和机器时间,因此应在打算根据结果采取行动时再运行。
- 覆盖率数字反映的是最近一次覆盖率运行,而不是最近一次扫描—请在历史记录表中核对日期。
- Clear History 会删除该项目已存储的覆盖率运行记录,且无法撤销。