@omdp/dsh-connector 0.2.6 → 0.3.0

package/README.md

@@ -1,12 +1,12 @@
 # @omdp/dsh-connector
 
-**MCP 服务器 + 用户 Skills + 魔搭市场浏览三合一设置页**（`v0.2.6`）。适合需要在 DSH 里频繁增删改 MCP server / skills、又不想手改 `cordis.patch.yml` 的用户。
+**MCP 服务器 + 用户 Skills + 魔搭市场浏览三合一设置页**（`v0.3.0`）。适合需要在 DSH 里频繁增删改 MCP server / skills、又不想手改 `cordis.patch.yml` 的用户。
 
 ## Requirements
 
 - DeepSeek Harness 带 `web` profile GUI（`npx @deepseek-ai/dsh web`）
 - Node.js `^22.19` 或 `>=24`
-- `@deepseek-ai/cordis` `^4.0.1`（peer；唯一 DSH 硬依赖是 `ctx.webServer`）
+- `@deepseek-ai/cordis` `4.0.1` / `4.0.2`（已实测版本；插件无 peer 声明，唯一 DSH 硬依赖是 `ctx.webServer`）
 
 ## Overview
 
@@ -14,6 +14,7 @@
 合并到 DSH Web UI 的同一个设置页（设置页标签：**Connector**）。
 
 - **MCP**：读取/编辑 `profiles/web/cordis.patch.yml` 中的 `mcp-*` 块（结构化表单）。保存后**重启 `dsh` 生效**。
+- **工具过滤（0.3.0 新增）**：每台 MCP server 卡片下可勾选放行的工具（`mcp__<server>__<raw>` 公开名按 `__` 切分回 raw 名）。规则存 `settings.yaml` 的 `connector.toolFilters`（`{<serverName>: {allow: [...]}}`），**无配置 = 全量放行**；保存后新会话即生效、无需重启。生效三件套：`systemPrompt.tools(provider)` 隐藏 schema + `ctx.tools.guard` 执行期硬拦截（做法参照 `hyqhyq3/dsh-mcp-manager`）。典型场景：tinyfish 这类 15 个工具只留 `search`/`fetch_content` 两个免费工具。
 - **Skills**：列出/查看/编辑/删除 `~/.dsh/skills` 下的 `SKILL.md`。保存**即时生效**（filesystem provider 自动重新发现）。
 - **市场探索（0.2.0 新增）**：只读浏览魔搭社区 [Skills 中心](https://modelscope.cn/skills) 与 [MCP 广场](https://modelscope.cn/mcp)（匿名 OpenAPI，无需密钥）。
   - 列表/详情：名称、作者、分类、下载/浏览数、认证标识（Hosted 官方托管 / 已认证）
@@ -80,7 +81,7 @@ pnpm install --lockfile-only --offline   # 按 link 依赖重写 lockfile
 
 ```jsonc
 "dependencies": {
-  "@omdp/dsh-connector": "^0.2.6"
+  "@omdp/dsh-connector": "^0.3.0"
 }
 ```
 
@@ -142,7 +143,8 @@ pnpm remove @omdp/dsh-connector
 1. **MCP 服务器** 区：
    - 列出当前 `cordis.patch.yml` 里的 `mcp-*` 服务器
    - 「编辑」改名称/传输/URL/命令/参数/Header；「删除」移除；「＋ 添加」新建
-   - 保存后提示**重启 dsh** 才会真正加载新的 MCP server
+   - 每台 server 卡片下有**工具过滤**多选（chips）：勾选即放行，未勾选的工具模型不可见、调用被拒；「清除」回到全量放行
+   - 保存后提示**重启 dsh** 才会真正加载新的 MCP server（工具过滤规则除外：存 settings，**新会话即生效**）
 2. **Skills** 区：
    - 列出 `~/.dsh/skills` 下的用户技能
    - 「编辑」改 frontmatter 与正文；「删除」移除目录；「＋ 新建」创建
@@ -158,9 +160,10 @@ pnpm remove @omdp/dsh-connector
 
 | 组成 | 机制 |
 |---|---|
-| 设置页 | client half 注册 `settings.section` 槽位（"Connector" 页签） |
+| 设置页 | client half 注册 `settings.section` 槽位（"Connector" 页签；client factory 须 `exports.inject = ['slots']`，否则 fiber 在 slots 就绪前跑 apply 会静默丢注册） |
 | 跨边界调用 | client 用 `fetch('/connector/api/...')`，host 用 `ctx.webServer.register` 接收（安装包走 HTTP） |
 | MCP 持久化 | 文本块级提取并替换 `cordis.patch.yml` 中含 `mcp-` 的 insert 块，**保留 `!!js` 表达式与 env 块原样**（preserve 桶） |
+| 工具过滤 | 规则存 settings `connector` 命名空间（`toolFilters`）；`systemPrompt.tools(provider)` 滤 schema + `tools.guard` 硬拦截；`dsh-mcp-client` Config 封闭，规则**不能**写进 mcp 行 config |
 | Skill 持久化 | 直接读写 `~/.dsh/skills/<name>/SKILL.md` |
 
 ## 已知限制
@@ -177,7 +180,8 @@ pnpm remove @omdp/dsh-connector
 
 | 问题 | 原因 / 解决 |
 |---|---|
-| 设置页看不到 Connector 标签 | bundle 未挂载：确认 `dsh.profile.bundles` 含 `@omdp/dsh-connector`，重启 dsh |
+| 设置页看不到 Connector 标签 | bundle 未挂载：确认 `dsh.profile.bundles` 含 `@omdp/dsh-connector`，重启 dsh；仍无则检查 client.js 尾部 `exports.inject = ['slots']` 是否在（缺了会静默丢注册） |
+| 工具过滤不生效（模型仍能看到/调用） | 过滤规则只对**新会话**生效（当前会话的 schema 已下发）；确认 settings.yaml 有 `connector.toolFilters` 且 serverName 拼写与 patch 一致 |
 | 保存 MCP 被拒（HTTP 400） | 配置不合法（transport/serverName/command/url 校验失败），按提示修正——插件不会写入坏配置 |
 | MCP server 保存后不生效 | 需**重启 dsh**（`dsh-mcp-client` 静态加载） |
 | `/connector/api/*` 404 | client/host 边界异常：确认插件 host 半边已加载（重启），浏览器强刷缓存 |
@@ -237,7 +241,7 @@ MIT License。安全问题请通过 GitHub Issues 私密报告（https://github.
 
 本插件采用**抗崩溃架构**，DSH 更新时不会导致 DSH 崩溃（硬保证）。
 
-- **纯静态依赖**：只 `import node:*` + `yaml`（唯一第三方依赖，版本 `^2.9.0`），**零 `@deepseek-ai/*` 依赖**。
+- **纯静态依赖**：只 `import node:*` + `yaml`（唯一第三方依赖，版本 `^2.9.0`），**零 `@deepseek-ai/*` 依赖**（`@deepseek-ai/schemastery` 仅 peer 声明，供工具过滤的 settings schema 用，无则过滤静默全放行）。
 - **唯一的 DSH 硬依赖**：`ctx.webServer`（`inject: ['webServer']`），用于注册 `/connector/api/*` HTTP 路由。
 - **失败隔离**：webServer 不可用/变化时插件**干净失败不加载**，DSH 照常运行；内部多处 try/catch 防御。
 
@@ -250,4 +254,4 @@ MIT License。安全问题请通过 GitHub Issues 私密报告（https://github.
 
 **最后验证**：DSH `0.1.0-rc.8`（2026-08-20）；0.2.0 市场功能以 `node --check` +
 真实 HTTP 集成测试通过（11 项：skills/mcp 列表与详情、证书/Hosted 标识、安装命令、
-记录来源回写、更新判定），未改动 DSH 实例。当前 npm 版本 `0.2.6`。
+记录来源回写、更新判定），未改动 DSH 实例。当前 npm 版本 `0.3.0`。

package/client.js

@@ -103,7 +103,9 @@ window.__ModuleLoader__.load({
       '.pm_chip{cursor:pointer;font:inherit;font-size:11.5px;padding:4px 12px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.35));background:transparent;color:var(--dsw-alias-label-secondary,#9aa);transition:all .12s}' +
       '.pm_chip:hover{color:var(--dsw-alias-label-primary,#ddd);border-color:var(--dsw-alias-brand-primary,#5b8cff)}' +
       '.pm_chip.active{background:color-mix(in srgb,var(--dsw-alias-brand-primary,#5b8cff) 26%,transparent);color:var(--dsw-alias-brand-primary,#7aa2ff);border-color:color-mix(in srgb,var(--dsw-alias-brand-primary,#5b8cff) 60%,transparent)}' +
-      '.pm_chipToggle{color:var(--dsw-alias-brand-primary,#5b8cff);border-style:dashed}'
+      '.pm_chipToggle{color:var(--dsw-alias-brand-primary,#5b8cff);border-style:dashed}' +
+      '.pm_toolFilter{margin-top:10px;padding-top:10px;border-top:1px dashed var(--dsw-alias-border-l1,rgba(128,128,128,.22));display:flex;flex-direction:column;gap:8px}' +
+      '.pm_toolFilterHead{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary,#eee);display:flex;align-items:center;gap:8px;flex-wrap:wrap}'
 
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css="@omdp/dsh-connector/section"]') === null) {
       var tag = document.createElement('style')
@@ -236,6 +238,119 @@ window.__ModuleLoader__.load({
 
     /* ─────────────────────────── MCP servers ─────────────────────────── */
 
+    /* ─────────────────── MCP 工具过滤（tool-filter）───────────────────
+     * 每个 server 一张卡片下的工具多选区：勾选 = allow 放行，未勾 = prompt 隐藏
+     * + 执行期硬拦截。无配置 = 全量放行。规则存 settings.yaml `connector:` 节，
+     * 保存后新会话即生效（无需重启；当前会话的已加载 schema 下次请求刷新）。
+     * 工具列表来自 host 的 GET /api/mcp/tools/:serverName（读 tools.schemas()
+     * 的实时注册）；server 未连接时列表为空，显示提示而非多选框。
+     * ─────────────────────────────────────────────────────────────── */
+
+    // 全 server 的过滤规则缓存：key: serverName → { tools: [publicName], allow: [rawName] }。
+    // 注意：这是普通函数（非 Hook），由 McpPane 直接调用；内部的 useState/useEffect
+    // 之所以合法，是因为 McpPane 每次渲染都以相同顺序调用它（servers 为空时也调用，
+    // 只是 effect 内提前返回）。servers 变化才重拉。
+    function useToolFilters(servers) {
+      var _a = react.useState({})
+      var cache = _a[0]
+      var setCache = _a[1]
+      react.useEffect(function () {
+        var cancelled = false
+        var names = (servers || []).map(function (s) { return s.serverName }).filter(Boolean)
+        if (!names.length) { setCache({}); return }
+        Promise.all(names.map(function (n) {
+          return api('/mcp/tools/' + encodeURIComponent(n), { method: 'GET' })
+            .then(function (r) { return { name: n, data: r } })
+            .catch(function () { return { name: n, data: null } })
+        })).then(function (pairs) {
+          if (cancelled) return
+          var next = {}
+          pairs.forEach(function (p) {
+            if (p.data && !p.data.error) next[p.name] = { tools: p.data.tools || [], allow: p.data.allow || [] }
+          })
+          setCache(next)
+        })
+        return function () { cancelled = true }
+      }, [(servers || []).map(function (s) { return s.serverName }).join(',')])
+      return [cache, setCache]
+    }
+
+    function ToolFilterBadge(props) {
+      // 卡片头徽标：有过滤规则才显示“已过滤 N/M”，无规则不占位。
+      var info = (props.cache || {})[props.serverName]
+      if (!info || !info.allow.length || !info.tools.length) return null
+      return badge('已过滤 ' + info.allow.length + '/' + info.tools.length, 'brand')
+    }
+
+    function ToolFilterBox(props) {
+      var info = (props.cache || {})[props.serverName]
+      var _a = react.useState(false)
+      var saving = _a[0]
+      var setSaving = _a[1]
+      var _b = react.useState('')
+      var err = _b[0]
+      var setErr = _b[1]
+      if (!props.serverName) return null
+      if (!info) return createElement('div', { className: 'pm_meta' }, '工具列表加载中…')
+      if (!info.tools.length) return createElement('div', { className: 'pm_meta' }, '该 server 暂无已注册工具（未连接或无需过滤）。')
+      var allow = info.allow
+      // raw 名 = 公开名去掉 `mcp__<server>__` 前缀。serverName 本身可含下划线
+      // 但公开名用双下划线分隔、且 server 是第一段，所以按 `__` 切分取第一段
+      // 校验后余下 join 回 raw（与 host 侧 splitPublicName 同逻辑）。
+      function rawOf(publicName) {
+        var parts = String(publicName).slice(5).split('__')
+        if (parts.length >= 2 && parts[0] === props.serverName) return parts.slice(1).join('__')
+        var prefix = 'mcp__' + props.serverName + '__'
+        if (String(publicName).indexOf(prefix) === 0) return String(publicName).slice(prefix.length)
+        return publicName
+      }
+      function toggle(raw) {
+        var next = allow.indexOf(raw) === -1 ? allow.concat([raw]) : allow.filter(function (t) { return t !== raw })
+        save(next)
+      }
+      function save(next) {
+        setSaving(true)
+        setErr('')
+        var body = { filters: {} }
+        // 读当前全量规则：只改这一个 server，其余保持（避免并发覆盖）。
+        api('/mcp/filters', { method: 'GET' }).then(function (r) {
+          var filters = (r && r.filters) || {}
+          if (!next.length) delete filters[props.serverName]
+          else filters[props.serverName] = { allow: next }
+          body.filters = filters
+          return api('/mcp/filters', { method: 'PUT', body: JSON.stringify(body) })
+        }).then(function (r) {
+          if (r && r.error) { setErr(r.error); return }
+          changed()
+        }).catch(function (e) {
+          setErr(String(e))
+        }).finally(function () { setSaving(false) })
+      }
+      return createElement('div', { className: 'pm_toolFilter' },
+        createElement('div', { className: 'pm_toolFilterHead' },
+          '工具过滤 Tool filter',
+          saving ? createElement('span', { className: 'pm_spinner' }) : null,
+          allow.length
+            ? createElement('button', { className: 'pm_btn', onClick: function () { save([]) } }, '清除（全量放行）')
+            : createElement('span', { className: 'pm_meta' }, '未配置 = 全量放行'),
+        ),
+        err ? createElement('div', { className: 'pm_err' }, err) : null,
+        createElement('div', { className: 'pm_chips' },
+          info.tools.map(function (pub) {
+            var raw = rawOf(pub)
+            var on = allow.indexOf(raw) !== -1
+            return createElement('button', {
+              key: pub,
+              className: 'pm_chip' + (on ? ' active' : ''),
+              title: pub,
+              onClick: function () { toggle(raw) },
+            }, (on ? '✓ ' : '') + raw)
+          }),
+        ),
+        createElement('div', { className: 'pm_meta' }, '保存后新会话即生效，无需重启。未勾选的工具模型不可见、调用被拒。'),
+      )
+    }
+
     function McpPane(props) {
       var _a = react.useState(null)
       var editing = _a[0]
@@ -243,6 +358,14 @@ window.__ModuleLoader__.load({
       var _b = react.useState('')
       var err = _b[0]
       var setErr = _b[1]
+      var _c = useToolFilters(props.mcp.servers)
+      var filterCache = _c[0]
+      var setFilterCache = _c[1]
+      // 刷新后工具列表可能变化（server 重连/改名），清掉旧缓存重拉。
+      function changed() {
+        setFilterCache({})
+        props.onChanged()
+      }
 
       function save(server) {
         api('/mcp', {
@@ -252,7 +375,7 @@ window.__ModuleLoader__.load({
           if (r && r.error) { setErr(r.error); return }
           setErr('')
           setEditing(null)
-          props.onChanged()
+          changed()
         })
       }
       function remove(id) {
@@ -262,7 +385,7 @@ window.__ModuleLoader__.load({
         }).then(function (r) {
           if (r && r.error) { setErr(r.error); return }
           setErr('')
-          props.onChanged()
+          changed()
         })
       }
 
@@ -271,12 +394,14 @@ window.__ModuleLoader__.load({
           createElement('div', { className: 'pm_cardHead' },
             createElement('span', { className: 'pm_name' }, s.name || s.id),
             badge(s.transport || 'stdio', 'muted'),
+            createElement(ToolFilterBadge, { serverName: s.serverName, cache: filterCache }),
           ),
           createElement('div', { className: 'pm_meta' }, s.url ? 'url: ' + s.url : (s.command ? 'cmd: ' + s.command : '')),
           createElement('div', { className: 'pm_actions' },
             createElement('button', { className: 'pm_btn', onClick: function () { setEditing(s) } }, '编辑 Edit'),
             createElement('button', { className: 'pm_btn danger', onClick: function () { remove(s.id) } }, '删除 Delete'),
           ),
+          createElement(ToolFilterBox, { serverName: s.serverName, cache: filterCache, onChanged: changed }),
         )
       })
 
@@ -1033,6 +1158,7 @@ window.__ModuleLoader__.load({
     }
 
     exports.apply = apply
+    exports.inject = ['slots']
     return module.exports
   },
 })

package/index.js

@@ -27,6 +27,7 @@ import { homedir } from 'node:os'
 import { join, dirname } from 'node:path'
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml'
 import { JSDOM, VirtualConsole } from 'jsdom'
+import z from '@deepseek-ai/schemastery'
 
 const API_PREFIX = '/connector/api'
 const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/
@@ -41,6 +42,54 @@ const TRANSPORTS = new Set(['stdio', 'streamable-http'])
 // the single-token rules; this catches the rest defensively.
 const CONTROL_CHARS = /[\x00-\x1f\x7f]/
 export const inject = ['webServer']
+
+// ── MCP 工具过滤（tool-filter, 0.3.0 新增）────────────────────────────
+// dsh-mcp-client 的 Config schema 是封闭的：未知键会拒收并导致下次启动失败，
+// 所以过滤规则不能写进 mcp-* 行的 config，只能放在 connector 自己的 settings
+// namespace（settings.yaml `connector:` 节）里：
+//   connector:
+//     toolFilters:
+//       <serverName>:
+//         allow: [<rawToolName>, ...]   # 只放行这些工具；空/缺失 = 全量放行
+//
+// 生效三件套（抄 hyqhyq3/dsh-mcp-manager 的做法）：
+//   1. systemPrompt.tools(provider) —— 提示词里的 schema 列表先过滤，模型看不到被滤掉的工具；
+//   2. ctx.tools.guard —— 执行期硬拦截（guard 返回 reason 即拒收），补 provider 漏网；
+//   3. UI 多选框 —— 见 client.js ServerForm 的工具过滤区 + GET /api/mcp/tools/:serverName。
+// 无配置 = 全量放行（零回归）；guard 是同步函数，读的是 apply 时缓存 + watch 刷新的快照。
+const CONNECTOR_SETTINGS_NS = 'connector'
+const ToolFilterSchema = z.object({
+  toolFilters: z.dict(z.object({ allow: z.array(String).default([]) })).default({}),
+})
+function readToolFilters(ctx) {
+  try {
+    const settings = ctx.get('settings')
+    const value = settings ? settings.get(CONNECTOR_SETTINGS_NS) : undefined
+    const filters = value && typeof value === 'object' ? value.toolFilters : undefined
+    if (!filters || typeof filters !== 'object' || Array.isArray(filters)) return {}
+    const out = {}
+    for (const [server, rule] of Object.entries(filters)) {
+      const allow = rule && Array.isArray(rule.allow) ? rule.allow.filter((t) => typeof t === 'string' && t.length > 0) : []
+      out[server] = { allow }
+    }
+    return out
+  } catch { return {} }
+}
+// 公开名 `mcp__<server>__<raw>` 反解回 (server, raw)：注意 serverName 本身可含
+// 下划线，所以按 `mcp__` 前缀 + __ 分段取“第一段”为 server，余下 join 回 raw。
+function splitPublicName(publicName) {
+  if (typeof publicName !== 'string' || !publicName.startsWith('mcp__')) return null
+  const parts = publicName.slice(5).split('__')
+  if (parts.length < 2 || !parts[0]) return null
+  return { server: parts[0], raw: parts.slice(1).join('__') }
+}
+function isToolAllowed(filters, publicName) {
+  const split = splitPublicName(publicName)
+  if (!split) return true // 非 MCP 工具：不过滤
+  const rule = filters[split.server]
+  if (!rule || !rule.allow.length) return true // 该 server 无配置 = 全量放行
+  return rule.allow.includes(split.raw)
+}
 export { validateServer, commandResolvable }
 
 function resolveHome() {
@@ -874,6 +923,46 @@ async function readBody(req) {
 }
 
 export function apply(ctx) {
+  // ── 工具过滤三件套之 (0)：settings namespace 注册 + 快照缓存 ──
+  // settings 服务可选（无 provider 时 ctx.inject 回调不跑，过滤保持全放行）。
+  let toolFilters = {}
+  const refreshFilters = () => { toolFilters = readToolFilters(ctx) }
+  ctx.inject(['settings'], (settingsCtx) => {
+    settingsCtx.settings.register(CONNECTOR_SETTINGS_NS, ToolFilterSchema, { base: { toolFilters: {} } })
+    refreshFilters()
+    settingsCtx.effect(() => settingsCtx.settings.watch(() => refreshFilters()), 'connector: watch tool filters')
+  })
+
+  // ── 三件套之 (1)：prompt 层过滤 —— 被滤掉的工具不进模型 schema ──
+  // tools provider 在每次 assembly 时求值，读最新快照；无 tools/systemPrompt
+  // 服务时跳过（ctx.get 可选读，失败隔离：connector 照常提供设置页）。
+  try {
+    const systemPrompt = ctx.get('systemPrompt')
+    if (systemPrompt && typeof systemPrompt.tools === 'function') {
+      ctx.effect(() => systemPrompt.tools(() => {
+        let schemas = []
+        try {
+          const tools = ctx.get('tools')
+          schemas = tools ? tools.schemas() : []
+        } catch { return { schemas: [] } }
+        const kept = schemas.filter((s) => isToolAllowed(toolFilters, s && s.name))
+        return { schemas: kept, knownNames: schemas.map((s) => s && s.name).filter(Boolean) }
+      }), 'connector: mcp tool filter provider')
+    }
+  } catch {}
+  // ── 三件套之 (2)：执行期硬拦截 —— 补 provider 漏网（如 guard 注册时序）──
+  try {
+    const tools = ctx.get('tools')
+    if (tools && typeof tools.guard === 'function') {
+      ctx.effect(() => tools.guard((exec) => {
+        if (!exec || typeof exec.name !== 'string') return undefined
+        if (isToolAllowed(toolFilters, exec.name)) return undefined
+        const split = splitPublicName(exec.name)
+        return `connector: 工具 ${exec.name} 已被过滤（server "${split ? split.server : '?'}” 的 allow 列表未包含它）`
+      }), 'connector: mcp tool filter guard')
+    }
+  } catch {}
+
   async function route(req, res) {
     const url = new URL(req.url, 'http://localhost')
     const path = url.pathname
@@ -947,6 +1036,66 @@ export function apply(ctx) {
         return json(res, 200, { ok: true })
       }
 
+      // GET /api/mcp/tools/:serverName — 该 server 当前注册的工具公开名
+      // （供 UI 渲染 allow 多选框；server 未连接/无工具时返回空列表）。
+      const toolsMatch = path.match(new RegExp('^' + API_PREFIX + '/mcp/tools/([^/]+)$'))
+      if (req.method === 'GET' && toolsMatch) {
+        const serverName = decodeURIComponent(toolsMatch[1])
+        if (!SERVER_NAME_RE.test(serverName)) return json(res, 400, { error: 'invalid server name' })
+        let names = []
+        try {
+          const tools = ctx.get('tools')
+          const schemas = tools ? tools.schemas() : []
+          names = schemas.map((s) => s && s.name).filter((n) => {
+            const split = splitPublicName(n)
+            return split && split.server === serverName
+          })
+        } catch (error) {
+          return json(res, 500, { error: String(error?.message ?? error).slice(0, 200) })
+        }
+        const filters = readToolFilters(ctx)
+        const rule = filters[serverName]
+        return json(res, 200, { server: serverName, tools: names.sort(), allow: rule ? rule.allow : [] })
+      }
+
+      // GET /api/mcp/filters — 全部 server 的过滤规则（UI 批量展示用）
+      if (req.method === 'GET' && path === API_PREFIX + '/mcp/filters') {
+        return json(res, 200, { filters: readToolFilters(ctx) })
+      }
+
+      // PUT /api/mcp/filters — 保存过滤规则 → settings.yaml `connector:` 节
+      // body: { filters: { <serverName>: { allow: [rawTool,...] } } }。
+      // 空 allow = 全量放行（删除该 server 规则与显式空列表等价）。
+      if (req.method === 'PUT' && path === API_PREFIX + '/mcp/filters') {
+        const body = await readBody(req)
+        const incoming = body && typeof body === 'object' && !Array.isArray(body) ? body.filters : undefined
+        if (!incoming || typeof incoming !== 'object' || Array.isArray(incoming)) {
+          return json(res, 400, { error: 'malformed request body: filters must be an object' })
+        }
+        const clean = {}
+        for (const [server, rule] of Object.entries(incoming)) {
+          if (!SERVER_NAME_RE.test(server)) {
+            return json(res, 400, { error: `invalid server name ${JSON.stringify(server)}` })
+          }
+          const allow = rule && Array.isArray(rule.allow) ? rule.allow : []
+          for (const t of allow) {
+            if (typeof t !== 'string' || !t.length || CONTROL_CHARS.test(t) || /\s/.test(t)) {
+              return json(res, 400, { error: `invalid tool name ${JSON.stringify(t)} for server ${JSON.stringify(server)}` })
+            }
+          }
+          if (allow.length) clean[server] = { allow: [...new Set(allow)].sort() }
+        }
+        try {
+          const settings = ctx.get('settings')
+          if (!settings) return json(res, 503, { error: 'settings service unavailable' })
+          await settings.update(CONNECTOR_SETTINGS_NS, { toolFilters: clean })
+        } catch (error) {
+          return json(res, 500, { error: String(error?.message ?? error).slice(0, 300) })
+        }
+        refreshFilters()
+        return json(res, 200, { ok: true, filters: readToolFilters(ctx) })
+      }
+
       // GET /api/skills — list
       if (req.method === 'GET' && path === API_PREFIX + '/skills') {
         const skills = await listUserSkills()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omdp/dsh-connector",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Unified DeepSeek Harness connector: edit MCP servers (cordis.patch.yml), user skills (~/.dsh/skills) and browse the ModelScope MCP/Skills marketplaces from one Web UI settings page.",
   "type": "module",
   "main": "index.js",
@@ -44,5 +44,8 @@
   "dependencies": {
     "yaml": "^2.9.0",
     "jsdom": "^24.1.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/schemastery": "3.18.1 || 3.18.2"
   }
 }