dsh-client-auto-continue 0.9.0 → 0.10.1

package/src/host/engine.ts

@@ -34,6 +34,7 @@ import {
   todayKey,
   toolResultFacts,
   type AutoContinueConfig,
+  type AutoContinueLocale,
   type DayStats,
   type FailureFacts,
   type SessionState,
@@ -42,6 +43,35 @@ import {
   type TemplateContext,
 } from '../shared/core.ts';
 
+const NOTICE_COPY = {
+  zh: {
+    notContinuedTitle: 'dsh-auto-continue: 未自动继续',
+    permanentErrorBody: (sessionId: SessionId, summary: string) =>
+      `${sessionId}: 永久性错误 ${summary}，需要人工处理`,
+    resumeAction: '立即续跑',
+    pauseAction: '暂停该会话 1 小时',
+    continuedTitle: 'dsh-auto-continue: 已自动继续',
+    continuedBody: (sessionId: SessionId, text: string, count: number) =>
+      `${sessionId}: 已发送「${text}」(第 ${count} 次连续)`,
+    stoppedTitle: 'dsh-auto-continue: 已停止自动继续',
+    stoppedBody: (sessionId: SessionId, count: number) =>
+      `${sessionId}: 连续失败 ${count} 次, 需要人工介入`,
+  },
+  en: {
+    notContinuedTitle: 'dsh-auto-continue: Not continued',
+    permanentErrorBody: (sessionId: SessionId, summary: string) =>
+      `${sessionId}: Permanent error ${summary}; manual intervention required`,
+    resumeAction: 'Resume now',
+    pauseAction: 'Pause this session for 1 hour',
+    continuedTitle: 'dsh-auto-continue: Continued automatically',
+    continuedBody: (sessionId: SessionId, text: string, count: number) =>
+      `${sessionId}: Sent "${text}" (consecutive attempt ${count})`,
+    stoppedTitle: 'dsh-auto-continue: Auto-continue stopped',
+    stoppedBody: (sessionId: SessionId, count: number) =>
+      `${sessionId}: ${count} consecutive failures; manual intervention required`,
+  },
+} as const satisfies Record<AutoContinueLocale, Record<string, unknown>>;
+
 /** 通知桥事件: host 引擎产生, browser 侧订阅展示(Notification / 动作按钮)。 */
 export interface HostNotice {
   /** 稳定标识(供 browser 去重)。 */
@@ -113,6 +143,7 @@ export class AutoContinueRunner {
   private readonly notices: HostNotice[] = [];
   private readonly noticeListeners = new Set<() => void>();
   private readonly stateListeners = new Set<() => void>();
+  private readonly disposeSessionEvents: () => void;
   private disposed = false;
 
   /**
@@ -124,7 +155,9 @@ export class AutoContinueRunner {
     private readonly getConfig: () => AutoContinueConfig,
   ) {
     // 单实例事件源: 宿主进程内的会话事件 firehose, 天然覆盖所有会话。
-    ctx.on('session/event', (session, event) => this.onHostEvent(session, event));
+    this.disposeSessionEvents = ctx.on('session/event', (session, event) =>
+      this.onHostEvent(session, event),
+    );
     const config = this.getConfig();
     if (config.scanOnBoot) {
       void this.bootScanLoop();
@@ -196,7 +229,9 @@ export class AutoContinueRunner {
   }
 
   dispose(): void {
+    if (this.disposed) return;
     this.disposed = true;
+    this.disposeSessionEvents();
     for (const state of this.states.values()) {
       if (state.pendingTimer !== undefined) clearTimeout(state.pendingTimer);
       if (state.loopRetryTimer !== undefined) clearTimeout(state.loopRetryTimer);
@@ -404,7 +439,11 @@ export class AutoContinueRunner {
               if (state.loopRetryTimer !== undefined) clearTimeout(state.loopRetryTimer);
               state.loopRetryTimer = setTimeout(() => {
                 state.loopRetryTimer = undefined;
-                this.schedule(sessionId, 'loop:aborted');
+                try {
+                  this.schedule(sessionId, 'loop:aborted');
+                } catch (error) {
+                  console.error(`[auto-continue] loop 重启异常 ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+                }
               }, remaining);
               this.log(`loop 重启延迟 ${remaining}ms(冷却期) ${sessionId}`);
             } else {
@@ -460,14 +499,15 @@ export class AutoContinueRunner {
   private onTurnFailure(sessionId: SessionId, reason: string, failure: FailureFacts): void {
     const config = this.getConfig();
     if (config.classify && !isTransientFailure(failure, config.retryableErrorPatterns)) {
+      const copy = NOTICE_COPY[config.locale];
       const summary = `${failure.code}${failure.status !== undefined ? ` (HTTP ${failure.status})` : ''}`;
       this.log(`跳过 ${sessionId}(${reason}): 永久性失败 ${summary} — ${failure.message}`);
       this.bumpStat({ skipped: 1, code: failure.code });
       if (config.notify) {
         this.notify(
-          'dsh-auto-continue: 未自动继续',
-          `${sessionId}: 永久性错误 ${summary}，需要人工处理`,
-          this.notifyOptions(sessionId),
+          copy.notContinuedTitle,
+          copy.permanentErrorBody(sessionId, summary),
+          this.notifyOptions(sessionId, config.locale),
         );
       }
       return;
@@ -476,11 +516,12 @@ export class AutoContinueRunner {
   }
 
   /** 通知操作按钮与回调(「立即续跑」/「暂停该会话 1 小时」)。 */
-  private notifyOptions(sessionId: SessionId): NotifyOptions {
+  private notifyOptions(sessionId: SessionId, locale: AutoContinueLocale): NotifyOptions {
+    const copy = NOTICE_COPY[locale];
     return {
       actions: [
-        { action: 'resume', title: '立即续跑' },
-        { action: 'pause1h', title: '暂停该会话 1 小时' },
+        { action: 'resume', title: copy.resumeAction },
+        { action: 'pause1h', title: copy.pauseAction },
       ],
       onAction: (action) => this.onNotifyAction(sessionId, action),
     };
@@ -559,7 +600,11 @@ export class AutoContinueRunner {
       clearTimeout(state.pendingTimer);
       state.pendingTimer = undefined;
     }
-    await this.fire(sessionId, 'manual:notification', true);
+    try {
+      await this.fire(sessionId, 'manual:notification', true);
+    } catch (error) {
+      console.error(`[auto-continue] 手动续跑异常 ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+    }
   }
 
   /** 本会话当前生效的冷却间隔(自适应退避)。 */
@@ -596,7 +641,12 @@ export class AutoContinueRunner {
     const timer = setTimeout(() => {
       if (state.pendingTimer !== timer) return;
       state.pendingTimer = undefined;
-      void this.fire(sessionId, reason);
+      // 保险丝: 定时器回调内任何异常(含 inactive context)都不得成为未捕获异常炸掉进程。
+      try {
+        void this.fire(sessionId, reason);
+      } catch (error) {
+        console.error(`[auto-continue] 定时发送异常 ${sessionId}: ${error instanceof Error ? error.message : String(error)}`);
+      }
     }, config.graceMs);
     state.pendingTimer = timer;
     const template = reason.startsWith('loop:')
@@ -668,20 +718,22 @@ export class AutoContinueRunner {
       this.bumpStat({ sent: 1, ...(state.lastFailure !== undefined ? { code: state.lastFailure.code } : {}) });
       this.log(`已自动发送「${text}」到 ${sessionId}(${reason}), 第 ${state.consecutive} 次连续`);
       if (config.notify) {
+        const copy = NOTICE_COPY[config.locale];
         this.notify(
-          'dsh-auto-continue: 已自动继续',
-          `${sessionId}: 已发送「${text}」(第 ${state.consecutive} 次连续)`,
-          this.notifyOptions(sessionId),
+          copy.continuedTitle,
+          copy.continuedBody(sessionId, text, state.consecutive),
+          this.notifyOptions(sessionId, config.locale),
         );
       }
       if (state.consecutive >= config.maxConsecutive) {
         this.bumpStat({ gaveUp: 1 });
         this.log(`达到连续上限 ${config.maxConsecutive} 次, 停止自动继续 ${sessionId}`);
         if (config.notify) {
+          const copy = NOTICE_COPY[config.locale];
           this.notify(
-            'dsh-auto-continue: 已停止自动继续',
-            `${sessionId}: 连续失败 ${state.consecutive} 次, 需要人工介入`,
-            this.notifyOptions(sessionId),
+            copy.stoppedTitle,
+            copy.stoppedBody(sessionId, state.consecutive),
+            this.notifyOptions(sessionId, config.locale),
           );
         }
       }

package/src/index.ts

@@ -24,22 +24,24 @@ import type {} from '@deepseek-ai/dsh-session';
 /** Settings namespace of the auto-continue plugin (lowercase kebab-case). */
 export const AUTO_CONTINUE_NS = 'auto-continue';
 
-/** Wire schema of the auto-continue section; defaults are the plugin's built-in values. */
+/** Wire schema; blank localized text fields tell resolveConfig() to select the active locale's defaults. */
 export const AutoContinueSchema = z.object({
+  /** Active browser/UI locale mirrored by the client. */
+  locale: z.string().default('zh'),
   /** Text automatically sent after an interruption. */
-  continueText: z.string().default('继续'),
+  continueText: z.string().default(''),
   /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
-  continueTextMaxTokens: z.string().default('继续'),
+  continueTextMaxTokens: z.string().default(''),
   /** Idempotency guard: inspect the last tool call before resuming and steer the model. */
   guardTools: z.boolean().default(true),
   /** Guard text appended when the last tool call has no confirmed result (it may have partially executed). */
   guardPendingText: z
     .string()
-    .default('(上一步工具「{tool}」可能未完成, 先确认状态再继续, 不要重复执行)'),
+    .default(''),
   /** Guard text appended when the last tool call completed successfully (don't rerun it). */
   guardDoneText: z
     .string()
-    .default('(上一步工具「{tool}」已完成, 结果: {result}; 不要重复执行, 直接继续)'),
+    .default(''),
   /** Grace period after an interruption before auto-sending (ms). */
   graceMs: z.natural().default(3000),
   /** Minimum interval between two auto-continues per session (ms). */
@@ -81,7 +83,7 @@ export const AutoContinueSchema = z.object({
   /** Text sent after the loop guard cancels and restarts a turn (supports {tool}). */
   loopText: z
     .string()
-    .default('(检测到你可能陷入循环, 请停止重复刚才的动作, 换一种方式继续)'),
+    .default(''),
 });
 
 /**
@@ -96,11 +98,19 @@ export function apply(ctx: Context): void {
     });
   });
 
+  // 引擎引用: inject 回调可能重入(依赖组合变化), 顶层 effect 在 fiber 卸载时必跑。
+  // dispose 绑定必须挂在 apply 的顶层 ctx 上——挂 inject 派生 ctx 的 effect 在 config HMR
+  // 替换行时不会执行, 悬空定时器会撞上 inactive context 炸掉整个进程。
+  let runnerRef: AutoContinueRunner | undefined;
+
   // 单实例引擎: host 进程内监听会话事件, 所有标签页共享同一个引擎。
   ctx.inject(['settings', 'agents', 'webServer'], (engineCtx) => {
+    // 回调重入时先清理旧引擎, 避免定时器与监听器叠加。
+    if (runnerRef !== undefined) runnerRef.dispose();
     const runner = new AutoContinueRunner(engineCtx, () =>
       resolveConfig(engineCtx.settings.get(settingsNamespace(AUTO_CONTINUE_NS)) as AutoContinueSettings | undefined),
     );
+    runnerRef = runner;
 
     // 状态桥: browser 侧订阅通知与运行时状态(SSE)。
     const sseClients = new Set<(data: string) => void>();
@@ -176,4 +186,12 @@ export function apply(ctx: Context): void {
       },
     });
   });
+
+  // 顶层生命周期绑定: fiber 卸载时清理引擎(定时器/监听器)。
+  // 挂在 apply 的 ctx 上保证 Cordis 一定会调用, 防止 inactive context 崩溃。
+  ctx.effect(() => () => {
+    const runner = runnerRef;
+    runnerRef = undefined;
+    if (runner !== undefined) runner.dispose();
+  });
 }

package/src/shared/core.ts

@@ -6,8 +6,34 @@
  */
 import type { SessionEvent, SessionId } from '@deepseek-ai/dsh-session/types';
 
+/** Supported UI/config locales. Any unknown browser locale falls back to Chinese. */
+export type AutoContinueLocale = 'en' | 'zh';
+
+/** Locale-owned defaults for the user-editable text fields. */
+export const LOCALIZED_TEXT_DEFAULTS = {
+  zh: {
+    continueText: '继续',
+    continueTextMaxTokens: '继续',
+    guardPendingText: '(上一步工具「{tool}」可能未完成, 先确认状态再继续, 不要重复执行)',
+    guardDoneText: '(上一步工具「{tool}」已完成, 结果: {result}; 不要重复执行, 直接继续)',
+    loopText: '(检测到你可能陷入循环, 请停止重复刚才的动作, 换一种方式继续)',
+  },
+  en: {
+    continueText: 'Continue',
+    continueTextMaxTokens: 'Continue',
+    guardPendingText:
+      '(The previous tool "{tool}" may not have completed. Check its state before continuing and do not run it again.)',
+    guardDoneText:
+      '(The previous tool "{tool}" completed successfully. Result: {result}; do not run it again. Continue from there.)',
+    loopText:
+      '(You may be stuck in a loop. Stop repeating the last action and continue with a different approach.)',
+  },
+} as const satisfies Record<AutoContinueLocale, Record<string, string>>;
+
 /** The `auto-continue` settings section (all fields optional on the wire; the host schema carries defaults). */
 export interface AutoContinueSettings {
+  /** Active browser/UI locale mirrored by the client. */
+  locale?: AutoContinueLocale;
   /** Text automatically sent after an interruption. */
   continueText?: string;
   /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
@@ -63,13 +89,11 @@ export interface AutoContinueSettings {
 /** Fully resolved configuration (built-in defaults + user overrides). */
 export type AutoContinueConfig = Required<AutoContinueSettings>;
 
-/** Built-in defaults — must match the host schema defaults in src/index.ts. */
+/** Effective built-in defaults; localized text fields use Chinese until a browser locale is mirrored. */
 export const DEFAULT_CONFIG: AutoContinueConfig = {
-  continueText: '继续',
-  continueTextMaxTokens: '继续',
+  locale: 'zh',
+  ...LOCALIZED_TEXT_DEFAULTS.zh,
   guardTools: true,
-  guardPendingText: '(上一步工具「{tool}」可能未完成, 先确认状态再继续, 不要重复执行)',
-  guardDoneText: '(上一步工具「{tool}」已完成, 结果: {result}; 不要重复执行, 直接继续)',
   graceMs: 3000,
   cooldownMs: 20000,
   maxConsecutive: 3,
@@ -89,7 +113,6 @@ export const DEFAULT_CONFIG: AutoContinueConfig = {
   loopShortCount: 12,
   loopRepeatText: 4,
   loopToolRepeat: 5,
-  loopText: '(检测到你可能陷入循环, 请停止重复刚才的动作, 换一种方式继续)',
 };
 
 function numberOr(value: unknown, fallback: number): number {
@@ -103,23 +126,26 @@ function booleanOr(value: unknown, fallback: boolean): boolean {
 /** Resolve a (possibly partial / not-yet-loaded) settings section to a full config. */
 export function resolveConfig(section: AutoContinueSettings | undefined): AutoContinueConfig {
   const value = section ?? {};
+  const locale: AutoContinueLocale = value.locale === 'en' ? 'en' : 'zh';
+  const localized = LOCALIZED_TEXT_DEFAULTS[locale];
   const text =
     typeof value.continueText === 'string' && value.continueText.trim() !== ''
       ? value.continueText
-      : DEFAULT_CONFIG.continueText;
+      : localized.continueText;
   const maxTokensText =
     typeof value.continueTextMaxTokens === 'string' && value.continueTextMaxTokens.trim() !== ''
       ? value.continueTextMaxTokens
-      : DEFAULT_CONFIG.continueTextMaxTokens;
+      : localized.continueTextMaxTokens;
   const guardPendingText =
     typeof value.guardPendingText === 'string' && value.guardPendingText.trim() !== ''
       ? value.guardPendingText
-      : DEFAULT_CONFIG.guardPendingText;
+      : localized.guardPendingText;
   const guardDoneText =
     typeof value.guardDoneText === 'string' && value.guardDoneText.trim() !== ''
       ? value.guardDoneText
-      : DEFAULT_CONFIG.guardDoneText;
+      : localized.guardDoneText;
   return {
+    locale,
     continueText: text,
     continueTextMaxTokens: maxTokensText,
     guardTools: booleanOr(value.guardTools, DEFAULT_CONFIG.guardTools),
@@ -150,7 +176,7 @@ export function resolveConfig(section: AutoContinueSettings | undefined): AutoCo
     loopText:
       typeof value.loopText === 'string' && value.loopText.trim() !== ''
         ? value.loopText
-        : DEFAULT_CONFIG.loopText,
+        : localized.loopText,
   };
 }