dsh-session-autarchive 0.1.3 → 0.1.5

package/README.en.md

@@ -29,7 +29,7 @@ dsh plugin --profile desktop add github:taoziliyouchong/dsh-session-autarchive
 
 Restart DSH afterwards. Replace `desktop` with your own profile name if you use another one.
 
-Compatible with the DSH 0.2.1 line (alpha / rc / stable); 0.3 and later are not guaranteed.
+Requires DSH >= 0.2.1-alpha.3; verified on 0.2.1-alpha.3 and 0.2.2-rc.1, later versions untested.
 
 Once published to npm, this also works:
 

package/README.md

@@ -29,7 +29,7 @@ dsh plugin --profile desktop add github:taoziliyouchong/dsh-session-autarchive
 
 装完重启 DSH。用别的 profile 就把 `desktop` 换成你的 profile 名。
 
-兼容：DSH 0.2.1 系列（alpha / rc / 正式版均可）；0.3 起不保证。
+要求 DSH >= 0.2.1-alpha.3；实测 0.2.1-alpha.3、0.2.2-rc.1，更高版本未验证。
 
 发布到 npm 之后也可以：
 

package/index.js

@@ -549,87 +549,99 @@ function registerRoutes(ctx) {
 
 /** 注册工具与路由。 */
 export function apply(ctx) {
-  ctx.tools.register({
-    name: 'dsh-session-autarchive',
-    description: '超期会话自动归档的开关台：status 看配置、保护名单与当前候选；run 立刻归档候选；protect/unprotect 标记单个会话「不自动归档」；config 改阈值与开关。判定口径＝会话内最后一条对话结束事件（turn/end）的时间——只是被打开/恢复过（会追写开场提示）不算活动；读不到事件时退回文件最后写入时间。已归档、保护名单内、置顶（可关）都跳过。浏览器半边每 5 分钟按同一份清单自动执行，侧栏右键菜单的「不自动归档」也写这份名单。',
-    parameters: {
-      type: 'object',
-      properties: {
-        action: { type: 'string', description: '要做什么：status（默认，看状态）｜run（立刻归档候选）｜protect（标记不自动归档）｜unprotect（取消标记）｜config（改阈值/开关）' },
-        sessionId: { type: 'string', description: 'protect/unprotect 用：会话 id，形如 session-xxxxxxxx-…' },
-        dryRun: { type: 'boolean', description: 'run 用：true 时只列候选、不动手' },
-        days: { type: 'number', description: 'config 用：多少天没动就归档，默认 5' },
-        enabled: { type: 'boolean', description: 'config 用：是否启用自动归档' },
-        exemptPinned: { type: 'boolean', description: 'config 用：置顶会话是否也豁免（默认豁免）' },
-      },
-      required: [],
-      additionalProperties: false,
-    },
-    output: {
-      schema: {
+  // 工具注册失败（重名、DSH 升级后格式漂移）不该拖垮路由与兜底定时：
+  // 单独圈起来，失败只留一行警告，归档主功能照常。
+  try {
+    ctx.tools.register({
+      name: 'dsh-session-autarchive',
+      description: '超期会话自动归档的开关台：status 看配置、保护名单与当前候选；run 立刻归档候选；protect/unprotect 标记单个会话「不自动归档」；config 改阈值与开关。判定口径＝会话内最后一条对话结束事件（turn/end）的时间——只是被打开/恢复过（会追写开场提示）不算活动；读不到事件时退回文件最后写入时间。已归档、保护名单内、置顶（可关）都跳过。浏览器半边每 5 分钟按同一份清单自动执行，侧栏右键菜单的「不自动归档」也写这份名单。',
+      parameters: {
         type: 'object',
-        properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
-        required: ['ok', 'text'],
+        properties: {
+          action: { type: 'string', description: '要做什么：status（默认，看状态）｜run（立刻归档候选）｜protect（标记不自动归档）｜unprotect（取消标记）｜config（改阈值/开关）' },
+          sessionId: { type: 'string', description: 'protect/unprotect 用：会话 id，形如 session-xxxxxxxx-…' },
+          dryRun: { type: 'boolean', description: 'run 用：true 时只列候选、不动手' },
+          days: { type: 'number', description: 'config 用：多少天没动就归档，默认 5' },
+          enabled: { type: 'boolean', description: 'config 用：是否启用自动归档' },
+          exemptPinned: { type: 'boolean', description: 'config 用：置顶会话是否也豁免（默认豁免）' },
+        },
+        required: [],
         additionalProperties: false,
       },
-      render: (_args, value) => [{ type: 'text', text: value.text }],
-    },
-    async execute(args) {
-      const action = String((args && args.action) || 'status')
-      let state = readState()
-
-      if (action === 'status') {
-        return { ok: true, text: statusText(ctx, state) }
-      }
-
-      if (action === 'run') {
-        const result = await runArchive(ctx, state, args && args.dryRun === true)
-        const head = args && args.dryRun === true
-          ? '干跑：候选 ' + result.candidates.length + ' 个，未动手'
-          : '已归档 ' + result.archived.length + ' 个' + (result.failed.length > 0 ? '，失败 ' + result.failed.length + ' 个' : '')
-        const lines = [head]
-        for (const id of result.archived) lines.push('  ✓ ' + id.slice(8, 16))
-        for (const line of result.failed) lines.push('  ✗ ' + line)
-        if (args && args.dryRun === true) {
-          for (const c of result.candidates) lines.push('  · ' + c.id.slice(8, 16) + '  最后对话 ' + stamp(c.last))
+      output: {
+        schema: {
+          type: 'object',
+          properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
+          required: ['ok', 'text'],
+          additionalProperties: false,
+        },
+        render: (_args, value) => [{ type: 'text', text: value.text }],
+      },
+      async execute(args) {
+        const action = String((args && args.action) || 'status')
+        let state = readState()
+  
+        if (action === 'status') {
+          return { ok: true, text: statusText(ctx, state) }
         }
-        return { ok: true, text: lines.join('\n') }
-      }
-
-      if (action === 'protect' || action === 'unprotect') {
-        const sessionId = String((args && args.sessionId) || '')
-        if (!/^session-/.test(sessionId)) return { ok: false, text: 'protect/unprotect 需要 sessionId（形如 session-xxxxxxxx-…）' }
-        const keep = new Set(state.protected)
-        if (action === 'protect') keep.add(sessionId)
-        else keep.delete(sessionId)
-        state = { ...state, protected: [...keep] }
-        writeProtected(state.protected)
-        audit((action === 'protect' ? 'protect ' : 'unprotect ') + sessionId + '，名单现有 ' + state.protected.length + ' 个')
-        return {
-          ok: true,
-          text: (action === 'protect' ? '已标记不自动归档：' : '已取消标记：') + sessionId
-            + '\n保护名单现有 ' + state.protected.length + ' 个',
+  
+        if (action === 'run') {
+          const result = await runArchive(ctx, state, args && args.dryRun === true)
+          const head = args && args.dryRun === true
+            ? '干跑：候选 ' + result.candidates.length + ' 个，未动手'
+            : '已归档 ' + result.archived.length + ' 个' + (result.failed.length > 0 ? '，失败 ' + result.failed.length + ' 个' : '')
+          const lines = [head]
+          for (const id of result.archived) lines.push('  ✓ ' + id.slice(8, 16))
+          for (const line of result.failed) lines.push('  ✗ ' + line)
+          if (args && args.dryRun === true) {
+            for (const c of result.candidates) lines.push('  · ' + c.id.slice(8, 16) + '  最后对话 ' + stamp(c.last))
+          }
+          return { ok: true, text: lines.join('\n') }
         }
-      }
-
-      if (action === 'config') {
-        const next = { ...state }
-        if (args.days !== undefined) next.days = Number(args.days) > 0 ? Number(args.days) : next.days
-        if (args.enabled !== undefined) next.enabled = args.enabled === true
-        if (args.exemptPinned !== undefined) next.exemptPinned = args.exemptPinned === true
-        writeState(next)
-        return { ok: true, text: '已更新：' + describe(next) }
-      }
-
-      return { ok: false, text: '不认识的 action：' + action + '（可用 status／run／protect／unprotect／config）' }
-    },
-  })
+  
+        if (action === 'protect' || action === 'unprotect') {
+          const sessionId = String((args && args.sessionId) || '')
+          if (!/^session-/.test(sessionId)) return { ok: false, text: 'protect/unprotect 需要 sessionId（形如 session-xxxxxxxx-…）' }
+          const keep = new Set(state.protected)
+          if (action === 'protect') keep.add(sessionId)
+          else keep.delete(sessionId)
+          state = { ...state, protected: [...keep] }
+          writeProtected(state.protected)
+          audit((action === 'protect' ? 'protect ' : 'unprotect ') + sessionId + '，名单现有 ' + state.protected.length + ' 个')
+          return {
+            ok: true,
+            text: (action === 'protect' ? '已标记不自动归档：' : '已取消标记：') + sessionId
+              + '\n保护名单现有 ' + state.protected.length + ' 个',
+          }
+        }
+  
+        if (action === 'config') {
+          const next = { ...state }
+          if (args.days !== undefined) next.days = Number(args.days) > 0 ? Number(args.days) : next.days
+          if (args.enabled !== undefined) next.enabled = args.enabled === true
+          if (args.exemptPinned !== undefined) next.exemptPinned = args.exemptPinned === true
+          writeState(next)
+          return { ok: true, text: '已更新：' + describe(next) }
+        }
+  
+        return { ok: false, text: '不认识的 action：' + action + '（可用 status／run／protect／unprotect／config）' }
+      },
+    })
+  } catch (error) {
+    console.warn('[dsh-session-autarchive] 工具未注册：' + (error && error.message ? error.message : error))
+  }
 
   registerRoutes(ctx)
 
   // 宿主侧兜底：浏览器窗口没开着也照常归档（客户端那条是让侧栏当场刷新的快通道）。
   // 启动 60 秒后第一次（避开启动竞争），之后每 10 分钟。
-  const tick = () => { void runArchive(ctx, readState(), false).catch(() => { /* 这轮不行，下一轮再来 */ }) }
+  // 开关每次现读：关掉自动归档后这条定时链要立刻停，不能等重启。
+  // 手动执行（工具／路由的 run）不在这里拦，那是用户主动点的，开关只管自动。
+  const tick = () => {
+    const state = readState()
+    if (!state.enabled) return
+    void runArchive(ctx, state, false).catch(() => { /* 这轮不行，下一轮再来 */ })
+  }
   const first = setTimeout(tick, 60 * 1000)
   const timer = setInterval(tick, 10 * 60 * 1000)
   if (typeof ctx.effect === 'function') {

package/lib/client.js

@@ -26,6 +26,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var entry_exports = {};
 __export(entry_exports, {
   AutoArchiveRow: () => AutoArchiveRow,
+  AutoArchiveToggleRow: () => AutoArchiveToggleRow,
   ProtectHover: () => ProtectHover,
   ProtectLeading: () => ProtectLeading,
   ProtectMenuItem: () => ProtectMenuItem,
@@ -223,6 +224,70 @@ var ROW_CSS = `
 .zsa-unit { font-size:12px; color:var(--dsw-alias-label-secondary); }
 .zsa-error { font-size:12px; line-height:18px; color:var(--dsw-alias-state-error-primary); }
 `;
+function Switch({ on, disabled, onChange }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "button",
+    {
+      type: "button",
+      role: "switch",
+      "aria-checked": on,
+      "aria-label": on ? "\u5173\u95ED\u81EA\u52A8\u5F52\u6863" : "\u5F00\u542F\u81EA\u52A8\u5F52\u6863",
+      disabled,
+      onClick: () => onChange(!on),
+      style: {
+        width: 36,
+        height: 20,
+        flex: "none",
+        border: 0,
+        borderRadius: 10,
+        padding: 0,
+        cursor: disabled ? "default" : "pointer",
+        position: "relative",
+        background: on ? "var(--dsw-alias-brand-primary)" : "var(--dsw-alias-border-l1)",
+        opacity: disabled ? 0.5 : 1,
+        transition: "background .15s"
+      },
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: {
+        position: "absolute",
+        top: 2,
+        left: on ? 18 : 2,
+        width: 16,
+        height: 16,
+        borderRadius: 8,
+        background: "#fff",
+        transition: "left .15s"
+      } })
+    }
+  );
+}
+function AutoArchiveToggleRow() {
+  const state = useStore();
+  const [busy, setBusy] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const on = state.enabled !== false;
+  const toggle = async (next) => {
+    if (busy) return;
+    setBusy(true);
+    setError(null);
+    try {
+      const data = await call("POST", ROUTE + "/config", { enabled: next });
+      patchStore({ enabled: data.enabled !== false });
+    } catch (err) {
+      setError("\u6CA1\u4FDD\u5B58\u4E0A\uFF1A" + String(err && err.message || err));
+    } finally {
+      setBusy(false);
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "zsa-item", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("style", { children: ROW_CSS }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "zsa-text", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "zsa-title", children: "\u81EA\u52A8\u5F52\u6863" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "zsa-desc", children: "\u5173\u95ED\u540E\u540E\u53F0\u4E0D\u518D\u81EA\u52A8\u5F52\u6863\uFF1B\u624B\u52A8\u6267\u884C\u4ECD\u7136\u53EF\u7528\u3002\u5F53\u524D\u5019\u9009 " + state.candidates.length + " \u4E2A\u3002" }),
+      error ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "zsa-error", role: "alert", children: error }) : null
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "zsa-field", children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Switch, { on, disabled: busy, onChange: (next) => void toggle(next) }) })
+  ] });
+}
 function AutoArchiveRow() {
   const state = useStore();
   const [draft, setDraft] = (0, import_react.useState)(null);
@@ -277,7 +342,7 @@ function AutoArchiveRow() {
           max: 3650,
           step: 1,
           value,
-          disabled: busy,
+          disabled: busy || state.enabled === false,
           "aria-label": "\u81EA\u52A8\u5F52\u6863\u5929\u6570",
           onChange: (event) => {
             setDraft(event.target.value);
@@ -318,6 +383,11 @@ function apply(ctx) {
   place(ctx, "sidebar.session.row.leading", 100, ProtectLeading);
   place(ctx, "sidebar.session.row.hover", 100, ProtectHover);
   try {
+    ctx.slots.inject("settings.general.item", () => ctx.slots.register({
+      name: "settings.general.item",
+      id: "session-autarchive-enabled",
+      order: 94
+    }, AutoArchiveToggleRow));
     ctx.slots.inject("settings.general.item", () => ctx.slots.register({
       name: "settings.general.item",
       id: "session-autarchive-days",

package/package.json

@@ -1,18 +1,16 @@
 {
   "name": "dsh-session-autarchive",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "把长期没动过的会话自动归档（默认 5 天），单个会话可以标成不归档。",
   "type": "module",
   "main": "index.js",
   "exports": {
     ".": "./index.js",
-    "./invariant": "./invariant.js",
     "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
   "files": [
     "index.js",
-    "invariant.js",
     "cordis.patch.yml",
     "src",
     "lib/client.js",
@@ -24,7 +22,7 @@
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.2.1-0 <0.3.0-0"
+    "dsh": ">=0.2.1-0"
   },
   "dsh": {
     "client": {
@@ -48,7 +46,7 @@
     "build:client": "node scripts/build-client.mjs",
     "check:client": "node scripts/build-client.mjs --check",
     "smoke": "node scripts/smoke.mjs",
-    "check": "node --check index.js && node --check invariant.js"
+    "check": "node --check index.js"
   },
   "devDependencies": {
     "esbuild": "^0.28.1"

package/scripts/smoke.mjs

@@ -2,20 +2,21 @@
 /**
  * 本机冒烟：不起应用、不发网络请求、不碰真实会话数据。
  *
- * 六关：
+ * 七关：
  *   1. 包结构      —— files 声明的必需文件都在（含已提交的 lib/client.js）
  *   2. 组合声明    —— dsh.bundle.patch 指向的文件在，且里面的 insert id 等于包名
  *   3. 宿主半边    —— 桩 ctx 跑 apply：注册 1 个工具、4 条路由，路径与包名一致
  *   4. 路由鉴权    —— 非回环 403、非 POST 405、坏会话 id 400
  *   5. 状态读写    —— 指向临时 DSH_HOME：改天数、加名单后回读一致
- *   6. 客户端产物  —— 外壳 id == 包名，产物里带上了路由与四个 slot 名
+ *   6. 开关生效    —— enabled=false 时兜底定时不归档，手动 run 仍归档
+ *   7. 客户端产物  —— 外壳 id == 包名，产物里带上了路由与四个 slot 名
  *
  * 用法：node scripts/smoke.mjs   （任一条失败退出码 1）
  *
  * ⚠️ 全程使用临时 DSH_HOME，跑完删掉；不会读到或改到你自己的会话数据。
  */
 
-import { readFileSync, existsSync, mkdtempSync, rmSync } from 'node:fs'
+import { readFileSync, existsSync, mkdirSync, mkdtempSync, rmSync, utimesSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
@@ -33,7 +34,6 @@ const fail = (label, why) => {
 /** 1. 包结构 */
 const REQUIRED = [
   'index.js',
-  'invariant.js',
   'cordis.patch.yml',
   'src/entry.jsx',
   'lib/client.js',
@@ -184,7 +184,74 @@ if (routes.length === wanted.length) {
   }
 }
 
-/** 6. 客户端产物 */
+/** 6. 开关生效：enabled=false 时兜底定时不归档；手动 run 不受限 */
+{
+  // 造一个 30 天前的会话目录（档里没有 turn/end，判定退回文件写入时间）
+  const wsDir = join(home, 'sessions', 'ws-smoke')
+  const sessDir = join(wsDir, 'session-smoke-old')
+  mkdirSync(sessDir, { recursive: true })
+  const oldFile = join(sessDir, 'session.v4.jsonl.zstd')
+  writeFileSync(oldFile, '')
+  const oldStamp = new Date(Date.now() - 30 * 86400000)
+  utimesSync(oldFile, oldStamp, oldStamp)
+  utimesSync(sessDir, oldStamp, oldStamp)
+
+  // 用一份新的桩 ctx 跑 apply，并把 60 秒的首次定时立即点一次
+  const tickOnce = async (enabled) => {
+    await call(routeOf('/config'), { method: 'POST', body: { enabled } })
+    const archived = []
+    const registry = {
+      archivedSessionIds: [],
+      pinnedSessionIds: [],
+      list: () => [{ sessionIds: ['session-smoke-old'] }],
+      archiveSession: async (id) => { archived.push(id) },
+    }
+    const hostTools = []
+    const hostCtx = {
+      tools: { register: (tool) => { hostTools.push(tool) } },
+      get: (name) => (name === 'webServer' ? webServer : name === 'workspaceRegistry' ? registry : undefined),
+      effect: (fn) => {
+        const cleanup = fn()
+        if (typeof cleanup === 'function') cleanups.push(cleanup)
+      },
+    }
+    const realSetTimeout = globalThis.setTimeout
+    globalThis.setTimeout = (fn, ms) => {
+      if (ms === 60 * 1000) { fn(); return { unref() {} } }
+      return realSetTimeout(fn, ms)
+    }
+    try {
+      mod.apply(hostCtx)
+      await new Promise((resolve) => setImmediate(resolve))
+      await new Promise((resolve) => setImmediate(resolve))
+    } finally {
+      globalThis.setTimeout = realSetTimeout
+    }
+    return { archived, tools: hostTools }
+  }
+
+  const off = await tickOnce(false)
+  // 先记下定时链这一轮的归档数：手动 run 会往同一个数组里记，不能等到 run 之后再判
+  const tickArchivedWhileOff = off.archived.length
+  const manualTool = off.tools[0]
+  let manualArchived = false
+  if (manualTool) {
+    const result = await manualTool.execute({ action: 'run' })
+    manualArchived = result && result.ok === true && /已归档 1 个/.test(result.text)
+  }
+  const on = await tickOnce(true)
+  if (tickArchivedWhileOff !== 0) {
+    fail('开关生效', 'enabled=false 时兜底定时仍归档了 ' + tickArchivedWhileOff + ' 个')
+  } else if (!manualArchived) {
+    fail('开关生效', 'enabled=false 时手动 run 没有归档候选')
+  } else if (on.archived.length !== 1) {
+    fail('开关生效', 'enabled=true 时兜底定时归档 ' + on.archived.length + ' 个，应为 1')
+  } else {
+    ok('开关生效', '关闭时定时不归档、手动照常、打开后恢复')
+  }
+}
+
+/** 7. 客户端产物 */
 const client = readFileSync(join(root, 'lib', 'client.js'), 'utf8')
 const idMatch = /^\s*id:\s*"([^"]+)"/m.exec(client)
 const SLOTS = [
@@ -199,9 +266,32 @@ else if (!client.includes(pkg.name + '/api')) fail('客户端产物', '产物里
 else {
   const absent = SLOTS.filter((slot) => !client.includes(slot))
   if (absent.length > 0) fail('客户端产物', '产物里缺 slot：' + absent.join('、'))
+  else if (!client.includes('session-autarchive-enabled')) fail('客户端产物', '产物里没有设置开关行（源码改了但没重新构建）')
   else ok('客户端产物', 'id=' + pkg.name + '，' + Buffer.byteLength(client, 'utf8') + ' 字节')
 }
 
+/** 8. 失败隔离：工具注册抛错时，路由与定时器照常 */
+{
+  const routesAfter = []
+  let effects = 0
+  const hostWeb = { port: 0, register: (route) => { routesAfter.push(route); return () => {} } }
+  const throwingCtx = {
+    tools: { register: () => { throw new Error('simulated duplicate tool') } },
+    get: (name) => (name === 'webServer' ? hostWeb : undefined),
+    effect: (fn) => {
+      effects += 1
+      const cleanup = fn()
+      if (typeof cleanup === 'function') cleanups.push(cleanup)
+    },
+  }
+  let threw = null
+  try { mod.apply(throwingCtx) } catch (error) { threw = error }
+  if (threw) fail('失败隔离', '工具注册抛错后 apply 整体抛出：' + threw.message)
+  else if (routesAfter.length !== 4) fail('失败隔离', '工具注册抛错后注册了 ' + routesAfter.length + ' 条路由，应为 4')
+  else if (effects !== 5) fail('失败隔离', '工具注册抛错后 effect 登记 ' + effects + ' 个，应为 5（4 条路由 + 1 个定时器）')
+  else ok('失败隔离', '工具注册抛错，路由 4 条与定时器照常')
+}
+
 /** 收尾：清掉宿主半边的定时器与临时目录 */
 for (const cleanup of cleanups) {
   try {

package/src/entry.jsx

@@ -242,6 +242,73 @@ const ROW_CSS = `
 .zsa-error { font-size:12px; line-height:18px; color:var(--dsw-alias-state-error-primary); }
 `
 
+/** 开关：纯内联样式，不 import 宿主组件包。 */
+function Switch({ on, disabled, onChange }) {
+  return (
+    <button
+      type="button"
+      role="switch"
+      aria-checked={on}
+      aria-label={on ? '关闭自动归档' : '开启自动归档'}
+      disabled={disabled}
+      onClick={() => onChange(!on)}
+      style={{
+        width: 36, height: 20, flex: 'none', border: 0, borderRadius: 10, padding: 0,
+        cursor: disabled ? 'default' : 'pointer', position: 'relative',
+        background: on ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-border-l1)',
+        opacity: disabled ? 0.5 : 1, transition: 'background .15s',
+      }}
+    >
+      <span style={{
+        position: 'absolute', top: 2, left: on ? 18 : 2, width: 16, height: 16,
+        borderRadius: 8, background: '#fff', transition: 'left .15s',
+      }} />
+    </button>
+  )
+}
+
+/**
+ * 通用设置里的一行：自动归档开关。
+ * 关掉后宿主定时链与浏览器侧都不再自动归档；手动 run 不受影响（宿主那边也这么判）。
+ * @returns 一行设置。
+ */
+export function AutoArchiveToggleRow() {
+  const state = useStore()
+  const [busy, setBusy] = useState(false)
+  const [error, setError] = useState(null)
+  const on = state.enabled !== false
+
+  const toggle = async (next) => {
+    if (busy) return
+    setBusy(true)
+    setError(null)
+    try {
+      const data = await call('POST', ROUTE + '/config', { enabled: next })
+      patchStore({ enabled: data.enabled !== false })
+    } catch (err) {
+      setError('没保存上：' + String((err && err.message) || err))
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  return (
+    <div className="zsa-item">
+      <style>{ROW_CSS}</style>
+      <div className="zsa-text">
+        <div className="zsa-title">自动归档</div>
+        <div className="zsa-desc">
+          {'关闭后后台不再自动归档；手动执行仍然可用。当前候选 ' + state.candidates.length + ' 个。'}
+        </div>
+        {error ? <div className="zsa-error" role="alert">{error}</div> : null}
+      </div>
+      <div className="zsa-field">
+        <Switch on={on} disabled={busy} onChange={(next) => void toggle(next)} />
+      </div>
+    </div>
+  )
+}
+
 /**
  * 通用设置里的一行：自动归档天数。
  * 失焦或回车即落盘（与设置里其它行一样即时生效），写的是宿主同一个 days 字段。
@@ -301,7 +368,7 @@ export function AutoArchiveRow() {
           max={3650}
           step={1}
           value={value}
-          disabled={busy}
+          disabled={busy || state.enabled === false}
           aria-label="自动归档天数"
           onChange={(event) => { setDraft(event.target.value); setError(null) }}
           onBlur={() => { void commit() }}
@@ -339,8 +406,14 @@ export function apply(ctx) {
   place(ctx, 'sidebar.session.row.leading', 100, ProtectLeading)
   place(ctx, 'sidebar.session.row.hover', 100, ProtectHover)
 
-  // 通用设置里一行，排在「当前版本」上面（order 95，当前版本是 100）：自动归档天数。
+  // 通用设置里两行，排在「当前版本」上面（order 94/95，当前版本是 100）：
+  // 「自动归档」开关与「自动归档天数」。先开关后天数，与页面从上到下的阅读顺序一致。
   try {
+    ctx.slots.inject('settings.general.item', () => ctx.slots.register({
+      name: 'settings.general.item',
+      id: 'session-autarchive-enabled',
+      order: 94,
+    }, AutoArchiveToggleRow))
     ctx.slots.inject('settings.general.item', () => ctx.slots.register({
       name: 'settings.general.item',
       id: 'session-autarchive-days',

package/invariant.js

@@ -1,10 +0,0 @@
-const PACKAGE_NAME = 'dsh-session-autarchive'
-
-/** Cordis companion plugin name. */
-export const name = 'dsh-session-autarchive-invariant'
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants']
-
-const install = () => {}
-
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))