
AI Time Estimator 插件:用本地日志测算 Claude Code 任务耗时
来源标题:Show HN: AI Time Estimator – how long Claude Code will take, from your own logs
AI Time Estimator 插件已发布,可根据用户自己的 Claude Code 会话日志估算任务所需时间,替代 Claude 凭直觉给出的粗略估计。安装后首次会话会在后台用约一分钟测量速率,之后每次回答都会被评分并自我改进。该插件需要 Python 3.9+,无需 pip 安装。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Claude 估算起来跟人类开发者一样:明明午饭前就能干完的活,它说“2–3 天”。这个插件让 Claude 去数工作量而不是靠猜,用时则用你自己会话里测出来的速率来算,而且每完成一个任务都会自我校验。 快速开始 • 工作原理 • 准确度 • 隐私 • 卸载 • 版本发布 /plugin install ai-time-estimator --marketplace noambrand/ai-time-estimator 2. 开一个新的 Claude Code 会话,然后问: how long will it take to add CSV export to the report page? 就这样。第一次会话会在后台测量你的速率(大约一分钟),之后每个回答都会被评分并自行改进。你不需要自己运行任何脚本。需要 PATH 中有 Python 3.9+;不需要 pip install 任何东西。 两种方式选一种。插件和 install.py 做的是同一件事,两个都装会导致每个任务被评分两次。 Claude 单独使用时 使用 AI Time Estimator 后 20 分钟就能干完的活,它说“这要 2–3 天” “大约 7 分钟,可能在 4–16 分钟之间”,按它自己的工作时间算 一周的计划,结果午饭前就做完了 按真实 AI 分钟来规划,速率在你自己的机器上测得 凭人类经验猜 Claude 数工作量;脚本用你测得的速率来算时间 从不知道自己错得多离谱 给每个估算打分,10 个任务后自动校正区间 工作原理 一个 time-estimator 子代理会以只读方式检查仓库,查找过去类似的请求,并把工作写成 2–3 种情景(顺利 / 预期 / 不顺),以计数形式表示:读了多少文件、改了多少处、写了多少行、运行了多少命令、修了多少轮。 estimate.py 把这些计数通过蒙特卡洛模拟转换成 P10 / P50 / P90 分钟数,用的是在你机器上测得的速率: 每个模型轮次的秒数,按模型、推理强度(reasoning effort)和上下文大小区分; 每个工具和 shell 命令的运行时间,包括后台代理直到其完成通知为止的时间; 长文本写入的输出速度; 一个速度离散系数:你过去请求的真实耗时 ÷ 预测耗时,因为一个真实请求整体上是快是慢。 一个 Stop hook(autoscore.py)会把每个估算和实际发生的情况做对比。你花在阅读、回答或批准上的时间不计入。 累计 10 个已评分的估算后,区间会根据你的结果自我校正,每个回答都会带上它的历史准确记录。 模型从不编造分钟数。它只数操作,算术由脚本完成。 你也可以输入 /estimate-here <task> 在当前会话内估算;之后 Claude 会等你确认。 作为插件使用时,不会改动你自己的设置:Claude Code 会从插件加载代理、/estimate-here 命令和两个 hook(每轮结束后评分,会话开始时同步)。你的速率和历史记录存放在 ~/.claude/ai-time-estimator/。 选项:--no-hook(不自动评分),--no-rule(不改动 ~/.claude/CLAUDE.md)。再次运行会就地更新。 python ~/.claude/ai-time-estimator/backtest.py 回测会用真实的工具调用重放你过去的请求。它在较早的 80% 请求上测量速率,在最新的 20% 上测试,然后报告真实时间落在 P10–P90 区间内的频率。 在作者机器上(72 个留出请求): 单个请求的波动很大,即使它的工具调用完全已知,所以请更信任区间而不是中间那个数。回测只检验时间模型;代理数工作量的准确度,由自动评分和自我校正来跟踪。 所有数据都留在你自己的机器上。它不发起网络请求,也不向任何地方发送任何东西。 它读取 ~/.claude/projects/ 中 Claude Code 的会话记录,只写入 ~/.claude/ai-time-estimator/(它的脚本、rates.json、estimates.jsonl、actuals.jsonl、autoscore.log)。详情见 PRIVACY.md。 它依赖 Claude Code 的本地会话记录格式,这是内部格式,可能会变。如果 calibrate.py 无法识别模型轮次,会打印 FORMAT CHECK FAILED;tools/cc_log.py 是唯一需要适配的文件。 历史记录能回溯到 Claude Code 保留会话记录的时限(cleanupPeriodDays,默认 30 天)。新安装且历史很少时,一开始区间会更宽、更粗糙。 当你发送下一条消息时,一个任务就结束了。如果 Claude 中途问你什么,评分就在那一刻停止。 它只测量 AI 时间:批准、回答和人工检查不计入估算。 卸载 插件:运行 /plugin uninstall ai-time-estimator。你的估算历史会保留在 ~/.claude/ai-time-estimator/;如果想彻底清除,把那个文件夹也删掉。 python install.py --uninstall # 移除代理、命令、脚本、hook 和 CLAUDE.md 中的段落;保留你的历史 python install.py --uninstall --purge # 同时删除 ~/.claude/ai-time-estimator 或者直接让 Claude Code:“uninstall the AI time estimator by running its install.py --uninstall”。 python -m unittest discover -s tests -v # 测试不会触碰 ~/.claude python tools/backtest.py --worst 10 # 你历史记录上的准确度,附带偏差最大的案例 python tools/history.py --everywhere --grep test 改动在运行 python install.py 后生效。.claude/CLAUDE.md 解释了其架构,供贡献者和 Claude Code 参考。欢迎提交 issue 和 pull request。 会话记录解析沿用了 dioptx/cctime(MIT)的做法:流式块按 requestId 合并,工具时间从 tool_use 计到 tool_result。 如果它帮你避免了一个错误的计划,点个 ⭐ 能帮助其他 Claude Code 用户发现它。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。