dsh-opencode-status 0.4.4 → 0.4.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -0
- package/README.md +5 -14
- package/package.json +1 -1
- package/src/client.js +69 -198
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,27 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.4.6
|
|
4
|
+
|
|
5
|
+
- **移除「可用时长估算」**:按当前速率推算「还能撑多久」需要先累计 10 分钟采样、再与重置时间比较,实际信息量低于直接看进度条;功能整体删除,包括采样记录、`localStorage` 持久化、「采样中」状态与时长粗化。面板只保留剩余百分比与 `⏱` 重置倒计时。
|
|
6
|
+
- **移除头部「最紧张 <窗口>」摘要**:三条进度条并列时哪个窗口最紧一眼可见,摘要属于重复表达;头部只保留连接状态(`已连接` / `异常`)。
|
|
7
|
+
- 旧版本写入的 `dsh-opencode-status.eta-samples` 键会在插件激活时清理一次,不影响任何其他数据。
|
|
8
|
+
- 测试 56 → 42:删除估算与采样相关用例;轮询生命周期、可访问性、安全与竞态用例全部保留。
|
|
9
|
+
|
|
10
|
+
## 0.4.5
|
|
11
|
+
|
|
12
|
+
- **修复用量面板长期停在「采样中」、估算始终不出现的问题**:
|
|
13
|
+
- 现象:面板三个窗口的估算位置长期只显示「采样中」,攒不出「约 X 后耗尽 / 可支撑到重置」;刷新页面或重启 DSH 后依旧如此,用户无法判断该等还是该重启。
|
|
14
|
+
- 主因(采样停摆):30 秒状态轮询原本建在侧栏按钮组件 `FooterEntry` 的挂载 `useEffect` 里——侧栏收起、布局切换导致组件卸载,或页面隐藏时 `clearInterval` 之后 `visibilitychange` 事件丢失,ticker 都不会再被重建,采样永久停止;面板读到的其实是冻结在 1–2 个内存样本的快照,而「采样中」这个状态本身(有样本但不足 3 个点、或首尾跨度不足 10 分钟)恰好掩盖了「轮询已经死了」。诊断时实测页面根本没有在按 30 秒轮询状态接口(7/7 探测直接穿透到上游),周 / 月窗口的 `resetAt` 与 `usedPct` 在真实数据里全程恒定。
|
|
15
|
+
- 次因(`resetAt` 被误当作窗口重置):`recordSamples` 原先用 `resetAt !== entry.resetAt` 判定「窗口已重置」并清空历史。但 5h 滚动窗口是滑动窗口,早先用量的过期会让重置时间不断前移——窗口根本没有重置——于是每次采样都清空历史,样本永远攒不到 3 个点。构造 `resetAt` 每 30 秒前移、`usedPct` 单调上升的 22 样本序列可 100% 复现同样的「采样中」。
|
|
16
|
+
- 不是接口数据、也不是估算算法的问题:真实 24 条响应回放显示估算链路本身健康(每 5 个样本 +1% 的健康输入在第 21 个样本、跨过 10 分钟门槛后即给出「约 3h30m 后耗尽」)。
|
|
17
|
+
- **修复方式**:
|
|
18
|
+
- 轮询提升为模块级幂等 ticker:`ensureStatusPolling` 只安装一次,footer 只幂等调用、组件卸载不再拆除,并随插件生命周期释放——`apply` 内改用 `ctx.effect(() => ensureStatusPolling())` 注册 disposer,插件 dispose / HMR 重载时 `clearInterval`、移除 `visibilitychange` 监听并复位状态,不再出现新旧 ticker 并存、每 30 秒发两次请求。页面隐藏期间保留 ticker(交给浏览器节流),恢复可见时立即补拉一次。
|
|
19
|
+
- `recordSamples` 删除 `resetAt !== entry.resetAt` 清空条件,只按 `usedPct` 真实回落(`used < last.used`)清空历史,`resetAt` 仅更新基准。源码注释写明前提(同一窗口内 `usedPct` 单调不减)与已知漏检(重置恰好发生在两次轮询之间、且新窗口用量已超过旧值时不会清空),并明确不能改用 `resetAt` 兜底。同一 `fetchedAt` 去重与 60 分钟 / 每窗口 120 条上限保持不变。
|
|
20
|
+
- 采样持久化到 `localStorage`(键 `dsh-opencode-status.eta-samples`,v2;每窗口最近 60 分钟、最多 120 条、按 `fetchedAt` 去重,只存窗口 id、`fetchedAt`、用量百分比与 `resetAt`,不含任何密钥或凭证),并按账号隔离:payload 带 `baseUrl` 与可获取时的密钥末四位掩码(不是密钥本身),恢复延迟到首个 status/config 身份响应,`baseUrl` 或双方已知末四位不匹配则整体丢弃并清除存储;运行时换 `baseUrl` / 换账号、设置保存与清除 Key 后立即作废旧历史。判据遵循「缺证据不下结论」:末四位晚到且相同只补写身份、不清历史;旧版 v1 无归属信息,整体丢弃不恢复。页面刷新与 DSH 重启后接着采样,不必再从 1 个点重新等满 10 分钟。
|
|
21
|
+
- **诚实性边界不变**:估算门槛与呈现规则一字未改——仍然要求样本 ≥3 个、首尾跨度 ≥10 分钟、速率 >0;速率为 0 / 剩余为 0 / `resetAt` 缺失或过期时该位置依旧完全不渲染,绝不补「--」「0m」占位。`estimateEta` / `etaView` 函数体与 0.4.4 逐字相同,「采样中」的文案与语义(只说明状态、不含任何数字)也保持原样;本次没有删掉「采样中」、没有放宽门槛、没有为了让数字出现而编造估算。
|
|
22
|
+
- 测试 49 → 56(48 → 55 个 `test()`,另 1 条文件级条目):按修复契约反转了「`resetsAt` 变化即清空」的旧断言,把旧的轮询源码字符串断言改为可控定时器 + 可见性的运行时用例,并新增模块级 ticker 生命周期、`resetAt` 前移累积出估算、`usedPct` 回落清空、同一 `fetchedAt` 去重、`localStorage` 恢复与重载续采、v2 账号隔离(含「末四位晚到、同账号不清空」与「换账号整体丢弃」)等真实运行时回归;其余既有断言未改,`npm test` 56/56 全绿。
|
|
23
|
+
- 已知限制(均为 low,不影响本次修复):持久化归属里的 `baseUrl` 按字符串精确比较,同一地址的不同写法(如结尾斜杠差异)会被判为换了账号并丢弃旧历史;轮询 disposer 是模块级共享函数、没有代际 token,正常 DSH「先 dispose 旧实例再 apply 新实例」的顺序不会触发问题,但旧实例的 disposer 迟到调用可能清掉新一代 ticker。
|
|
24
|
+
|
|
3
25
|
## 0.4.4
|
|
4
26
|
|
|
5
27
|
- **去掉面板内的两处重复**:
|
package/README.md
CHANGED
|
@@ -10,19 +10,10 @@ OpenCode GO 套餐用量与配额状态监控面板插件(DeepSeek Harness)
|
|
|
10
10
|
- `⚙ 设置`:进入面板内的独立连接设置视图,可随时 `← 返回用量`。
|
|
11
11
|
- 右侧显示相对时间「上次同步 12s 前」(刚刚 / Ns 前 / N 分钟前 / N 小时前 / N 天前),绝对时刻 HH:MM:SS 保留在 `title`;同步数据超过 2 分钟追加「· 可能已过期」并用警告色,避免把旧额度当成实时值。
|
|
12
12
|
- **3 维度用量行**:主百分比只给剩余额度,进度条条长与它同源(条长 = 剩余占比,条色 = 剩余档位),「已用」放在 `title` 与 `aria-valuetext` 里,同一行不再重复表达同一个数字;窗口状态非 `ok` 时给出可见提示。
|
|
13
|
-
- **滚动窗口 (5h)**:`剩余 70% ·
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
- **可用时长估算(按当前速率,仅供参考)**:窗口行会顺带告诉你「按现在的用法还能撑多久」。三种状态严格区分,不存在第四种:
|
|
18
|
-
- `约 13h 后耗尽`(警告色):按当前速率会在窗口重置前用完;
|
|
19
|
-
- `可支撑到重置`(中性色):按当前速率能撑到重置,此时不再显示具体时长;
|
|
20
|
-
- **采样中**:已有采样点但还攒不够(少于 3 个点,或首尾跨度不足 10 分钟)时显示「采样中」,`title` 给出已有几个点、跨了多少分钟。它只是状态说明,不含任何数字,用来区分「功能没加载」和「还在攒数据」。
|
|
21
|
-
- **不显示**:速率为 0、剩余为 0、重置时间缺失或已过期时,这个位置直接不出现,也不用「--」「0m」之类占位凑数。
|
|
22
|
-
- 鼠标悬停会说明依据:「按最近 N 分钟的消耗速率估算(按当前速率),仅供参考」。它是对已有采样点的机械外推(只用首尾两点,不做回归),**不是预测或承诺**。
|
|
23
|
-
- 时长按两位有效数字粗化:<1h 取 5 分钟、1–10h 取 30 分钟、≥10h 取 1 小时、≥48h 取 1 天。上游只有整数百分比,分钟级精度属于虚假精确,粗化后不再暗示比实际更准。
|
|
24
|
-
- 采样只存在于页面打开期间的内存里(每窗口最近 60 分钟、最多 120 个点),刷新页面即清空,需要重新积累约 10 分钟才可能再次出现;上游只给整数百分比,样本不足时宁可不出数,也不给看起来精确的假时长。
|
|
25
|
-
- 纯前端计算:不新增网络请求、不新增依赖,数据仍只来自既有的 30 秒轮询与手动刷新。220ms 悬浮微卡不显示估算(一行放不下五项,缩字号或截断都不可接受,因此有意省略)。
|
|
13
|
+
- **滚动窗口 (5h)**:`剩余 70% · ⏱ 4h20m`
|
|
14
|
+
- **周窗口**:剩余 % + ⏱ 重置倒计时
|
|
15
|
+
- **月窗口**:剩余 % + ⏱ 重置倒计时
|
|
16
|
+
- 面板头部只显示连接状态(`已连接` / `异常`),不再给「最紧张」摘要——哪个窗口最紧,看三条进度条一眼就知道。
|
|
26
17
|
- **可访问性与键盘交互**:
|
|
27
18
|
- 面板是 `role="dialog"`,`aria-label` 随视图切换(「OpenCode GO 用量」/「OpenCode GO 连接配置」)。
|
|
28
19
|
- `Esc` 关闭面板;`Tab` 在面板内首尾循环;打开时焦点移入面板,关闭(含 Esc)后归还到打开前的触发按钮,点击面板外关闭时不抢焦点。
|
|
@@ -32,7 +23,7 @@ OpenCode GO 套餐用量与配额状态监控面板插件(DeepSeek Harness)
|
|
|
32
23
|
- 面板宽度为 `min(360px, calc(100vw - 24px))`,窄窗口(<372px)不再右侧溢出。
|
|
33
24
|
- **连接设置视图**:未配置(`mode === 'needs_config'`)时面板直接显示设置视图;保存成功后自动回到用量视图;「取消」丢弃未保存的编辑并关闭面板。密钥仅存入宿主凭据库(`OPENCODE_GO_API_KEY`),API 响应不回传明文。数据口径说明(上游只提供百分比、界面不展示金额余额)放在此视图底部,不占用用量视图。
|
|
34
25
|
- **220ms 悬浮微卡**:鼠标悬停常驻按钮 220ms 后在面板关闭且连接正常时出现,展示标题 + GO 标识 + 最近同步时间(相对时间)、三个窗口的紧凑行(名称 / 剩余 % / ⏱ 重置倒计时 / 细进度条)与底部「点击查看详情」;纯展示卡片,不拦截按钮点击。
|
|
35
|
-
- **缓存与刷新**:服务端 30 秒缓存 + 客户端 30
|
|
26
|
+
- **缓存与刷新**:服务端 30 秒缓存 + 客户端 30 秒自动刷新。自动轮询是插件级单例:插件激活时安装一次,侧栏按钮组件卸载(侧栏收起、布局切换)不会停表,只有插件被卸载 / 热替换时才随生命周期释放(避免旧 ticker 残留);页面隐藏期间保留 ticker、由浏览器自行节流,恢复可见时立即补拉一次。打开面板、切换视图不会额外探测上游,手动刷新是唯一绕过缓存的入口。
|
|
36
27
|
- **额度语义**:上游 `/v1/usage` 只提供 rolling/weekly/monthly 百分比,没有 USD 余额接口([anomalyco/opencode#10448](https://github.com/anomalyco/opencode/issues/10448) 仍 open),因此界面只展示「剩余额度 / 可用百分比」,不编造金额余额;百分比由宿主统一取整并钳制到 0–100,剩余与已用恒和 100。
|
|
37
28
|
|
|
38
29
|
## 安装与更新
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-opencode-status",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.6",
|
|
4
4
|
"description": "OpenCode GO quota status panel for DeepSeek Harness: click to open a usage panel with manual refresh, per-window remaining quota, a hover overview card, and in-app connection settings",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
package/src/client.js
CHANGED
|
@@ -159,154 +159,6 @@ window.__ModuleLoader__.load({
|
|
|
159
159
|
return `${Math.round(clampPct(value))}%`
|
|
160
160
|
}
|
|
161
161
|
|
|
162
|
-
/** 最紧张的用量窗口:头部只给判断性摘要,避免与窗口行重复表达同一个数字。 */
|
|
163
|
-
function tightestWindow(status) {
|
|
164
|
-
const windows = Array.isArray(status?.windows) ? status.windows : []
|
|
165
|
-
let tightest = null
|
|
166
|
-
for (const w of windows) {
|
|
167
|
-
if (typeof w?.remainingPct !== 'number') continue
|
|
168
|
-
if (!tightest || w.remainingPct < tightest.remainingPct) tightest = w
|
|
169
|
-
}
|
|
170
|
-
return tightest
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
// ---------- 消耗速率估算(按当前速率还能撑多久) ----------
|
|
174
|
-
// 采样放模块级而不是 store:每次采样不触发整树重渲染,渲染时按需读取。
|
|
175
|
-
const ETA_SAMPLE_WINDOW_MS = 60 * 60_000
|
|
176
|
-
const ETA_MAX_SAMPLES = 120
|
|
177
|
-
const ETA_MIN_SAMPLES = 3
|
|
178
|
-
const ETA_MIN_SPAN_MS = 10 * 60_000
|
|
179
|
-
|
|
180
|
-
/** windowId -> { resetAt, samples: [{ at, used }] };at 取 status.fetchedAt(不是 Date.now)。 */
|
|
181
|
-
const etaSamples = new Map()
|
|
182
|
-
|
|
183
|
-
/**
|
|
184
|
-
* 记录一次成功刷新的样本:按窗口分组,用 fetchedAt 去重(宿主 30s 缓存会让多次轮询拿到同一个时间),
|
|
185
|
-
* usedPct 回落或 resetsAt 变化说明窗口已重置,立即清空该窗口历史重新采样,避免算出负数或荒谬 ETA。
|
|
186
|
-
*/
|
|
187
|
-
function recordSamples(status) {
|
|
188
|
-
if (!status?.ok || typeof status.fetchedAt !== 'number') return
|
|
189
|
-
const windows = Array.isArray(status.windows) ? status.windows : []
|
|
190
|
-
for (const w of windows) {
|
|
191
|
-
const id = w?.id
|
|
192
|
-
if (!id || typeof w?.usedPct !== 'number') continue
|
|
193
|
-
const at = status.fetchedAt
|
|
194
|
-
const used = w.usedPct
|
|
195
|
-
const resetAt = typeof w.resetAt === 'number' && Number.isFinite(w.resetAt) ? w.resetAt : null
|
|
196
|
-
let entry = etaSamples.get(id)
|
|
197
|
-
if (!entry) {
|
|
198
|
-
entry = { resetAt, samples: [] }
|
|
199
|
-
etaSamples.set(id, entry)
|
|
200
|
-
}
|
|
201
|
-
const last = entry.samples[entry.samples.length - 1]
|
|
202
|
-
if (last && last.at === at) continue // 同一份缓存数据不重复采样
|
|
203
|
-
if (last && (used < last.used || resetAt !== entry.resetAt)) entry.samples = []
|
|
204
|
-
entry.resetAt = resetAt
|
|
205
|
-
entry.samples.push({ at, used })
|
|
206
|
-
// 只保留最近 60 分钟、每窗口最多 120 个样本。
|
|
207
|
-
const cutoff = at - ETA_SAMPLE_WINDOW_MS
|
|
208
|
-
while (entry.samples.length && entry.samples[0].at < cutoff) entry.samples.shift()
|
|
209
|
-
if (entry.samples.length > ETA_MAX_SAMPLES) entry.samples.splice(0, entry.samples.length - ETA_MAX_SAMPLES)
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
|
|
213
|
-
/**
|
|
214
|
-
* 估算「按当前速率还能撑多久」。样本 ≥3、首尾跨度 ≥10 分钟、速率 >0 三者缺一即返回 null;
|
|
215
|
-
* 速率只用首尾两点(不做回归,抗噪且好解释)。resetAt 缺失或已过期时无法判断能否撑到重置,同样返回 null。
|
|
216
|
-
* 返回 { etaMs, untilResetMs, exhaustsBeforeReset, spanMs }:能否撑到重置由调用方决定怎么展示。
|
|
217
|
-
*/
|
|
218
|
-
function estimateEta(samples, remainingPct, resetAt, now = Date.now()) {
|
|
219
|
-
if (!Array.isArray(samples) || samples.length < ETA_MIN_SAMPLES) return null
|
|
220
|
-
if (typeof remainingPct !== 'number' || !Number.isFinite(remainingPct) || remainingPct <= 0) return null
|
|
221
|
-
if (typeof resetAt !== 'number' || !Number.isFinite(resetAt)) return null
|
|
222
|
-
const first = samples[0]
|
|
223
|
-
const last = samples[samples.length - 1]
|
|
224
|
-
if (typeof first?.at !== 'number' || typeof last?.at !== 'number') return null
|
|
225
|
-
if (typeof first?.used !== 'number' || typeof last?.used !== 'number') return null
|
|
226
|
-
const spanMs = last.at - first.at
|
|
227
|
-
if (!(spanMs >= ETA_MIN_SPAN_MS)) return null
|
|
228
|
-
const ratePerMs = (last.used - first.used) / spanMs
|
|
229
|
-
if (!(ratePerMs > 0)) return null
|
|
230
|
-
const etaMs = remainingPct / ratePerMs
|
|
231
|
-
if (!Number.isFinite(etaMs) || etaMs <= 0) return null
|
|
232
|
-
const untilResetMs = resetAt - now
|
|
233
|
-
if (!Number.isFinite(untilResetMs) || untilResetMs <= 0) return null
|
|
234
|
-
return { etaMs, untilResetMs, exhaustsBeforeReset: etaMs < untilResetMs, spanMs }
|
|
235
|
-
}
|
|
236
|
-
|
|
237
|
-
/** 时长短文案:<1h 用分钟,<24h 用 h+m,更长用 d+h(「还能撑多久」不需要精确到分秒)。 */
|
|
238
|
-
function fmtEtaDuration(ms) {
|
|
239
|
-
const mins = Math.max(1, Math.round(ms / 60_000))
|
|
240
|
-
if (mins < 60) return `${mins}m`
|
|
241
|
-
const hours = Math.floor(mins / 60)
|
|
242
|
-
if (hours < 24) return `${hours}h${mins % 60 ? `${mins % 60}m` : ''}`
|
|
243
|
-
const days = Math.floor(hours / 24)
|
|
244
|
-
return `${days}d${hours % 24 ? `${hours % 24}h` : ''}`
|
|
245
|
-
}
|
|
246
|
-
|
|
247
|
-
/**
|
|
248
|
-
* 估算值粗化:上游只给整数 percent,量化误差会让 ETA 的真实区间比点值宽 2-3 倍,
|
|
249
|
-
* 分钟级精度属于虚假精确。按「两位有效数字」粗化,既保留量级又不再暗示精度:
|
|
250
|
-
* <1h 取 5 分钟、1-10h 取 30 分钟、≥10h 取 1 小时、≥48h 取 1 天。
|
|
251
|
-
*/
|
|
252
|
-
function coarsenEta(ms) {
|
|
253
|
-
const minutes = ms / 60_000
|
|
254
|
-
if (minutes < 60) return Math.max(5, Math.round(minutes / 5) * 5) * 60_000
|
|
255
|
-
if (minutes < 600) return Math.round(minutes / 30) * 30 * 60_000
|
|
256
|
-
const hours = minutes / 60
|
|
257
|
-
if (hours < 48) return Math.round(hours) * 3_600_000
|
|
258
|
-
return Math.round(hours / 24) * 86_400_000
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
/**
|
|
262
|
-
* 估算文案的三态:不可估算返回 null(调用方完全不渲染节点,不显示 "--"/"估算中" 之类占位);
|
|
263
|
-
* 撑不到重置用告警色「约 X 后耗尽」,撑得到用中性色「可支撑到重置」。
|
|
264
|
-
* 文案只用「按当前速率」的描述,不用「预计/将」这种预测口吻。
|
|
265
|
-
* 行内必须保留「约」与「后」:这是常驻可见的唯一表述(悬浮卡等场景 title 不可达),
|
|
266
|
-
* 缺了「约」会被读成确定性断言,与「仅供参考」的定位冲突。
|
|
267
|
-
* compact(悬浮微卡,外宽约 220px)整段不展示:一行放不下「名称/条/剩余/估算/倒计时」五项,
|
|
268
|
-
* 缩字号、砍进度条/倒计时、截断估算都不可接受,所以宁可不显示;估算逻辑仍共用 estimateEta,只是呈现密度不同。
|
|
269
|
-
* 这是有意为之,不是漏渲染。
|
|
270
|
-
*/
|
|
271
|
-
function etaView(w, options = {}) {
|
|
272
|
-
if (options?.compact) return null
|
|
273
|
-
const entry = etaSamples.get(w?.id)
|
|
274
|
-
if (!entry || !entry.samples.length) return null
|
|
275
|
-
const estimate = estimateEta(entry.samples, w?.remainingPct, w?.resetAt)
|
|
276
|
-
if (!estimate) {
|
|
277
|
-
// 「采样中」只在样本数或跨度还不够时出现:让用户能区分「功能没加载」与「还在攒数据」。
|
|
278
|
-
// 速率 0、剩余 0、重置缺失或已过期都不是采样问题,仍然什么都不显示。
|
|
279
|
-
const samples = entry.samples
|
|
280
|
-
const span = samples[samples.length - 1].at - samples[0].at
|
|
281
|
-
if (samples.length >= ETA_MIN_SAMPLES && span >= ETA_MIN_SPAN_MS) return null
|
|
282
|
-
if (typeof w?.remainingPct !== 'number' || w.remainingPct <= 0) return null
|
|
283
|
-
if (!w?.resetAt || w.resetAt <= Date.now()) return null
|
|
284
|
-
return {
|
|
285
|
-
text: '采样中',
|
|
286
|
-
color: T.secondary,
|
|
287
|
-
title: `正在积累采样:已有 ${samples.length} 个点、跨度约 ${Math.max(1, Math.round(span / 60_000))} 分钟;需要 ${ETA_MIN_SAMPLES} 个点且跨度满 ${ETA_MIN_SPAN_MS / 60_000} 分钟`,
|
|
288
|
-
}
|
|
289
|
-
}
|
|
290
|
-
const minutes = Math.max(1, Math.round(estimate.spanMs / 60_000))
|
|
291
|
-
// 文案只说「按最近 N 分钟的消耗速率(按当前速率)」的实测依据,不写「预计/将」这类预测口吻。
|
|
292
|
-
const title = `按最近 ${minutes} 分钟的消耗速率估算(按当前速率),仅供参考`
|
|
293
|
-
// 保留完整字面「约 X 后耗尽」:真实 Chrome 实测在 326px/262px 内容宽下都不会截断,只会让标签多收缩。
|
|
294
|
-
return estimate.exhaustsBeforeReset
|
|
295
|
-
? { text: `约 ${fmtEtaDuration(coarsenEta(estimate.etaMs))} 后耗尽`, color: T.warn, title }
|
|
296
|
-
: { text: '可支撑到重置', color: T.secondary, title }
|
|
297
|
-
}
|
|
298
|
-
|
|
299
|
-
/** 仅供测试与诊断:读取某个窗口的采样副本。 */
|
|
300
|
-
function getSamples(windowId) {
|
|
301
|
-
const entry = etaSamples.get(windowId)
|
|
302
|
-
return entry ? entry.samples.map((s) => ({ ...s })) : []
|
|
303
|
-
}
|
|
304
|
-
|
|
305
|
-
/** 仅供测试与诊断:清空所有采样。 */
|
|
306
|
-
function resetEtaSamples() {
|
|
307
|
-
etaSamples.clear()
|
|
308
|
-
}
|
|
309
|
-
|
|
310
162
|
/** 月窗口剩余百分比;上游只给百分比,不存在金额余额。 */
|
|
311
163
|
function monthlyRemainingOf(status) {
|
|
312
164
|
if (!status) return null
|
|
@@ -374,7 +226,6 @@ window.__ModuleLoader__.load({
|
|
|
374
226
|
const status = await api('/api/opencode-status')
|
|
375
227
|
// 只接受最新 epoch 的响应:手动刷新之后返回的在途 GET 一律丢弃。
|
|
376
228
|
if (epoch === statusEpoch) {
|
|
377
|
-
recordSamples(status)
|
|
378
229
|
store.set({ status, error: null })
|
|
379
230
|
}
|
|
380
231
|
} catch (err) {
|
|
@@ -393,6 +244,63 @@ window.__ModuleLoader__.load({
|
|
|
393
244
|
} catch {}
|
|
394
245
|
}
|
|
395
246
|
|
|
247
|
+
// 30 秒状态轮询是模块级单例:采样服务于面板,不能依赖 footer 组件是否挂载。
|
|
248
|
+
let statusPollingStarted = false
|
|
249
|
+
let statusPollTimer = null
|
|
250
|
+
let visibilityListenerBound = false
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* 页面恢复可见时立即补拉一次;隐藏期间保留 ticker(浏览器会自行节流后台定时器)。
|
|
254
|
+
* 旧实现 hidden 时 clearInterval,恢复只靠这一次 visibilitychange——事件一旦丢失,
|
|
255
|
+
* 轮询就永久停摆,面板会一直显示冻结的旧额度。
|
|
256
|
+
*/
|
|
257
|
+
function onVisibilityChange() {
|
|
258
|
+
if (typeof document !== 'undefined' && document.hidden) return
|
|
259
|
+
refreshStatus()
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/**
|
|
263
|
+
* 幂等释放轮询与可见性监听:插件 dispose / HMR 重载时由 apply 的 ctx.effect 调用。
|
|
264
|
+
* 不释放的话旧 ticker 会随模块退役继续存活,新旧 ticker 并存时每 30 秒发两次请求。
|
|
265
|
+
*/
|
|
266
|
+
function disposeStatusPolling() {
|
|
267
|
+
if (statusPollTimer !== null) {
|
|
268
|
+
clearInterval(statusPollTimer)
|
|
269
|
+
statusPollTimer = null
|
|
270
|
+
}
|
|
271
|
+
statusPollingStarted = false
|
|
272
|
+
if (visibilityListenerBound) {
|
|
273
|
+
visibilityListenerBound = false
|
|
274
|
+
if (typeof document !== 'undefined' && typeof document.removeEventListener === 'function') {
|
|
275
|
+
document.removeEventListener('visibilitychange', onVisibilityChange)
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* 安装 30 秒 GET 轮询(幂等),返回同一个幂等 disposer。旧实现在 FooterEntry 的挂载 effect 里建 ticker:
|
|
282
|
+
* footer 卸载(侧栏收起、布局切换)或 hidden 清理后事件丢失,轮询永久停止,面板显示冻结的旧额度。
|
|
283
|
+
* 轮询属于模块级资源,组件卸载不拆除,但插件 dispose 时必须释放(见 disposeStatusPolling)。
|
|
284
|
+
*/
|
|
285
|
+
function ensureStatusPolling() {
|
|
286
|
+
if (!statusPollingStarted) {
|
|
287
|
+
statusPollingStarted = true
|
|
288
|
+
statusPollTimer = setInterval(() => refreshStatus(), 30_000)
|
|
289
|
+
// 首次安装立即拉一次,面板不用等第一个 30 秒。
|
|
290
|
+
refreshStatus()
|
|
291
|
+
}
|
|
292
|
+
if (!visibilityListenerBound) {
|
|
293
|
+
// 测试与 SSR 沙箱里 document 可能没有事件接口,先探测再注册。
|
|
294
|
+
const canListen = typeof document !== 'undefined' && typeof document.addEventListener === 'function'
|
|
295
|
+
if (canListen) {
|
|
296
|
+
document.addEventListener('visibilitychange', onVisibilityChange)
|
|
297
|
+
visibilityListenerBound = true
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
// 多次 ensure 返回同一个函数引用:FooterEntry 的幂等调用不会造出第二个 disposer。
|
|
301
|
+
return disposeStatusPolling
|
|
302
|
+
}
|
|
303
|
+
|
|
396
304
|
/** 手动刷新唯一入口:绕过 30 秒缓存,强制重新拉取当前剩余额度。 */
|
|
397
305
|
async function manualRefresh() {
|
|
398
306
|
if (store.state.refreshing) return
|
|
@@ -405,7 +313,6 @@ window.__ModuleLoader__.load({
|
|
|
405
313
|
headers: { 'content-type': 'application/json' },
|
|
406
314
|
})
|
|
407
315
|
// 手动刷新自身的响应始终落库(刷新期间已阻止新的 GET)。
|
|
408
|
-
recordSamples(status)
|
|
409
316
|
store.set({ status, error: null })
|
|
410
317
|
} catch (err) {
|
|
411
318
|
store.set({ error: String(err?.message ?? err) })
|
|
@@ -442,23 +349,9 @@ window.__ModuleLoader__.load({
|
|
|
442
349
|
const hoverTimerRef = useRef(null)
|
|
443
350
|
|
|
444
351
|
useEffect(() => {
|
|
445
|
-
|
|
446
|
-
//
|
|
447
|
-
|
|
448
|
-
const onVisibilityChange = () => {
|
|
449
|
-
clearInterval(timer)
|
|
450
|
-
timer = null
|
|
451
|
-
if (typeof document !== 'undefined' && document.hidden) return
|
|
452
|
-
refreshStatus()
|
|
453
|
-
timer = setInterval(() => refreshStatus(), 30_000)
|
|
454
|
-
}
|
|
455
|
-
// 测试与 SSR 沙箱里 document 可能没有事件接口,先探测再注册。
|
|
456
|
-
const canListen = typeof document !== 'undefined' && typeof document.addEventListener === 'function'
|
|
457
|
-
if (canListen) document.addEventListener('visibilitychange', onVisibilityChange)
|
|
458
|
-
return () => {
|
|
459
|
-
if (timer !== null) clearInterval(timer)
|
|
460
|
-
if (canListen) document.removeEventListener('visibilitychange', onVisibilityChange)
|
|
461
|
-
}
|
|
352
|
+
// 只幂等确保 ticker 存在,不接管清理:ticker 的生命周期归 apply 的 ctx.effect 管理。
|
|
353
|
+
// footer 卸载(侧栏收起、布局切换)不得停采,这里也不能创建第二个 disposer 去重复清理。
|
|
354
|
+
ensureStatusPolling()
|
|
462
355
|
}, [])
|
|
463
356
|
|
|
464
357
|
// 卸载时清掉待触发的悬停定时器,避免 220ms 后对已卸载组件 setState。
|
|
@@ -682,9 +575,6 @@ window.__ModuleLoader__.load({
|
|
|
682
575
|
const w = props.window
|
|
683
576
|
const remaining = w?.remainingPct ?? null
|
|
684
577
|
const color = remainingColor(remaining)
|
|
685
|
-
// compact:悬浮微卡外宽约 220px,五个元素塞不进去。这里整段不渲染估算(etaView 返回 null),
|
|
686
|
-
// 不缩字号、不砍进度条/倒计时、不截断成残句;面板 QuotaRow 仍照常展示。
|
|
687
|
-
const eta = etaView(w, { compact: true })
|
|
688
578
|
return h('div', { style: { display: 'flex', alignItems: 'center', gap: 6 } }, [
|
|
689
579
|
h('span', { key: 'n', style: { width: 46, flexShrink: 0, fontSize: 10, color: T.secondary, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, w?.shortLabel ?? w?.label ?? '—'),
|
|
690
580
|
h(
|
|
@@ -695,10 +585,6 @@ window.__ModuleLoader__.load({
|
|
|
695
585
|
: h('div', { style: { height: '100%', width: `${clampPct(remaining)}%`, background: color, borderRadius: 2 } }),
|
|
696
586
|
),
|
|
697
587
|
h('span', { key: 'v', style: { minWidth: 30, flexShrink: 0, textAlign: 'right', fontSize: 10, fontWeight: 600, color, fontVariantNumeric: 'tabular-nums' } }, remaining === null ? '—' : pctText(remaining)),
|
|
698
|
-
// 紧凑视图不会走到这里(etaView(compact) 恒为 null);保留非截断样式,避免以后误开时变成残句。
|
|
699
|
-
eta
|
|
700
|
-
? h('span', { key: 'e', title: eta.title, style: { flexShrink: 0, fontSize: 10, color: eta.color, whiteSpace: 'nowrap' } }, eta.text)
|
|
701
|
-
: null,
|
|
702
588
|
// 倒计时用 ⏱ 区分刷新动作的 ↻,避免两个图标同义混淆。
|
|
703
589
|
h('span', { key: 'r', style: { minWidth: 34, flexShrink: 0, textAlign: 'right', fontSize: 10, color: T.secondary, fontVariantNumeric: 'tabular-nums' } }, w?.resetAt ? `⏱ ${timeUntil(w.resetAt)}` : ''),
|
|
704
590
|
])
|
|
@@ -714,28 +600,12 @@ window.__ModuleLoader__.load({
|
|
|
714
600
|
}
|
|
715
601
|
|
|
716
602
|
const windows = Array.isArray(st.windows) ? st.windows : []
|
|
717
|
-
// 头部只给判断性摘要(最紧张窗口),具体数字留给下方窗口行,避免同一数字说两遍。
|
|
718
|
-
const tightest = tightestWindow(st)
|
|
719
603
|
|
|
720
604
|
return h('div', null, [
|
|
721
605
|
h('div', { key: 'sum', style: { display: 'flex', alignItems: 'center', gap: 6 } }, [
|
|
722
606
|
h('span', { key: 'd', style: dotStyle(st.ok ? T.ok : T.err) }),
|
|
723
607
|
// 窄视口下让标题让位给右侧摘要:摘要 flexShrink:0,标题可省略。
|
|
724
608
|
h('span', { key: 't', style: { fontSize: 12, fontWeight: 600, color: T.label, minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', flexShrink: 1 } }, st.ok ? '已连接' : '异常'),
|
|
725
|
-
tightest
|
|
726
|
-
? h(
|
|
727
|
-
'span',
|
|
728
|
-
{
|
|
729
|
-
key: 'm',
|
|
730
|
-
// host 只在面板标题行展示一次;这里不再重复。
|
|
731
|
-
title: `最紧张窗口:${tightest.label ?? tightest.id ?? '—'},剩余 ${pctText(tightest.remainingPct)}`,
|
|
732
|
-
style: { marginLeft: 'auto', fontSize: 11, fontWeight: 600, color: remainingColor(tightest.remainingPct), fontVariantNumeric: 'tabular-nums', flexShrink: 0 },
|
|
733
|
-
},
|
|
734
|
-
// 用 label 而不是 shortLabel:shortLabel 是给 220px 悬浮微卡的窄列设计的紧凑缩写,
|
|
735
|
-
// 复用到这里会把「Weekly / Monthly」这类英文缩写漏进主面板。
|
|
736
|
-
`最紧张 ${tightest.label ?? tightest.id ?? '—'}`,
|
|
737
|
-
)
|
|
738
|
-
: null,
|
|
739
609
|
].filter(Boolean)),
|
|
740
610
|
state.error
|
|
741
611
|
? h('div', { key: 'ce', style: { fontSize: 11, color: T.err, marginTop: 8 } }, `刷新失败:${state.error}`)
|
|
@@ -762,18 +632,12 @@ window.__ModuleLoader__.load({
|
|
|
762
632
|
const remaining = w?.remainingPct ?? null
|
|
763
633
|
const color = remainingColor(remaining)
|
|
764
634
|
const band = remainingBand(remaining)
|
|
765
|
-
const eta = etaView(w)
|
|
766
635
|
const statusText = w?.status && w.status !== 'ok' ? w.status : null
|
|
767
636
|
const detail = remaining === null ? '数据不可用' : `已用 ${pctText(used)} · 剩余 ${pctText(remaining)}`
|
|
768
637
|
return h('div', { style: { marginBottom: 12 } }, [
|
|
769
638
|
h('div', { key: 'meta', style: { display: 'flex', alignItems: 'baseline', gap: 6, fontSize: 11, marginBottom: 4, fontVariantNumeric: 'tabular-nums' } }, [
|
|
770
639
|
h('span', { key: 'l', style: { color: T.label, fontWeight: 500, minWidth: 0, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, w?.label ?? '—'),
|
|
771
640
|
h('span', { key: 'r', title: detail, style: { marginLeft: 'auto', color, fontWeight: 600, flexShrink: 0 } }, remaining === null ? '剩余 —' : `剩余 ${pctText(remaining)}`),
|
|
772
|
-
// 估算整段展示、不截断:flexShrink:0 且无 ellipsis;空间不足时只让窗口标签 ellipsis,
|
|
773
|
-
// 档位徽标(告警不只靠颜色)、剩余 % 与倒计时都不收缩。
|
|
774
|
-
eta
|
|
775
|
-
? h('span', { key: 'eta', title: eta.title, style: { flexShrink: 0, fontSize: 10, color: eta.color, whiteSpace: 'nowrap' } }, eta.text)
|
|
776
|
-
: null,
|
|
777
641
|
// 低额度除颜色外再给文字标记:色觉障碍与灰度截图里也能看出档位。
|
|
778
642
|
band
|
|
779
643
|
? h(
|
|
@@ -846,7 +710,7 @@ window.__ModuleLoader__.load({
|
|
|
846
710
|
headers: { 'content-type': 'application/json' },
|
|
847
711
|
body: JSON.stringify({ baseUrl, ...(apiKey ? { apiKey } : {}) }),
|
|
848
712
|
})
|
|
849
|
-
//
|
|
713
|
+
// 保存成功后回到用量视图;账号/baseUrl 变了就立刻作废旧账号的采样历史,不等下一次轮询。
|
|
850
714
|
store.set({ status: result.status, config: result.config, view: 'status', error: null })
|
|
851
715
|
setApiKey('')
|
|
852
716
|
} catch (e) {
|
|
@@ -1138,6 +1002,13 @@ window.__ModuleLoader__.load({
|
|
|
1138
1002
|
|
|
1139
1003
|
// ---------- 注册 ----------
|
|
1140
1004
|
function apply(ctx) {
|
|
1005
|
+
// 0.4.6 起不再使用采样持久化,清掉旧版本留下的键(仅清理,不含任何用户数据)。
|
|
1006
|
+
try {
|
|
1007
|
+
if (typeof localStorage !== 'undefined' && localStorage) localStorage.removeItem('dsh-opencode-status.eta-samples')
|
|
1008
|
+
} catch {}
|
|
1009
|
+
// 轮询与 visibilitychange 监听随插件生命周期释放:不依赖 footer 是否挂载(侧栏收起/布局切换仍持续采样),
|
|
1010
|
+
// 但 dispose/HMR 时必须清掉,否则旧 ticker 会和新 ticker 并存、每 30 秒发两次请求。
|
|
1011
|
+
ctx.effect(() => ensureStatusPolling())
|
|
1141
1012
|
ctx.effect(() => {
|
|
1142
1013
|
const el = document.createElement('style')
|
|
1143
1014
|
el.id = 'dsh-opencode-status-styles'
|
|
@@ -1160,7 +1031,7 @@ window.__ModuleLoader__.load({
|
|
|
1160
1031
|
exports.apply = apply
|
|
1161
1032
|
exports.inject = ['slots']
|
|
1162
1033
|
// 仅供测试与诊断:估算/采样是纯函数 + 模块内状态,导出以便做真实单元测试(宿主侧不消费)。
|
|
1163
|
-
exports.__internal = {
|
|
1034
|
+
exports.__internal = { ensureStatusPolling }
|
|
1164
1035
|
return module.exports
|
|
1165
1036
|
},
|
|
1166
1037
|
})
|