任务进度追踪 · 百分比与 ETA 看板【律令·本地零联网】

进度跟踪与进度条估算：给出百分比、双速率、ETA、心跳与卡死检测，支持多任务并行看板；算不出 ETA 时明确拒绝给数字。

常见的触发场景有：进度追踪、任务进度、还剩多久。

完整说明、版本记录和安装方式在 SkillHub 上的「任务进度追踪 · 百分比与 ETA 看板」页面。

本包只做职责范围内的事。下面这些情况它会明确转给兄弟技能，而不是硬做：

• 中断后要从断点继续 → 转给 resume-runner
• 要追踪一批并行任务 → 转给 batch-runner
• 进度异常/卡死 → 转给 task-recovery

反向边界：算不出 ETA 时明确拒绝给数字，绝不编造进度。

每次执行前要过的自检项：

• eta_human 为 null 时，是否把 eta_unavailable 的原因一并告知？
• 若 stalled: true，是否先说卡死再谈 ETA？（eta_reliable 为 false）
• 若 over_total 非空，是否提醒用户核对清单改动/重复计数？
• 若有 rate_note / eta_caveat，是否说明速率仅供参考？

安装后，在支持 SkillHub 的 AI 客户端（如 WorkBuddy）里直接使用即可。

触发方式：对话里提到「进度追踪、任务进度、还剩多久」等场景，或把相关文件发给 AI，它就会自动响应。

也可以直接跑脚本，典型用法：python scripts/progress_tracker.py --store registry.json <子命令> [参数]（完整参数见包内说明）。

或从客户端的「已安装技能」列表里手动唤起。

不发一个网络包——包的 frontmatter 声明 network: none，不声明就没有联网能力。三条验证路径任选：

① 安装后把网断掉再跑一遍，功能照常——它本来就没打算联网；

② 用抓包工具（Wireshark / Fiddler）观察该技能进程，零外部连接；

③ 直接翻源码：job_state.py、progress_tracker.py 等源码全部公开可预览，没有一行网络代码。这是能逐行核对的技术事实，不是宣传口号。

不需要 API Key，全部技能免费安装。

许可为 BUSL-1.1：BUSL-1.1 源码可见，个人及企业内部可自由使用（含内部生产环境）；发布满 4 年自动转为 Apache-2.0。详见随包 LICENSE.md。

Windows / macOS / Linux 都能跑。

纯 Python 标准库实现，不需要 pip install 任何东西，也就没有环境冲突要调。

唯一前置是本机装了 Python 3；客户端（如 WorkBuddy）会替你调用，一般不用手动敲命令。

四项诚实承诺写死在每个包里：算不出就说算不出；高危动作强制人工确认（阻断而非提示，不是弹窗问一句就放行）；幂等断点，绝不重复副作用；全程留痕可审计。

这类工具包只读取你指定的输入，结果写到输出目录，不改原文件；每一步动作留痕可查。

两个出口：

① 微信公众号「AI技能工具箱」——每周更新实测与安装步骤，后台留言即可；

② 首页底部有公众号二维码（点此直达）；每个技能包内附完整 SKILL.md 与版本记录，多数问题翻文档就能解决。