前言¶
在 DSH web GUI 中运行智能体时，常希望快速看到当前会话还剩多久、已经消耗多少 token、按模型大约花费多少。已有做法多依赖会话日志或零散统计，缺少一个集中的标题栏入口。dsh-task-estimator 把预计剩余时间、token 用量与按模型花费估算放到会话标题栏中，并支持 LLM 智能估算。下面介绍它的功能、安装与用法。
这是什么¶
dsh-task-estimator 是 DSH 插件，由 0x250-t 维护，许可为 MIT。它面向 DeepSeek Harness 的 web GUI，在会话标题栏提供一个任务估算窗口，用于查看预计剩余时间、token 用量、按模型花费估算（约 CNY），以及可选的 LLM 估算。
核心功能¶
启发式估算¶
基于会话投影（sessionStats、tokenUsage、goal）实时计算：
- 已用轮次
- token 用量
- 耗时
- 平均每轮
- 预计剩余，采用近 5 轮趋势外推并附置信区间
- 预计完成时刻
花费估算¶
按会话日志重放 token 用量，并按「模型 × 时段」增量计价。时段包括 legacy、peak、offPeak，使用北京时间。
输出包含：
- 汇总花费
- 按模型明细：模型、token、花费
价格表是内置参考值，可在设置中修改。legacy 档下，峰谷倍率会自动派生。
AI 估算¶
使用会话当前模型做轻量补全，输出：
- PERT 三点估算：乐观、最可能、悲观剩余分钟，以及期望值
- 剩余轮数
- 剩余 token
- 任务复杂度分档：
XS~XL - METR 可靠性警告
本轮预计¶
当 agent 思考中，即出现「Deep diving…」状态行时，会在该行右侧显示「本轮预计 ≈ X」。
该预估基于近 5 轮 LLM 耗时趋势；趋势不可用时取全程平均，用来估计当前这一轮对话所需时长。
交互¶
窗口支持以下交互：
- 悬停显示
- 移开 0.3s 后，0.5s 线性淡出
- 点击固定面板
- 再次点击任意位置关闭
Alt+E切换- 触屏自动降级
- 面板内点击不退出
- 内容超高时可滚动
设置¶
设置区包括：
- 价格表编辑
- 刷新间隔自定义，单位为分钟，支持小数
- 恢复默认
- 固定状态管理
- 价格生效日程
关于固定状态是否写入本地存储，已核实资料中存在不同表述：设置项曾提到 localStorage，隐私说明又称全部状态为进程内存、无持久化。使用前应以当前版本实现和说明为准。
安装与启用¶
它是 bundle 插件，安装后需要重启 web。已核实安装命令为：
dsh plugin --profile web add github:0x250-t/dsh-task-estimator#v1.1.0
如果从本地目录安装，需要先构建，再添加：
cd dsh-task-estimator
npm run build
dsh plugin --profile web add .
已核实资料中，安装命令使用 #v1.1.0，而 package.json 版本为 1.1.1。安装前请以仓库当前 README 和可用标签为准。
典型用法¶
1、悬停会话标题栏右侧的估算按钮，查看剩余时间、token 与约花费明细。
2、点击按钮固定面板；再次点击任意位置关闭。
3、展开「AI 估算」区块，点击「开始估算」；也可以设置自动刷新间隔。
4、展开「设置」区块，编辑价格或刷新间隔后保存；需要还原时点击「恢复默认」。
5、agent 思考中，即「Deep diving…」状态行出现时，右侧会显示「本轮预计 ≈ X」，用于预估当前轮耗时。
适用场景与注意¶
- 适合使用 DSH web GUI 的开发者和用户，尤其是希望快速查看会话 ETA、token 用量与模型花费估算的场景。
- 插件以当前 dsh 进程权限运行。安装前检查源码、依赖、许可证和更新说明；本项目许可为 MIT。
- 隐私说明称：全部状态为进程内存，无 API key、密钥、密码硬编码，无网络外发；AI 估算除外，AI 估算会对已配置模型做一次调用。
- 花费估算基于价格表与时段规则，是估算值，不是账单。价格表为内置参考值，可按设置修改。
- AI 估算会调用当前会话模型，可能产生模型用量。
结尾¶
dsh-task-estimator 将剩余时间、token 用量和按模型花费估算集中到 DSH 会话标题栏中，适合需要快速判断任务进度与成本的用户。
GitHub 地址：https://github.com/0x250-t/dsh-task-estimator
已核实资料未提供目录页 URL。如通过社区目录安装，请以目录页给出的命令为准。
