dsh-consumption-badge 1.2.1 → 1.2.2

package/lib/index.js

@@ -196,24 +196,28 @@ export function apply(ctx) {
     return null
   }
 
-  /** 用 curl 取余额：密钥走 stdin 上的 curl 配置，不进进程参数。 */
+  /**
+   * 用 curl 取余额：密钥走 stdin 上的 curl 配置，不进进程参数。
+   * 失败一律回 `{ ok:false, code, detail, error }`：`code` 是语言无关的错误码（浏览器半边负责
+   * 按当前语言翻译），`detail` 是原始细节，`error` 是英文兜底文案（code 未知时才会被显示）。
+   */
   async function fetchBalance() {
     const credentials = ctx.get('credentials')
     if (!credentials || typeof credentials.resolve !== 'function') {
-      return { ok: false, error: 'credentials 服务不可用' }
+      return { ok: false, code: 'no-credentials', error: 'credentials service unavailable' }
     }
     let resolved = null
     try {
       resolved = await credentials.resolve(KEY_REF)
     } catch (e) {
-      return { ok: false, error: '读取 API Key 失败：' + errText(e) }
+      return { ok: false, code: 'key-read-failed', detail: errText(e), error: 'failed to read the API key' }
     }
     if (!resolved || typeof resolved.value !== 'string' || resolved.value === '') {
-      return { ok: false, error: '未配置 ' + KEY_REF }
+      return { ok: false, code: 'no-key', detail: KEY_REF, error: 'no API key configured' }
     }
     const subprocess = ctx.get('subprocess')
     if (!subprocess || typeof subprocess.spawn !== 'function') {
-      return { ok: false, error: 'subprocess 服务不可用' }
+      return { ok: false, code: 'no-subprocess', error: 'subprocess service unavailable' }
     }
     let cwd = process.cwd()
     try {
@@ -229,6 +233,8 @@ export function apply(ctx) {
       ['curl.exe', '-sS', '--max-time', '12', '-K', '-'],
     ]
     let lastError = ''
+    let lastCode = ''
+    let lastDetail = ''
     for (let i = 0; i < candidates.length; i += 1) {
       let handle = null
       try {
@@ -243,14 +249,18 @@ export function apply(ctx) {
           graceMs: 3000,
         })
       } catch (e) {
-        lastError = errText(e)
+        lastCode = 'spawn-failed'
+        lastDetail = errText(e)
+        lastError = 'spawn failed'
         continue
       }
       let outcome = null
       try {
         outcome = await handle.done
       } catch (e) {
-        lastError = errText(e)
+        lastCode = 'spawn-failed'
+        lastDetail = errText(e)
+        lastError = 'spawn failed'
         continue
       }
       const collected = handle.collected || {}
@@ -259,27 +269,30 @@ export function apply(ctx) {
       const text = outRead && typeof outRead.text === 'string' ? outRead.text.trim() : ''
       const stderrText = errRead && typeof errRead.text === 'string' ? errRead.text.trim() : ''
       if (!text) {
-        const code = outcome && typeof outcome.exitCode === 'number' ? '（退出码 ' + String(outcome.exitCode) + '）' : ''
-        lastError = 'curl 无输出' + (stderrText ? '：' + stderrText.slice(0, 200) : '') + code
+        lastCode = 'curl-empty'
+        lastDetail = (stderrText ? stderrText.slice(0, 200) : '') + (outcome && typeof outcome.exitCode === 'number' ? ' (exit ' + String(outcome.exitCode) + ')' : '')
+        lastError = 'curl produced no output'
         continue
       }
       let json = null
       try {
         json = JSON.parse(text)
       } catch (e) {
-        lastError = '响应解析失败：' + text.slice(0, 160)
+        lastCode = 'bad-response'
+        lastDetail = text.slice(0, 160)
+        lastError = 'could not parse the response'
         continue
       }
       return normalizeBalance(json)
     }
-    return { ok: false, error: lastError || '余额接口请求失败' }
+    return { ok: false, code: lastCode || 'balance-request-failed', detail: lastDetail, error: lastError || 'balance request failed' }
   }
 
   /** 逐轮用量（带 length 版本缓存，日志没变就不重折）。 */
   async function handleTurns(sessionId) {
-    if (!sessionId) return { ok: false, error: '缺少 sessionId', turns: [] }
+    if (!sessionId) return { ok: false, code: 'missing-session-id', error: 'missing sessionId', turns: [] }
     const events = await readEvents(sessionId)
-    if (events === null) return { ok: false, error: '会话日志不可用', turns: [] }
+    if (events === null) return { ok: false, code: 'log-unavailable', error: 'session log unavailable', turns: [] }
     const cached = turnCache.get(sessionId)
     if (cached && cached.length === events.length) return { ok: true, cached: true, turns: cached.turns }
     const turns = foldTurns(events)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-consumption-badge",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "DSH Web UI plugin: a per-message consumption badge (tokens | estimated cost | peak/valley) plus a session detail modal with cumulative tokens, estimated cost, Beijing-time peak/off-peak pricing, a per-turn dual-axis chart, and the DeepSeek account balance",
   "keywords": [
     "deepseek-harness",