dsh-plugin-tool-management 0.9.1 → 0.11.0

package/lib/ops/candidates.js

@@ -0,0 +1,64 @@
+// 场景档案与候选源域的 HTTP ops（2026-09-19 从 index.ts 的 handlers 表抽出）。
+//
+// 三个 op 都是**只读候选源**：preset-tools（人设表单的工具候选）、model-candidates
+// （宿主 LLM 目录）、scene-inventory（场景档案勾选器的数据源 v2）。
+export function buildCandidateOps(deps) {
+    return {
+        // 人设表单的两个候选源之一（只读，均为「按需拉取」——不进 scene-inventory，避免每次开
+        // 档案弹窗都枚举预设）。
+        // preset-tools：全体 Agent 预设工具名并集 + 各工具所属预设 + 当前会话是否可见。
+        // `unavailable` = 本插件自己没注册上的工具：工具列表接口是唯一按名字枚举工具的地方，
+        // 注册失败只能在这里被如实回答。
+        'preset-tools': async () => ({
+            ok: true,
+            ...(await deps.presetToolCandidates()),
+            unavailable: deps.getToolFailures().map((f) => ({ ...f })),
+        }),
+        // model-candidates：宿主 LLM 目录里的 (provider, model) 对（不发网络请求）。
+        'model-candidates': async () => ({ ok: true, ...(await deps.modelCandidates()) }),
+        // 场景档案勾选器数据源 v2：全部 MCP 服务器（含未运行）+ 技能全集 + 人设清单。
+        'scene-inventory': async () => {
+            const [rowsR, tools, skills, subs] = await Promise.all([deps.mcpmListView(), deps.toolStates(), deps.skillRows(), deps.subagentList()]);
+            const disabledRaw = await deps.readDisabledTools();
+            const rows = (rowsR && rowsR.rows) || [];
+            const mcpServers = [];
+            const seen = new Set();
+            for (const row of rows) {
+                const name = String((row && row.serverName) || '');
+                if (!name || seen.has(name))
+                    continue;
+                seen.add(name);
+                const live = !!(row.live && row.live.enabled);
+                mcpServers.push({
+                    name,
+                    level: row.level || null,
+                    live,
+                    serverDisabled: !!row.disabled,
+                    // 停用表里的 ['*'] = 整台工具停用（勾选器据此预勾，避免把"全停"读成"全启用"）。
+                    allToolsDisabled: (disabledRaw[name] || []).indexOf('*') >= 0,
+                    // 未运行且没有任何已知工具 ⇒ null（客户端显示「工具数未知」并引导读取），
+                    // 不再给出误导性的 0。
+                    toolCount: live || Number(row.toolCount) > 0
+                        ? (typeof row.toolCount === 'number' ? row.toolCount : null)
+                        : null,
+                });
+            }
+            return {
+                ok: true,
+                mcpServers,
+                tools: Object.entries(tools).map(([key, enabled]) => ({ key, enabled })),
+                // 技能行：技能名与来源名分开给（早先只给 `<来源 key>/<技能名>`，自定义目录的
+                // 来源 key 是 `custom-<hash>`，于是导入的技能在场景里显示成一串哈希）。
+                skills,
+                // 人设行要显示"按模式配了什么限制"，所以把按模式名单一起带上；
+                // presets 只给名字与来源（不枚举工具，避免打开档案弹窗就挂载每个预设）。
+                subagents: subs.map((p) => ({ name: p.name, description: p.description, toolsByPreset: p.toolsByPreset ?? null })),
+                presets: await deps.presetNames(),
+                // 档案编辑器第 4 段「记忆」的候选：场景 + 每个场景里的记忆条数。
+                // 记忆正文不在这里返回（勾选集只存 id，渲染时才读盘）。
+                scenes: await deps.memorySceneCandidates(),
+                memories: await deps.memoryCandidates(),
+            };
+        },
+    };
+}

package/lib/ops/compat.js

@@ -0,0 +1,136 @@
+// 兼容 / 注入 / 备份域的 HTTP ops（2026-09-19 从 index.ts 的 handlers 表抽出）。
+//
+// 为什么抽出来：index.ts 的 apply() 闭包里塞了 40 个 op 的内联实现，改一处要在 700 行
+// 的对象字面量里找。这里按域收成一个 `buildCompatOps(deps)` —— 依赖全部显式传参，
+// 不再靠闭包隐式捕获，各域可以单独读、单独改。
+//
+// 边界纪律：本文件只负责「op 的实现」，不负责 ops 表之外的接线（MCP 写后刷新、场景锁定
+// 守卫仍作用在组装后的整张表上，见 index.ts）。
+import { EXPECTED_MIN_HOST_VERSION, EXPECTED_PEER_RANGE, VERIFIED_HOST_VERSION, summarize, } from '../compat/probe.js';
+import { assessPresetReach } from '../compat/preset-reach.js';
+import { pluginLog } from '../skills/service.js';
+export function buildCompatOps(deps) {
+    return {
+        'compat-status': async (args) => {
+            const force = Boolean(args && args.refresh);
+            try {
+                const registry = deps.getSessionsRegistry();
+                const assessment = registry && typeof registry.capabilities === 'function'
+                    ? registry.capabilities(force)
+                    : undefined;
+                if (assessment === undefined) {
+                    return {
+                        ok: true,
+                        host: { version: 'unknown' },
+                        findings: [],
+                        degraded: [],
+                        blockers: ['归档服务未挂载：无法探测宿主能力'],
+                        summary: '宿主能力探测不可用（归档服务未挂载）',
+                    };
+                }
+                const summary = summarize(assessment);
+                // 每次刷新都留一条结构化日志：升级当天就能在日志里看到降级发生。
+                if (force || !deps.compatLog.version || deps.compatLog.version !== assessment.identity.version) {
+                    deps.compatLog.version = assessment.identity.version;
+                    void pluginLog()('compat/probe', {
+                        hostVersion: assessment.identity.version,
+                        summary,
+                        degraded: assessment.degraded.map((item) => ({ id: item.id, state: item.state, detail: item.detail })),
+                        blockers: assessment.identity.blockers,
+                        sameAsHost: assessment.identity.sameAsHost,
+                    }).catch(() => { });
+                }
+                return {
+                    ok: true,
+                    host: { version: assessment.identity.version, modules: assessment.identity.modules },
+                    sameAsHost: assessment.identity.sameAsHost,
+                    unverified: assessment.identity.unverified,
+                    findings: assessment.findings,
+                    degraded: assessment.degraded,
+                    blockers: assessment.identity.blockers,
+                    mayDelete: assessment.mayDelete,
+                    verifiedVersion: VERIFIED_HOST_VERSION,
+                    expectedPeerRange: EXPECTED_PEER_RANGE,
+                    minHostVersion: EXPECTED_MIN_HOST_VERSION,
+                    generatedAt: assessment.generatedAt,
+                    summary,
+                };
+            }
+            catch (e) {
+                return { ok: false, error: deps.message(e) };
+            }
+        },
+        // 预设可达性矩阵：每个 Agent 预设下，本插件的注入类能力到不到得了模型。
+        // 只读预设组合文本，不挂载任何预设、不改任何数据。回答的是"面板上说注入了，
+        // 模型真的看得到吗" —— 压制型预设（persona complete / includeRuntimeContext:false，
+        // 如极简）默认不注入，可在「注入」设置里改成强制注入。
+        'preset-reach': async () => {
+            try {
+                // 宿主平面的 MCP 工具数：四个官方预设都不在组合里挂 MCP，MCP 由
+                // $DSH_HOME/cordis.patch.yml 这一层挂载，所以它对所有预设一视同仁；
+                // 这一列要回答的只是"现在有没有 MCP 工具可用"。探测失败 → 不传该字段，
+                // 矩阵那一格显示"判断不了"而不是猜。
+                let mcpTools;
+                try {
+                    const schemas = (await deps.tools.schemas());
+                    mcpTools = schemas.filter((s) => String(s && s.name || '').startsWith('mcp__')).length;
+                }
+                catch {
+                    mcpTools = undefined;
+                }
+                const settings = await deps.readInjectSettings();
+                const report = await assessPresetReach(deps.presetRoster(), {
+                    mcpTools,
+                    inject: { underSuppressingPresets: settings.underSuppressingPresets, domains: settings.domains },
+                });
+                return { ok: true, ...report };
+            }
+            catch (e) {
+                return { ok: false, error: deps.message(e) };
+            }
+        },
+        // 注入设置（读 / 写）：压制型预设下是否仍然注入 + 各域开关。界面在「兼容」页。
+        'inject-settings': (args) => deps.injectSettingsOp(args),
+        // patch 备份（改宿主配置前的整份副本）：列清单只读，清理按写门禁。
+        // 每份备份里都是**明文**凭据，所以给一个显式出口让人能删掉多余的副本（理由见
+        // cleanPatchBackups 的注释）。清单不带文件内容，只给名字 / 层级 / 时间 / 大小。
+        'backups-list': async () => {
+            const files = await deps.listPatchBackups();
+            return { ok: true, files, total: files.length, totalSize: files.reduce((s, f) => s + f.size, 0) };
+        },
+        'backups-clean': async (args) => {
+            // 口径是**每个层级各删最旧的几份**：`del` 是 `{ 层级: 份数 }`，键与 listPatchBackups
+            // 给的层级标签同源（global / profile:<名> / legacy）。认不出的键天然落空（没有这个
+            // 层级就没得删），非法值一律忽略 —— 参数畸形时**一份都不删**，这是安全的默认。
+            const raw = (args && args.del) || {};
+            const del = {};
+            if (raw && typeof raw === 'object') {
+                for (const key of Object.keys(raw)) {
+                    const n = Number(raw[key]);
+                    if (Number.isSafeInteger(n) && n >= 1 && n <= 20)
+                        del[key] = n;
+                }
+            }
+            const r = await deps.cleanPatchBackups(del);
+            // 失败原因（文件被占用等）由界面按当前语言拼：这里只回结构化字段。回中文串会让
+            // 英文界面原样露出中文（与 compat-status 的 summary 同一条纪律）。
+            return {
+                ok: true, removed: r.removed.length, kept: r.kept,
+                ...(r.failed.length ? { failedCount: r.failed.length, failedNames: r.failed } : {}),
+            };
+        },
+        // 注入实况（只读）：最近活跃会话里模型**真正看到**的五域文本 + 本次运行的投递统计。
+        // 回答"勾了开关到底送没送到"——界面配置与实际注入不一致时，这里一眼可见。
+        'injection-live': async () => {
+            const live = deps.getContextInjectorLive();
+            if (live === null)
+                return { ok: false, error: '注入通道未装配' };
+            try {
+                return { ok: true, ...live() };
+            }
+            catch (e) {
+                return { ok: false, error: deps.message(e) };
+            }
+        },
+    };
+}

package/lib/ops/ctx.js

@@ -0,0 +1,9 @@
+// 记忆域 op 的**显式上下文契约**（2026-09-19 抽出，配合 memories/service.ts 组装）。
+//
+// 为什么要有它：24 个 op 原先写在 createMemoriesService 闭包里，靠闭包隐式捕获读模型
+// （snapshot / sceneMemory / scenePrompt）、写管道（invalidateSnapshot）、入口
+// （parseId / locateRule / buildProjected）与三个路径配置。抽成独立文件后，这些依赖必须
+// 显式传入 —— 本文件就是那份清单，签名与原声明逐字对应（改这里等于改 op 的可见面）。
+//
+// 刻意不做成 `typeof rc`：那会把契约藏回 service.ts，域文件又得反向引它。
+export {};