dsh-auto-compaction 0.2.1 → 0.2.3

package/cordis.patch.yml

@@ -8,3 +8,482 @@
 - insert:
     - id: dsh-auto-compaction
       name: dsh-auto-compaction
+# >>> handoff:takeover:begin  （dsh-auto-compaction 按当前预设组合生成，勿手改本块）
+- id: preset-cordis
+  config:
+    id: cordis
+    order: 4
+    plugins:
+      - id: persona
+        name: '@deepseek-ai/dsh-persona'
+        config:
+          prefix: You are a coding agent powered by the {{model}} model.
+      - id: agent-instructions
+        name: '@deepseek-ai/dsh-agent-instructions'
+        config:
+          maxBytes: 65536
+      - id: time-context
+        name: '@deepseek-ai/dsh-time-context'
+      - id: tool-bash
+        name: '@deepseek-ai/dsh-tool-bash'
+        disabled: !!js process.platform === 'win32'
+      - id: tool-pwsh
+        name: '@deepseek-ai/dsh-tool-pwsh'
+        disabled: !!js process.platform !== 'win32'
+      - id: tool-fs
+        name: '@deepseek-ai/dsh-tool-fs'
+      - id: tool-fs-search
+        name: '@deepseek-ai/dsh-tool-fs-search'
+        config:
+          sampleOverCapGlobResults: false
+      - id: tool-jobs
+        name: '@deepseek-ai/dsh-tool-jobs'
+      - id: tool-schedule
+        name: '@deepseek-ai/dsh-tool-schedule'
+      - id: command-goal
+        name: '@deepseek-ai/dsh-command-goal'
+      - id: tool-goal
+        name: '@deepseek-ai/dsh-tool-goal'
+      - id: planning
+        name: cordis:group
+        group: true
+        isolate:
+          planMode: true
+        config:
+          - id: plan-mode
+            name: '@deepseek-ai/dsh-plan-mode'
+            config:
+              section: |
+                You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+                Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+                The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+                Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+                Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+                When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+      - id: compaction
+        name: cordis:group
+        group: true
+        isolate:
+          compaction: true
+          toolResultPruner: true
+        config:
+          - id: compaction-basic
+            name: dsh-auto-compaction-engine
+            config:
+              thresholdRatio: 0.9
+              headroomTokens: 10000
+              maxTokens: 12288
+              idleDelayMs: 1500
+              presetId: cordis
+          - id: command-compact
+            name: '@deepseek-ai/dsh-command-compact'
+          - id: tool-result-pruner
+            name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+            config:
+              thresholdChars: 8192
+              headChars: 4096
+              tailChars: 1024
+      - id: delegation
+        name: cordis:group
+        group: true
+        isolate:
+          workflowEngine: true
+        config:
+          - id: tool-subagent-control
+            name: '@deepseek-ai/dsh-tool-subagent-control'
+          - id: tool-subagent-list-agents
+            name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+          - id: tool-subagent
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: spawn
+              toolName: subagent
+              modelSelectionSettings: true
+          - id: tool-subagent-fork
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: fork
+              toolName: subagent_fork
+          - id: workflow-ptc
+            name: '@deepseek-ai/dsh-workflow-ptc'
+            config:
+              provider: spawn
+          - id: tool-workflow
+            name: '@deepseek-ai/dsh-tool-workflow'
+      - id: tool-ask-user
+        name: '@deepseek-ai/dsh-tool-ask-user'
+      - id: tool-todo
+        name: '@deepseek-ai/dsh-tool-todo'
+        config:
+          allowParallelInProgress: true
+      - id: tool-web
+        name: '@deepseek-ai/dsh-tool-web'
+        config:
+          fetch: true
+          searchTimeoutMs: 60000
+      - id: tool-cordis
+        name: '@deepseek-ai/dsh-tool-cordis'
+      - id: skill-filesystem
+        name: '@deepseek-ai/dsh-skill-filesystem'
+        config:
+          customSkillDirs:
+            - !!js process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:path').dirname(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('@deepseek-ai/dsh-agent-preset/package.json')), 'skills')
+      - id: tool-skill
+        name: '@deepseek-ai/dsh-tool-skill'
+      - id: present
+        name: '@deepseek-ai/dsh-tool-present'
+      - id: tool-plugin-manager
+        name: '@deepseek-ai/dsh-plugin-manager/tools'
+        disabled: !!js '!ctx.get(''profileContext'')'
+      - id: tool-plugin-market
+        name: '@deepseek-ai/dsh-plugin-market/tools'
+        disabled: !!js '!ctx.get(''profileContext'')'
+- id: preset-minimal
+  config:
+    id: minimal
+    order: 3
+    plugins:
+      - id: persona
+        name: '@deepseek-ai/dsh-persona'
+        config:
+          prefix: You are a helpful software engineer assistant.
+          complete: true
+          includeRuntimeContext: false
+      - id: tool-fs
+        name: '@deepseek-ai/dsh-tool-fs'
+        config:
+          read: false
+          readImage: true
+          write: false
+          edit: false
+      - id: compaction
+        name: cordis:group
+        group: true
+        isolate:
+          compaction: true
+        config:
+          - id: compaction-basic
+            name: dsh-auto-compaction-engine
+            config:
+              thresholdRatio: 0.9
+              headroomTokens: 10000
+              maxTokens: 12288
+              idleDelayMs: 1500
+              presetId: minimal
+          - id: command-compact
+            name: '@deepseek-ai/dsh-command-compact'
+      - id: persistent-shell
+        name: cordis:group
+        group: true
+        isolate:
+          terminals: true
+        config:
+          - id: pty
+            name: '@deepseek-ai/dsh-terminal'
+          - id: terminal-bash
+            name: '@deepseek-ai/dsh-terminal-bash'
+            disabled: !!js process.platform === 'win32'
+            config:
+              timeoutMs: 300000
+          - id: persistent-bash
+            name: '@deepseek-ai/dsh-tool-bash-persistent'
+            disabled: !!js process.platform === 'win32'
+            config:
+              timeoutMs: 300000
+              description: |-
+                Run commands in a bash shell
+                * When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.
+                * Network access depends on the task environment. Prefer configured mirrors/proxies when they are available.
+                * State is persistent across command calls and discussions with the user.
+                * To inspect a particular line range of a file, e.g. lines 10-25, try 'sed -n 10,25p /path/to/the/file'.
+                * Please avoid commands that may produce a very large amount of output.
+                * Please run long lived commands in the background, e.g. 'sleep 10 &' or start a server in the background.
+          - id: terminal-pwsh
+            name: '@deepseek-ai/dsh-terminal-bash'
+            disabled: !!js process.platform !== 'win32'
+            config:
+              shellDialect: pwsh
+              timeoutMs: 300000
+          - id: persistent-pwsh
+            name: '@deepseek-ai/dsh-tool-pwsh-persistent'
+            disabled: !!js process.platform !== 'win32'
+            config:
+              timeoutMs: 300000
+              description: |-
+                Run commands in a PowerShell shell
+                * When invoking this tool, the contents of the "command" parameter does NOT need to be XML-escaped.
+                * You don't have access to the internet via this tool.
+                * State is persistent across command calls and discussions with the user.
+                * Use native Windows paths (C:\...) and $env:NAME variables; this is PowerShell, not bash.
+                * Please avoid commands that may produce a very large amount of output.
+                * Please run long lived commands in the background, e.g. 'Start-Job' or start a server with Start-Process.
+- id: preset-ptc
+  config:
+    id: ptc
+    order: 2
+    plugins:
+      - id: persona
+        name: '@deepseek-ai/dsh-persona'
+        config:
+          prefix: You are a coding agent powered by the {{model}} model.
+      - id: agent-instructions
+        name: '@deepseek-ai/dsh-agent-instructions'
+        config:
+          maxBytes: 65536
+      - id: time-context
+        name: '@deepseek-ai/dsh-time-context'
+      - id: tool-bash
+        name: '@deepseek-ai/dsh-tool-bash'
+        disabled: !!js process.platform === 'win32'
+      - id: tool-pwsh
+        name: '@deepseek-ai/dsh-tool-pwsh'
+        disabled: !!js process.platform !== 'win32'
+      - id: tool-fs
+        name: '@deepseek-ai/dsh-tool-fs'
+      - id: tool-fs-search
+        name: '@deepseek-ai/dsh-tool-fs-search'
+        config:
+          sampleOverCapGlobResults: false
+      - id: tool-jobs
+        name: '@deepseek-ai/dsh-tool-jobs'
+      - id: tool-schedule
+        name: '@deepseek-ai/dsh-tool-schedule'
+      - id: skill-filesystem
+        name: '@deepseek-ai/dsh-skill-filesystem'
+      - id: tool-skill
+        name: '@deepseek-ai/dsh-tool-skill'
+      - id: command-goal
+        name: '@deepseek-ai/dsh-command-goal'
+      - id: tool-goal
+        name: '@deepseek-ai/dsh-tool-goal'
+      - id: planning
+        name: cordis:group
+        group: true
+        isolate:
+          planMode: true
+        config:
+          - id: plan-mode
+            name: '@deepseek-ai/dsh-plan-mode'
+            config:
+              section: |
+                You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+                Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+                The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+                Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+                Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+                When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+      - id: compaction
+        name: cordis:group
+        group: true
+        isolate:
+          compaction: true
+          toolResultPruner: true
+        config:
+          - id: compaction-basic
+            name: dsh-auto-compaction-engine
+            config:
+              thresholdRatio: 0.9
+              headroomTokens: 10000
+              maxTokens: 12288
+              idleDelayMs: 1500
+              presetId: ptc
+          - id: command-compact
+            name: '@deepseek-ai/dsh-command-compact'
+          - id: tool-result-pruner
+            name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+            config:
+              thresholdChars: 8192
+              headChars: 4096
+              tailChars: 1024
+      - id: delegation
+        name: cordis:group
+        group: true
+        isolate:
+          workflowEngine: true
+        config:
+          - id: tool-subagent-control
+            name: '@deepseek-ai/dsh-tool-subagent-control'
+          - id: tool-subagent-list-agents
+            name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+          - id: tool-subagent
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: spawn
+              toolName: subagent
+              modelSelectionSettings: true
+          - id: tool-subagent-fork
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: fork
+              toolName: subagent_fork
+          - id: workflow-ptc
+            name: '@deepseek-ai/dsh-workflow-ptc'
+            disabled: true
+            config:
+              provider: spawn
+          - id: tool-workflow
+            name: '@deepseek-ai/dsh-tool-workflow'
+            disabled: true
+      - id: tool-ask-user
+        name: '@deepseek-ai/dsh-tool-ask-user'
+      - id: tool-todo
+        name: '@deepseek-ai/dsh-tool-todo'
+        config:
+          allowParallelInProgress: true
+      - id: tool-web
+        name: '@deepseek-ai/dsh-tool-web'
+        config:
+          fetch: true
+          searchTimeoutMs: 60000
+      - id: tool-presentation
+        name: '@deepseek-ai/dsh-agent-tool-presentation'
+        config:
+          mode: ptc
+      - id: present
+        name: '@deepseek-ai/dsh-tool-present'
+      - id: tool-plugin-manager
+        name: '@deepseek-ai/dsh-plugin-manager/tools'
+        disabled: true
+      - id: tool-plugin-market
+        name: '@deepseek-ai/dsh-plugin-market/tools'
+        disabled: true
+- id: preset-standard
+  config:
+    id: standard
+    order: 1
+    plugins:
+      - id: persona
+        name: '@deepseek-ai/dsh-persona'
+        config:
+          prefix: You are a coding agent powered by the {{model}} model.
+      - id: agent-instructions
+        name: '@deepseek-ai/dsh-agent-instructions'
+        config:
+          maxBytes: 65536
+      - id: time-context
+        name: '@deepseek-ai/dsh-time-context'
+      - id: tool-bash
+        name: '@deepseek-ai/dsh-tool-bash'
+        disabled: !!js process.platform === 'win32'
+      - id: tool-pwsh
+        name: '@deepseek-ai/dsh-tool-pwsh'
+        disabled: !!js process.platform !== 'win32'
+      - id: tool-fs
+        name: '@deepseek-ai/dsh-tool-fs'
+      - id: tool-fs-search
+        name: '@deepseek-ai/dsh-tool-fs-search'
+        config:
+          sampleOverCapGlobResults: false
+      - id: tool-jobs
+        name: '@deepseek-ai/dsh-tool-jobs'
+      - id: tool-schedule
+        name: '@deepseek-ai/dsh-tool-schedule'
+      - id: skill-filesystem
+        name: '@deepseek-ai/dsh-skill-filesystem'
+      - id: tool-skill
+        name: '@deepseek-ai/dsh-tool-skill'
+      - id: command-goal
+        name: '@deepseek-ai/dsh-command-goal'
+      - id: tool-goal
+        name: '@deepseek-ai/dsh-tool-goal'
+      - id: planning
+        name: cordis:group
+        group: true
+        isolate:
+          planMode: true
+        config:
+          - id: plan-mode
+            name: '@deepseek-ai/dsh-plan-mode'
+            config:
+              section: |
+                You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+                Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+                The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+                Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+                Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+                When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+      - id: compaction
+        name: cordis:group
+        group: true
+        isolate:
+          compaction: true
+          toolResultPruner: true
+        config:
+          - id: compaction-basic
+            name: dsh-auto-compaction-engine
+            config:
+              thresholdRatio: 0.9
+              headroomTokens: 10000
+              maxTokens: 12288
+              idleDelayMs: 1500
+              presetId: standard
+          - id: command-compact
+            name: '@deepseek-ai/dsh-command-compact'
+          - id: tool-result-pruner
+            name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+            config:
+              thresholdChars: 8192
+              headChars: 4096
+              tailChars: 1024
+      - id: delegation
+        name: cordis:group
+        group: true
+        isolate:
+          workflowEngine: true
+        config:
+          - id: tool-subagent-control
+            name: '@deepseek-ai/dsh-tool-subagent-control'
+          - id: tool-subagent-list-agents
+            name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+          - id: tool-subagent
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: spawn
+              toolName: subagent
+              modelSelectionSettings: true
+          - id: tool-subagent-fork
+            name: '@deepseek-ai/dsh-tool-subagent'
+            config:
+              provider: fork
+              toolName: subagent_fork
+          - id: workflow-ptc
+            name: '@deepseek-ai/dsh-workflow-ptc'
+            config:
+              provider: spawn
+          - id: tool-workflow
+            name: '@deepseek-ai/dsh-tool-workflow'
+      - id: tool-ask-user
+        name: '@deepseek-ai/dsh-tool-ask-user'
+      - id: tool-todo
+        name: '@deepseek-ai/dsh-tool-todo'
+        config:
+          allowParallelInProgress: true
+      - id: tool-web
+        name: '@deepseek-ai/dsh-tool-web'
+        config:
+          fetch: true
+          searchTimeoutMs: 60000
+      - id: present
+        name: '@deepseek-ai/dsh-tool-present'
+      - id: tool-plugin-manager
+        name: '@deepseek-ai/dsh-plugin-manager/tools'
+        disabled: true
+      - id: tool-plugin-market
+        name: '@deepseek-ai/dsh-plugin-market/tools'
+        disabled: true
+# <<< handoff:takeover:end

package/lib/client.js

@@ -32,10 +32,21 @@ window.__ModuleLoader__.load({
     };
 
     var DEFAULT_TEMPLATE = "~/.dsh-handoff-compaction/template.md";
-    var PRESETS = [
-      { id: "lightweight-local", label: "轻量本地" },
-      { id: "lightweight-standard", label: "轻量标准" },
-    ];
+    /* Preset names come from DSH's own registry through the `scope` RPC, never
+     * from a list baked in here: a release that renames or adds a preset must
+     * not leave this page showing names that no longer exist. */
+    var presetLabels = {};
+    function rememberPresetLabels(list) {
+      for (var i = 0; i < list.length; i += 1) {
+        var entry = list[i];
+        if (entry && typeof entry.id === "string") {
+          presetLabels[entry.id] = typeof entry.label === "string" && entry.label.length > 0 ? entry.label : entry.id;
+        }
+      }
+    }
+    function presetLabel(id) {
+      return presetLabels[String(id)] || String(id || "未命名预设");
+    }
     var DISPLAY_OPTIONS = [
       { id: "orbit", label: "轨道环" },
       { id: "strip", label: "状态条" },
@@ -480,7 +491,7 @@ window.__ModuleLoader__.load({
               indicator,
               h("div", { style: { fontSize: 12.5, fontWeight: 600, color: STATUS_TEXT } }, title),
               h("div", { style: { fontSize: 11, color: STATUS_MUTED } }, cardSub),
-              h("div", { style: { fontSize: 10.5, color: STATUS_MUTED, opacity: 0.85 } }, "完成后整段历史收成一条交接文档")
+              h("div", { style: { fontSize: 10.5, color: STATUS_MUTED, opacity: 0.85 } }, "完成后把最旧的这段历史收成一条交接文档")
             )
           ),
           document.body
@@ -687,8 +698,31 @@ window.__ModuleLoader__.load({
       var draft = draftState[0], setDraft = draftState[1];
       var statusState = React.useState({ loading: true, error: "", saving: false, saved: false });
       var status = statusState[0], setStatus = statusState[1];
+      var scopeState = React.useState({ loading: true, error: "", value: null });
+      var scope = scopeState[0], setScope = scopeState[1];
+      var tokenState = React.useState(0);
+      var token = tokenState[0], setToken = tokenState[1];
       ensureStatusStyles();
 
+      // Which presets exist and which of them this plugin's patch reaches is
+      // DSH's answer, not ours, so it is read fresh each time the section opens.
+      React.useEffect(function () {
+        if (!connection) {
+          setScope({ loading: false, error: "连接服务不可用", value: null });
+          return undefined;
+        }
+        var alive = true;
+        setScope(function (previous) { return { loading: true, error: "", value: previous.value }; });
+        call(connection, "scope").then(function (value) {
+          if (!alive) return;
+          rememberPresetLabels(value && Array.isArray(value.presets) ? value.presets : []);
+          setScope({ loading: false, error: "", value: value });
+        }).catch(function (error) {
+          if (alive) setScope({ loading: false, error: String(error && error.message || error), value: null });
+        });
+        return function () { alive = false; };
+      }, [connection, token]);
+
       React.useEffect(function () {
         var alive = true;
         if (!connection) { setStatus({ loading: false, error: "连接服务不可用", saving: false, saved: false }); return; }
@@ -715,6 +749,95 @@ window.__ModuleLoader__.load({
       var defaultTemplate = base.defaultTemplate || DEFAULT_TEMPLATE;
       var themeStyle = normalizeDisplayStyle(base.displayStyle);
 
+      // Detection only: who compacts is decided by the preset slot (read from
+      // disk) times the 启用插件 switch. This row never changes either of them.
+      var SCOPE_TONE = {
+        native: { dot: "#6b7178", text: C.muted },
+        plugin: { dot: C.accent, text: "#cfe0ff" },
+        part: { dot: "#d29922", text: "#e6c98a" },
+        err: { dot: "#e5534b", text: "#f0b8b4" },
+      };
+      var scopeView = (function () {
+        var st = scope.value;
+        if (!st) {
+          return {
+            tone: "err",
+            text: scope.loading ? "读取中…" : "读不到生效情况",
+            sub: scope.loading
+              ? "正在向 DSH 读取预设名单与本插件的接管行。"
+              : "读不到预设名单：" + (scope.error || "未知原因") + "。",
+            rows: [], retry: true,
+          };
+        }
+        var list = Array.isArray(st.presets) ? st.presets : [];
+        rememberPresetLabels(list);
+        var rows = list.map(function (p) {
+          return {
+            key: String(p.id),
+            label: presetLabel(p.id),
+            taken: p.effective === true,
+            owner: p.effective === true ? "插件" : p.covered === true ? "原生（未勾选）" : "原生（未覆盖）",
+          };
+        });
+        var names = rows.map(function (r) { return r.label; });
+        var takenNames = rows.filter(function (r) { return r.taken; }).map(function (r) { return r.label; });
+        var restNames = rows.filter(function (r) { return !r.taken; }).map(function (r) { return r.label; });
+        var total = Number(st.total) || list.length;
+        var covered = Number(st.covered) || 0;
+        var effective = Number(st.effective) || 0;
+        var globalSaved = st.scope !== "preset";
+        var scopeLead = globalSaved ? "全局生效：" : "按预设生效：";
+        var mechanism = "接管行写在本插件包内的补丁里，卸载插件时随包一起消失，你的预设文件不会被改动。";
+
+        if (total === 0) {
+          return {
+            tone: "err", text: "读不到预设", rows: [], retry: true,
+            sub: "DSH 没有返回任何 Agent 预设" + (st.reason ? "（" + st.reason + "）" : "") + "，所以无法判断压缩由谁负责。重新读取试试。",
+          };
+        }
+        if (covered === 0) {
+          return {
+            tone: "native", text: "DSH 原生压缩", rows: rows, retry: true,
+            sub: "本插件的接管行还没覆盖到任何预设" + (st.reason ? "（" + st.reason + "）" : "")
+              + "，压缩目前由 DSH 自己完成。" + mechanism + " 新生成或新装的预设需要重启 DSH 重新生成接管行。",
+          };
+        }
+        if (effective === 0 && !enabled) {
+          return {
+            tone: "native", text: "DSH 原生压缩（插件已停用）", rows: rows, retry: false,
+            sub: "「启用插件」已关闭：" + takenNames.length + "/" + total + " 个预设虽然被接管行覆盖，但插件把压缩交回 DSH 原生实现。打开开关即恢复，不需要重启。",
+          };
+        }
+        if (effective === 0) {
+          return {
+            tone: "native", text: "DSH 原生压缩", rows: rows, retry: false,
+            sub: scopeLead + "当前没有任何预设处于接管状态（" + names.join("、") + " 都走原生）。"
+              + "勾选预设或切到「全局生效」并保存即可，下一次判定就生效，不需要重启。",
+          };
+        }
+        if (effective < total) {
+          return {
+            tone: "part", text: effective + "/" + total + " 预设已由插件压缩", rows: rows, retry: false,
+            sub: scopeLead + "由插件负责：" + takenNames.join("、") + "；" + restNames.join("、") + " 仍走各自的原生压缩。" + mechanism,
+          };
+        }
+        return {
+          tone: "plugin",
+          text: globalSaved ? "已由插件接管（全局）" : "已由插件接管",
+          rows: rows, retry: false,
+          sub: scopeLead + (globalSaved
+            ? "这 " + total + " 个预设（" + names.join("、") + "）"
+            : "勾选的 " + effective + " 个预设（" + takenNames.join("、") + "）")
+            + " 的压缩由本插件的交接文档负责，且「启用插件」是开的。" + mechanism,
+        };
+      })();
+      var scopeTone = SCOPE_TONE[scopeView.tone] || SCOPE_TONE.native;
+      /* Only presets the takeover rows reach can be selected; the rest stay
+       * native and would be misleading to offer. */
+      var takeable = scope.value && Array.isArray(scope.value.presets)
+        ? scope.value.presets.filter(function (p) { return p && p.covered === true; })
+        : [];
+
       var budget = EXAMPLE_WINDOW - EXAMPLE_RESERVED;
       var ceiling = budget - EXAMPLE_HEADROOM;
       var eff = Math.min(Math.round(budget * ratio / 100), ceiling);
@@ -726,6 +849,20 @@ window.__ModuleLoader__.load({
         (settings.templateFile || "") !== template ||
         normalizeDisplayStyle(settings.displayStyle) !== themeStyle;
 
+      // The detection row reports what is on disk, so every unsaved choice that
+      // would change that report has to be named — otherwise it looks ignored.
+      var enabledIsPending = settings !== null && (settings.enabled !== false) !== enabled;
+      var scopeIsPending = settings !== null && (settings.scope === "preset") !== scopePreset;
+      var presetsIsPending = settings !== null && scopePreset &&
+        JSON.stringify(presets.slice().sort()) !== JSON.stringify((settings.presets || []).slice().sort());
+      var pendingParts = [];
+      if (enabledIsPending) pendingParts.push("「启用插件」改成" + (enabled ? "开" : "关"));
+      if (scopeIsPending) pendingParts.push("生效范围改成「" + (scopePreset ? "按预设生效" : "全局生效") + "」");
+      if (presetsIsPending) pendingParts.push("勾选的预设改成" + (presets.length ? presets.map(presetLabel).join("、") : "（都不勾）"));
+      var pendingNote = pendingParts.length
+        ? "还没保存：" + pendingParts.join("；") + "。保存后开关与勾选在下一次判定就生效，不需要重启；只有接管行本身要覆盖新的预设时才需要重启 DSH 重新生成。"
+        : "";
+
       function patch(next) { setDraft(Object.assign({}, base, next)); setStatus({ loading: false, error: "", saving: false, saved: false }); }
       function setPreset(id) {
         var next = presets.indexOf(id) >= 0 ? presets.filter(function (v) { return v !== id; }) : presets.concat([id]);
@@ -744,10 +881,12 @@ window.__ModuleLoader__.load({
           setSettings(value); setDraft(value);
           publishDisplayStyle(value && value.displayStyle);
           setStatus({ loading: false, error: "", saving: false, saved: true });
+          setToken(token + 1);
         }).catch(function (error) {
           setStatus({ loading: false, error: String(error && error.message || error), saving: false, saved: false });
         });
       }
+
       function discard() { setDraft(settings); setStatus({ loading: false, error: "", saving: false, saved: false }); }
       function open(kind) {
         call(connection, "open", { kind: kind, path: template }).then(function () {
@@ -791,7 +930,7 @@ window.__ModuleLoader__.load({
         h("div", { style: rowStyle },
           h("div", null,
             h("div", { style: labelStyle }, "生效范围"),
-            h("div", { style: subStyle }, scopePreset ? "仅勾选的预设切到插件并关闭其原生压缩；其余预设保持原生" : "所有带 handoff slot 的可编辑预设都切到插件，共用这份设置")
+            h("div", { style: subStyle }, scopePreset ? "只有勾选的预设由插件压缩，其余预设保持 DSH 原生行为；名单来自 DSH 的预设注册表" : "所有能被本插件接管的预设都由插件压缩，共用这份设置")
           ),
           h("div", { style: { display: "inline-flex", border: "1px solid " + C.line, borderRadius: 8, overflow: "hidden" } },
             seg(!scopePreset, "全局生效", function () { patch({ scope: "global" }); }),
@@ -799,15 +938,51 @@ window.__ModuleLoader__.load({
           )
         ),
         scopePreset ? h("div", { style: { display: "flex", gap: 8, flexWrap: "wrap", padding: "10px 0", borderBottom: "1px solid " + C.line } },
-          PRESETS.map(function (p) {
-            var on = presets.indexOf(p.id) >= 0;
-            return h("button", {
-              key: p.id, type: "button", onClick: function () { setPreset(p.id); },
-              style: { fontSize: 12, padding: "5px 11px", borderRadius: 999, cursor: "pointer", font: "inherit", border: "1px solid " + (on ? C.accent : C.line), background: on ? "rgba(76,141,255,.12)" : "#191a1d", color: on ? C.text : C.muted },
-            }, p.label);
-          })
+          takeable.length === 0
+            ? h("span", { style: subStyle }, scope.loading
+              ? "正在向 DSH 读取预设名单…"
+              : "本插件的接管行还没覆盖到任何预设。重启 DSH 会重新生成接管行；仍未出现预设名单说明 DSH 没有返回预设。")
+            : takeable.map(function (p) {
+                var on = presets.indexOf(p.id) >= 0;
+                return h("button", {
+                  key: p.id, type: "button", onClick: function () { setPreset(p.id); },
+                  style: { fontSize: 12, padding: "5px 11px", borderRadius: 999, cursor: "pointer", font: "inherit", border: "1px solid " + (on ? C.accent : C.line), background: on ? "rgba(76,141,255,.12)" : "#191a1d", color: on ? C.text : C.muted },
+                }, presetLabel(p.id));
+              })
         ) : null,
 
+        h("div", { style: rowStyle },
+          h("div", { style: { minWidth: 0 } },
+            h("div", { style: labelStyle }, "当前生效情况"),
+            h("div", { style: subStyle }, scopeView.sub),
+            scopeView.rows.length
+              ? h("div", { style: { display: "flex", gap: "6px 16px", flexWrap: "wrap", marginTop: 7 } },
+                scopeView.rows.map(function (r) {
+                  return h("span", { key: r.key, style: { display: "inline-flex", alignItems: "center", gap: 6, fontSize: 12, color: C.muted } },
+                    h("i", { "aria-hidden": true, style: { width: 6, height: 6, borderRadius: "50%", background: r.taken ? C.accent : "#6b7178" } }),
+                    r.label,
+                    h("em", { style: { fontStyle: "normal", color: C.faint } }, r.owner));
+                })
+              )
+              : null,
+            pendingNote ? h("div", { style: { fontSize: 11.5, color: "#d29922", marginTop: 6 } }, pendingNote) : null,
+            scope.error && scope.value ? h("div", { style: { fontSize: 11.5, color: "#e5534b", marginTop: 6 } }, "读取失败：" + scope.error) : null
+          ),
+          h("div", { style: { display: "inline-flex", alignItems: "center", gap: 12, flex: "0 0 auto" } },
+            h("span", { "aria-live": "polite", style: { display: "inline-flex", alignItems: "center", gap: 7, fontSize: 12.5, color: scopeTone.text } },
+              h("i", { "aria-hidden": true, style: { width: 7, height: 7, borderRadius: "50%", background: scopeTone.dot } }),
+              scopeView.text
+            ),
+            scopeView.retry && !scope.loading
+              ? h("button", {
+                type: "button",
+                onClick: function () { setToken(token + 1); },
+                style: Object.assign({}, btnBase, { fontSize: 11.5, padding: "4px 9px" }),
+              }, "重新读取")
+              : null
+          )
+        ),
+
         h("div", { style: { padding: "12px 0", borderBottom: "1px solid " + C.line } },
           h("div", null,
             h("div", { style: labelStyle }, "压缩显示方式", h("span", { style: newBadgeStyle }, "新")),
@@ -881,8 +1056,8 @@ window.__ModuleLoader__.load({
           h("ol", { style: { margin: 0, paddingLeft: 18, color: C.muted, fontSize: 12.5, lineHeight: 1.85 } },
             h("li", null, "到点后不立即动手，等 agent 结束当前回合。"),
             h("li", null, "用会话自己的前缀（命中缓存）让模型按模板写交接文档，不额外全量 prefill。"),
-            h("li", null, "把整段历史替换成这一条消息；旧消息仍在会话日志里，rewind 可回滚。"),
-            h("li", null, "下一轮只剩 系统提示词 + 工具定义 + 交接文档。")
+            h("li", null, "只替换最旧的这一段历史，换成一条交接文档；最近约 16% 窗口的原文逐字留着，切点也不会把工具调用和它的结果拆开。"),
+            h("li", null, "下一轮 = 系统提示词 + 工具定义 + 这条交接文档 + 那段逐字保留的最近消息；旧消息仍在会话日志里，rewind 可回滚。")
           ),
           h("div", { style: { marginTop: 8, fontSize: 11.5, color: C.faint } }, "手动压缩：会话里发送 /compact 可随时折叠一次，不受这个比例限制。")
         ),

package/lib/index.js

@@ -17,6 +17,7 @@ import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { execFile, spawn } from "node:child_process";
+import { mountTakeover, presetInventory } from "./takeover-mount.js";
 
 export const name = "dsh-auto-compaction";
 export const inject = [];
@@ -25,7 +26,7 @@ export const Config = z.object({
   enabled: z.boolean().default(true),
   thresholdRatio: z.number().default(90),
   scopePreset: z.boolean().default(false),
-  presets: z.string().default("lightweight-local"),
+  presets: z.string().default(""),
   templateFile: z.string().default(""),
   openTemplate: z.string().default(""),
   displayStyle: z.string().default("orbit"),
@@ -143,9 +144,9 @@ function scopeScriptPath() {
   }
 }
 
-function execSwitchOnce(command, env, script) {
+function execSwitchOnce(command, env, script, action) {
   return new Promise((resolve, reject) => {
-    execFile(command, [script, "enable"], { timeout: 6000, windowsHide: true, env }, (error, stdout, stderr) => {
+    execFile(command, [script, action], { timeout: 6000, windowsHide: true, env }, (error, stdout, stderr) => {
       if (error) {
         error.stdout = stdout;
         error.stderr = stderr;
@@ -158,15 +159,14 @@ function execSwitchOnce(command, env, script) {
 }
 
 /**
- * Apply the current settings sidecar to the preset/profile YAML. `node` is the
- * normal path; the Electron binary with ELECTRON_RUN_AS_NODE is the fallback
- * when the host has no node on PATH.
+ * Run one preset-scope action. `node` is the normal path; the Electron binary
+ * with ELECTRON_RUN_AS_NODE is the fallback when the host has no node on PATH.
  */
-async function applyScopeSwitch() {
+async function runScope(action) {
   const script = scopeScriptPath();
   if (!existsSync(script)) {
     const message = "preset-scope.mjs not found: " + script;
-    trace("scope switch failed: " + message);
+    trace("scope " + action + " failed: " + message);
     return { ok: false, message };
   }
   const explicit = process.env.DSH_NODE;
@@ -179,10 +179,11 @@ async function applyScopeSwitch() {
   let lastError;
   for (const attempt of attempts) {
     try {
-      const result = await execSwitchOnce(attempt.command, attempt.env, script);
-      const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
-      trace("scope switch ok" + (output ? " | " + output : ""));
-      return { ok: true, output };
+      const result = await execSwitchOnce(attempt.command, attempt.env, script, action);
+      const output = `${result.stdout ?? ""}`.trim();
+      const noise = `${result.stderr ?? ""}`.trim();
+      trace("scope " + action + " ok" + (output ? " | " + output : "") + (noise ? " | " + noise : ""));
+      return { ok: true, output, noise };
     } catch (error) {
       lastError = error;
       if (error?.code !== "ENOENT") break;
@@ -190,10 +191,44 @@ async function applyScopeSwitch() {
   }
   const output = `${lastError?.stdout ?? ""}${lastError?.stderr ?? ""}`.trim();
   const message = (lastError?.message ?? String(lastError)) + (output ? "\n" + output : "");
-  trace("scope switch failed: " + message);
+  trace("scope " + action + " failed: " + message);
   return { ok: false, message };
 }
 
+/**
+ * Hand compaction back where the old mechanism left it.
+ *
+ * Up to 0.2.x the takeover was written into the user's own preset files plus a
+ * root-level guard in the profile patch. Those rows now live inside this
+ * package, so a leftover switch would mount two providers in the same realm and
+ * DSH would refuse to start. Detection goes through the script's own read-only
+ * report rather than a second YAML parser; the revert runs once and is recorded
+ * so later boots skip the subprocess entirely.
+ */
+async function revertLegacyTakeover(ctx) {
+  const settings = readSettings();
+  if (settings?.legacyRevertedAt !== undefined) return { reverted: false, skipped: "already" };
+  const state = await runScope("state");
+  if (!state.ok) return { reverted: false, reason: state.message };
+  const line = String(state.output ?? "").split(/\r?\n/).filter(Boolean).pop() ?? "";
+  let value;
+  try {
+    value = JSON.parse(line);
+  } catch {
+    return { reverted: false, reason: "unreadable legacy state" };
+  }
+  const legacy = Number(value?.taken) > 0 || value?.rootGuard === "off";
+  if (!legacy) return { reverted: false, legacy: false };
+
+  const disabled = await runScope("disable");
+  if (!disabled.ok) return { reverted: false, reason: disabled.message };
+
+  writeSettings(ctx, { ...settings, legacyRevertedAt: new Date().toISOString() });
+  trace(`legacy takeover reverted: taken=${value?.taken}/${value?.total} rootGuard=${value?.rootGuard}`);
+  ctx.logger?.info?.("[handoff-ui] 旧版接管残留已恢复为原生压缩（预设文件与根级守卫）");
+  return { reverted: true, taken: value?.taken, total: value?.total };
+}
+
 const CHANNEL = "/dsh-auto-compaction";
 
 function readSettings() {
@@ -224,6 +259,22 @@ function sanitize(payload) {
 export function apply(ctx, config = {}) {
   const seeded = normalize(config);
   if (readSettings() === undefined) writeSettings(ctx, seeded);
+  // Takeover rows are regenerated from the live preset definitions on every
+  // load, into this package's own patch file. Nothing here depends on the
+  // user's scope selection: an unselected preset is handled by the engine
+  // delegating to the stock one, so installing is enough to take over and
+  // uninstalling is enough to hand compaction back.
+  void (async () => {
+    const legacy = await revertLegacyTakeover(ctx);
+    if (legacy.reverted) trace("legacy takeover reverted before mounting");
+    else if (legacy.reason) trace("legacy takeover check skipped: " + legacy.reason);
+    return mountTakeover(ctx);
+  })().then((result) => {
+    trace(`takeover mount ${result.ok ? "ok" : "failed"} taken=${result.taken?.join(",") ?? "-"} mounted=${result.mounted?.join(",") ?? "-"} skipped=${result.skipped?.join(",") ?? "-"} ${result.reason ?? ""}`);
+  }).catch((error) => {
+    trace("takeover mount threw: " + (error instanceof Error ? error.message : String(error)));
+    ctx.logger?.warn?.(`[handoff-ui] takeover mount failed: ${error instanceof Error ? error.message : String(error)}`);
+  });
   void handleOpen(ctx, config.openTemplate, seeded.templateFile || TEMPLATE_FILE).catch((error) => {
     ctx.logger?.warn?.(`[handoff-ui] openTemplate failed: ${error instanceof Error ? error.message : String(error)}`);
   });
@@ -259,11 +310,29 @@ export function apply(ctx, config = {}) {
             const next = sanitize(payload);
             trace("set " + JSON.stringify(next));
             writeSettings(ctx, next);
-            const applied = await applyScopeSwitch();
-            if (!applied.ok) {
-              return { ok: false, error: { code: "auto-compaction/switch-failed", message: applied.message }, value: next };
+            // No rewriting of preset files: the engine applies the switch and
+            // the scope per preset at decision time, so a save is live at the
+            // next idle check and uninstalling still leaves nothing behind.
+            return { ok: true, value: { ...next, defaultTemplate: TEMPLATE_FILE } };
+          }
+          if (endpoint === "scope") {
+            const stored = readSettings() ?? seeded;
+            try {
+              const inventory = await presetInventory(ctx, stored);
+              return {
+                ok: true,
+                value: {
+                  enabled: stored.enabled !== false,
+                  scope: stored.scope === "preset" ? "preset" : "global",
+                  source: "bundle-patch",
+                  ...inventory,
+                },
+              };
+            } catch (error) {
+              const message = error instanceof Error ? error.message : String(error);
+              trace("scope inventory failed: " + message);
+              return { ok: false, error: { code: "auto-compaction/scope-unknown", message } };
             }
-            return { ok: true, value: { ...next, switchApplied: true, defaultTemplate: TEMPLATE_FILE } };
           }
           if (endpoint === "open") {
             trace("open " + JSON.stringify(payload));

package/lib/takeover-mount.js

@@ -0,0 +1,306 @@
+/**
+ * Mount the takeover, in this package's own patch file.
+ *
+ * The rows that hand compaction over to this plugin live in the bundle patch
+ * shipped inside the package, because that is the only place uninstalling
+ * removes them automatically: DSH's uninstall neither clears nor refuses
+ * config-replacement rows in a user's own patch, so writing them there would
+ * leave a preset pointing at a package that no longer exists — a broken
+ * compaction setup the user cannot see. Writing here costs nothing on removal.
+ *
+ * Rows are generated from the live preset definitions rather than baked in, so
+ * a preset that gains a tool in a later DSH release keeps it. The generator
+ * lives in the engine package and is loaded lazily: DSH's host module fallback
+ * cannot resolve a linked package's subpath from here, and a top-level import
+ * blocks startup.
+ */
+import { createRequire } from "node:module";
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+const requireFromHere = createRequire(import.meta.url);
+
+/** The patch file this package is mounted from. */
+function patchFile() {
+  const override = process.env.DSH_HANDOFF_TAKEOVER_FILE;
+  if (typeof override === "string" && override.trim().length > 0) return override.trim();
+  return join(dirname(requireFromHere.resolve("../package.json")), "cordis.patch.yml");
+}
+
+/**
+ * Load the row generator without importing the engine package statically.
+ * @returns the module, or undefined when it cannot be resolved.
+ */
+async function loadGenerator() {
+  // Dynamic import rather than createRequire: the generator is ESM. Installed,
+  // the engine sits beside this package in the same node_modules and publishes
+  // ./lib/*; in development it is the monorepo sibling, since the workspace
+  // installs nothing and everything runs through junctions.
+  for (const attempt of [
+    () => import("dsh-auto-compaction-engine/lib/takeover-rows.js"),
+    () => import("../../dsh-auto-compaction-engine/lib/takeover-rows.js"),
+  ]) {
+    try {
+      return await attempt();
+    } catch { /* try the next location */ }
+  }
+  return undefined;
+}
+
+/** The profile manifest DSH composes its layers from. */
+function profileManifest() {
+  const override = process.env.DSH_PROFILE_MANIFEST;
+  if (typeof override === "string" && override.trim().length > 0) return override.trim();
+  const appData = process.env.APP_DATA
+    ?? path.join(process.env.SystemDrive ?? "C:", "Users", process.env.USERNAME ?? process.env.USER ?? "", "AppData", "Roaming");
+  return path.join(appData, "dsh-desktop", "harness", "profiles", "web", "package.json");
+}
+
+/**
+ * Keep this package's patch layer behind every preset declaration.
+ *
+ * Layer order is the order of `dsh.profile.bundles`, and a takeover row is an
+ * update of a preset row that has to exist by the time our layer applies:
+ * presets declared by a later layer would leave our row with nothing to point
+ * at, silently. DSH's own presets come early, but a preset installed from the
+ * market or written by the user can come after us, so the entry belongs last.
+ *
+ * The desktop market appends newly installed bundles to the end, so this is a
+ * no-op for a fresh install; it matters when another plugin is installed after
+ * us. Verified on this machine: without the entry 4 of 6 presets mounted, with
+ * it at the end all 6 did.
+ *
+ * Text surgery rather than a JSON rewrite, because this file is the user's and
+ * the market rewrites it too.
+ */
+export function ensureBundleLayer(text, name = "dsh-auto-compaction") {
+  if (typeof text !== "string" || text.length === 0) return { text, changed: false, reason: "manifest unreadable" };
+  const start = text.indexOf("\"bundles\"");
+  const open = start < 0 ? -1 : text.indexOf("[", start);
+  const close = open < 0 ? -1 : text.indexOf("]", open);
+  if (close < 0) return { text, changed: false, reason: "no dsh.profile.bundles array" };
+  const body = text.slice(open + 1, close);
+  const entries = [...body.matchAll(/"([^"]+)"/g)].map((m) => m[1]);
+  if (entries.length > 0 && entries[entries.length - 1] === name) return { text, changed: false, reason: "" };
+
+  const kept = entries.filter((entry) => entry !== name);
+  const rebuilt = kept.length === 0 ? `["${name}"]` : `[\n${kept.concat([name]).map((entry) => `      "${entry}"`).join(",\n")}\n    ]`;
+  return { text: text.slice(0, open) + rebuilt + text.slice(close + 1), changed: true, reason: "" };
+}
+
+/** Apply the layer rule to the profile manifest, writing only on change. */
+export function ensureBundleLayerFile() {
+  const file = profileManifest();
+  let text = "";
+  try {
+    text = readFileSync(file, "utf8");
+  } catch (error) {
+    return { ok: false, file, reason: `manifest missing: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  const result = ensureBundleLayer(text);
+  if (!result.changed) return { ok: true, file, changed: false, reason: result.reason };
+  try {
+    JSON.parse(result.text);
+  } catch (error) {
+    return { ok: false, file, reason: `refusing to write invalid JSON: ${error.message}` };
+  }
+  const tmp = `${file}.tmp`;
+  writeFileSync(tmp, result.text, "utf8");
+  renameSync(tmp, file);
+  return { ok: true, file, changed: true };
+}
+
+/**
+ * Ask DSH which agent presets exist and what each one currently declares.
+ *
+ * `list()` publishes the display metadata ({id, name, description, order,
+ * broken?}) and `readDocument()` the plugin list as a YAML string; a preset's
+ * config is exactly `{id, name, description, order, plugins}`, so the two
+ * together are the whole definition and nothing here is guessed.
+ */
+async function readPresets(ctx, generator) {
+  let service;
+  try {
+    service = ctx.get?.("agentPresets");
+  } catch {
+    return { presets: [], failures: [], reason: "agentPresets service unavailable" };
+  }
+  if (service === undefined || typeof service.list !== "function") {
+    return { presets: [], failures: [], reason: "agentPresets service has no list()" };
+  }
+  if (generator === undefined) {
+    return { presets: [], failures: [], reason: "row generator not resolvable" };
+  }
+  let listed;
+  try {
+    listed = await service.list();
+  } catch (error) {
+    return { presets: [], failures: [], reason: `list() failed: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  const entries = Array.isArray(listed) ? listed : Array.isArray(listed?.presets) ? listed.presets : [];
+  const presets = [];
+  const failures = [];
+  for (const entry of entries) {
+    const id = typeof entry?.id === "string" && entry.id.length > 0 ? entry.id : undefined;
+    if (id === undefined) continue;
+    let document;
+    try {
+      document = typeof service.readDocument === "function" ? await service.readDocument(id) : undefined;
+    } catch (error) {
+      failures.push(`${id}: ${error instanceof Error ? error.message : String(error)}`);
+      continue;
+    }
+    const parsed = generator.parsePlugins(document?.content);
+    if (parsed.plugins === undefined) {
+      failures.push(`${id}: ${parsed.reason}`);
+      continue;
+    }
+    const config = { id };
+    for (const key of ["name", "description", "order"]) {
+      if (entry[key] !== undefined) config[key] = entry[key];
+    }
+    config.plugins = parsed.plugins;
+    presets.push({
+      id,
+      config,
+      label: typeof entry.name === "string" && entry.name.length > 0 ? entry.name : id,
+      // What the composition actually registers, and whether it failed to.
+      provider: generator.compactionProvider?.(config)?.name ?? "",
+      broken: typeof entry.broken === "string" ? entry.broken : "",
+    });
+  }
+  return { presets, failures };
+}
+
+/** Write the managed block, atomically, only when it actually changed. */
+function writeBlock(text, file) {
+  const tmp = `${file}.tmp`;
+  writeFileSync(tmp, text, "utf8");
+  renameSync(tmp, file);
+}
+
+/**
+ * Regenerate the takeover rows at activation.
+ *
+ * @returns {ok, file, taken, skipped, reason} for the log and the settings page.
+ */
+export async function mountTakeover(ctx) {
+  const generator = await loadGenerator();
+  if (generator === undefined) {
+    return { ok: false, reason: "row generator not resolvable", taken: [], skipped: [] };
+  }
+  const file = patchFile();
+  let current = "";
+  try {
+    current = readFileSync(file, "utf8");
+  } catch {
+    current = "";
+  }
+
+  const { presets, failures = [], reason = "" } = await readPresets(ctx, generator);
+  if (presets.length === 0) {
+    // Nothing could be read: leave the file as it is rather than wiping the
+    // shipped rows on a transient host failure.
+    return { ok: false, file, taken: [], skipped: [], reason: reason || failures[0] || "no presets declared" };
+  }
+
+  const engineName = process.env.DSH_HANDOFF_ENGINE_NAME ?? "dsh-auto-compaction-engine";
+  const layer = ensureBundleLayerFile();
+  if (layer.changed) ctx.logger?.info?.(`[handoff-ui] bundle layer moved to the end of dsh.profile.bundles`);
+  else if (layer.reason) ctx.logger?.warn?.(`[handoff-ui] bundle layer left as is: ${layer.reason}`);
+  const rows = generator.takeoverRows(presets, { engineName });
+  const taken = rows.map((row) => String(row.id).replace(/^preset-/, ""));
+  const skipped = presets.map((preset) => preset.id).filter((id) => !taken.includes(id));
+  /* Written rows and effective rows are different facts: the composition reads
+   * the patch at startup, so rows first written by this activation only take
+   * effect next boot. Reporting both is what keeps the settings page honest. */
+  const mounted = presets.filter((preset) => preset.provider === engineName).map((preset) => preset.id);
+  const broken = presets.filter((preset) => preset.broken).map((preset) => `${preset.id}: ${preset.broken}`);
+  /* Saying which presets were left out and why is the difference between an
+   * honest "not taken over" and a silent one. */
+  const skippedReasons = presets
+    .filter((preset) => !taken.includes(preset.id))
+    .map((preset) => {
+      const unsupported = generator.findUnsupported?.(preset.config ?? {});
+      return `${preset.id}: ${unsupported ? `含无法原样重写的值（${unsupported}）` : "没有可接管的 compaction 组"}`;
+    });
+  const notes = [];
+  if (failures.length > 0) notes.push(`unreadable: ${failures.join("; ")}`);
+  if (skippedReasons.length > 0) notes.push(`skipped: ${skippedReasons.join("; ")}`);
+  if (broken.length > 0) notes.push(`broken: ${broken.join("; ")}`);
+  const block = generator.renderBlock(rows);
+
+  // Nothing to take over and nothing recorded before: leave the shipped file
+  // alone rather than appending an empty block.
+  if (rows.length === 0 && !current.includes(generator.BLOCK_MARKERS.BEGIN)) {
+    return { ok: true, file, taken: [], skipped, mounted, broken, reason: notes.join(" | ") };
+  }
+  if (generator.needsRewrite(current, block)) {
+    try {
+      writeBlock(generator.mergeBlock(current, block), file);
+      ctx.logger?.info?.(`[handoff-ui] takeover rows written to ${file} (${taken.length} preset(s))`);
+    } catch (error) {
+      return {
+        ok: false, file, taken, skipped,
+        reason: `patch write failed: ${error instanceof Error ? error.message : String(error)}`,
+      };
+    }
+  }
+  return { ok: true, file, taken, skipped, mounted, broken, reason: notes.join(" | ") };
+}
+
+/** Which presets the shipped block currently covers. */
+export async function readTakenPresets() {
+  const generator = await loadGenerator();
+  const file = patchFile();
+  if (generator === undefined) return [];
+  let text = "";
+  try {
+    text = readFileSync(file, "utf8");
+  } catch {
+    return [];
+  }
+  const { BEGIN, END } = generator.BLOCK_MARKERS;
+  const begin = text.indexOf(BEGIN);
+  const end = text.indexOf(END);
+  if (begin < 0 || end < 0 || end < begin) return [];
+  return [...text.slice(begin + BEGIN.length, end).matchAll(/^-\s+id:\s*preset-(\S+)/gm)].map((m) => m[1]);
+}
+
+/**
+ * Everything the settings page needs to answer "who compacts each preset".
+ *
+ * `covered` is what the block in this package's patch reaches; `effective` adds
+ * the runtime gates the engine applies per preset (the switch and the scope).
+ */
+export async function presetInventory(ctx, settings = {}) {
+  const generator = await loadGenerator();
+  const covered = new Set(await readTakenPresets());
+  const { presets, failures = [], reason = "" } = await readPresets(ctx, generator);
+  const selected = new Set(Array.isArray(settings.presets) ? settings.presets : []);
+  const global = settings.scope !== "preset";
+  const enabled = settings.enabled !== false;
+  const rows = presets.map((preset) => {
+    const isCovered = covered.has(preset.id);
+    const isSelected = global ? isCovered : isCovered && selected.has(preset.id);
+    return {
+      id: preset.id,
+      label: typeof preset.label === "string" ? preset.label : undefined,
+      covered: isCovered,
+      selected: isSelected,
+      effective: isSelected && enabled,
+      // Whether this boot's composition already registers our provider; a row
+      // written during this activation only shows up here after a restart.
+      mounted: preset.provider === (process.env.DSH_HANDOFF_ENGINE_NAME ?? "dsh-auto-compaction-engine"),
+      broken: preset.broken || undefined,
+    };
+  });
+  return {
+    presets: rows,
+    total: rows.length,
+    covered: rows.filter((row) => row.covered).length,
+    mounted: rows.filter((row) => row.mounted).length,
+    effective: rows.filter((row) => row.effective).length,
+    reason: reason || (failures.length > 0 ? `unreadable: ${failures.join("; ")}` : ""),
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-compaction",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -51,6 +51,6 @@
     "access": "public"
   },
   "dependencies": {
-    "dsh-auto-compaction-engine": "^0.2.1"
+    "dsh-auto-compaction-engine": "^0.2.3"
   }
 }