dsh-file-history 0.2.2 → 0.2.3

package/README.md

@@ -4,6 +4,16 @@
 
 装进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 之后，AI 每回应一次，插件把这一轮改过的文件整理成卡片贴在该回复下方：改了哪些文件、增删多少行，点文件名看 diff，点按钮还原。
 
+## 它做什么
+
+每一轮对话结束，插件把整个工作区拍一张快照。不是只记 AI 调用过的那次写入，而是这一轮前后磁盘上真实的样子——AI 用脚本绕过去改的文件同样在里面。快照存在 `~/.dsh/file-history/` 下，不进你的项目目录，也不经过你的 git：项目里没有 `.git` 一样能用，有也不会被读写。
+
+于是每条真正改了文件的回复下面多一张卡片：这一轮动了哪些文件、各增删多少行，点文件名看这一轮具体改了什么。最下面四个按钮——只还原文件、只还原对话、两者一起还原、从这一轮开个分支。还原就是拿回这一轮开始前的内容，改错了当没说；还原本身也能撤销。侧栏另有一条时间线，把每轮和你手动标的检查点排在一起，可以跳到任意一个退回去；输入框上方只在工作区跟你标的检查点有差异时出现一条，写明差多少，一键退回。
+
+用的东西不陌生：VS Code 侧边栏那个「时间线」按时间列出同一个文件被改过的每个版本，随时退回去。这插件做的是同一件事，只是单位从「一次保存」换成「一轮对话」，退的时候可以连对话一起退，整件事都在对话框里做完，不用切到编辑器、不用翻 git 日志。
+
+它不做代码审查，也不替代 git：项目里的提交、分支、暂存区一概不碰。
+
 ## 安装
 
 ```bash
@@ -52,7 +62,7 @@ dsh plugin --profile web remove dsh-file-history
 
 ## 配置
 
-写在 profile 的 `cordis.patch.yml` 里，示例见 `config.example.yml`。
+写在 profile 的 `cordis.patch.yml` 里，示例见 `config.example.yml`。这些值也能在**设置 → 插件 → 文件历史**里直接改：三个界面开关和几个数量上限都在那一张卡里，改完下一轮就生效，不用重启。
 
 ```yaml
 - insert:

package/lib/client.js

@@ -5,13 +5,16 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
     var React = require('react')
-    // 侧栏 guide 条目的图标用官方图标集；模块表里没有时留空，回落到自带的方块占位。
-    var IconClock = null
+    // 图标和设置页的开关都来自官方控件集；模块表里没有时留空，各自回落到自带的画法。
+    var primitives = null
     try {
-      IconClock = require('@deepseek-ai/dsh-client-ui-primitives').IconClockOutline16 || null
+      primitives = require('@deepseek-ai/dsh-client-ui-primitives')
     } catch (error) {
-      IconClock = null
+      primitives = null
     }
+    var IconClock = primitives && primitives.IconClockOutline16 || null
+    var IconChevron = primitives && primitives.IconChevronDownOutline14 || null
+    var Switch = primitives && primitives.Switch || null
     var h = React.createElement
     var CHANNEL = '/dsh-file-history'
     var NS = 'file-history'
@@ -196,6 +199,32 @@ window.__ModuleLoader__.load({
       '.fh-card-chk{border-color:var(--dsw-alias-border-l2);box-shadow:inset 2px 0 0 var(--dsw-alias-state-warn-primary)}',
       // 「当前」是自己的一格：手改出来、还没被任何轮次或检查点记下来的那一版，同样按重的处理。
       '.fh-card-now{border-color:var(--dsw-alias-border-l2);box-shadow:inset 2px 0 0 var(--dsw-alias-state-business-primary)}',
+      // 设置页那张卡照官方那张插件卡来：默认折叠，点标题展开，展开的是一行一个 field。
+      '.fh-set{border:.5px solid var(--dsw-alias-border-l4);border-radius:16px;background:var(--dsw-alias-bg-layer-3);transition:border-color .16s,background .16s}',
+      '.fh-set:hover{border-color:var(--dsw-alias-label-dimmed)}',
+      '.fh-set-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}',
+      '.fh-set-head{appearance:none;width:100%;padding:14px 16px;display:flex;align-items:center;gap:12px;border:0;border-radius:12px;background:0 0;color:inherit;font:inherit;text-align:left;cursor:pointer}',
+      '.fh-set-head:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}',
+      '.fh-set-headText{display:flex;flex-direction:column;flex:1;gap:4px;min-width:0}',
+      '.fh-set-name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}',
+      '.fh-set-desc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}',
+      '.fh-chev{flex:none;color:var(--dsw-alias-label-tertiary);transition:transform .16s}',
+      '.fh-chev-open{transform:rotate(180deg)}',
+      '.fh-set-body{border-top:.5px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}',
+      '.fh-set-field{display:flex;flex-direction:column;gap:6px;padding:12px 0}',
+      '.fh-set-field+.fh-set-field{border-top:.5px solid var(--dsw-alias-border-l2)}',
+      '.fh-set-row{display:flex;align-items:center;gap:8px}',
+      '.fh-set-label{flex:1;min-width:0;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:1.5}',
+      '.fh-set-hint{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}',
+      '.fh-set-input{display:flex;align-items:center;gap:6px}',
+      '.fh-set-num{width:88px;height:34px;padding:0 12px;border:.5px solid var(--dsw-alias-border-l4);border-radius:8px;background:var(--dsw-alias-bg-layer-3);color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;line-height:1.5;text-align:right}',
+      '.fh-set-num:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}',
+      '.fh-set-unit{flex:none;width:30px;color:var(--dsw-alias-label-tertiary);font-size:12px}',
+      '.fh-sw{position:relative;flex:none;width:32px;height:18px;padding:0;border:none;border-radius:9px;background:var(--dsw-alias-border-l2);cursor:pointer;transition:background .15s}',
+      '.fh-sw-on{background:var(--dsw-alias-state-business-primary)}',
+      '.fh-sw:disabled{cursor:default;opacity:.45}',
+      '.fh-sw-dot{position:absolute;top:2px;left:2px;width:14px;height:14px;border-radius:50%;background:var(--dsw-alias-bg-layer-1);transition:left .15s}',
+      '.fh-sw-on .fh-sw-dot{left:16px}',
       '.fh-note{color:var(--dsw-alias-label-tertiary)}',
       '.fh-error{color:var(--dsw-alias-state-error-primary)}',
       '.fh-ok{color:var(--dsw-alias-state-success-primary)}',
@@ -297,7 +326,28 @@ window.__ModuleLoader__.load({
       tooBig: '太大没记：',
       crossLineHint: '父分支的轮次只能查看，要动它请从上方那张卡跳过去',
       elsewhereTitle: '文件现在停在另一条分支上',
-      elsewhereGo: '跳转到该分支'
+      elsewhereGo: '跳转到该分支',
+      setTurnCard: '轮次卡片',
+      setDock: '改动条',
+      setTimeline: '侧栏时间线',
+      setKeep: '保留最近轮次',
+      setFileSize: '单个文件上限',
+      setRepoFiles: '单个仓库文件数',
+      setTotal: '快照总量上限',
+      setDesc: '每轮对话结束后给整个工作区拍一张快照，这里管它的开关和上限。',
+      hintTurnCard: '每轮对话结束，在那条回复下面列出改动的文件。',
+      hintDock: '输入框上方那条提示，只在工作区和检查点有差别时出现。',
+      hintTimeline: '右侧栏里把轮次和检查点排成一条线。',
+      hintKeep: '超过这个数目的旧轮次会被清理，检查点不受影响。',
+      hintFileSize: '超过这个大小的文件不记内容，只在卡片里标出来。',
+      hintRepoFiles: '单个内嵌的仓库文件比这多，就整块跳过。',
+      hintTotal: '快照总共占多少盘，超了先清最旧的轮次。',
+      hintPrune: '每设一个检查点，就把走到它的轮次清掉。',
+      setPrune: '检查点后清理到',
+      setUnitTurn: '轮',
+      setUnitPiece: '个',
+      setUnitMB: 'MB',
+      saveFailed: '没存上'
     }
 
     var EN = {
@@ -355,7 +405,28 @@ window.__ModuleLoader__.load({
       tooBig: 'Too large to record:',
       crossLineHint: 'Turns from a parent branch are read-only — jump to that branch to change anything',
       elsewhereTitle: 'The files now sit on another branch',
-      elsewhereGo: 'Go to that branch'
+      elsewhereGo: 'Go to that branch',
+      setTurnCard: 'Turn card',
+      setDock: 'Change bar',
+      setTimeline: 'Sidebar timeline',
+      setKeep: 'Keep recent turns',
+      setFileSize: 'Max file size',
+      setRepoFiles: 'Max files per repository',
+      setTotal: 'Max snapshot size',
+      setDesc: 'A snapshot of the whole workspace after each turn; its switches and limits live here.',
+      hintTurnCard: 'Lists the changed files under each reply, once the turn ends.',
+      hintDock: 'The bar above the input, shown only when the workspace differs from the checkpoint.',
+      hintTimeline: 'Turns and checkpoints as one line in the sidebar.',
+      hintKeep: 'Turns past this count get pruned; checkpoints stay.',
+      hintFileSize: 'Files larger than this are listed but not stored.',
+      hintRepoFiles: 'An embedded repository with more files than this is skipped whole.',
+      hintTotal: 'Disk the snapshots may use; the oldest turns go first.',
+      hintPrune: 'Each checkpoint prunes the turns leading up to it.',
+      setPrune: 'Prune to checkpoint',
+      setUnitTurn: 'turns',
+      setUnitPiece: 'files',
+      setUnitMB: 'MB',
+      saveFailed: 'Not saved'
     }
 
     function Entry(props) {
@@ -952,6 +1023,160 @@ window.__ModuleLoader__.load({
         onChanged: function () { reloadSession(call, sessionId) }
       })
     }
+    // 设置页里的那张卡。命名空间跟宿主注册的那个一样，值也只有一份：
+    // 卡片改完，宿主那边下一轮读到的就是新值，不必重启。
+    var SETTINGS_NS = 'dsh-file-history'
+    // 按常用程度从上往下排：三个界面开关在前，数量类在后。
+    // factor 是把界面上显示的单位换成存储单位的倍数——字节的东西按 MB 给人看。
+    var FIELDS = [
+      { key: 'turnCard', type: 'bool', label: 'setTurnCard', hint: 'hintTurnCard' },
+      { key: 'dock', type: 'bool', label: 'setDock', hint: 'hintDock' },
+      { key: 'timeline', type: 'bool', label: 'setTimeline', hint: 'hintTimeline' },
+      { key: 'keepRecentTurns', type: 'num', label: 'setKeep', hint: 'hintKeep', unit: 'setUnitTurn', min: 0, max: 1000, step: 1 },
+      { key: 'maxFileBytes', type: 'num', label: 'setFileSize', hint: 'hintFileSize', unit: 'setUnitMB', min: 0, max: 1024, step: 1, factor: 1048576 },
+      { key: 'maxRepoFiles', type: 'num', label: 'setRepoFiles', hint: 'hintRepoFiles', unit: 'setUnitPiece', min: 0, max: 1000000, step: 1000 },
+      { key: 'maxBytes', type: 'num', label: 'setTotal', hint: 'hintTotal', unit: 'setUnitMB', min: 0, max: 1048576, step: 256, factor: 1048576 },
+      { key: 'pruneAfterCheckpoints', type: 'num', label: 'setPrune', hint: 'hintPrune', unit: 'setUnitPiece', min: 0, max: 100, step: 1 }
+    ]
+
+    // 快照是客户端这边的镜像：订阅一次，宿主一提交再取一份。引用没变就不重渲染。
+    function useSettingsSnapshot(scope) {
+      var pair = React.useState(function () { return scope ? scope.getSnapshot() : null })
+      var snapshot = pair[0]
+      var setSnapshot = pair[1]
+      React.useEffect(function () {
+        if (!scope) return undefined
+        setSnapshot(scope.getSnapshot())
+        return scope.subscribe(function () { setSnapshot(scope.getSnapshot()) })
+      }, [scope])
+      return snapshot
+    }
+
+    // 读不到（还没送到、或这边没有设置通道）就当开着：插件默认是三个界面都在。
+    function flagOf(snapshot, key) {
+      if (!snapshot || snapshot.status !== 'ready' || !snapshot.value) return true
+      return snapshot.value[key] !== false
+    }
+
+    // 关掉时不光不渲染，连注册一起撤掉：留个空槽比不注册更难看。开关一变就重挂一次。
+    function whenShown(scope, key, setup) {
+      var dispose = null
+      function sync() {
+        var on = scope === null ? true : flagOf(scope.getSnapshot(), key)
+        if (on && dispose === null) {
+          dispose = setup() || function () {}
+        } else if (!on && dispose !== null) {
+          var stop = dispose
+          dispose = null
+          stop()
+        }
+      }
+      sync()
+      var off = scope === null ? null : scope.subscribe(sync)
+      return function () {
+        if (off !== null) off()
+        if (dispose !== null) dispose()
+      }
+    }
+
+    function BoolRow(props) {
+      var t = props.t
+      var failed = React.useState(false)
+      var busy = React.useState(false)
+      function flip(next) {
+        busy[1](true)
+        failed[1](false)
+        Promise.resolve(props.scope.set(props.field.key, typeof next === 'boolean' ? next : !props.value))
+          .catch(function () { failed[1](true) })
+          .then(function () { busy[1](false) })
+      }
+      return h('div', { className: 'fh-set-field' },
+        h('div', { className: 'fh-set-row' },
+          h('span', { className: 'fh-set-label' }, t(props.field.label)),
+          Switch
+            ? h(Switch, { checked: props.value, disabled: busy[0], label: t(props.field.label), onChange: flip })
+            : h('button', {
+                type: 'button',
+                role: 'switch',
+                'aria-checked': props.value,
+                className: 'fh-sw' + (props.value ? ' fh-sw-on' : ''),
+                disabled: busy[0],
+                onClick: function () { flip(!props.value) }
+              }, h('span', { className: 'fh-sw-dot' })),
+          failed[0] ? h('span', { className: 'fh-error' }, t('saveFailed')) : null),
+        h('p', { className: 'fh-set-hint' }, t(props.field.hint)))
+    }
+
+    function NumRow(props) {
+      var t = props.t
+      var field = props.field
+      var factor = field.factor || 1
+      var shown = typeof props.value === 'number' ? Math.round(props.value / factor) : ''
+      // 输入框只在编辑时用草稿：不编辑的时候永远显示宿主那一份，别人改了也会跟着动。
+      var draft = React.useState(null)
+      var failed = React.useState(false)
+      function commit() {
+        var text = draft[0]
+        if (text === null) return
+        draft[1](null)
+        var parsed = Number(String(text).trim())
+        if (String(text).trim() === '' || !isFinite(parsed)) return
+        var real = Math.round(parsed) * factor
+        if (real < field.min * factor) real = field.min * factor
+        if (real > field.max * factor) real = field.max * factor
+        if (real === props.value) return
+        failed[1](false)
+        Promise.resolve(props.scope.set(field.key, real)).catch(function () { failed[1](true) })
+      }
+      return h('div', { className: 'fh-set-field' },
+        h('div', { className: 'fh-set-row' },
+          h('span', { className: 'fh-set-label' }, t(field.label)),
+          h('span', { className: 'fh-set-input' },
+            h('input', {
+              type: 'number',
+              className: 'fh-set-num',
+              min: field.min,
+              max: field.max,
+              step: field.step,
+              value: draft[0] === null ? String(shown) : draft[0],
+              onChange: function (event) { draft[1](event.target.value) },
+              onBlur: commit,
+              onKeyDown: function (event) { if (event.key === 'Enter') event.currentTarget.blur() }
+            }),
+            h('span', { className: 'fh-set-unit' }, t(field.unit))),
+          failed[0] ? h('span', { className: 'fh-error' }, t('saveFailed')) : null),
+        h('p', { className: 'fh-set-hint' }, t(field.hint)))
+    }
+
+    function SettingsCard(props) {
+      var t = props.t
+      var scope = props.scope
+      var snapshot = useSettingsSnapshot(scope)
+      // 宿主还没把这一份发下来时整张卡不出现，免得先亮一排默认值再跳一次。
+      if (!scope || snapshot === null || snapshot.status !== 'ready' || !snapshot.value) return null
+      var value = snapshot.value
+      // 跟官方那张插件卡一样先折着：一页里可能有好几个插件，摊开会很长。
+      var open = React.useState(false)
+      return h('div', { className: 'fh-set' + (open[0] ? ' fh-set-open' : '') },
+        h('button', {
+          type: 'button',
+          className: 'fh-set-head',
+          'aria-expanded': open[0],
+          onClick: function () { open[1](!open[0]) }
+        },
+          h('span', { className: 'fh-set-headText' },
+            h('span', { className: 'fh-set-name' }, t('panelTitle')),
+            h('span', { className: 'fh-set-desc' }, t('setDesc'))),
+          h('span', { className: 'fh-chev' + (open[0] ? ' fh-chev-open' : '') }, IconChevron ? h(IconChevron) : '▾')),
+        open[0]
+          ? h('div', { className: 'fh-set-body' }, h('div', { className: 'fh-set-rows' }, FIELDS.map(function (field) {
+              return field.type === 'bool'
+                ? h(BoolRow, { key: field.key, t: t, scope: scope, field: field, value: value[field.key] !== false })
+                : h(NumRow, { key: field.key, t: t, scope: scope, field: field, value: value[field.key] })
+            })))
+          : null)
+    }
+
     function apply(ctx) {
       var slots = ctx.slots || ctx.get('slots')
       var locale = ctx.locale || ctx.get('locale')
@@ -981,6 +1206,10 @@ window.__ModuleLoader__.load({
 
       var t = locale && typeof locale.bind === 'function' ? locale.bind(NS) : function (key) { return key }
 
+      // 设置页的那张卡和三个界面开关共用这一份：宿主注册的命名空间，客户端这边只是镜像。
+      var settingsScope = ctx.settingsScope || ctx.get('settingsScope')
+      var settings = settingsScope && typeof settingsScope.bind === 'function' ? settingsScope.bind({ namespace: SETTINGS_NS }) : null
+
       async function call(endpoint, payload) {
         var result = await connection.rpc.call(CHANNEL, endpoint, payload)
         if (!result || result.ok !== true) {
@@ -988,47 +1217,69 @@ window.__ModuleLoader__.load({
         }
         return result.value
       }
-
-      if (slots && ctx.sidebarRightTabs) {
+      // 设置页里的一张卡：宿主注册了这个命名空间，卡片才会出现在插件列表里。
+      if (slots && settings) {
         ctx.effect(function () {
-          return ctx.sidebarRightTabs.register({
-            id: TAB_ID,
-            kind: TAB_ID,
-            priority: 'extension',
-            title: function () { return t('panelTitle') },
-            guide: [{
-              order: 15,
-              title: function () { return t('panelTitle') },
-              description: function () { return t('panelDesc') },
-              icon: IconClock || undefined
-            }]
-          })
-        }, 'dsh-file-history: tab type')
-
-        ctx.effect(function () {
-          return slots.inject('sidebar.right.pane.tab', function () {
+          return slots.inject('settings.plugin.item', function () {
             return slots.register(
               {
-                name: 'sidebar.right.pane.tab',
-                key: TAB_ID,
-                locale: NS,
-                inject: function (sessionId) { return { sessionId: sessionId } }
+                name: 'settings.plugin.item',
+                key: SETTINGS_NS,
+                locale: NS
               },
-              function (props) {
-                return h(Panel, {
-                  t: t,
-                  call: call,
-                  uiWorkspace: uiWorkspace,
-                  sessionId: props.sessionId
-                })
+              function () {
+                return h(SettingsCard, { t: t, scope: settings })
               }
             )
           })
-        }, 'dsh-file-history: tab body')
+        }, 'dsh-file-history: settings card')
+      }
+
+      if (slots && ctx.sidebarRightTabs) {
+        // 时间线关掉时，标签类型和面板一起撤：只撤面板会留下一个空标签。
+        ctx.effect(function () {
+          return whenShown(settings, 'timeline', function () {
+            var unTab = ctx.sidebarRightTabs.register({
+              id: TAB_ID,
+              kind: TAB_ID,
+              priority: 'extension',
+              title: function () { return t('panelTitle') },
+              guide: [{
+                order: 15,
+                title: function () { return t('panelTitle') },
+                description: function () { return t('panelDesc') },
+                icon: IconClock || undefined
+              }]
+            })
+            var unBody = slots.inject('sidebar.right.pane.tab', function () {
+              return slots.register(
+                {
+                  name: 'sidebar.right.pane.tab',
+                  key: TAB_ID,
+                  locale: NS,
+                  inject: function (sessionId) { return { sessionId: sessionId } }
+                },
+                function (props) {
+                  return h(Panel, {
+                    t: t,
+                    call: call,
+                    uiWorkspace: uiWorkspace,
+                    sessionId: props.sessionId
+                  })
+                }
+              )
+            })
+            return function () {
+              unBody()
+              unTab()
+            }
+          })
+        }, 'dsh-file-history: tab')
       }
 
       if (slots) {
         ctx.effect(function () {
+          return whenShown(settings, 'turnCard', function () {
           return slots.inject('conversation.chat.turnTail', function () {
             return slots.register(
               {
@@ -1056,6 +1307,7 @@ window.__ModuleLoader__.load({
               }
             )
           })
+          })
         }, 'dsh-file-history: turn tail')
       }
 
@@ -1079,7 +1331,7 @@ window.__ModuleLoader__.load({
     }
 
     exports.name = 'dsh-file-history'
-    exports.inject = ['connection', 'locale', 'slots', 'sidebarRightTabs']
+    exports.inject = ['connection', 'locale', 'slots', 'sidebarRightTabs', 'settingsScope']
     exports.apply = apply
     return module.exports
   }

package/lib/index.js

@@ -7,12 +7,13 @@ import fs from 'node:fs'
 import fsp from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
+import z from 'schemastery'
 
 // git 输出的解析与合并规则单独一处：它们最容易改错，也最容易单独验。
 import { foldPointers, parseBatchBlobs, parseLsFiles, parseNumstat, parseRaw, parseSizes, summarize } from './parse.js'
 
 export const name = 'dsh-file-history'
-export const inject = ['sessions', 'workspaceRegistry', 'connection']
+export const inject = ['sessions', 'workspaceRegistry', 'connection', 'settings']
 
 const CHANNEL = '/dsh-file-history'
 const LEDGER_VERSION = 1
@@ -57,6 +58,21 @@ const DEFAULTS = {
   gcIntervalMs: 10 * 60 * 1000
 }
 
+const SETTINGS_NS = 'dsh-file-history'
+
+// 设置页里露出来的就这几项，按用到的先后排：三个界面开关在前，数量类在后。
+// 单位：两个上限按字节存，卡片里换成 MB 给人看。
+const SettingsSchema = z.object({
+  turnCard: z.boolean().default(true),
+  dock: z.boolean().default(true),
+  timeline: z.boolean().default(true),
+  keepRecentTurns: z.number().min(0).max(1000).default(DEFAULTS.keepRecentTurns),
+  maxFileBytes: z.number().min(0).max(1024 * 1024 * 1024).default(DEFAULTS.maxFileBytes),
+  maxRepoFiles: z.number().min(0).max(1000000).default(DEFAULTS.maxRepoFiles),
+  maxBytes: z.number().min(0).max(1024 * 1024 * 1024 * 1024).default(DEFAULTS.maxBytes),
+  pruneAfterCheckpoints: z.number().min(0).max(100).default(DEFAULTS.pruneAfterCheckpoints)
+})
+
 function stateRoot() {
   return path.join(process.env.DSH_HOME || path.join(os.homedir(), '.dsh'), 'file-history')
 }
@@ -1277,7 +1293,17 @@ class History {
 
 export async function apply(ctx, config) {
   const options = Object.assign({}, DEFAULTS, config && typeof config === 'object' ? config : {})
-  if (!Array.isArray(options.excludes)) options.excludes = DEFAULTS.excludes.slice()
+  // 设置页写的是同一份值：注册成命名空间后，卡片一改就往这个对象里覆盖，
+  // 各个工作区在构造时拿的就是这个引用，不必重建。
+  const scope = ctx.settings.register(SETTINGS_NS, SettingsSchema, { base: options })
+  const keys = Object.keys(SettingsSchema.dict)
+  const spread = (next) => {
+    for (const key of keys) if (next[key] !== undefined) options[key] = next[key]
+  }
+  spread(scope.get())
+  ctx.effect(() => scope.watch((next) => {
+    spread(next)
+  }))
   const history = new History(ctx, options)
   ctx.on('session/event', (session, event) => {
     try {

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "dsh-file-history",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Per-turn file history for DeepSeek Harness: every conversation turn gets a snapshot, a change card in the chat, and one-click rollback of files, conversation, or both.",
   "type": "module",
   "main": "lib/index.js",
   "scripts": {
     "test": "node --test"
   },
+  "dependencies": {
+    "schemastery": "^3.18.0"
+  },
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
@@ -44,7 +47,7 @@
     },
     "client": {
       "platform": "web",
-      "inject": ["@deepseek-ai/dsh-client-locale", "@deepseek-ai/dsh-client-ui-primitives", "@deepseek-ai/dsh-client-ui-slots", "@deepseek-ai/dsh-client-ui-conversation"]
+      "inject": ["@deepseek-ai/dsh-client-locale", "@deepseek-ai/dsh-client-ui-primitives", "@deepseek-ai/dsh-client-ui-slots", "@deepseek-ai/dsh-client-ui-settings", "@deepseek-ai/dsh-client-ui-conversation"]
     }
   }
 }