Progress Tracker 用于在自主编码会话中跟踪和报告进度，提供指标计算、可视化和完成度估算能力。
用途 该工具面向自主编码场景，帮助开发者或自动化流程掌握项目整体完成情况。它可生成进度报告、计算指标、可视化完成度，并估算剩余工作量。
主要能力
- 获取进度指标：通过 ProgressTracker 类读取项目目录，返回功能通过数、总数、完成百分比等指标。
- 生成报告：支持以 Markdown 等格式生成进度报告。
- 可视化进度：输出 ASCII 进度条，例如 ████████████░░░░░░░░ 60% (30/50)。
- 进度仪表盘：展示整体进度、功能通过数、已完成会话数、提交数，并按类别（如 auth、crud、ui、api、testing、other）细分完成度，同时给出预计完成情况（按当前速率剩余会话数、时间估算、每日会话数）。
- 跟踪指标：包括功能通过/总数、进度百分比、会话数、git 提交数、速度（每会话完成功能数）、ETA（预计完成所需会话数）。
使用方式 快速开始示例：
获取进度指标： from scripts.progress_tracker import ProgressTracker
tracker = ProgressTracker(project_dir) metrics = tracker.get_progress()
print(f"Features: {metrics.passing}/{metrics.total}") print(f"Progress: {metrics.percentage:.1f}%")
生成报告： report = tracker.generate_report(format="markdown") print(report)
可视化进度： visualization = tracker.visualize_progress() print(visualization)
████████████░░░░░░░░ 60% (30/50)
集成点
- context-state-tracker：读取功能和进度数据。
- coding-agent：跟踪功能完成情况。
- autonomous-loop：使用指标进行是否继续的决策。
参考与脚本
- references/METRICS.md：详细指标文档。
- references/REPORT-FORMATS.md：报告格式选项。
- scripts/progress_tracker.py：核心 ProgressTracker 类。
- scripts/metrics_calculator.py：指标计算。
- scripts/report_generator.py：报告生成。
- scripts/visualization.py：ASCII 可视化。
适用场景 适用于自主编码会话中的进度跟踪与汇报，例如生成进度报告、计算完成指标、可视化完成度、估算剩余会话数或时间。
限制 资料未提供关于收费、价格、平台支持范围、具体效果保证或额外使用步骤的说明，这些信息暂未提供。