- Accueil
- Plugins
- Améliorations UI
- dsh-reply-timer
H
dsh-reply-timer
henry1996-yl/dsh-reply-timer
Shows a live reply timer under the composer with a three-segment ledger (first token / tools / generation) and a reference range from this machine's past turns of the same shape. The chip follows only the session it is mounted in and never shows a fabricated countdown.
Installer
dsh plugin --profile web add github:henry1996-yl/dsh-reply-timerREADME
dsh-reply-timer · 会话回复计时器
在输入框下方(conversation.composer.dock)显示一条计时状态,解决「老是要等很久、
不知道是不是卡了、这一轮到底慢在哪」:
- 等待中:
⏳ 14.2s · 正在生成 · 工具 2 次,带一个会呼吸的圆点; 副行显示模型仍在输出 · 最后活动 3s 前。若超过 60 秒没有任何真实输出帧, 改为⚠ 63s 没有新输出 · 可能停滞(这是对「卡住」的诚实判断,而非浏览器自嗨)。 等审批/提问时显示⏸ 等待你确认 · 计时已暂停并暂停累计。 - 结束后:
✓ 本轮 31s;点开可展开三段账本首字 / 工具耗时 / 生成耗时 / 工具次数, 以及按「工具次数分桶」的历史参考区间参考 18–40s · 中位 26s。 样本不足时只写再观测 N 轮后给出参考区间,绝不编倒计时。 - 关闭 / 展开 / 减弱动效 / 多会话:可点开关关闭计时器;展开明细;
prefers-reduced-motion下停止呼吸动画;role="status" aria-live="polite"。
架构(v2「自适应版」,双半场)
v1 是纯客户端:只读 sessions.list 的 running 位 + 本地定时器。它能显示「等了多久」,
但两个承诺没兑现——「心跳说明没卡住」是假的(本地脉冲只证明浏览器活着),
阶段/工具次数靠猜行字段(实际上一直是 0),而且没有「预计用时」。
v2 把计时搬到宿主半场,由真实事件驱动,客户端只做诚实的渲染:
| 半场 | 文件 | 职责 |
|---|---|---|
| Host | index.js | 订阅 session/event(turn/start·turn/end·tool/call·tool/result·approval/asked·user/message)、agent/assistant-stream(首字帧时间戳)、api-session/status、session/disposed;测量三段耗时与工具并行区间;把 lastDone 与历史样本持久化到 $DSH_HOME/storages/dsh-reply-timer/samples.json;通过 webServer.register({kind:'exact', path:'/__dsh-reply-timer/state'}) 暴露只读快照。 |
| Client | client.js | 以 document.baseURI 为基准轮询该路由(运行中 1s / 空闲 3s,同源相对 GET);把宿主快照渲染进 composer dock;本地 250ms tick 仅用于平滑插值与圆点动画。 |
关键点:
- 真心跳:
lastActivityAt来自真实AssistantStreamFrame与 session 事件, idle 超时才判停滞;工具正在跑(openTools > 0)时即便无输出也不误报。 - 三段账本:首字 =
turn/start→ 首个输出帧(text-delta/reasoning-delta等); 工具 =tool/call→tool/result区间的并集(并行工具不重复计时,等待确认单独计); 生成 = 总时长扣掉工具与暂停。首字未观测到就写「未观测到」,不填 0。 - 参考区间:按
toolCount分plain / few / many三桶,各保留最近 20 个样本,n ≥ 5才用 0.2 / 0.5 / 0.8 分位给出区间;不足就明说还差几轮。 - 持久化:
node:fs/promises写到$DSH_HOME/storages/dsh-reply-timer/samples.json(DSH_HOME缺省~/.dsh,与 dsh-cost-meter / dsh-ops / dsh-better-sidebar 一致;800ms 防抖), 刷新页面 / 重启应用后账本与历史仍在;不写入包目录,升级插件不会丢历史。不引入storageDomain、不改会话数据、不加新事件类型。 - 只跟随本会话:
conversation.composer.dock是scope: 'session'的 slot,注册时用inject: (sessionId) => ({ t, sessionId })拿到归属会话 id,多标签页 / 多会话不会显示别人的计时。 - 安全:路由用
connection.requestRejection(req)做同源/回环校验(与 dsh-better-sidebar 一致), 只接受 GET;客户端mode:'same-origin'、cache:'no-store',不带任何 token。 - 主题色
var(--dsw-alias-*, fallback),纯 inline style,不注入 CSS、不用 iframe、 不引用 Harness Client 包;所有资源在apply内用ctx.effect注册并可反注册(HMR 安全)。
结构
| 文件 | 作用 |
|---|---|
index.js | 宿主半场(事件计时 + 持久化 + 只读路由),ESM |
client.js | 客户端半场,懒加载 CJS 工厂,注册进 conversation.composer.dock |
samples.json | 运行时生成的历史样本 / 最近账本,落在 $DSH_HOME/storages/dsh-reply-timer/(首次回答后自动出现;不进仓库 / 发布包) |
cordis.patch.yml | 插入一条 loader 记录 |
locale/{zh,en}.json | 插件页展示用的 meta.title / meta.description / meta.detail |
icon.svg | 插件图标 |
docs/DETAIL.md + docs/preview.svg | DSH 插件详情页的特性图(locale/*.json 的 meta.detail 指向,只放一张自包含 SVG) |
screenshots.json + screenshots/*.png | 市场门店卡片图(awesome-dsh-plugin 的 probe-screenshots.mjs 读仓库根这份 JSON;纯路径数组格式) |
SUBMISSION.md | 向 awesome-dsh-plugin 投稿的中文操作指南 |
LICENSE | MIT 许可证 |
.gitignore | 排除运行时产物(samples.json、*.tgz 等) |
package.json | dsh.bundle.patch + dsh.client 声明 |
用到的扩展点,均来自已安装可用插件 / 官方源码实测:
ctx.on("session/event" | "agent/assistant-stream" | "api-session/status" | "session/disposed", ...)ctx.webServer.register({ kind, path, handler(req, res) })— Node 风格(req,res),kind:'exact'ctx.connection.requestRejection(req)— 请求来源校验ctx.slots.inject(SLOT, () => ctx.slots.register({ name, id, order, inject }, Component))ctx.locale.register(NS, {zh, en})+ctx.locale.bind(NS),包在ctx.effect里便于 HMR 反注册require('react')(shell 注入,含useSyncExternalStore),不引用任何 Harness Client 包
验证状态
- 代码:
index.js/client.js经 Node--check语法检查通过; 所有 JSON / 清单有效;用 mock ctx 驱动真实事件序列做过端到端断言(10 项全过, 三段账本总耗时 = 首字 + 工具 + 生成精确自洽)。 - 安装:
plugin_manager install_bundle返回application: applied;list_plugins显示fiberPhase: active;路由/__dsh-reply-timer/state已注册(无登录 cookie 的命令行请求 被connection.requestRejection拦为 403,属预期);宿主半区真实落盘$DSH_HOME/storages/dsh-reply-timer/samples.json。 - 浏览器:v2.0.0 完整重启 App 后 widget 已在输入框下方渲染;字体加深与「点空白 / Esc 收起明细」
的交互修复均经用户实测确认。v2.1.0 另修了 slot 会话绑定(改用
inject取 sessionId)、 路由加__dsh-唯一前缀、样本迁出包目录、轮询降频,并补了详情页docs/DETAIL.md。 - v2.2.0 修了两个真实会话日志暴露的记账 bug:①开回合的
user/message在turn/start之后约 35ms 才落盘,旧代码据此把每个回合判成 36ms 的interrupted,导致参考区间永远 攒不到样本——现在权威回合只认turn/end,该分支仅服务没观测到turn/start的回退路径; ②实例日志里存在 120s 的tool/call→tool/result空档,旧的 120s 空闲看门狗会把健康的 长时间工具回合误杀——现在有未闭合工具时改用 30 分钟上限。另加tests/_replay-session.mjs, 拿真实会话日志(1610 事件 / 13 万帧)回放校验:四个已完成回合的时长、三段账本、工具计数 全部与原日志一致。 - v2.3.0 修了子代理污染:
agent/assistant-stream与api-session/status只带 session id, 拿不到origin,子代理开流时会先建一条startedMidTurn的临时行,回合结束时照样写进lastDone,把历史挤满子代理的耗时(recordSample又因 midTurn 跳过,于是样本永远为空)。 现在一旦session/event认出子代理,就把该 id 记进拒绝表并删掉临时行,两条只带 id 的 通路也随之拒收。tests/_test-host.mjs增加了一条子代理回归用例。 - v2.4.0 按真实日志重新标定了两个阈值(此前两者都会静默吃掉最该被记录的场景):
①
MAX_TURN_MS从 30 分钟放宽到 6 小时——本工作区 122 个真实回合的时长分布是 p50 56s / p90 562s / p99 3496s / 最长 4493s(75 分钟),旧的 30 分钟上限让 3.3% 的回合 既不入样本也不写账本,而它们正是「这一轮到底慢在哪」最需要答案的那种回合; ②STALL_MS从 20 秒放宽到 60 秒——实测每个 step 的「模型首字等待」p99 达 78 秒、 6.1% 的 step 超过 20 秒,旧值会让界面在正常思考时反复闪「疑似停滞」。新增tests/_test-longturn.mjs,用假时钟跑一个 4493 秒的回合,断言它仍然入样本、仍有账本。 - v2.4.1 补回市场门店图:
screenshots.json恢复为纯路径数组(原包写的是{"src","alt"}对象数组,awesome-dsh-plugin 的scripts/probe-screenshots.mjs只认字符串数组 /{"screenshots": [...]}/ 单键 URL 映射三种形态,对象元素的写法会 被判为「every entry must be a non-empty string」而整份失效)。它与docs/DETAIL.md是两个不同的消费方,各自都需要:前者供市场卡片,后者供 DSH 插件详情页。 - 参考区间需要攒够 5 轮同类回复才出现,这是刻意设计——样本不足时绝不编造倒计时。
- 本包以
link:软链安装时,改client.js无需重装;完整重启后改index.js需再次重启。
Plugins associés
Z
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
10.5kil y a 10 heuresAméliorations UIApache-2.0
Z
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
10.5kil y a 10 heuresAméliorations UIApache-2.0
C
dsh-TUI
ccch1mneyyy/dsh-tui
7.9kil y a 4 heuresAméliorations UIMIT
Z
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui
6.3kil y a 3 moisAméliorations UIApache-2.0