dsh-plugin-tool-management 0.7.0 → 0.8.0

package/lib/subagents/service.js

@@ -130,26 +130,98 @@ export function parsePersona(raw, fallbackName) {
 const RESULT_MAX = 16 * 1024;
 export function createSubagentService(ctx, opts) {
     const dir = opts?.subagentsDir || defaultPersonasDir();
+    const stateDir = opts?.stateDir && opts.stateDir.trim() !== '' ? opts.stateDir : join(resolveDshHome(), 'tool-management');
+    const stateFile = join(stateDir, 'agents-index.json');
     const req = createRequire(import.meta.url);
     let cache = null;
-    async function list() {
-        if (cache && Date.now() - cache.at < 1000)
-            return cache.value;
-        // 旧目录搬家放在首次扫描前（幂等；失败不阻断，旧目录仍会被下面的读取兜底看到）。
-        await relocateLegacyPersonas(dir).catch(() => undefined);
-        const docs = [];
+    // ── 人设启用集合（子智能体开关）────────────────────────────────────────
+    // agents-index.json：{ version: 1, enabled: string[] }（与 rules-index.json 同目录约定）。
+    //   - 文件缺失/损坏 = **全部启用**（老用户升级零感知，行为与开关上线前一致）；
+    //   - 文件一旦写出即为权威：之后新建/导入/回收站恢复的人设**自动启用**（刚建就想用是常理）；
+    //   - 停用只影响注入与 subagent_* 工具的可见性，人设文件一个字节不动。
+    // 缓存约定：undefined = 还没读过盘；null = 文件缺失（全部启用）；数组 = 权威集合。
+    let enabledCache = undefined;
+    async function readEnabled() {
+        if (enabledCache !== undefined)
+            return enabledCache;
+        // 用局部变量过渡：await 之后 TS 对闭包级缓存变量的收窄会失效，直接返回会报 undefined。
+        let next;
         try {
-            const entries = await readdir(dir);
-            for (const fileName of entries.filter((e) => e.endsWith('.md')).sort()) {
-                const raw = await readFile(join(dir, fileName), 'utf8').catch(() => '');
-                if (!raw.trim())
-                    continue;
-                docs.push({ ...parsePersona(raw, fileName.slice(0, -3)), path: join(dir, fileName) });
+            const raw = JSON.parse(await readFile(stateFile, 'utf8'));
+            next = Array.isArray(raw && raw.enabled) ? raw.enabled.map((x) => String(x)) : [];
+        }
+        catch {
+            next = null;
+        }
+        enabledCache = next;
+        return next;
+    }
+    async function writeEnabled(list) {
+        await mkdir(stateDir, { recursive: true });
+        await writeFile(stateFile, JSON.stringify({ version: 1, enabled: list }, null, 2), 'utf8');
+        enabledCache = list;
+    }
+    /** 新建/导入/恢复的人设默认启用；文件缺失（本来就全启用）时无需写。 */
+    async function enablePersonaNames(names) {
+        const set = await readEnabled();
+        if (set === null)
+            return;
+        let dirty = false;
+        for (const n of names)
+            if (set.indexOf(n) < 0) {
+                set.push(n);
+                dirty = true;
             }
+        if (dirty)
+            await writeEnabled(set);
+    }
+    /** 改名跟随：旧名在集合里就改新名；不在（停用中）保持停用。 */
+    async function renamePersonaInEnabled(from, to) {
+        const set = await readEnabled();
+        if (set === null)
+            return;
+        const i = set.indexOf(from);
+        if (i < 0)
+            return;
+        set[i] = to;
+        await writeEnabled(set);
+    }
+    /** 删除后从集合摘掉，别留悬空名（列表时无害，但会让集合越攒越脏）。 */
+    async function removePersonaFromEnabled(name) {
+        const set = await readEnabled();
+        if (set === null || set.indexOf(name) < 0)
+            return;
+        await writeEnabled(set.filter((n) => n !== name));
+    }
+    /** list() 输出统一附上 enabled：文件缺失 → 全 true；否则按集合。 */
+    function withEnabled(docs, set) {
+        if (set === null)
+            return docs.map((d) => ({ ...d, enabled: true }));
+        return docs.map((d) => ({ ...d, enabled: set.indexOf(d.name) >= 0 }));
+    }
+    async function list() {
+        let docs;
+        if (cache && Date.now() - cache.at < 1000) {
+            docs = cache.value;
         }
-        catch { /* 目录缺失 = 无人设 */ }
-        cache = { at: Date.now(), value: docs };
-        return docs;
+        else {
+            // 旧目录搬家放在首次扫描前（幂等；失败不阻断，旧目录仍会被下面的读取兜底看到）。
+            await relocateLegacyPersonas(dir).catch(() => undefined);
+            const fresh = [];
+            try {
+                const entries = await readdir(dir);
+                for (const fileName of entries.filter((e) => e.endsWith('.md')).sort()) {
+                    const raw = await readFile(join(dir, fileName), 'utf8').catch(() => '');
+                    if (!raw.trim())
+                        continue;
+                    fresh.push({ ...parsePersona(raw, fileName.slice(0, -3)), path: join(dir, fileName) });
+                }
+            }
+            catch { /* 目录缺失 = 无人设 */ }
+            cache = { at: Date.now(), value: fresh };
+            docs = fresh;
+        }
+        return withEnabled(docs, await readEnabled());
     }
     // spawn provider 在场性（设计 §3.2，落地方式见 cordis.patch.yml 的取舍注释）：
     // 官方通道探测（ctx.subagents.list()）→ 缺失才挂载 → 失败把原因原样带出（不吞、不谎报）。
@@ -254,7 +326,7 @@ export function createSubagentService(ctx, opts) {
             const docs = await list();
             return {
                 ok: true,
-                subagents: docs.map((p) => ({ name: p.name, description: p.description, provider: p.provider ?? null, model: p.model ?? null, tools: p.tools ?? null, toolsDeny: p.toolsDeny ?? null, toolsByPreset: p.toolsByPreset ?? null })),
+                subagents: docs.map((p) => ({ name: p.name, enabled: p.enabled !== false, description: p.description, provider: p.provider ?? null, model: p.model ?? null, tools: p.tools ?? null, toolsDeny: p.toolsDeny ?? null, toolsByPreset: p.toolsByPreset ?? null })),
             };
         },
         'subagent-get': async (args) => {
@@ -282,9 +354,17 @@ export function createSubagentService(ctx, opts) {
                 return { ok: false, error: `创建人设目录失败: ${dir}（${message(e)}）` };
             }
             await writeFile(target, serializePersona(args), 'utf8');
+            // 新建即启用（文件缺失 = 本来全启用，无需写）；缓存失效让下次 list 带上新成员。
+            await enablePersonaNames([name]).catch(() => undefined);
             cache = null;
             return { ok: true, name };
         },
+        /**
+         * 保存人设，**可选改名**（nextName）。
+         * 人设名就是文件名（`agents/<名>.md`），所以改名 = 重命名文件；
+         * 目标名已存在直接拒绝，绝不覆盖别人的文件。
+         * 返回 `renamedFrom` 供调用方把场景档案里的绑定一起改掉（档案存的是人设名）。
+         */
         'subagent-update': async (args) => {
             const name = String((args && args.name) || '').trim();
             if (!validPersonaName(name))
@@ -293,9 +373,31 @@ export function createSubagentService(ctx, opts) {
             const exists = await readFile(target, 'utf8').then(() => true).catch(() => false);
             if (!exists)
                 return { ok: false, error: `人设不存在: ${name}` };
-            await writeFile(target, serializePersona(args), 'utf8');
+            let finalName = name;
+            let renamedFrom;
+            const nextRaw = args && args.nextName !== undefined ? String(args.nextName).trim() : '';
+            if (nextRaw !== '' && nextRaw !== name) {
+                if (!validPersonaName(nextRaw)) {
+                    return { ok: false, error: `新人设名不合法: ${nextRaw}（非空、≤64 字符、不含路径分隔符与 < > : " | ? *、不以 . 开头）` };
+                }
+                const nextTarget = join(dir, nextRaw + '.md');
+                const taken = await readFile(nextTarget, 'utf8').then(() => true).catch(() => false);
+                if (taken)
+                    return { ok: false, error: `人设已存在: ${nextRaw}` };
+                try {
+                    await rename(target, nextTarget);
+                }
+                catch (e) {
+                    return { ok: false, error: `人设改名失败: ${message(e)}` };
+                }
+                finalName = nextRaw;
+                renamedFrom = name;
+            }
+            await writeFile(join(dir, finalName + '.md'), serializePersona({ ...args, name: finalName }), 'utf8');
+            if (renamedFrom)
+                await renamePersonaInEnabled(renamedFrom, finalName).catch(() => undefined);
             cache = null;
-            return { ok: true, name };
+            return { ok: true, name: finalName, ...(renamedFrom ? { renamedFrom } : {}) };
         },
         /**
          * 删除人设 = **移入回收站**（`hub/trash/agents-trash/<id>/persona.md`）。
@@ -313,6 +415,7 @@ export function createSubagentService(ctx, opts) {
             const moved = await moveToTrash('agents', name, [{ from: target, dest: 'persona.md' }]);
             if (moved.ok === false)
                 return { ok: false, error: `移入回收站失败: ${moved.error}` };
+            await removePersonaFromEnabled(name).catch(() => undefined);
             cache = null;
             return { ok: true, name, trashId: moved.id };
         },
@@ -337,6 +440,8 @@ export function createSubagentService(ctx, opts) {
                 return { ok: false, error: `恢复失败: ${message(e)}` };
             }
             await purgeTrashEntry('agents', id);
+            // 恢复 = 拿回来用：自动启用（文件缺失本来就全启用，无需写）。
+            await enablePersonaNames([entry.name]).catch(() => undefined);
             cache = null;
             return { ok: true, name: entry.name };
         },
@@ -386,12 +491,76 @@ export function createSubagentService(ctx, opts) {
                 }
                 imported.push(target.name);
             }
-            if (imported.length)
+            if (imported.length) {
+                await enablePersonaNames(imported).catch(() => undefined);
                 cache = null;
+            }
             return { ok: true, imported, skipped };
         },
+        /**
+         * 子智能体开关（v0.8）：停用 = 不注入目录段、subagent_list/run 不可见；文件本体不动。
+         * `enabled` 必须显式给布尔值 —— 与 rules-toggle 同一条口径：不按"翻转"推断，
+         * 免得参数丢了时界面以为改了、实际什么都没动。
+         */
+        'subagent-toggle': async (args) => {
+            const name = String((args && args.name) || '').trim();
+            if (!validPersonaName(name))
+                return { ok: false, error: `人设名不合法: ${name || '(空)'}` };
+            if (typeof (args && args.enabled) !== 'boolean') {
+                return { ok: false, error: '缺少参数：enabled 必须是布尔值（只按传入值写入，不做"翻转"推断）' };
+            }
+            const docs = await list();
+            if (!docs.some((d) => d.name === name))
+                return { ok: false, error: `人设不存在: ${name}` };
+            const set = await readEnabled();
+            // 文件缺失 = 当前全启用：首次开关时把现状物化成显式集合（否则"部分停用"无处落笔）。
+            const base = (set === null ? docs.map((d) => d.name) : set.slice()).filter((n) => docs.some((d) => d.name === n));
+            const i = base.indexOf(name);
+            if (args.enabled === true) {
+                if (i < 0)
+                    base.push(name);
+            }
+            else if (i >= 0) {
+                base.splice(i, 1);
+            }
+            await writeEnabled(base);
+            cache = null;
+            return { ok: true, name, enabled: args.enabled === true };
+        },
+    };
+    const enabledStore = {
+        /** 指定名单里当前被停用的（进入模式拍快照用：只记将被启用的行，退出时精确停回）。 */
+        async disabledAmong(names) {
+            const docs = await list();
+            const state = new Map(docs.map((d) => [d.name, d.enabled !== false]));
+            return names.filter((n) => state.get(n) === false);
+        },
+        /** 批量启停；只碰给出的名字，人设已不存在的跳过（别把悬空名写进集合）。 */
+        async setEnabled(names, enabled) {
+            const docs = await list();
+            const set = await readEnabled();
+            const base = (set === null ? docs.map((d) => d.name) : set.slice()).filter((n) => docs.some((d) => d.name === n));
+            let dirty = false;
+            for (const n of names) {
+                if (!docs.some((d) => d.name === n))
+                    continue;
+                const i = base.indexOf(n);
+                if (enabled && i < 0) {
+                    base.push(n);
+                    dirty = true;
+                }
+                if (!enabled && i >= 0) {
+                    base.splice(i, 1);
+                    dirty = true;
+                }
+            }
+            if (dirty) {
+                await writeEnabled(base);
+                cache = null;
+            }
+        },
     };
-    return { list, runSerial, ops, writeOps: new Set(['subagent-create', 'subagent-update', 'subagent-delete', 'subagent-import', 'subagent-trash-restore', 'subagent-trash-delete']) };
+    return { list, runSerial, ops, enabledStore, writeOps: new Set(['subagent-create', 'subagent-update', 'subagent-delete', 'subagent-import', 'subagent-toggle', 'subagent-trash-restore', 'subagent-trash-delete']) };
 }
 function validPersonaName(name) {
     return name.length > 0 && name.length <= 64 && !name.startsWith('.') && !/[\\/<>:"|?*]/.test(name);

package/lib/subagents/tools.js

@@ -1,12 +1,19 @@
 export function text(v) {
     return [{ type: 'text', text: v }];
 }
-/** 场景绑定校验（设计 §3.3）：启用场景的 subagents 并集；空并集 = 全部可用。 */
+/**
+ * 可见性过滤（两道闸，按序）：
+ *   ① 人设开关（全局）：停用的绝不进上下文 —— 即便它被场景绑定（场景启动时会自动把
+ *      绑定的人设启用，见 archive-engine 的 applySubagentSwitches）。
+ *   ② 场景绑定校验（设计 §3.3）：启用场景的 subagents 并集；空并集 = 全部可用。
+ * 之前只有②：全局默认所有子智能体都进上下文，没有开关可言。
+ */
 export async function filterBySceneBinding(docs, enabledSceneLists) {
+    const live = docs.filter((d) => d.enabled !== false);
     const bound = new Set(enabledSceneLists.flat());
     if (!bound.size)
-        return { allowed: docs, reason: null };
-    const allowed = docs.filter((d) => bound.has(d.name));
+        return { allowed: live, reason: null };
+    const allowed = live.filter((d) => bound.has(d.name));
     return { allowed, reason: allowed.length ? null : `当前启用场景的子智能体绑定: ${[...bound].join('、')}` };
 }
 export function defineSubagentListTool(subagents) {

package/package.json

@@ -1,97 +1,97 @@
-{
-  "name": "dsh-plugin-tool-management",
-  "version": "0.7.0",
-  "description": "DSH plugin: one settings panel for MCP servers, Skills, AGENTS.md presets, archived sessions and scene memories — plus scene memory injected into the system prompt and one-shot persona subagents. Settings UI + HTTP API + 14 model tools (skill_mcp_manager_*, skill_manager_*, agentsmd_*, rule_manager_*, subagent_*). Install with one command: dsh plugin --profile web add dsh-plugin-tool-management@latest",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ouli-1242/dsh-plugin-tool-management"
-  },
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./workspace": "./lib/history/workspace.js",
-    "./projcache": "./lib/history/projcache.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README_EN.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "screenshots.json",
-    "docs"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/sync-client.mjs",
-    "build:client": "node scripts/sync-client.mjs",
-    "prepublishOnly": "npm run build",
-    "lint": "node --check lib/client.js && node --check lib/index.js",
-    "check:i18n": "node scripts/check-i18n.mjs src/client.js",
-    "check:host": "node scripts/host-deps.mjs && node scripts/doctor.mjs",
-    "host-deps": "node scripts/host-deps.mjs --fix",
-    "doctor": "node scripts/doctor.mjs",
-    "test": "npm run build && npm run check:i18n && node --test test/archive.test.mjs test/import.test.mjs test/approval-policy.test.mjs test/subagent-scene.test.mjs test/subagent-persona.test.mjs test/hub-layout.test.mjs test/skills-state.test.mjs test/skills-delete.test.mjs test/skills-source-remove.test.mjs test/client-exports.test.mjs test/client-render.test.mjs test/compat-probe.test.mjs test/compat-fallback.test.mjs test/preset-reach.test.mjs test/rules-toggle-args.test.mjs"
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "skill",
-    "skills",
-    "mcp",
-    "mcp-server",
-    "plugin",
-    "cordis"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ]
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-spill-local": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-session-projection-cache": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-storage-domain": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2 <0.2.0-0",
-    "react": "^18.2.0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-subagent-spawn-in-process": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-spill-local": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
-    "@types/node": "^24.0.0",
-    "typescript": "^6.0.0"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "fflate": "^0.8.3"
-  }
-}
+{
+  "name": "dsh-plugin-tool-management",
+  "version": "0.8.0",
+  "description": "DSH plugin: one settings panel for MCP servers, Skills, AGENTS.md presets, archived sessions and scene memories — plus scene memory injected into the system prompt and one-shot persona subagents. Settings UI + HTTP API + 14 model tools (skill_mcp_manager_*, skill_manager_*, agentsmd_*, rule_manager_*, subagent_*). Install with one command: dsh plugin --profile web add dsh-plugin-tool-management@latest",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ouli-1242/dsh-plugin-tool-management"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./workspace": "./lib/history/workspace.js",
+    "./projcache": "./lib/history/projcache.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README_EN.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "screenshots.json",
+    "docs"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/sync-client.mjs",
+    "build:client": "node scripts/sync-client.mjs",
+    "prepublishOnly": "npm run build",
+    "lint": "node --check lib/client.js && node --check lib/index.js",
+    "check:i18n": "node scripts/check-i18n.mjs src/client.js",
+    "check:host": "node scripts/host-deps.mjs && node scripts/doctor.mjs",
+    "host-deps": "node scripts/host-deps.mjs --fix",
+    "doctor": "node scripts/doctor.mjs",
+    "test": "npm run build && npm run check:i18n && node --test test/archive.test.mjs test/import.test.mjs test/approval-policy.test.mjs test/subagent-scene.test.mjs test/subagent-persona.test.mjs test/hub-layout.test.mjs test/skills-state.test.mjs test/skills-delete.test.mjs test/skills-source-remove.test.mjs test/client-exports.test.mjs test/client-render.test.mjs test/compat-probe.test.mjs test/compat-fallback.test.mjs test/preset-reach.test.mjs test/rules-toggle-args.test.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "skill",
+    "skills",
+    "mcp",
+    "mcp-server",
+    "plugin",
+    "cordis"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-spill-local": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-session-projection-cache": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2 <0.2.0-0",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-subagent-spawn-in-process": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-spill-local": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "fflate": "^0.8.3"
+  }
+}

package/lib/rules/provider.js

@@ -1,121 +0,0 @@
-// dsh-plugin-tool-management —— 规则「自动在场层」投影（systemPrompt 段注册）。
-//
-// 变更单 01 的核心：把规则从"投影为 skill 目录条目（模型按需 load）"改为
-// **投影为 system prompt 段（自动在场）**。前者即使命中，模型也要自己决定看不看，
-// 正是用户抱怨的"每次都要解释"。
-//
-// 官方接口语义（@deepseek-ai/dsh-system-prompt）：
-//   - `section({ name, order, text })` 在**调用者的 scope** 注册；scoped 段遮蔽同名全局段。
-//   - `text` 可以是**每次装配时求值的 provider 函数** → 切换启用场景后**下一个请求即生效**，
-//     无需重开会话、无需重载插件。
-//   - `renderPrompt` 会**删除空段** → 无启用场景/空目录时返回 `''`，不产生空标题。
-//
-// 为什么注册两处（全局 + per-agent）：
-//   全局注册覆盖所有 agent（含子 agent）；per-agent 注册保证即使插件 ctx 自带 scope
-//   （全局段对某些 agent 不可见）也能命中 —— 两者同名，scoped 遮蔽全局，不会重复注入。
-//
-// 缓存契约（§5.2）：段文本是**会话级恒定**的（只由启用场景与文件内容决定），
-// 因此前缀逐字节稳定 → 前缀缓存可命中；禁止在段里放时间戳/计数/相对时间。
-const SECTION_NAME = 'tool-management:scene-memory';
-/**
- * §5.1 硬约束 2：官方 `SECTION_ORDERS` 里 2901–4999 是空档（TOOL_REPORT 2900 →
- * TOOLS_SDK 5000），取 **3000** —— 语义上是"工具能力说明之后、输出与 SDK 约定之前"，
- * 且远离任何既有段。**不要**用官方已有数值（同号按名称排序，虽确定但难读，日后易撞）。
- */
-const SECTION_ORDER = 3000;
-const GLOBAL_KEY = '@global';
-/** 取 scope 上的 systemPrompt 服务（Cordis 的 ctx.get 可能抛错，全部吞掉）。 */
-function systemPromptOf(scope) {
-    if (!scope)
-        return undefined;
-    try {
-        if (typeof scope.get === 'function')
-            return scope.get('systemPrompt');
-        return scope.systemPrompt;
-    }
-    catch {
-        return undefined;
-    }
-}
-/** 注册全局 + agent-scope 的场景记忆段与场景提示词段。 */
-export function createRuleProviderRegistrar(ctx, facade) {
-    const registrations = new Map();
-    const install = (scope, key) => {
-        if (!scope || registrations.has(key))
-            return;
-        const systemPrompt = systemPromptOf(scope);
-        if (!systemPrompt || typeof systemPrompt.section !== 'function')
-            return;
-        try {
-            const dispose = systemPrompt.section({
-                name: SECTION_NAME,
-                order: SECTION_ORDER,
-                // 每次装配重读活动场景 → 切换启用状态后下一个请求即生效。
-                // ⚠️ 硬约束 1：必须**同步返回 string**（不能是 Promise）——异步读取会破坏 renderPrompt。
-                text: () => facade.renderActiveScenes(),
-            });
-            registrations.set(key, { scope, dispose: typeof dispose === 'function' ? dispose : () => { } });
-        }
-        catch (e) {
-            // 同层重名注册会抛错：降级为"该段不注入"，不影响其余 scope。
-            console.error(`[dsh-plugin-tool-management] ${SECTION_NAME} section registration failed:`, String((e && e.message) || e));
-        }
-    };
-    const uninstall = (key) => {
-        const entry = registrations.get(key);
-        if (!entry)
-            return;
-        registrations.delete(key);
-        try {
-            entry.dispose();
-        }
-        catch { /* ignore */ }
-    };
-    // ① 全局：插件 ctx 的 scope（覆盖所有 agent）
-    install(ctx, GLOBAL_KEY);
-    // ② per-agent：与既有 install/uninstall 生命周期一致（agent/created、agent/disposed）
-    const on = ctx && ctx.on;
-    let stopCreated;
-    let stopDisposed;
-    if (typeof on === 'function') {
-        stopCreated = on('agent/created', (payload) => {
-            const agent = payload && payload.agent;
-            if (agent && agent.id != null)
-                install(agent.ctx, String(agent.id));
-        });
-        stopDisposed = on('agent/disposed', (payload) => {
-            const agent = payload && payload.agent;
-            if (agent && agent.id != null)
-                uninstall(String(agent.id));
-        });
-    }
-    // 已存在的 agent（插件热加载场景）：补注册。
-    try {
-        const agents = typeof ctx.get === 'function' ? ctx.get('agents') : undefined;
-        if (agents && typeof agents.list === 'function') {
-            for (const agent of agents.list()) {
-                if (agent && agent.id != null)
-                    install(agent.ctx, String(agent.id));
-            }
-        }
-    }
-    catch { /* agents 服务不可用 → 仅靠事件 */ }
-    return {
-        invalidate: () => {
-            for (const entry of registrations.values()) {
-                try {
-                    entry.scope?.emit?.('system-prompt/change');
-                }
-                catch { /* 宿主无该事件 → 忽略 */ }
-            }
-        },
-        dispose: () => {
-            if (typeof stopCreated === 'function')
-                stopCreated();
-            if (typeof stopDisposed === 'function')
-                stopDisposed();
-            for (const key of [...registrations.keys()])
-                uninstall(key);
-        },
-    };
-}