dsh-client-auto-continue 0.3.1 → 0.3.2

package/README.md

@@ -36,10 +36,10 @@ For [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh we
 
 **Smart recovery** (all configurable):
 
-- **Error classification** — transient failures (network / timeout / 5xx…) are auto-resumed; permanent ones (auth, balance, unknown model, context overflow) are **skipped** and notified, because retrying them never helps
-- **Adaptive backoff** — consecutive failures wait longer each time (e.g. 20s → 40s → 80s), instead of hammering a broken upstream
+- **Error classification** — transient failures (network / timeout / 5xx / 429…) are auto-resumed; permanent ones are **skipped** and notified, because retrying them never helps. A failure counts as permanent when its HTTP status is 401/403 or its code/message matches auth, credential/API-key, balance/quota, unknown-model, or context-length/overflow keywords. Turn classification off to resume everything
+- **Adaptive backoff** — consecutive failures wait longer each time (cooldown × factor: 20s → 40s → 80s…), capped at the max backoff, instead of hammering a broken upstream
 - **Templated continue text** — `continueText` supports `{code}` `{message}` `{status}` `{tool}` `{turn}` placeholders, so the resume message can carry the failure context ("继续 (git push failed: UPSTREAM)")
-- **Browser notifications** — optional alerts when auto-continue fires, gives up, or hits a permanent error
+- **Browser notifications** — optional alerts when auto-continue fires, gives up, or hits a permanent error; the browser asks for permission on first use, and nothing is shown again after a denial
 
 It watches the live event streams and reacts to:
 
@@ -60,6 +60,8 @@ The plugin opens two extra SSE streams in the browser — `events.mux` (session
 
 On page load / reconnect it also scans the most recently updated sessions: a session whose last turn ended with a non-human reason **within the scan window** (default 15 minutes), with no later `turn/start` or user message, gets resumed automatically too (e.g. the host crashed while the browser was closed).
 
+With the page open in several tabs, a localStorage mutex plus a shared per-session cooldown stamp guarantee exactly one tab sends — no duplicated 「继续」.
+
 All knobs live in the plugin's settings card — see [Configuration](#configuration).
 
 ---
@@ -142,7 +144,16 @@ dsh web
 
 ## Configuration
 
-Everything is configurable from the GUI — no file or console edits needed. Open **Settings → Plugin configuration** and find the **Auto continue** card. Changes are staged and written on **Save**, apply immediately, and persist in `~/.dsh/settings.yaml`.
+Everything is configurable from the GUI — no file or console edits needed. Open **Settings → Plugin configuration** and find the **Auto continue** card.
+
+**How the card works:**
+
+- Edits are **staged** — nothing reaches the disk until you hit **Save**; an unsaved badge marks the card while drafts are pending, and **Discard** drops them
+- A field you changed shows an **Overridden** badge with a per-field **Reset to default** button that restores the built-in value
+- Boolean fields are **tri-state**: *Inherit* (use the default) / *On* / *Off*
+- Invalid drafts (non-numbers, values below the minimum) block the save with a hint
+- In a read-only deployment the card shows the stored values but disables every control
+- Changes apply immediately after Save and persist in `~/.dsh/settings.yaml` (uninstalling the plugin leaves the section behind — harmless, delete it by hand if you like)
 
 | Field | Default | Description |
 | --- | --- | --- |
@@ -165,6 +176,17 @@ Everything is configurable from the GUI — no file or console edits needed. Ope
 
 ---
 
+## Privacy & permissions
+
+The plugin is browser-only and touches **no files, credentials, or network beyond the dsh host**:
+
+- It opens the same two read-only event streams the web UI already uses (no extra server, no third-party endpoints)
+- The only write it ever performs is `sessions.prompt` — the same call the Send button makes — with the text you configured
+- Browser storage is limited to small `localStorage` keys for cross-tab coordination
+- Browser notifications are opt-in (`notify` setting) and permission is requested on first use only
+
+---
+
 ## Development
 
 ```bash

package/README.zh.md

@@ -36,10 +36,10 @@
 
 **智能恢复**(全部可配置):
 
-- **错误分类** — 临时性错误(网络 / 超时 / 5xx 等)自动续跑; 永久性错误(认证、余额不足、模型不存在、上下文超限)跳过并通知, 因为重试也没用
-- **自适应退避** — 连续失败时等待时间递增(如 20s → 40s → 80s), 不再对故障上游狂轰滥炸
+- **错误分类** — 临时性错误(网络 / 超时 / 5xx / 429 等)自动续跑; 永久性错误跳过并通知, 因为重试也没用。判定为永久性的条件: HTTP 状态码 401/403, 或 code/message 命中认证、凭据/API Key、余额/配额、模型不存在、上下文长度/超限等关键词。关闭分类后则全部自动继续
+- **自适应退避** — 连续失败时等待时间递增(冷却 × 系数: 20s → 40s → 80s…), 有上限, 不再对故障上游狂轰滥炸
 - **模板化继续文本** — `continueText` 支持 `{code}` `{message}` `{status}` `{tool}` `{turn}` 占位符, 续跑消息可携带失败上下文(如「继续 (git push 失败: UPSTREAM)」)
-- **浏览器通知** — 可选: 自动继续成功 / 放弃 / 遇到永久性错误时弹出提醒
+- **浏览器通知** — 可选: 自动继续成功 / 放弃 / 遇到永久性错误时弹出提醒; 首次使用时请求权限, 被拒绝后不再打扰
 
 插件监听实时事件流, 对以下情况作出反应:
 
@@ -60,6 +60,8 @@
 
 页面启动 / 重连时, 插件还会扫描最近更新的会话: 若某个会话的最后一个回合在**扫描时间窗**(默认 15 分钟)内以非人为原因结束, 且之后没有新的 `turn/start` 或用户消息, 也会被自动续跑(例如浏览器关闭期间宿主崩溃的情况)。
 
+多个标签页同时打开时, 通过 localStorage 互斥锁 + 共享的每会话冷却记录保证**只有一个标签页发送**——不会重复出现两条「继续」。
+
 所有参数都在插件的设置卡片中调整——见 [配置](#配置)。
 
 ---
@@ -139,7 +141,16 @@ dsh web
 
 ## 配置
 
-所有参数都可以在 GUI 里配置——无需改文件或控制台。打开 **设置 → 插件配置**, 找到 **自动继续** 卡片。修改后点 **保存** 生效, 立即应用, 并持久化到 `~/.dsh/settings.yaml`。
+所有参数都可以在 GUI 里配置——无需改文件或控制台。打开 **设置 → 插件配置**, 找到 **自动继续** 卡片。
+
+**卡片操作说明:**
+
+- 修改是**暂存式**的——点「保存」之前不会写入磁盘; 有待保存草稿时卡片显示「未保存」徽章, 「放弃」可丢弃草稿
+- 改动过的字段会带「已覆盖」徽章, 并有逐字段的「恢复默认」按钮(回到内置默认值)
+- 布尔字段是三态:**继承**(用默认)/ 开 / 关
+- 非法输入(非数字、小于最小值)会阻止保存并给出提示
+- 只读部署中卡片只显示已存值, 所有控件禁用
+- 保存后立即生效, 持久化在 `~/.dsh/settings.yaml`(卸载插件会留下该段落, 无害, 想清理可手动删除)
 
 | 字段 | 默认 | 说明 |
 | --- | --- | --- |
@@ -162,6 +173,17 @@ dsh web
 
 ---
 
+## 隐私与权限
+
+插件是纯浏览器端, **不触碰任何文件、凭据, 也不访问 dsh 宿主以外的网络**:
+
+- 只复用 webui 本身就在用的两条只读事件流(无额外服务、无第三方端点)
+- 唯一会执行的写入是 `sessions.prompt`——与点「发送」按钮完全相同的调用, 内容为你配置的文本
+- 浏览器存储仅限于少量 `localStorage` 键(跨标签页协调用)
+- 浏览器通知是可选开启的(`notify` 设置), 仅在首次使用时请求一次权限
+
+---
+
 ## 开发
 
 ```bash

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-client-auto-continue",
   "description": "DSH Web UI plugin: automatically sends \"继续\" (continue) when a request is interrupted by network errors or other non-human causes",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",