@a9i5k4/dsh-auto-memory 2.3.1 → 2.4.1

package/lib/client.js

@@ -7,7 +7,7 @@
  *   3. settings.section      — 自动记忆设置页(存储位置、注入、反思风格)
  * Data flows over /api/dsh-auto-memory/* (loopback-only host routes).
  */
-console.log('[dsh-auto-memory] client v0.1.13 fingerprint: drawer-summary-ok')
+console.log('[dsh-auto-memory] client v2.4.1 fingerprint: drawer-summary-ok')
 window.__ModuleLoader__.load({
   id: '@a9i5k4/dsh-auto-memory',
   factory: (require) => {
@@ -252,6 +252,8 @@ window.__ModuleLoader__.load({
         fProjectDir: '项目记忆目录', fProjectDirHint: '相对各工作区的目录名(默认 .dsh-memory)。',
         fInject: '注入记忆上下文', fInjectHint: '每次组装提示词时自动注入 <memory_system> 块。',
         fBudget: '注入预算(字符)', fBudgetHint: '记忆块总预算,超出部分截断。默认 1600(≈400-600 token/轮);活跃会话每轮都注入这段背景,调低更省 token,调高保留更多记忆。',
+        fNoteCap: '项目笔记容量上限(字符)', fNoteCapHint: '项目笔记 MEMORY.md 的容量上限,默认 12000。超出时自动整理:先把较早内容交给模型折叠成要点,失败则退回整条归档(原文进 archive,不丢)——新记忆不会被堵在外面。注意与上面的「注入预算」不是一回事:这个管文件本体大小,注入预算管每轮往上下文塞多少摘要。',
+        fUserCap: '用户级记忆容量上限(字符)', fUserCapHint: '用户级 MEMORY.md(跨项目规则)的容量上限,默认 12000。整理方式与项目笔记相同(先折叠成要点,必要时整条归档)。',
         fSnapGap: '快照最小间隔(轮)', fSnapGapHint: '动态记忆快照内容变化后,至少隔 N 轮才重新注入,避免每轮日志微变都追加快照导致历史膨胀。默认 5;0=每轮都尝试(仍受内容变化约束)。',
         fReinjectOnCompact: '压缩后立即重注入快照', fReinjectOnCompactHint: '上下文被压缩/截断(通常伴随 contextVersion 重置)后,快照会被清掉;开启后强制立即重注入一次,确保记忆背景重建。默认开。',
         fPromptCustom: '自定义记忆注入 prompt', fPromptCustomHint: '可覆盖各层提示文案(小众功能)。支持占位符 {date} {ws} {budget} {n}。改坏了可一键恢复默认。',
@@ -282,7 +284,7 @@ window.__ModuleLoader__.load({
         fMaintSchedule: '定时 30 天蒸馏', fMaintScheduleHint: '每天到点自动把超过 30 天的旧日志蒸馏归档(等价 memory_maintain);无旧日志时零成本跳过。',
         fMaintScheduleTime: '蒸馏触发时间', fMaintScheduleTimeHint: 'HH:MM,默认 10:00(与固化时间错开)。',
         waterCardTitle: '上下文水位', waterAutoSrc: '自动检测', waterManualSrc: '手动设定', waterOfficialSrc: '官方路由容量', waterFallbackSrc: '回退默认值', waterNotMeasured: '本会话尚未测量(发送一轮后自动更新)', waterMeterOfficial: '官方计量', waterMeterHeuristic: '启发式降级', waterThresholdHint: '水位达到 {t} 时注入交接建议并自动补写账本;计量优先用官方 token-meter(与聊天框 context ring 同源),不可用时降级启发式估算;窗口优先取官方路由容量(request/context 的 contextWindow),其次按当前模型查 settings.yaml contextWindow,也可在下方手动覆盖。',
-        autoContTitle: '自动接续', autoContHint: '开启后:水位达到阈值、且旧会话已空闲(harness 权威 running 位在轮次边界转为 false,取代旧「两轮水位持平」)时,弹出确认卡——同意=立即接续,拒绝=本轮跳过(同一边界不再提示),30-40 秒无操作视为挂机自动接续;接续前先让旧 Agent 刷新白板 PLAN 与交接账本,再建新会话(沿用工作区/模型/思考档位)并注入分层交接材料;触发后默认 30 分钟内不重复。', autoContOn: '自动接续:开', autoContOff: '自动接续:关', autoContThreshold: '阈值', autoContCountdown: '⏳ {s} 秒后自动接续…', autoContCancel: '取消', autoContConfirm: '本会话水位已达 {p}%,旧会话已空闲(轮次边界)——现在接续到新会话?', autoContAgree: '同意接续', autoContReject: '拒绝', autoContTimeout: '{s} 秒后自动接续(视为挂机)', autoContRejected: '已跳过本次接续(下一个轮次边界再提醒)',
+        autoContTitle: '自动接续', autoContHint: '开启后:水位达到阈值、且旧会话已空闲(harness 权威 running 位在轮次边界转为 false,取代旧「两轮水位持平」)时,弹出确认卡——同意=立即接续,拒绝=本轮跳过(同一边界不再提示),30-40 秒无操作视为挂机自动接续;接续前先让旧 Agent 刷新白板 PLAN 与交接账本,再建新会话(沿用工作区/模型/思考档位)并注入分层交接材料;触发后默认 30 分钟内不重复。', autoContOn: '自动接续:开', autoContOff: '自动接续:关', autoContThreshold: '阈值', autoContCountdown: '⏳ {s} 秒后自动接续…', autoContCancel: '取消', autoContConfirm: '本会话「可用额度」已用 {p}%(小圈读数见下行),旧会话已空闲(轮次边界)——现在接续到新会话?', autoContAgree: '同意接续', autoContReject: '拒绝', autoContTimeout: '{s} 秒后自动接续(视为挂机)', autoContRejected: '已跳过本次接续(下一个轮次边界再提醒)',
         continueCardTitle: '一键接续', continueCardHint: '写好交接账本→创建新会话→把交接材料作为首条消息预载,并自动切换到新会话继续任务(接续材料含白板节选+最新账本;当前工作区无账本时自动取全局最近一篇)。', continueBtn: '一键接续到新会话', continueBusy: '处理中…',
         fStyle: '反思风格', fStyleHint: '生活化 / 专业性 / 由内容决定。',
         fLocale: '界面语言', fLocaleHint: '默认跟随 DSH 系统语言;也可手动指定中文 / English。', followSystem: '跟随系统语言',
@@ -401,6 +403,8 @@ window.__ModuleLoader__.load({
         fProjectDir: 'Project memory dir', fProjectDirHint: 'Directory name relative to each workspace (default .dsh-memory).',
         fInject: 'Inject memory context', fInjectHint: 'Auto-inject <memory_system> block into every prompt.',
         fBudget: 'Injection budget (chars)', fBudgetHint: 'Total budget for the memory block; excess is truncated. Default 1600 (~400-600 tokens/turn); this background is injected every turn, so lower = fewer tokens, higher = more memory retained.',
+        fNoteCap: 'Project note capacity (chars)', fNoteCapHint: 'Capacity cap for the project MEMORY.md, default 12000. When exceeded the framework auto-consolidates: older content is first folded into bullet points by the model, falling back to whole-record archiving (originals go to archive, never lost) — new memories are never blocked. This is NOT the injection budget above: this caps the file itself, the injection budget caps the digest added to each turn.',
+        fUserCap: 'User memory capacity (chars)', fUserCapHint: 'Capacity cap for the user-level MEMORY.md (cross-project rules), default 12000. Same consolidation behaviour (fold into points first, whole-record archive as fallback).',
         fSnapGap: 'Snapshot min gap (turns)', fSnapGapHint: 'After the dynamic memory snapshot changes, re-inject at least N turns later, so small per-turn log changes do not append a new snapshot every turn (history bloat). Default 5; 0 = try every turn (still change-gated).',
         fReinjectOnCompact: 'Re-inject snapshot immediately after compaction', fReinjectOnCompactHint: 'When the context is compacted/truncated (usually a contextVersion reset), the snapshot is cleared; on = force re-inject once so the memory background rebuilds. Default on.',
         fPromptCustom: 'Customize memory-injection prompt', fPromptCustomHint: 'Override any prompt layer (power feature). Placeholders: {date} {ws} {budget} {n}. One-click reset restores defaults.',
@@ -563,6 +567,30 @@ window.__ModuleLoader__.load({
 
     // ───────────────────────── 更新弹窗 / 首次指导 ─────────────────────────
     var CHANGELOG = {
+      '2.4.1': { zh: [
+        '修复:已接续过的会话会被再次触发接续(重复建窗口)。新增「已接续闩锁」并落盘(session id 为键、重启有效):宿主路径在交接材料投料成功后落闩,浏览器路径在新会话真建成后落闩,失败不落闩以便重试。',
+        '修复:宿主已完成接续后,确认卡仍停在「同意接续/拒绝」并与「已自动接续到新会话」并存;arm 状态改为按会话过滤,不再在其他窗口弹「本会话水位已达」。',
+        '修复:水位双口径那一行(本会话水位 / 官方小圈读数 / 距硬墙余量)此前因漏拷贝 ring/wall 永不渲染。',
+        '内部:界面路径表引入唯一前缀常量与一致性锁(客户端路径必须都在宿主表内、表外零裸字面量);写配置 4 条路径收敛为一个出口;10 处重复的语义状态刷新收敛为一处。',
+        '流程:自本版起,发版必须同步 CHANGELOG、应用内更新说明与版本标识(release.mjs 已加校验,缺一即拒绝构建)。',
+      ], en: [
+        'Fix: a session that had already been continued could be armed again, creating duplicate windows. A persisted continuation latch (keyed by session id, survives restarts) is now written only after the handoff material is actually delivered (host path) or the new session really exists (browser path); failures do not latch, so retries still work.',
+        'Fix: after the host finished continuing, the confirm card still sat on Agree/Decline next to "continued into a new session"; arming is now filtered per session, so other windows no longer show "this session reached the water level".',
+        'Fix: the dual-scale water line (session level / official ring reading / distance to the hard wall) never rendered because ring/wall were not copied through.',
+        'Internal: one prefix constant plus a consistency lock for the panel route table, a single config-write exit, and one shared semantic-status refresh replacing ten copies.',
+        'Process: from this version on, releases must update CHANGELOG, in-app release notes and version identifiers together (release.mjs now refuses to build otherwise).',
+      ] },
+      '2.4.0': { zh: [
+        '★ 水位判据按「该会话当前模型」的预留额度自适应:消息可用上限 = 窗口 − 该路由的 maxTokens(实测 384,000 预留 → 可用 616,000),阈值随之落在健康区间;压缩与 CONTEXT_WINDOW_EXCEEDED 升为硬触发。',
+        '★ 修复自动接续静默失效:DSH 0.1.5 起 requestId 必填,宿主兜底接续漏传该字段时官方抛错被包装成误导性的 "prompt rejected" —— 现象是新会话建出来了、交接材料却从未送达。',
+        '★ 记忆容量口径重做:改为「文件容量上限」(noteCapacityChars / userCapacityChars,默认各 12000 字符),先 AI 折叠成要点、失败退回整条归档,写入不再被堵死。',
+        '★ Python 语义引擎贯通:安装向导写入正确的工作目录、模型落位与 onnxFile 契约对齐、向导常驻设置页,装了就能用。',
+      ], en: [
+        '★ Water-level judgement now adapts to the reserve of the session\'s current route: usable budget = window − that route\'s maxTokens (measured 384,000 reserve → 616,000 usable), so thresholds land in a healthy range; compaction and CONTEXT_WINDOW_EXCEEDED became hard triggers.',
+        '★ Fixed silent auto-continue failure: since DSH 0.1.5 requestId is required, and the host fallback omitted it, so the official error surfaced as a misleading "prompt rejected" — the new session existed but the handoff material never arrived.',
+        '★ Memory capacity reworked around per-file character caps (noteCapacityChars / userCapacityChars, 12000 each): fold into key points first, fall back to whole-entry archiving, so writes are never blocked.',
+        '★ Python semantic engine works end to end: the wizard writes the right working directory, model placement and onnxFile contracts line up, and the wizard is always reachable from Settings.',
+      ] },
       '2.3.0': { zh: [
         '★ 检索改为分层语义唤回:memory_recall 先返回 L0 摘要列表(每条记忆约 90 字,含 id/得分/匹配原因),需要原文再按 id 展开——此前全文直接进 embedding,超过模型 512 token 上限的条目尾部全部丢失(实测最长一条 9,822 字符);现在摘要永远在限制内,长记忆不再有损。',
         '★ 检索融合改为三臂 rank-space:词法 + 语义 + 时间 三路各自排名后按 RRF(k=60)融合,取代旧的 minmax 归一化加权——旧方案分数只反映「这一批里排第几」,候选集一换分数就漂移、候选只剩 1 条时退化为常数,而「要不要注入」的决策恰恰依赖分数与阈值比较。现在排序与决策解耦,分数不再说谎。',
@@ -851,44 +879,56 @@ window.__ModuleLoader__.load({
     }
 
     // ───────────────────────── API ─────────────────────────
+    // 路由前缀唯一常量(2026-09-10 第 0 步止血):表中每条路径由它拼出,不再逐个重复全串。
+    var ROUTE_PREFIX = '/api/dsh-auto-memory'
+    // 宿主半边(lib/index.js 的 API)声明的是同一批路径 —— 两个半边是独立 bundle(本文件经 __ModuleLoader__ 手写加载,
+    // 无法 import 宿主模块),所以"只有一份"这件事由 tests/smoke/ 下的路径表一致性锁保证:
+    // 客户端路径 ⊆ 宿主路径、宿主独有路径只允许显式白名单、本文件表外不得再出现裸路径字面量。
     var API = {
-      state: '/api/dsh-auto-memory/state',
-      list: '/api/dsh-auto-memory/list',
-      file: '/api/dsh-auto-memory/file',
-      recall: '/api/dsh-auto-memory/recall',
-      smartRecall: '/api/dsh-auto-memory/smart-recall',
-      workspaces: '/api/dsh-auto-memory/workspaces',
-      debug: '/api/dsh-auto-memory/debug',
-      scanDirty: '/api/dsh-auto-memory/scan-dirty',
-      browseDir: '/api/dsh-auto-memory/browse-dir',
-      pickDir: '/api/dsh-auto-memory/pick-dir',
-      updateCheck: '/api/dsh-auto-memory/update-check',
-      update: '/api/dsh-auto-memory/update',
-      config: '/api/dsh-auto-memory/config',
-      reflect: '/api/dsh-auto-memory/reflect',
-      reflectAuto: '/api/dsh-auto-memory/reflect-auto',
-      note: '/api/dsh-auto-memory/note',
-      external: '/api/dsh-auto-memory/external',
-      externalView: '/api/dsh-auto-memory/external-view',
-      externalRemove: '/api/dsh-auto-memory/external-remove',
-      externalImport: '/api/dsh-auto-memory/external-import',
-      calendar: '/api/dsh-auto-memory/calendar',
-      summarize: '/api/dsh-auto-memory/summarize',
-      greet: '/api/dsh-auto-memory/greet',
-      notices: '/api/dsh-auto-memory/notices',
-      models: '/api/dsh-auto-memory/models',
-      semanticDeepDetect: '/api/dsh-auto-memory/semantic-deep-detect',
-      pyDetect: '/api/dsh-auto-memory/python-setup/detect',
-      pyVenv: '/api/dsh-auto-memory/python-setup/venv',
-      pyDeps: '/api/dsh-auto-memory/python-setup/deps',
-      pyModel: '/api/dsh-auto-memory/python-setup/model',
-      pyCancel: '/api/dsh-auto-memory/python-setup/cancel',
-      pyStatus: '/api/dsh-auto-memory/python-setup/status',
-      handoffState: '/api/dsh-auto-memory/handoff-state',
-      handoffContinue: '/api/dsh-auto-memory/handoff-continue',
-      autoContState: '/api/dsh-auto-memory/auto-continue-state',
-      autoContDecide: '/api/dsh-auto-memory/auto-continue-decide',
-      semanticDownload: '/api/dsh-auto-memory/semantic-download',
+      state: ROUTE_PREFIX + '/state',
+      list: ROUTE_PREFIX + '/list',
+      file: ROUTE_PREFIX + '/file',
+      recall: ROUTE_PREFIX + '/recall',
+      smartRecall: ROUTE_PREFIX + '/smart-recall',
+      workspaces: ROUTE_PREFIX + '/workspaces',
+      debug: ROUTE_PREFIX + '/debug',
+      scanDirty: ROUTE_PREFIX + '/scan-dirty',
+      browseDir: ROUTE_PREFIX + '/browse-dir',
+      pickDir: ROUTE_PREFIX + '/pick-dir',
+      updateCheck: ROUTE_PREFIX + '/update-check',
+      update: ROUTE_PREFIX + '/update',
+      config: ROUTE_PREFIX + '/config',
+      reflect: ROUTE_PREFIX + '/reflect',
+      reflectAuto: ROUTE_PREFIX + '/reflect-auto',
+      note: ROUTE_PREFIX + '/note',
+      external: ROUTE_PREFIX + '/external',
+      externalView: ROUTE_PREFIX + '/external-view',
+      externalRemove: ROUTE_PREFIX + '/external-remove',
+      externalImport: ROUTE_PREFIX + '/external-import',
+      calendar: ROUTE_PREFIX + '/calendar',
+      summarize: ROUTE_PREFIX + '/summarize',
+      greet: ROUTE_PREFIX + '/greet',
+      notices: ROUTE_PREFIX + '/notices',
+      models: ROUTE_PREFIX + '/models',
+      semanticDeepDetect: ROUTE_PREFIX + '/semantic-deep-detect',
+      semanticStatus: ROUTE_PREFIX + '/semantic-status',
+      semanticEmit: ROUTE_PREFIX + '/semantic-emit',
+      pyDetect: ROUTE_PREFIX + '/python-setup/detect',
+      pyVenv: ROUTE_PREFIX + '/python-setup/venv',
+      pyDeps: ROUTE_PREFIX + '/python-setup/deps',
+      pyModel: ROUTE_PREFIX + '/python-setup/model',
+      pyCancel: ROUTE_PREFIX + '/python-setup/cancel',
+      pyStatus: ROUTE_PREFIX + '/python-setup/status',
+      handoffState: ROUTE_PREFIX + '/handoff-state',
+      handoffContinue: ROUTE_PREFIX + '/handoff-continue',
+      handoffPermission: ROUTE_PREFIX + '/handoff-permission',
+      autoContState: ROUTE_PREFIX + '/auto-continue-state',
+      autoContDecide: ROUTE_PREFIX + '/auto-continue-decide',
+      semanticDownload: ROUTE_PREFIX + '/semantic-download',
+      shadowRecent: ROUTE_PREFIX + '/shadow-recent',
+      reviewFeedback: ROUTE_PREFIX + '/review-feedback',
+      memoryHub: ROUTE_PREFIX + '/memory-hub',
+      storageManage: ROUTE_PREFIX + '/storage-manage',
     }
     function query(params) {
       var search = new URLSearchParams()
@@ -908,6 +948,28 @@ window.__ModuleLoader__.load({
       if (!res.ok) throw new Error(body.error || ('POST ' + path + ' → HTTP ' + res.status))
       return body
     }
+    /**
+     * 写配置的唯一出口(2026-09-10 第 0 步止血):此前有 4 条互不相同的写配置路径
+     * (设置页整对象 POST / 接续页 patch / 向导两处 patch),端点、后置刷新、错误处理各写一遍。
+     * 现在全部经这里,以后加配置项或改保存行为只改这一处。
+     * hooks = { onSaved, onError } 可省;省略时静默失败(与原先的 fire-and-forget 行为一致)。
+     */
+    function saveConfigPatch(patch, hooks) {
+      var h = hooks || {}
+      var p = apiPost(API.config, patch)
+      if (h.onSaved || h.onError) p.then(function (d) { if (h.onSaved) h.onSaved(d) }, function (e) { if (h.onError) h.onError(e) })
+      else p.catch(function () {})
+      return p
+    }
+    /**
+     * 语义引擎状态的统一刷新(2026-09-10 第 0 步止血):此前同一段 fetch + 状态写回在界面里逐字重复 10 处,
+     * 响应形状或失败兜底要改时得挨个改。apply 收合并后的状态对象(已带 loaded:true),onError 可省。
+     */
+    function refreshSem(apply, onError) {
+      try {
+        fetch(API.semanticStatus).then(function (r) { return r.json() }).then(function (j) { if (typeof apply === 'function') apply(Object.assign({ loaded: true }, j)) }, function (e) { if (typeof onError === 'function') onError(e) }).catch(function () {})
+      } catch (_) {}
+    }
 
     // ───────────────────────── 样式 ─────────────────────────
     // 视觉:液态玻璃(毛玻璃)—— backdrop-filter + DSH 主题令牌(--dsw-alias-*),
@@ -1478,7 +1540,7 @@ window.__ModuleLoader__.load({
         var st = p2.status === 'ok' ? t('pyWizOk') + (p2.isVenv ? ' · ' + t('pyWizVenvRec') : '') + (p2.version ? ' (' + p2.version + ')' : '') : p2.status === 'too-old' ? t('pyWizTooOld') + (p2.version ? ' (' + p2.version + ')' : '') : t('pyWizMissing')
         return h('div', { key: idx, style: { fontSize: 'calc(10.5px * var(--dam-scale))', opacity: p2.status === 'ok' ? 1 : 0.55, margin: '2px 0' } }, '· ' + p2.label + ' — ' + st)
       })
-      var allReady = data.venvOk && data.depsOk && data.modelReady
+      var allReady = data.venvOk && data.depsOk && data.modelReady && data.configOk
       return h('div', { style: { border: '1px solid color-mix(in srgb, var(--dam-accent, #2456c4) 40%, transparent)', borderRadius: '10px', padding: '10px 12px', marginBottom: '8px', fontSize: 'calc(11.5px * var(--dam-scale))', lineHeight: 1.6 } },
         h('div', { style: { fontWeight: 700, marginBottom: '4px' } }, t('pyWizTitle')),
         h('div', { style: { opacity: .6, fontSize: 'calc(10.5px * var(--dam-scale))', marginBottom: '6px' } }, t('pyWizModelHint')),
@@ -1618,16 +1680,16 @@ window.__ModuleLoader__.load({
       var setFb = fbPair[1]
       useEffect(function () {
         var alive = true
-        fetch('/api/dsh-auto-memory/shadow-recent').then(function (r) { return r.json() }).then(function (j) {
+        fetch(API.shadowRecent).then(function (r) { return r.json() }).then(function (j) {
           if (alive) setData((j && j.rows) || [])
         }).catch(function (e) { if (alive) setErr(String(e && e.message)) })
-        fetch('/api/dsh-auto-memory/review-feedback').then(function (r) { return r.json() }).then(function (j) {
+        fetch(API.reviewFeedback).then(function (r) { return r.json() }).then(function (j) {
           if (alive) setFb(j || {})
         }).catch(function () {})
         return function () { alive = false }
       }, [])
       function send(obsId, choice) {
-        fetch('/api/dsh-auto-memory/review-feedback', { method: 'POST',
+        fetch(API.reviewFeedback, { method: 'POST',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({ observationId: obsId, choice: choice }) })
           .then(function (r) { return r.json() })
@@ -1796,7 +1858,7 @@ window.__ModuleLoader__.load({
       var setActMsg = actMsgPair[1]
       useEffect(function () {
         var alive = true
-        fetch('/api/dsh-auto-memory/memory-hub').then(function (r) { return r.json() }).then(function (j) {
+        fetch(API.memoryHub).then(function (r) { return r.json() }).then(function (j) {
           if (alive) setData(j || null)
         }).catch(function (e) { if (alive) setErr(String(e && e.message)) })
         return function () { alive = false }
@@ -1804,7 +1866,7 @@ window.__ModuleLoader__.load({
       // M9 审批动作(G-02 同款 append-only 精神):晋升/激活/弃用走 /memory-hub POST,
       // 后端走 store 门槛判定,不绕过任何 gate;动作后刷新 overview。
       function hubAct(action, procedureId, v) {
-        fetch('/api/dsh-auto-memory/memory-hub', { method: 'POST',
+        fetch(API.memoryHub, { method: 'POST',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({ action: action, procedureId: procedureId, v: v }) })
           .then(function (r) { return r.json() })
@@ -1898,7 +1960,7 @@ window.__ModuleLoader__.load({
       var setDelFile = filePair[1]
       useEffect(function () {
         var alive = true
-        fetch('/api/dsh-auto-memory/storage-manage').then(function (r) { return r.json() }).then(function (j) {
+        fetch(API.storageManage).then(function (r) { return r.json() }).then(function (j) {
           if (alive) setData(j || null)
         }).catch(function (e) { if (alive) setErr(String(e && e.message)) })
         return function () { alive = false }
@@ -1906,7 +1968,7 @@ window.__ModuleLoader__.load({
       function act(action, payload, onDone) {
         setMsg('')
         var body = Object.assign({ action: action }, payload || {})
-        fetch('/api/dsh-auto-memory/storage-manage', { method: 'POST',
+        fetch(API.storageManage, { method: 'POST',
           headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) })
           .then(function (r) { return r.json() })
           .then(function (j) {
@@ -1916,7 +1978,7 @@ window.__ModuleLoader__.load({
             }
             setMsg(action + ': ' + reason)
             if (onDone) onDone(j)
-            var again = fetch('/api/dsh-auto-memory/storage-manage').then(function (r2) { return r2.json() })
+            var again = fetch(API.storageManage).then(function (r2) { return r2.json() })
             again.then(function (j2) { setData(j2 || null) })
           })
           .catch(function (e) { setMsg(action + ' failed: ' + String(e && e.message)) })
@@ -2012,6 +2074,10 @@ window.__ModuleLoader__.load({
     // 流程:③刷新仪式(旧 Agent 先刷 PLAN+账本)→ 取材料 → 修A(workspaceId 建会话)→ 序号标题
     //      → 修B(沿用模型+思考档位)→ 打开 → 注入材料。
     var continueFlowBusy = false
+    // 刷新仪式认到的旧会话 id(2026-09-10):权限继承要用它反查旧会话预设。
+    // 材料里的 prevSessionId 依赖宿主 _lastAgent,重启后可能为空;这份来自 handoff-state.refresh,
+    // 宿主侧带磁盘回退,更可靠。
+    var lastRefreshSessionId = ''
     function continueCreateArgs(d) {
       // 修A(2026-09-08):官方 session.create 只接受 workspaceId 或 cwd 之一(同传报 bad-request),
       // 且只有 workspaceId 分支会 workspace.attachSession()(api-session-controller/lib/index.js:566-588);
@@ -2021,18 +2087,31 @@ window.__ModuleLoader__.load({
     }
     async function refreshOldSession(onMsg) {
       // ③接续前刷新仪式:让旧 Agent 把 PLAN.md 与交接账本刷到最新,host 再用最新材料组装交接。
-      // 任何失败/超时都 fail-soft(用现有材料继续),绝不阻塞接续。
+      // 2026-09-10:原先任何失败/超时都静默(fail-soft),用户看到的现象是"点了接续却什么也没发生、旧会话毫无动静"。
+      // 现改为 fail-soft 但**可见** —— 跳过/失败/超时都回报一句原因,接续本身照常继续。
       try {
         var st = await apiGet(API.handoffState)
         var rf = st && st.refresh
-        if (!rf || !rf.sessionId || !rf.prompt) return { ok: false, skipped: true }
-        if (!remoteFace || !remoteFace.session || typeof remoteFace.session.prompt !== 'function') return { ok: false, skipped: true }
+        if (!rf || !rf.sessionId || !rf.prompt) {
+          if (onMsg) onMsg(locale === 'zh' ? '⚠ 刷新仪式已跳过:宿主未给出旧会话 id(刚重启、旧会话未活跃时会发生)——本次直接用现有材料接续。' : '⚠ Refresh ritual skipped: host supplied no old-session id (happens right after a restart) — continuing with current material.')
+          return { ok: false, skipped: true }
+        }
+        if (!remoteFace || !remoteFace.session || typeof remoteFace.session.prompt !== 'function') {
+          if (onMsg) onMsg(locale === 'zh' ? '⚠ 刷新仪式已跳过:harness 未提供 remote.session。' : '⚠ Refresh ritual skipped: remote.session unavailable.')
+          return { ok: false, skipped: true }
+        }
         var before = String((st.planMtime || 0)) + '|' + String((st.ledgers && st.ledgers[0] && st.ledgers[0].name) || '')
+        lastRefreshSessionId = String(rf.sessionId || '')
         if (onMsg) onMsg(locale === 'zh' ? '刷新仪式:请旧 Agent 更新白板 PLAN 与交接账本…' : 'Refresh ritual: asking the old agent to update PLAN + ledger…')
         await remoteFace.session.prompt({ requestId: amReqId('amr'), sessionId: rf.sessionId, mode: 'queue', content: [{ type: 'text', text: rf.prompt }], clientTimeZone: amCtzValue() })
         var waited = await waitForRefresh(rf.sessionId, before)
+        if (onMsg && waited !== 'updated') onMsg(locale === 'zh' ? '刷新仪式:旧会话未在超时内产出新白板/账本(' + waited + '),用现有材料继续。' : 'Refresh ritual: old session produced no new PLAN/ledger within timeout (' + waited + '); continuing with current material.')
         return { ok: true, waited: waited }
-      } catch (eRf) { return { ok: false, error: String(eRf && eRf.message ? eRf.message : eRf) } }
+      } catch (eRf) {
+        var msg = String(eRf && eRf.message ? eRf.message : eRf)
+        if (onMsg) onMsg(locale === 'zh' ? '⚠ 刷新仪式失败:' + msg + '(用现有材料继续)' : '⚠ Refresh ritual failed: ' + msg + ' (continuing with current material)')
+        return { ok: false, error: msg }
+      }
     }
     async function waitForRefresh(oldId, before) {
       // 结束条件(任一):材料变了 / 旧会话跑完这一轮(true→false) / 超时(默认 90s,配置可调)。
@@ -2079,7 +2158,28 @@ window.__ModuleLoader__.load({
         try { await rf.session.selectModel({ sessionId: newId, provider: d.provider, model: d.model, reasoningEffort: d.reasoningEffort || undefined }) } catch (eMdl) {}
       }
       try { if (sessions && typeof sessions.open === 'function') sessions.open(newId) } catch (eOpen) {}
+      // 权限继承(2026-09-10):官方 session.create 不收权限字段,新会话一律落 settings 的
+      // permission.defaultPreset(本机默认曾=workspace-write+ask)→ 接续后每一步都要用户批准,静默运行被打断。
+      // 两段式:投料前先试(命中则**首轮就已继承**),投料后再试(新会话的 agent 往往是投料时才建出来)。
+      var fromSid = String((d && d.prevSessionId) || lastRefreshSessionId || '')
+      var permPreset = ''
+      if (fromSid) {
+        try {
+          var pp1 = await apiPost(API.handoffPermission, { fromSessionId: fromSid, toSessionId: newId, attempts: [0, 400] })
+          if (pp1 && pp1.ok) permPreset = String(pp1.preset || '')
+        } catch (ePp1) {}
+      }
       await rf.session.prompt({ requestId: amReqId('amc'), sessionId: newId, mode: 'queue', content: [{ type: 'text', text: d.carryText }], clientTimeZone: amCtzValue() })
+      if (!permPreset && fromSid) {
+        try {
+          var pp2 = await apiPost(API.handoffPermission, { fromSessionId: fromSid, toSessionId: newId, attempts: [0, 700, 1600] })
+          if (pp2 && pp2.ok) permPreset = String(pp2.preset || '')
+          else if (onMsg && pp2 && pp2.reason && pp2.reason !== 'no-permission-service') {
+            onMsg(locale === 'zh' ? '⚠ 权限未继承(' + pp2.reason + '),新会话按设置里的默认权限运行。' : '⚠ Permission not inherited (' + pp2.reason + '); new session runs with the default permission.')
+          }
+        } catch (ePp2) {}
+      }
+      if (onMsg && permPreset) onMsg(locale === 'zh' ? '已继承旧会话权限:' + permPreset : 'Permission inherited: ' + permPreset)
       return newId
     }
     async function runContinueFlow(opts) {
@@ -2093,7 +2193,8 @@ window.__ModuleLoader__.load({
         var ritual = !(cfg && cfg.autoContinueRefreshRitual === false) && !(opts && opts.skipRefresh)
         if (ritual) { try { await refreshOldSession(onMsg) } catch (eRf) {} }
         onMsg(locale === 'zh' ? '正在构造交接材料(含旧会话转写)…' : 'Preparing handoff material (incl. prev-session transcript)…')
-        var d = await apiPost(API.handoffContinue, {})
+        var fromSidForCarry = String(lastRefreshSessionId || currentSessionIdClient() || '')
+        var d = await apiPost(API.handoffContinue, fromSidForCarry ? { fromSessionId: fromSidForCarry } : {})
         if (!d || !d.ok) throw new Error((d && d.error) || 'no handoff material')
         var newId = await executeContinue(d, onMsg)
         try { localStorage.setItem('dsh-auto-memory.autoCont.last', String(Date.now())) } catch (eL) {}
@@ -2133,7 +2234,7 @@ window.__ModuleLoader__.load({
       }, [])
       var autoSave = function (patch) {
         setAutoCfg(function (p) { return Object.assign({}, p, patch) })
-        apiPost(API.config, patch).catch(function () {})
+        saveConfigPatch(patch)
       }
       async function oneClickContinue() {
         // 一键接续 = 共用执行器(刷新仪式 → 材料 → workspaceId 建会话 → 沿用模型 → 注入),与自动接续同一路径
@@ -3045,10 +3146,10 @@ window.__ModuleLoader__.load({
       if (!wizSt) {
         wizSt = { loaded: false }
         window['dsh-auto-memory.wizStatus'] = wizSt
-        fetch('/api/dsh-auto-memory/semantic-status').then(function (r) { return r.json() }).then(function (j) {
-          Object.assign(wizSt, j, { loaded: true })
+        refreshSem(function (s) {
+          Object.assign(wizSt, s)
           try { dlgTick() } catch (e9) {}
-        }).catch(function () { Object.assign(wizSt, { loaded: true, ready: false }) })
+        }, function () { Object.assign(wizSt, { loaded: true, ready: false }) })
       }
       var tourDlPhase = wizSt && wizSt.download && wizSt.download.phase
       var tourShowing = !!dialogState && (dialogState.kind === 'welcomeTour' || dialogState.kind === 'modelDownload')
@@ -3058,19 +3159,19 @@ window.__ModuleLoader__.load({
           setTourStep(0)
           wizSt.tourCfg = null
           wizSt.cfgLoaded = false
-          fetch('/api/dsh-auto-memory/config').then(function (r) { return r.json() }).then(function (j) {
+          fetch(API.config).then(function (r) { return r.json() }).then(function (j) {
             wizSt.tourCfg = (j && (j.config || j)) || {}
             // mode 型开关(唤起注入模式)实际存储在 embedding-config.json(semantic-emit 接口维护),
             // 需从 semantic-status 合并进来,导览开关才能显示真实当前值并与设置页联动。
             try {
-              fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) {
+              refreshSem(function (j2) {
                 if (j2 && j2.activationEmitMode !== undefined) { wizSt.tourCfg.activationEmitMode = j2.activationEmitMode; try { dlgTick() } catch (e13) {} }
-              }).catch(function () {})
+              })
             } catch (_) {}
             wizSt.cfgLoaded = true
             try { dlgTick() } catch (e11) {}
           }).catch(function () { wizSt.tourCfg = wizSt.tourCfg || {}; wizSt.cfgLoaded = true })
-          fetch('/api/dsh-auto-memory/external').then(function (r) { return r.json() }).then(function (j) {
+          fetch(API.external).then(function (r) { return r.json() }).then(function (j) {
             wizSt.extScan = j
             try { dlgTick() } catch (e12) {}
           }).catch(function () {})
@@ -3080,9 +3181,9 @@ window.__ModuleLoader__.load({
         if (!tourShowing) return undefined
         if (wizSt.ready) return undefined // 已就绪无需轮询
         var iv = setInterval(function () {
-          fetch('/api/dsh-auto-memory/semantic-status').then(function (r) { return r.json() }).then(function (j) {
+          refreshSem(function (j) {
             Object.assign(wizSt, j); try { dlgTick() } catch (e10) {}
-          }).catch(function () {})
+          })
         }, 1500)
         return function () { clearInterval(iv) }
       }, [tourShowing, tourDlPhase, wizSt.ready])
@@ -3095,7 +3196,7 @@ window.__ModuleLoader__.load({
         if (wizSt.ready || wizSt.loaded === false) return undefined
         var ph = wizSt.download && wizSt.download.phase
         if (ph === 'downloading' || ph === 'verifying' || ph === 'done' || ph === 'error') return undefined
-        apiPost('/api/dsh-auto-memory/semantic-download', { action: 'start', mirror: 'auto' }).catch(function () {})
+        apiPost(API.semanticDownload, { action: 'start', mirror: 'auto' }).catch(function () {})
       }, [tourShowing, tourStep, wizSt.ready])
       if (!dialogState) return null
       // 左下角小卡片(记忆按钮上方),高透明毛玻璃,不遮全屏
@@ -3213,7 +3314,7 @@ window.__ModuleLoader__.load({
               : t('dlDone'))
           : (locale === 'zh' ? '未下载 · 词法检索照常可用' : 'Not downloaded · lexical search keeps working')
         var startDl = function () {
-          apiPost('/api/dsh-auto-memory/semantic-download', { action: 'start', mirror: 'auto' }).catch(function () {})
+          apiPost(API.semanticDownload, { action: 'start', mirror: 'auto' }).catch(function () {})
         }
         // 功能开关:读当前值(带每项默认)/点击即时写配置(乐观更新+POST,失败不回滚——下次重看向导会以真实配置为准)
         var EXT_SOURCE_KEYS = ['workbuddy-user', 'workbuddy-profile', 'codebuddy-memory', 'claude-global', 'project-conventions', 'workbuddy-sessions', 'claude-sessions', 'codex-sessions']
@@ -3239,9 +3340,9 @@ window.__ModuleLoader__.load({
           // mode 型开关(唤起注入模式)走 semantic-emit 接口——与设置页同源(embedding-config.json),
           // 保证导览切换与设置页双向联动;其余开关写常规 config。
           if (tg.mode) {
-            apiPost('/api/dsh-auto-memory/semantic-emit', { mode: patch[tg.key] }).catch(function () {})
+            apiPost(API.semanticEmit, { mode: patch[tg.key] }).catch(function () {})
           } else {
-            apiPost('/api/dsh-auto-memory/config', patch).catch(function () {})
+            saveConfigPatch(patch)
           }
         }
         // 外部来源单源勾选(扫描行;勾选即写 externalSources 对象)
@@ -3252,7 +3353,7 @@ window.__ModuleLoader__.load({
           cur[id] = (cur[id] !== false) ? false : true
           c.externalSources = cur
           dlgTick()
-          apiPost('/api/dsh-auto-memory/config', { externalSources: cur }).catch(function () {})
+          saveConfigPatch({ externalSources: cur })
         }
         var tourExtOn = function (id) {
           var c = wizSt.tourCfg || {}
@@ -3538,8 +3639,11 @@ window.__ModuleLoader__.load({
       useEffect(function () {
         var alive = true
         var load = function () {
+          // 带上当前会话 id:宿主据此只在「属于本窗口的」armed 上弹确认卡(2026-09-10)
+          var sidQ = ''
+          try { sidQ = String(currentSessionIdClient() || '') } catch (eS) {}
           apiGet(API.config).then(function (c) { if (alive) setAcCfg(c || {}) }).catch(function () {})
-          apiGet(API.autoContState).then(function (s) { if (alive && s) setAcState(s) }).catch(function () {})
+          apiGet(API.autoContState, sidQ ? { sessionId: sidQ } : {}).then(function (s) { if (alive && s) setAcState(s) }).catch(function () {})
         }
         load()
         var iv = setInterval(load, 3000)
@@ -3554,21 +3658,34 @@ window.__ModuleLoader__.load({
         // 触发/倒计时/超时执行全部由宿主侧驱动(2.2.6),浏览器即使被节流也不影响接续。
         var poll = function () {
           if (!alive) return
-          apiGet(API.autoContState).then(function (s) {
+          var sidQ = ''
+          try { sidQ = String(currentSessionIdClient() || '') } catch (eS) {}
+          apiGet(API.autoContState, sidQ ? { sessionId: sidQ } : {}).then(function (s) {
             if (!alive || !s) return
             setAcState(s)
             if (s.executing) {
+              // 2026-09-10:执行中/已完成时必须**收起确认卡** —— 旧实现在这两个分支直接 return,
+              // acConfirm 保持旧值,于是宿主已接续完成后,卡片仍停在「同意接续/拒绝」上
+              // (实测:旧窗口一直显示确认卡 + 「✓ 已自动接续到新会话」并存,像是「它还想接续」)。
+              setAcConfirm(null)
+              setAcCd(0)
               setAcSt(locale === 'zh' ? '宿主正在自动接续:刷新白板/账本 → 建新会话 → 注入材料…' : 'Host auto-continuing: refresh PLAN/ledger → new session → inject…')
               return
             }
-            if (s.lastOk) {
+            var okAt = Number(s.lastOk && s.lastOk.at) || 0
+            // 10 分钟有效期(2026-09-10):宿主状态是全局单值,提示不设期限会一直挂在每个窗口上
+            if (s.lastOk && (okAt === 0 || Date.now() - okAt < 10 * 60 * 1000)) {
+              setAcConfirm(null)
+              setAcCd(0)
               setAcSt((locale === 'zh' ? '✓ 已自动接续到新会话,可直接上手' : '✓ Auto-continued into a new session') + (s.lastOk.model ? ' · ' + s.lastOk.model + (s.lastOk.reasoningEffort ? '/' + s.lastOk.reasoningEffort : '') : ''))
               return
             }
             if (s.error) { setAcSt('✗ ' + s.error); return }
             var arm = s.armed
             if (arm && arm.ratio >= thr) {
-              setAcConfirm({ ratio: Number(arm.ratio) || 0, tokens: Number(arm.tokens) || 0, window: Number(arm.window) || 0, edgeAt: Number(arm.edgeAt) || 0 })
+              // ring/wall 必须一起带进来:卡片读的是 acConfirm.ring / acConfirm.wall,
+              // 宿主透出了但这里不拷 → 双口径那行永远不渲染(2026-09-10 自查发现)
+              setAcConfirm({ ratio: Number(arm.ratio) || 0, tokens: Number(arm.tokens) || 0, window: Number(arm.window) || 0, ring: Number(arm.ring) || 0, wall: Number(arm.wall) || 0, edgeAt: Number(arm.edgeAt) || 0 })
               setAcCd(Math.max(0, Math.ceil((Number(arm.expiresAt) || 0) - Date.now()) / 1000))
             } else {
               setAcConfirm(null)
@@ -3609,7 +3726,9 @@ window.__ModuleLoader__.load({
         return h('div', { 'data-dam-autocont': '', style: { position: 'fixed', right: '16px', bottom: '16px', zIndex: 9000, maxWidth: 'min(440px, calc(100vw - 32px))', boxSizing: 'border-box', padding: '10px 12px', borderRadius: '12px', border: '1px solid rgba(128,128,128,.35)', background: 'rgba(18,22,30,.93)', color: '#e8eaed', fontSize: '12px', lineHeight: '1.55', fontFamily: 'system-ui', boxShadow: '0 10px 30px rgba(0,0,0,.35)', backdropFilter: 'blur(10px)' } },
           acConfirm ? h('div', { 'data-dam-autocont-confirm': '' }, [
             h('div', { style: { marginBottom: '4px' } }, t('autoContConfirm').replace('{p}', String(Math.round((acConfirm.ratio || 0) * 100)))),
-            h('div', { 'data-dam-hint': '' }, (acConfirm.tokens || 0).toLocaleString() + ' / ' + (acConfirm.window || 0).toLocaleString() + ' token'),
+            h('div', { 'data-dam-hint': '' }, (acConfirm.tokens || 0).toLocaleString() + ' / ' + (acConfirm.window || 0).toLocaleString() + ' token'
+              + (acConfirm.ring > 0 ? '  ·  ' + (locale === 'zh' ? '官方小圈读数 ' : 'ring ') + String(Math.round((acConfirm.ring || 0) * 100)) + '%' : '')
+              + (acConfirm.wall > 0 ? '  ·  ' + (locale === 'zh' ? '距硬墙还剩 ' : 'to the wall ') + Math.max(0, (acConfirm.wall || 0) - (acConfirm.tokens || 0)).toLocaleString() + ' token' : '')),
             h('div', { style: { marginTop: '8px' } },
               h('button', { 'data-dam-btn': '', onClick: onAgree }, t('autoContAgree')),
               h('button', { 'data-dam-btn': '', style: { marginLeft: '6px' }, onClick: onReject }, t('autoContReject')),
@@ -3737,6 +3856,29 @@ window.__ModuleLoader__.load({
           }
           kids.push(h('input', { key: '__manual__', 'data-dam-input': '', style: { marginTop: '6px', width: '100%' }, value: cfg.subagentModel || '', placeholder: locale === 'zh' ? '手动输入(可选,provider 跟随路由默认)' : 'manual entry (optional, provider follows routing default)', onChange: function (e) { set('subagentModel', String(e.target.value || '').trim()); set('subagentProvider', '') } }))
         }
+        // 思考强度(DSH 0.1.5 agentOptions.reasoningEffort):与模型成对下发给子代理;留空=跟随模型默认。
+        // 合法值按 DeepSeek 适配器口径 off|low|high|max(默认 high)——服务端同样做白名单过滤。
+        var effortOpts = [
+          ['', locale === 'zh' ? '跟随默认' : 'default'],
+          ['off', 'off'],
+          ['low', 'low'],
+          ['high', 'high'],
+          ['max', 'max'],
+        ]
+        var curEffort = String(cfg.subagentReasoningEffort || '').toLowerCase()
+        kids.push(h('div', { key: '__effort__', style: { marginTop: '10px', paddingTop: '8px', borderTop: '1px solid color-mix(in srgb, var(--dsw-alias-border-l1, rgba(128,128,128,.25)) 45%, transparent)' } },
+          h('b', { style: { display: 'block', fontSize: 'calc(12px * var(--dam-scale))' } }, locale === 'zh' ? '思考强度（子代理）' : 'Reasoning effort (subagents)'),
+          h('div', { 'data-dam-row': '', style: { flexWrap: 'wrap', marginTop: '4px' } },
+            effortOpts.map(function (o) {
+              return h('button', {
+                key: 'eff-' + (o[0] || 'def'), 'data-dam-btn': '',
+                style: { padding: '3px 9px', fontWeight: curEffort === o[0] ? 700 : 400, opacity: curEffort === o[0] ? 1 : 0.72 },
+                onClick: function () { set('subagentReasoningEffort', o[0]) },
+              }, o[1] + (curEffort === o[0] ? ' ✓' : ''))
+            })),
+          h('div', { 'data-dam-hint': '' }, locale === 'zh'
+            ? 'off=关闭思维链，low/high/max 递增思考深度（DeepSeek 默认 high）。只作用于本插件的子代理（时段总结/问候/自动沉淀/蒸馏），不影响主对话；留空或模型不支持时跟随模型默认。'
+            : 'off disables thinking; low/high/max increase depth (DeepSeek default: high). Applies only to this plugin’s subagents, never the main conversation; empty follows the model default.')))
         return h('div', { style: panelStyle }, kids)
       }
       var verPair = useState(null)
@@ -3785,9 +3927,7 @@ window.__ModuleLoader__.load({
       var detBusy = detBusyPair[0]
       var setDetBusy = detBusyPair[1]
       useEffect(function () {
-        fetch('/api/dsh-auto-memory/semantic-status').then(function (r) { return r.json() }).then(function (j) {
-          setSem(Object.assign({ loaded: true }, j))
-        }).catch(function () { setSem({ loaded: true, ready: false }) })
+        refreshSem(setSem, function () { setSem({ loaded: true, ready: false }) })
         return function () {}
       }, [])
       // 下载进行中每 1.5s 轮询真实进度(服务端流式记账 bytesDone/bytesTotal/mirrorUsed)
@@ -3795,9 +3935,7 @@ window.__ModuleLoader__.load({
         var ph = sem && sem.download && sem.download.phase
         if (ph !== 'downloading' && ph !== 'verifying') return function () {}
         var iv = setInterval(function () {
-          fetch('/api/dsh-auto-memory/semantic-status').then(function (r) { return r.json() }).then(function (j) {
-            setSem(Object.assign({ loaded: true }, j))
-          }).catch(function () {})
+          refreshSem(setSem)
         }, 1500)
         return function () { clearInterval(iv) }
       }, [sem && sem.download && sem.download.phase])
@@ -3821,8 +3959,10 @@ window.__ModuleLoader__.load({
       function save() {
         if (busy) return
         setBusy(true); setMsg(''); setErr('')
-        apiPost(API.config, cfg).then(function (d) { setCfg(d.config); setDirty(false); setMsg(t('saved') + (d.migrated ? ' ' + d.migrated : '')); setBusy(false); if (d && d.config && d.config.locale) applyLocalePref(d.config.locale); try { fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) { setSem(Object.assign({ loaded: true }, j2)) }).catch(function () {}) } catch (_) {} })
-          .catch(function (e) { setErr(e.message); setBusy(false) })
+        saveConfigPatch(cfg, {
+          onSaved: function (d) { setCfg(d.config); setDirty(false); setMsg(t('saved') + (d.migrated ? ' ' + d.migrated : '')); setBusy(false); if (d && d.config && d.config.locale) applyLocalePref(d.config.locale); refreshSem(setSem) },
+          onError: function (e) { setErr(e.message); setBusy(false) }
+        })
       }
       function field(label, control, hint) {
         return h('div', { 'data-dam-settings-row': '' },
@@ -3854,7 +3994,7 @@ window.__ModuleLoader__.load({
           else if ((rec === 'download-model' || rec === 'install-peer' || rec === 'setup-both') && mode !== 'python') setGuide('js')
           else if (rec === 'setup-both' && mode === 'python') setGuide('python')
         }).catch(function () { setDet({ failed: true }); setDetBusy(false) })
-        fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) { setSem(Object.assign({ loaded: true }, j2)) }).catch(function () {})
+        refreshSem(setSem)
       }
       function onEngineModeChange(e) {
         var v = e.target.value
@@ -3874,12 +4014,11 @@ window.__ModuleLoader__.load({
         // 2026-08-27 修复显示不跟随:切换后重新 fetch semantic-status,刷新「当前生效检索」
         // (sem.resolvedTier 原只在挂载/下载时更新,切换后不刷新导致一直显示旧档位)。
         try {
-          fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) {
-            var s2 = Object.assign({ loaded: true }, j2)
+          refreshSem(function (s2) {
             setSem(s2)
             if (v === 'js' && s2.ready === false) setGuide('js')
             else if (v === 'python' && s2.pythonInt8Present === false) setGuide('python')
-          }).catch(function () {})
+          })
         } catch (_) {}
       }
       var sectionLabels = {
@@ -3906,7 +4045,7 @@ window.__ModuleLoader__.load({
           field(t('fJsCooldown'), h('input', { 'data-dam-input': '', type: 'number', min: 0, max: 60, value: cfg.jsDecideCooldownRounds === undefined ? 1 : cfg.jsDecideCooldownRounds, onChange: function (e) { set('jsDecideCooldownRounds', (function () { var v = Number(e.target.value); return (Number.isFinite(v) && v >= 0) ? v : 1 })())  /* #19: 0=不冷却 是合法值,|| 1 会吃掉 0 */ } }), t('fJsCooldownHint')),
           field(t('fJsDelta'), h('input', { 'data-dam-input': '', type: 'number', min: 0, max: 1, step: 0.005, value: cfg.jsDecideDeltaExp === undefined ? 0.01 : cfg.jsDecideDeltaExp, onChange: function (e) { var v = Number(e.target.value); set('jsDecideDeltaExp', Number.isFinite(v) && v >= 0 ? v : 0.01) } }), t('fJsDeltaHint')),
           field(t('fJsExcerpt'), h('input', { 'data-dam-input': '', type: 'number', min: 20, max: 480, value: cfg.jsDecideExcerptChars === undefined ? 40 : cfg.jsDecideExcerptChars, onChange: function (e) { set('jsDecideExcerptChars', Math.max(20, Math.min(480, Number(e.target.value) || 40))) } }), t('fJsExcerptHint')),
-          field(t('fEmitMode'), h('select', { 'data-dam-select': '', value: (sem && sem.activationEmitMode) || 'shadow', onChange: function (e) { var m = e.target.value; apiPost('/api/dsh-auto-memory/semantic-emit', { mode: m }).then(function () { try { fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) { setSem(Object.assign({ loaded: true }, j2)) }).catch(function () {}) } catch (_) {} }).catch(function () {}) } },
+          field(t('fEmitMode'), h('select', { 'data-dam-select': '', value: (sem && sem.activationEmitMode) || 'shadow', onChange: function (e) { var m = e.target.value; apiPost(API.semanticEmit, { mode: m }).then(function () { refreshSem(setSem) }).catch(function () {}) } },
             h('option', { value: 'shadow' }, locale === 'zh' ? 'shadow 只记录' : 'shadow (record only)'),
             h('option', { value: 'canary-explicit' }, locale === 'zh' ? 'canary 显式回忆注入' : 'canary (explicit recall)'),
             h('option', { value: 'active' }, locale === 'zh' ? 'active 全部注入' : 'active (all)')), t('fEmitModeHint')),
@@ -3922,6 +4061,10 @@ window.__ModuleLoader__.load({
               h('option', { value: 'js' }, t('semJs')),
               h('option', { value: 'python' }, t('semPy'))),
             h('button', { 'data-dam-btn': '', title: locale === 'zh' ? '自动检测本机语义引擎环境(JS/Python 资产+推理库),并联动安装助手' : 'Auto-detect local semantic engine assets & runtime, with setup assistant', disabled: detBusy, onClick: function () { void runDetect() } }, detBusy ? '⏳' : '⟳ 检测'),
+            // 2026-09-10:向导入口原先只在"资产未就绪"时自动弹出,已装好的用户反而进不去(想重装/换布局无处可点)。
+            // 现在常驻一个显式开关,永远可达;已就绪时打开也只是复用同一套下载/校验步骤。
+            h('button', { 'data-dam-btn': '', title: locale === 'zh' ? '打开/收起安装向导(按当前引擎选择:JS 模型 或 Python 引擎)' : 'Open/collapse setup wizard (follows the selected engine)', onClick: function () { setGuide(guide ? '' : ((cfg.semanticEngineMode === 'python') ? 'python' : 'js')) } },
+              guide ? (locale === 'zh' ? '收起向导' : 'Hide wizard') : (locale === 'zh' ? '🧩 安装向导' : '🧩 Setup')),
           ]), t('semModeHint')),
           sem.loaded ? h('div', { 'data-dam-hint': '', style: { marginTop: '-4px', marginBottom: '8px' } },
             t('semResolved') + ': ' + (sem.resolvedTier === 'c2' ? t('tierC2') + ' ✓' : sem.resolvedTier === 'c3' ? t('tierC3') + ' ✓' : t('tierC1')))
@@ -4005,13 +4148,13 @@ window.__ModuleLoader__.load({
                   : (isJs && dl.phase === 'done' && !ready ? t('dlDone') + (locale === 'zh' ? '（缺运行库时需安装 @huggingface/transformers）' : ' (install @huggingface/transformers if runtime missing)')
                     : (locale === 'zh' ? '下载进度' : 'Download progress'))))
             var refreshSem = function () {
-              fetch('/api/dsh-auto-memory/semantic-status').then(function (r2) { return r2.json() }).then(function (j2) { setSem(Object.assign({ loaded: true }, j2)) }).catch(function () {})
+              refreshSem(setSem)
             }
             var startDl = function () {
-              apiPost('/api/dsh-auto-memory/semantic-download', { action: 'start', mirror: mirror }).then(refreshSem).catch(function () {})
+              apiPost(API.semanticDownload, { action: 'start', mirror: mirror }).then(refreshSem).catch(function () {})
             }
             var cancelDl = function () {
-              apiPost('/api/dsh-auto-memory/semantic-download', { action: 'cancel', mirror: mirror }).then(refreshSem).catch(function () {})
+              apiPost(API.semanticDownload, { action: 'cancel', mirror: mirror }).then(refreshSem).catch(function () {})
             }
             return h('div', { style: { border: '1px solid color-mix(in srgb, var(--dam-accent, #2456c4) 40%, transparent)', borderRadius: '10px', padding: '10px 12px', marginBottom: '8px', fontSize: 'calc(11.5px * var(--dam-scale))', lineHeight: 1.6 } },
               h('div', { 'data-dam-row': '', style: { alignItems: 'center' } },
@@ -4103,6 +4246,8 @@ window.__ModuleLoader__.load({
           : null]),
         section('injection', sectionLabels.injection, [field(t('fInject'), h('input', { type: 'checkbox', checked: !!cfg.injectEnabled, onChange: function (e) { set('injectEnabled', e.target.checked) } }), t('fInjectHint')),
         field(t('fBudget'), h('input', { 'data-dam-input': '', type: 'number', min: 400, value: cfg.injectBudgetChars, onChange: function (e) { set('injectBudgetChars', Number(e.target.value) || 2400) } }), t('fBudgetHint')),
+        field(t('fNoteCap'), h('input', { 'data-dam-input': '', type: 'number', min: 500, value: cfg.noteCapacityChars === undefined ? 12000 : cfg.noteCapacityChars, onChange: function (e) { set('noteCapacityChars', Number(e.target.value) || 12000) } }), t('fNoteCapHint')),
+        field(t('fUserCap'), h('input', { 'data-dam-input': '', type: 'number', min: 500, value: cfg.userCapacityChars === undefined ? 12000 : cfg.userCapacityChars, onChange: function (e) { set('userCapacityChars', Number(e.target.value) || 12000) } }), t('fUserCapHint')),
         field(t('fDays'), h('input', { 'data-dam-input': '', type: 'number', min: 1, max: 14, value: cfg.recentDaysInjected, onChange: function (e) { set('recentDaysInjected', Number(e.target.value) || 1) } }), t('fDaysHint')),
         field(t('fExtBudget'), h('input', { 'data-dam-input': '', type: 'number', min: 200, value: cfg.externalInjectionChars === undefined ? 1400 : cfg.externalInjectionChars, onChange: function (e) { set('externalInjectionChars', Number(e.target.value) || 1400) } }), t('fExtBudgetHint')),
         field(t('fSnapGap'), h('input', { 'data-dam-input': '', type: 'number', min: 0, max: 50, value: cfg.snapshotMinGapRounds === undefined ? 5 : cfg.snapshotMinGapRounds, onChange: function (e) { set('snapshotMinGapRounds', Number(e.target.value) || 5) } }), t('fSnapGapHint')),
@@ -4136,10 +4281,10 @@ window.__ModuleLoader__.load({
         field(t('fMaintScheduleTime'), h('input', { 'data-dam-input': '', placeholder: '10:00', value: cfg.maintainScheduleTime === undefined ? '10:00' : cfg.maintainScheduleTime, onChange: function (e) { set('maintainScheduleTime', String(e.target.value || '').trim()) } }), t('fMaintScheduleTimeHint')),
         field(t('fStyle'), h('select', { 'data-dam-select': '', value: cfg.reflectStyle, onChange: function (e) { set('reflectStyle', e.target.value) } },
           STYLE_IDS.map(function (id) { return h('option', { key: id, value: id }, t('style' + id.charAt(0).toUpperCase() + id.slice(1))) })), t('fStyleHint')),
-        field(locale === 'zh' ? '总结/问候默认模型' : 'Summary & greeting model', h('div', { 'data-dam-row': '', style: { flex: 1 } },
-          h('span', { style: { flex: 1, fontSize: 'calc(12px * var(--dam-scale))', wordBreak: 'break-all', opacity: cfg.subagentModel ? 1 : 0.6 } }, cfg.subagentModel || (locale === 'zh' ? '跟随路由默认' : 'routing default')),
-          h('button', { 'data-dam-btn': '', onClick: openModels }, locale === 'zh' ? '选择模型' : 'Pick model')),
-          locale === 'zh' ? '用于时段总结、问候语、自动沉淀等 subagent 功能;从检测到的模型中选择,或留空跟随路由默认。保存后生效。' : 'For scheduled summaries, greetings and auto-consolidation subagents; pick a detected model or leave empty for the routing default. Applies after saving.'),
+        field(locale === 'zh' ? '子代理模型 / 思考强度' : 'Subagent model & reasoning effort', h('div', { 'data-dam-row': '', style: { flex: 1 } },
+          h('span', { style: { flex: 1, fontSize: 'calc(12px * var(--dam-scale))', wordBreak: 'break-all', opacity: cfg.subagentModel ? 1 : 0.6 } }, (cfg.subagentModel || (locale === 'zh' ? '跟随路由默认' : 'routing default')) + (String(cfg.subagentReasoningEffort || '') ? ' · ' + String(cfg.subagentReasoningEffort) : '')),
+          h('button', { 'data-dam-btn': '', onClick: openModels }, locale === 'zh' ? '选择模型 / 强度' : 'Pick model / effort')),
+          locale === 'zh' ? '用于时段总结、问候语、自动沉淀、蒸馏等 subagent 功能;模型与思考强度(off/low/high/max)都经 DSH 的 agentOptions 下发,留空跟随路由与模型默认。保存后生效。' : 'For scheduled summaries, greetings, auto-consolidation and distillation subagents; model and reasoning effort (off/low/high/max) are delivered via DSH agentOptions. Empty follows routing and model defaults. Applies after saving.'),
         mdlOpen ? buildModelDrawer() : null,
         ]),
         section('context', sectionLabels.context, [field(t('fHandoff'), h('input', { type: 'checkbox', checked: cfg.handoffEnabled !== false, onChange: function (e) { set('handoffEnabled', e.target.checked) } }), t('fHandoffHint')),