dsh-plugin-tool-management 0.12.0 → 0.13.0

package/lib/tools/table.js

@@ -0,0 +1,101 @@
+// 「模型工具表」开关（2026-09-23）。
+//
+// 为什么要有它：工具表是按**每个请求**付钱的 —— 本插件 20 个工具的 schema 合计 ≈3,100 tok，
+// 每一轮都随请求发出，哪怕这一轮根本用不上（实测口径见 review/后续方向.md）。关掉某几个工具，
+// 它们整份不进请求（不是"把描述写短点"那种省）；面板（114 个 op）与注入通道完全不受影响。
+//
+// 本文件只放纯逻辑（normalize / 分域分组 / 体积汇总）。落盘与 TTL 缓存在 index.ts，与
+// 注入设置（`inject-settings.json`）走同一套写法。
+//
+// 谁读这份设置：
+//   · index.ts 的 op `tool-table`（读写侧车 + 写后刷新可见性与两个目录）；
+//   · mcp/manager.ts 的 `pluginHiddenTools` —— 官方 `tools.restrict()` 只允许**每个 agent
+//     scope 一层**限制（两处各调一次会互相覆盖），所以 MCP 停用名单与我们的名单必须在那边
+//     并成一次 restrict；
+//   · 工具执行门禁（关掉的工具即便被点到也不执行 —— 可见性半边失败时仍有这一半）；
+//   · 注入通道与两个目录：目录里「用 `skill_manager_list` 查」这类句子在工具关掉后就是假的。
+import { INJECT_DOMAIN_KEYS, domainOfTool } from '../context-inject.js';
+/** 默认一个都不关：装完即用，省钱的开关由用户自己按需打开。 */
+export const DEFAULT_TOOL_TABLE_SETTINGS = { hidden: [] };
+/** 把任意输入夹成合法设置（只收非空字符串；重复的只留一份）。 */
+export function normalizeToolTableSettings(raw) {
+    const obj = (raw && typeof raw === 'object' ? raw : {});
+    const list = Array.isArray(obj.hidden) ? obj.hidden : [];
+    const hidden = [];
+    for (const item of list) {
+        // 只认字符串：`[7]` 这种手改产物不该被 String() 变成一个看着像工具名的东西。
+        if (typeof item !== 'string')
+            continue;
+        const name = item.trim();
+        if (name !== '' && hidden.indexOf(name) < 0)
+            hidden.push(name);
+    }
+    return { hidden };
+}
+/**
+ * 宿主与界面共用的字符/词比（`dsh-token-meter` 的 `CHARS_PER_TOKEN`，其
+ * `estimateToolsTokens` = `ceil(JSON.stringify(tools).length / 4) + 4`）。
+ *
+ * 这是**估算**：宿主自己也这么说（"Actual usage remains authoritative"，真实用量来自
+ * API 的 `stream_options.include_usage`）。界面上必须带「≈」。
+ */
+export const CHARS_PER_TOKEN = 4;
+export function estimateTok(bytes) {
+    const value = Number(bytes);
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    return Math.ceil(value / CHARS_PER_TOKEN);
+}
+/**
+ * 纯函数：把注册时量到的体积按域分组，标出哪些被关掉，给出三档合计。
+ *
+ * 顺序：域按 `INJECT_DOMAIN_KEYS`（界面与注入通道同一顺序），域内按**注册顺序**
+ * —— 改顺序等于改显示顺序，不额外定义"重要性"，免得出现第二份排序真相。
+ */
+export function buildToolTableReport(rows, hidden) {
+    const off = new Set(hidden.map((name) => String(name)));
+    const buckets = new Map();
+    for (const key of INJECT_DOMAIN_KEYS)
+        buckets.set(key, []);
+    for (const row of rows) {
+        const name = String(row && row.name ? row.name : '').trim();
+        if (name === '')
+            continue;
+        // 认不出前缀的工具归到 `other` 而不是丢掉：丢掉 = 它在界面上根本不出现，
+        // 于是"没登记的域"就永远关不掉，而且没人看得出来（静默降级）。
+        const key = domainOfTool(name) ?? 'other';
+        let list = buckets.get(key);
+        if (list === undefined) {
+            list = [];
+            buckets.set(key, list);
+        }
+        list.push({ name, tok: estimateTok(row.bytes), hidden: off.has(name) });
+    }
+    const groups = [];
+    let visibleTok = 0;
+    let hiddenTok = 0;
+    let visibleCount = 0;
+    let totalCount = 0;
+    for (const [key, tools] of buckets) {
+        if (!tools.length)
+            continue;
+        let tok = 0;
+        let offTok = 0;
+        for (const tool of tools) {
+            tok += tool.tok;
+            totalCount += 1;
+            if (tool.hidden)
+                offTok += tool.tok;
+            else {
+                visibleTok += tool.tok;
+                visibleCount += 1;
+            }
+        }
+        hiddenTok += offTok;
+        groups.push({ key, tools, tok, hiddenTok: offTok });
+    }
+    return {
+        groups, visibleTok, hiddenTok, totalTok: visibleTok + hiddenTok,
+        visibleCount, hiddenCount: totalCount - visibleCount, totalCount,
+    };
+}

package/package.json

@@ -1,108 +1,108 @@
-{
-  "name": "dsh-plugin-tool-management",
-  "version": "0.12.0",
-  "description": "DSH plugin: one settings panel for MCP servers, skills, scenes, memories, subagents, AGENTS.md presets and archived sessions — scene memory injects into the system prompt, scene lock freezes all five domains, deleted workspaces re-register with one click. Settings UI + HTTP API + 14 model tools (mcp_manager_*, skill_manager_*, prompt_manager_*, memory_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/sessions/workspace.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 && node scripts/sync-profile.mjs",
-    "prepublishOnly": "npm run build && npm run lint && node --test test/client-exports.test.mjs",
-    "lint": "node --check lib/client.js && node --check lib/index.js",
-    "typecheck:client": "node scripts/sync-client.mjs && tsc -p tsconfig.client.json",
-    "check:i18n": "node scripts/check-i18n.mjs lib/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/contracts.test.mjs test/client-exports.test.mjs",
-    "sync:profile": "node scripts/sync-profile.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.2",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": ">=0.1.5-rc.2",
-    "@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-subagent-fork-in-process": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2",
-    "react": "^18.2.0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-subagent-fork-in-process": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-subagent-spawn-in-process": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@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-subagent-fork-in-process": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.0",
-    "typescript": "^6.0.0"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "fflate": "^0.8.3",
-    "js-yaml": "^4.3.2"
-  }
-}
+{
+  "name": "dsh-plugin-tool-management",
+  "version": "0.13.0",
+  "description": "DSH plugin: one settings panel for MCP servers, skills, scenes, memories, subagents, AGENTS.md presets and archived sessions — scene memory injects into the system prompt, scene lock freezes all five domains, deleted workspaces re-register with one click. Settings UI + HTTP API + 20 model tools (mcp_manager_*, skill_manager_*, prompt_manager_*, memory_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/sessions/workspace.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 && node scripts/sync-profile.mjs",
+    "prepublishOnly": "npm run build && npm run lint && npm run typecheck:client && node --test test/client-exports.test.mjs",
+    "lint": "node --check lib/client.js && node --check lib/index.js",
+    "typecheck:client": "node scripts/sync-client.mjs && tsc -p tsconfig.client.json",
+    "check:i18n": "node scripts/check-i18n.mjs lib/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 && npm run typecheck:client && node --test test/contracts.test.mjs test/client-exports.test.mjs",
+    "sync:profile": "node scripts/sync-profile.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.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.5-rc.2",
+    "@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-subagent-fork-in-process": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-subagent-fork-in-process": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-subagent-spawn-in-process": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
+    "@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-subagent-fork-in-process": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-rc.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "fflate": "^0.8.3",
+    "js-yaml": "^4.3.2"
+  }
+}