dsh-deepseek-account 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.5 - 2026-08-30
+
+- Group Codex five-hour and weekly quota data into compact visual blocks with stronger percentage hierarchy and secondary reset-time rows.
+- Refresh the selected Provider once when the current conversation transitions from running to idle, without polling or duplicate idle refreshes.
+- Replace the generic gear beside the DeepSeek account settings entry with the DeepSeek whale icon, restoring the original shell icon when the plugin unloads.
+
 ## 0.1.4 - 2026-08-30
 
 - Show the remaining Grok quota percentage with its current reset window.

package/README.en.md

@@ -34,14 +34,14 @@ Requirements:
 Install the current stable version:
 
 ```sh
-dsh plugin --profile web add dsh-deepseek-account@0.1.4
+dsh plugin --profile web add dsh-deepseek-account@0.1.5
 dsh web
 ```
 
 In the current conversation's Web UI:
 
-1. The sidebar footer shows account information for the current Provider; click it to refresh.
-2. The “DeepSeek account” settings page shows CNY/USD total, granted, and topped-up balances.
+1. The sidebar footer shows account information for the current Provider; click it to refresh, or let it refresh once automatically after each conversation turn finishes.
+2. The settings navigation uses the DeepSeek whale icon; the “DeepSeek account” page shows CNY/USD total, granted, and topped-up balances.
 3. “Sign in and top up” opens only `https://platform.deepseek.com/balance` in a new page.
 
 Continue to pin an exact version when upgrading so pre-release dependencies cannot drift:
@@ -61,7 +61,7 @@ dsh web
 | Showing the last verified balance | The current request failed and the plugin retained a marked stale snapshot | Check the network, retry later, and note the timestamp |
 | Quota source unavailable | The Grok/Codex plugin is absent, stopped, or exposes an incompatible local RPC | Check that plugin; DeepSeek remains unaffected |
 
-Automatic reads are cached for up to five minutes, manual refreshes for 30 seconds, and concurrent reads are coalesced into one request.
+Automatic DeepSeek reads are cached for up to five minutes, forced refreshes for 30 seconds, and concurrent reads are coalesced into one request. After each conversation turn, the plugin observes the current session's running-to-idle edge and refreshes the current Provider without polling.
 
 ## Security design
 

package/README.md

@@ -34,14 +34,14 @@ DeepSeek Harness 的独立账户插件：在一个侧栏入口中展示当前对
 安装当前稳定版本：
 
 ```sh
-dsh plugin --profile web add dsh-deepseek-account@0.1.4
+dsh plugin --profile web add dsh-deepseek-account@0.1.5
 dsh web
 ```
 
 打开当前对话的 Web 界面后：
 
-1. 侧栏底部会显示当前 Provider 的账户信息；点击可手动刷新。
-2. 设置页的“DeepSeek 账户”可查看 CNY/USD 的总余额、赠送余额和充值余额。
+1. 侧栏底部会显示当前 Provider 的账户信息；点击可手动刷新，每轮对话结束后也会主动刷新一次。
+2. 设置导航使用 DeepSeek 鲸鱼图标；“DeepSeek 账户”页面可查看 CNY/USD 的总余额、赠送余额和充值余额。
 3. “登录并充值”只会在新页面打开 `https://platform.deepseek.com/balance`。
 
 升级时继续使用精确版本，避免预发布阶段的依赖漂移：
@@ -61,7 +61,7 @@ dsh web
 | 展示上一次成功读取的余额 | 当前请求失败，插件保留了已标记的旧快照 | 检查网络后重试，并留意数据时间 |
 | 额度来源不可用 | Grok/Codex 插件未安装、未运行或其本地 RPC 不兼容 | 检查对应插件；DeepSeek 功能不受影响 |
 
-自动读取最多缓存 5 分钟，手动刷新最多每 30 秒发起一次请求；并发读取会合并为一次请求。
+DeepSeek 自动读取最多缓存 5 分钟，强制刷新最多每 30 秒发起一次上游请求；并发读取会合并为一次请求。每轮对话结束时，插件会监听当前会话由运行变为空闲的边沿并刷新当前 Provider，不使用定时轮询。
 
 ## 安全设计
 

package/dist/client/client.js

@@ -1,4 +1,4 @@
-/* global document, window */
+/* global document, MutationObserver, window */
 
 window.__ModuleLoader__.load({
   id: "dsh-deepseek-account",
@@ -175,6 +175,26 @@ window.__ModuleLoader__.load({
       return provider
     }
 
+    function subscribeCurrentConversationCompletion(list, onComplete) {
+      const currentState = () => {
+        const snapshot = list.getSnapshot()
+        const sessionId = snapshot.current
+        return { sessionId, running: sessionId === undefined ? false : snapshot.byId?.[sessionId]?.running === true }
+      }
+      let previous = currentState()
+      return list.subscribe(() => {
+        const current = currentState()
+        if (current.sessionId !== undefined && current.sessionId === previous.sessionId && previous.running && !current.running) {
+          onComplete(current.sessionId)
+        }
+        previous = current
+      })
+    }
+
+    function useConversationCompletionRefresh(sessions, refresh) {
+      React.useEffect(() => subscribeCurrentConversationCompletion(sessions.list, () => { void refresh(true) }), [refresh, sessions])
+    }
+
     function accountProvider(selected) {
       return selected === "llm-grok" || selected === "grok" ? "grok" : selected === "dsh-codex" ? "codex" : "deepseek"
     }
@@ -219,9 +239,78 @@ window.__ModuleLoader__.load({
       }, React.createElement("path", { d: providerIconPaths[provider] ?? providerIconPaths.deepseek }))
     }
 
+    function mountSettingsNavIcon(button) {
+      const existing = button?.querySelector?.("[data-dsh-deepseek-account-nav-icon]")
+      if (existing !== null && existing !== undefined) return undefined
+      const original = button?.querySelector?.("svg")
+      if (original === null || original === undefined || typeof document.createElementNS !== "function") return undefined
+      const wasHidden = original.hidden === true
+      const icon = document.createElementNS("http://www.w3.org/2000/svg", "svg")
+      icon.dataset.dshDeepseekAccountNavIcon = ""
+      icon.setAttribute("viewBox", "0 0 24 24")
+      icon.setAttribute("width", "16")
+      icon.setAttribute("height", "16")
+      icon.setAttribute("fill", "currentColor")
+      icon.setAttribute("fill-rule", "evenodd")
+      icon.setAttribute("focusable", "false")
+      icon.setAttribute("aria-hidden", "true")
+      const path = document.createElementNS("http://www.w3.org/2000/svg", "path")
+      path.setAttribute("d", providerIconPaths.deepseek)
+      icon.append(path)
+      original.hidden = true
+      original.after(icon)
+      let mounted = true
+      return () => {
+        if (!mounted) return
+        mounted = false
+        original.hidden = wasHidden
+        icon.remove()
+      }
+    }
+
+    function installSettingsNavIcon() {
+      if (typeof MutationObserver !== "function" || document.body?.querySelectorAll === undefined) return () => {}
+      const labels = new Set([dictionaries.zh.nav, dictionaries.en.nav])
+      const mounted = new Map()
+      const scan = () => {
+        for (const [button, cleanup] of mounted) {
+          if (button.isConnected === false) { cleanup(); mounted.delete(button) }
+        }
+        for (const button of document.body.querySelectorAll("button")) {
+          if (mounted.has(button)) continue
+          const matches = Array.from(button.querySelectorAll?.("span") ?? [])
+            .some((node) => labels.has(node.textContent?.trim()))
+          if (!matches) continue
+          const cleanup = mountSettingsNavIcon(button)
+          if (cleanup !== undefined) mounted.set(button, cleanup)
+        }
+      }
+      const observer = new MutationObserver(scan)
+      observer.observe(document.body, { childList: true, subtree: true })
+      scan()
+      return () => {
+        observer.disconnect()
+        for (const cleanup of mounted.values()) cleanup()
+        mounted.clear()
+      }
+    }
+
+    function SidebarDetails({ provider, state, presentation, t }) {
+      if (provider !== "codex" || state.status !== "ready") {
+        return React.createElement(React.Fragment, null, ...presentation.lines.map((line, index) =>
+          React.createElement("small", { key: `${provider}-${index}` }, line)))
+      }
+      return React.createElement("span", { className: "dsh-deepseek-account-quota-windows" }, ...state.windows.map((window) =>
+        React.createElement("span", { className: "dsh-deepseek-account-quota-window", key: window.kind },
+          React.createElement("span", { className: "dsh-deepseek-account-quota-period" }, t(window.kind === "five-hour" ? "fiveHour" : "weekly")),
+          React.createElement("strong", { className: "dsh-deepseek-account-quota-remaining" }, `${t("remaining")} ${percentText(window.remainingPercent)}%`),
+          React.createElement("small", { className: "dsh-deepseek-account-quota-reset" }, `${t("resetsAt")} ${resetTime(window.resetsAt)}`))))
+    }
+
     function SidebarBalance({ wide, ctx, client, t }) {
       const provider = useActiveAccountProvider(ctx)
       const { state, busy, refresh } = useAccount(client, provider)
+      useConversationCompletionRefresh(ctx.sessions, refresh)
       const currentState = state.provider === provider ? state : { provider, status: "loading" }
       const presentation = sidebarPresentation(provider, currentState, t)
       return React.createElement("button", {
@@ -231,7 +320,7 @@ window.__ModuleLoader__.load({
         ? React.createElement(React.Fragment, null,
           React.createElement("span", { className: "dsh-deepseek-account-symbol", "aria-hidden": "true" }, ProviderIcon({ provider })),
           React.createElement("span", { className: "dsh-deepseek-account-copy" }, React.createElement("span", null, presentation.label),
-            ...presentation.lines.map((line, index) => React.createElement("small", { key: `${provider}-${index}` }, line))),
+            SidebarDetails({ provider, state: currentState, presentation, t })),
           React.createElement("span", { "aria-hidden": "true" }, busy ? "…" : "↻"))
         : ProviderIcon({ provider }))
     }
@@ -265,7 +354,7 @@ window.__ModuleLoader__.load({
       const style = document.createElement("style")
       style.dataset.dshDeepseekAccount = ""
       style.textContent = ".dsh-deepseek-account-card{display:grid;width:100%;min-height:48px;margin:3px 0;padding:4px 3px;border:0;border-radius:8px;grid-template-columns:22px minmax(0,1fr) 16px;align-items:center;gap:10px;color:inherit;background:transparent;cursor:pointer;font:inherit;text-align:left}.dsh-deepseek-account-card:hover,.dsh-deepseek-account-rail:hover{background:var(--dsw-alias-interactive-bg-hover)}.dsh-deepseek-account-symbol{font-weight:650;text-align:center}.dsh-deepseek-account-copy{display:flex;min-width:0;flex-direction:column}.dsh-deepseek-account-copy small{overflow:hidden;color:var(--dsw-alias-label-tertiary);font-size:11px;text-overflow:ellipsis;white-space:nowrap}.dsh-deepseek-account-rail{display:grid;width:36px;height:36px;margin:4px auto;border:0;border-radius:8px;place-items:center;color:inherit;background:transparent;cursor:pointer;font-size:10px;font-weight:650}.dsh-deepseek-account-page{box-sizing:border-box;width:min(860px,100%);padding:8px 4px 40px;color:var(--dsw-alias-label-primary)}.dsh-deepseek-account-page h2{margin:0}.dsh-deepseek-account-description{color:var(--dsw-alias-label-secondary)}.dsh-deepseek-account-panel{margin-top:14px;padding:18px;border:1px solid var(--dsw-alias-border-l2);border-radius:16px;background:var(--dsw-alias-bg-layer-1)}.dsh-deepseek-account-head{display:flex;align-items:center;justify-content:space-between;gap:12px}.dsh-deepseek-account-head h3{margin:0}.dsh-deepseek-account-head button,.dsh-deepseek-account-topup{min-height:34px;border:1px solid var(--dsw-alias-border-l2);border-radius:999px;padding:0 13px;color:inherit;background:transparent;font:inherit}.dsh-deepseek-account-balances{display:grid;margin-top:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:10px}.dsh-deepseek-account-balance{display:flex;flex-direction:column;gap:5px;padding:14px;border-radius:12px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-interactive-bg-hover))}.dsh-deepseek-account-balance strong{font-size:22px}.dsh-deepseek-account-balance span,.dsh-deepseek-account-panel p,.dsh-deepseek-account-panel small{color:var(--dsw-alias-label-secondary);font-size:12px}.dsh-deepseek-account-warning{color:var(--dsw-alias-state-warn-label)!important}.dsh-deepseek-account-topup{display:inline-flex;align-items:center;color:#fff;text-decoration:none;background:var(--dsw-alias-state-business-primary)}"
-      style.textContent += ".dsh-deepseek-account-provider-icon{display:block;width:18px;height:18px;margin:auto}.dsh-deepseek-account-copy{gap:2px}.dsh-deepseek-account-copy small{overflow:visible;line-height:1.35;overflow-wrap:anywhere;text-overflow:clip;white-space:normal}"
+      style.textContent += ".dsh-deepseek-account-provider-icon{display:block;width:18px;height:18px;margin:auto}.dsh-deepseek-account-copy{gap:2px}.dsh-deepseek-account-copy small{overflow:visible;line-height:1.35;overflow-wrap:anywhere;text-overflow:clip;white-space:normal}.dsh-deepseek-account-quota-windows{display:grid;gap:4px;margin-top:2px}.dsh-deepseek-account-quota-window{display:grid;min-width:0;padding:3px 5px;border-radius:5px;grid-template-columns:auto minmax(0,1fr);align-items:baseline;column-gap:6px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-interactive-bg-hover))}.dsh-deepseek-account-quota-period{font-size:11px;font-weight:650}.dsh-deepseek-account-quota-remaining{min-width:0;color:var(--dsw-alias-label-secondary);font-size:11px;font-weight:600}.dsh-deepseek-account-quota-reset{grid-column:1/-1;font-size:10px!important;line-height:1.25!important}"
       document.head.append(style)
       return () => style.remove()
     }
@@ -274,6 +363,7 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       ctx.effect(() => ctx.locale.register(namespace, dictionaries), "deepseek-account: dictionaries")
       ctx.effect(() => installStyle(), "deepseek-account: styles")
+      ctx.effect(() => installSettingsNavIcon(), "deepseek-account: settings navigation icon")
       const t = ctx.locale.bind(namespace)
       const client = createAccountClient(ctx.connection)
       ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
@@ -293,6 +383,8 @@ window.__ModuleLoader__.load({
     module.exports.safeCodexUsage = safeCodexUsage
     module.exports.safeGrokQuota = safeGrokQuota
     module.exports.safeSnapshot = safeSnapshot
+    module.exports.installSettingsNavIcon = installSettingsNavIcon
+    module.exports.subscribeCurrentConversationCompletion = subscribeCurrentConversationCompletion
     return module.exports
   },
 })

package/docs/ARCHITECTURE.md

@@ -18,6 +18,8 @@ browser account client ──> sidebar + DeepSeek settings
           │
           ├── optional /grok-auth RPC  ──> remaining % + current reset window
           └── optional /dsh-codex RPC  ──> remaining % + 5-hour/weekly reset windows
+
+current session list ── running true→false ──> one forced account refresh
 ```
 
 充值是独立路径：浏览器只打开固定的 `https://platform.deepseek.com/balance`。插件不参与该网页的登录、Cookie 或付款请求。
@@ -58,10 +60,16 @@ await balance.read({ force? })
 - 调用 DeepSeek、Grok 或 Codex 的本地 RPC；
 - 再次校验所有跨 RPC 数据；
 - 注册侧栏与设置页；
+- 监听当前会话的运行结束边沿，并刷新一次当前 Provider；
+- 在 Harness 尚未提供 settings section 图标接口时，只对中英文“DeepSeek 账户”导航行挂载可清理的鲸鱼图标；
 - 注册中英文文案和局部样式。
 
 客户端只依赖投影后的账户状态。`scripts/build.mjs` 会复制确定性产物，并拒绝包含 `DEEPSEEK_API_KEY`、credential resolution 或 Authorization header 特征的客户端文件。
 
+完成刷新只观察 `ctx.sessions.list` 已公开的 `current` 与 `running` 状态。同一会话仅在 `true → false` 时触发；初始空闲、重复空闲通知和切换到另一个空闲会话都不能触发。不要为此增加定时轮询或读取完整对话日志。
+
+设置导航图标 adapter 只匹配插件拥有的中英文 label，保留并隐藏 Harness 原图标，重复 DOM 通知不得重复挂载；插件卸载时必须断开观察并恢复原图标。Harness 将来提供正式 section 图标接口后，应删除这个临时 adapter。
+
 ### Optional Provider adapters
 
 Grok 的 `/grok-auth` 和 Codex 的 `/dsh-codex` 是外部、可选 seam。它们不是本插件拥有的接口，因此：

package/docs/releases/v0.1.5.md

@@ -0,0 +1,58 @@
+## 中文
+
+`0.1.5` 优化 Codex 额度可读性，在每轮对话结束后主动刷新当前 Provider，并让 DeepSeek 账户设置项使用对应的鲸鱼图标。
+
+### 主要变化
+
+- Codex 的 5 小时和每周额度改为两个紧凑信息块：窗口与剩余百分比位于主行，重置时间位于次级行。
+- 当前会话从运行变为空闲时，主动刷新一次当前 Provider；初始空闲、重复空闲通知和会话切换不会误触发，也不使用轮询。
+- 将“DeepSeek 账户”设置导航的通用齿轮替换为 DeepSeek 鲸鱼图标；重复渲染不会重复插入，插件卸载时恢复 Harness 原图标。
+
+### 兼容性与安全边界
+
+- 图标适配只匹配本插件拥有的中英文设置 label，不修改其他设置项。
+- 本版本不接入 DeepSeek 网页登录、用量分析或插件内充值，也不读取网页 Cookie、账户密码或支付数据。
+- Grok/Codex 仍是可选数据源，其登录、模型、设置与 RPC 行为不变。
+
+### 验证限制
+
+- 自动化测试覆盖配额分层渲染、Provider 图标、设置导航图标的挂载/去重/恢复，以及单次对话完成刷新。
+- 未执行真实 Grok/Codex 账户读取、真实 DeepSeek 余额请求、网页登录或付款；真实 Harness GUI 视觉验收仍需安装后确认。
+
+安装：
+
+```sh
+dsh plugin --profile web add dsh-deepseek-account@0.1.5
+dsh web
+```
+
+<details>
+<summary>English release notes</summary>
+
+`0.1.5` improves Codex quota readability, refreshes the current Provider after each completed conversation turn, and gives the DeepSeek account settings entry its matching whale icon.
+
+### Changes
+
+- Codex five-hour and weekly quotas render as compact blocks, with the window and remaining percentage on the primary row and reset time on a secondary row.
+- A current-session running-to-idle edge refreshes the selected Provider once. Initial idle state, duplicate idle notifications, and session switches do not trigger false refreshes; no polling is used.
+- The generic settings gear beside “DeepSeek account” is replaced with the DeepSeek whale icon. Re-renders do not duplicate it, and plugin cleanup restores the Harness icon.
+
+### Compatibility and security boundaries
+
+- The icon adapter matches only this plugin's Chinese and English settings labels and does not modify other entries.
+- This release does not add DeepSeek web login, usage analytics, or in-plugin payment, and it does not read web cookies, passwords, or payment data.
+- Grok and Codex remain optional data sources; their authentication, models, settings, and RPC behavior are unchanged.
+
+### Verification limits
+
+- Automated tests cover quota hierarchy, Provider icons, settings-icon mount/deduplication/restoration, and one refresh per completed conversation turn.
+- No live Grok/Codex quota read, DeepSeek balance request, web login, or payment was performed. Live Harness GUI visual acceptance remains pending installation.
+
+Install:
+
+```sh
+dsh plugin --profile web add dsh-deepseek-account@0.1.5
+dsh web
+```
+
+</details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deepseek-account",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "DeepSeek account balance and official top-up entry for DeepSeek Harness",
   "type": "module",
   "license": "MIT",