@max-null/dsh-skill-mcp-center 0.6.5 → 0.7.0

package/README.md

@@ -29,6 +29,12 @@ DSH 的 `Loader.write()` 是空实现，面板上的启停只改内存树——
 
 ![MCP 开关的效力边界](docs/shots/mcp-switch-session-only.png)
 
+### 设置页：插件技能的启停
+
+插件包内自带的技能没有可写的 `SKILL.md`——改名、移出目录、断链对安装内容都不生效（社区同类项目因此都只能显示「内置只读」）。这里改用 registry 的 rank 遮蔽：停用时注册一个同名占位技能（runtime rank 250 赢过包内 provider ≈550、bundled 600），两个 invocation 都设为 false，于是模型与人都调不到它，但它仍在 catalog 里、仍可被面板列出与管理；启用时调 disposer。停用清单落在 `$DSH_HOME/skill-mcp-center/disabled-skills.json`，重启后自动重放。
+
+![](docs/shots/skill-hotplug-toggle.png)
+
 ### 侧栏：Skill 一览
 
 搜索 + 命名空间筛选（全部 / 全局 / 工作区），每条带开关与 `MD`（查看 SKILL.md）。**插件包内自带的 skill 同样列出**，并标出来源插件——下图里 8 个 `ssid-*` 来自 `dsh-skills`，而用户级的 `ssid-release` 没有来源标签，这正是两者的区别：

package/client.js

@@ -217,6 +217,7 @@ var zhDict = {
   sectionSub: "\u7BA1\u7406\uFF08\u9759\u6001\u914D\u7F6E\uFF09\xB7 \u8FD0\u884C\u65F6\u72B6\u6001\u5728\u53F3\u4FA7\u8FB9\u680F",
   modelDisabled: "\u6A21\u578B\u5DF2\u505C\u7528",
   toggleModelVisible: "\u5207\u6362\u6A21\u578B\u53EF\u89C1",
+  toggleSkillEnabled: "\u542F\u7528 / \u505C\u7528\uFF08\u8FD0\u884C\u65F6\u906E\u853D\uFF0C\u5373\u65F6\u751F\u6548\uFF09",
   skillReadonly: "system/runtime \u6280\u80FD\u53EA\u8BFB",
   enable: "\u542F\u7528",
   disable: "\u505C\u7528",
@@ -284,6 +285,7 @@ var enDict = {
   sectionSub: "Manage (static config) \xB7 runtime status lives in the sidebar",
   modelDisabled: "Model disabled",
   toggleModelVisible: "Toggle model visibility",
+  toggleSkillEnabled: "Enable / disable (runtime shadow, applies immediately)",
   skillReadonly: "system/runtime skills are read-only",
   enable: "Enable",
   disable: "Disable",
@@ -458,8 +460,9 @@ function SkillView() {
   if (error !== null) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "smc-sub", children: t("loadFailed", { e: error }) });
   if (items === null) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "smc-sub", children: t("loading") });
   const toggle = (s) => {
-    setBusy(s.path);
-    void rpc("toggleSkill", { path: s.path }).then(
+    setBusy(skillKeyOf(s));
+    const call = s.writable ? rpc("toggleSkill", { path: s.path }) : rpc("setSkillEnabled", { name: s.name, enabled: !s.enabled });
+    void call.then(
       () => {
         setBusy(null);
         load();
@@ -535,19 +538,19 @@ function SkillView() {
             ]
           }
         ),
-        s.writable ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        (s.writable || hasSkillFile(s)) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
           "button",
           {
             type: "button",
-            className: `smc-toggle${s.modelInvocable ? " on" : ""}`,
-            disabled: busy === s.path,
-            title: t("toggleModelVisible"),
+            className: `smc-toggle${(s.writable ? s.modelInvocable : s.enabled) ? " on" : ""}`,
+            disabled: busy === skillKeyOf(s),
+            title: s.writable ? t("toggleModelVisible") : t("toggleSkillEnabled"),
             onClick: () => {
               toggle(s);
             },
-            "aria-label": s.modelInvocable ? t("disable") : t("enable")
+            "aria-label": (s.writable ? s.modelInvocable : s.enabled) ? t("disable") : t("enable")
           }
-        ) : null,
+        ),
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: `smc-chevron${open ? " open" : ""}` })
       ] }),
       open && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "smc-detail", children: [

package/dist/rpc.js

@@ -93,6 +93,13 @@ async function dispatch(ctx, body) {
                     return internal('toggleSkill: path is required');
                 return { ok: true, value: await ctx.skillMcp.toggleSkill(path) };
             }
+            case 'setSkillEnabled': {
+                const name = p.name;
+                if (typeof name !== 'string' || name === '')
+                    return internal('setSkillEnabled: name is required');
+                await ctx.skillMcp.setSkillEnabled(name, p.enabled === true);
+                return { ok: true, value: null };
+            }
             case 'readSkill': {
                 const path = p.path;
                 if (typeof path !== 'string' || path === '')

package/dist/service.d.ts

@@ -25,6 +25,8 @@ export interface SkillView {
     writable: boolean;
     /** Absolute SKILL.md path (the toggle target; opaque to the client display). */
     path: string;
+    /** False when the panel disabled this skill; a runtime placeholder shadows the real definition. */
+    enabled: boolean;
 }
 /** Plugin configuration for the skill/MCP engine. */
 export interface SkillConfig {
@@ -155,6 +157,12 @@ export declare class SkillMcpService extends Service {
     private readonly officialSkillDirs;
     /** Ids toggled by the panel during this run (in-memory only, by design: the host does not persist it). */
     private readonly sessionToggled;
+    /** Skill names the panel disabled; runtime placeholders shadow the real definitions. */
+    private readonly skillsDisabled;
+    /** Live disposers for those shadow registrations, keyed by skill name. */
+    private readonly shadowDisposers;
+    /** Set once the disabled list has been read from disk and replayed. */
+    private shadowsLoaded;
     constructor(ctx: Context, config?: SkillConfig);
     /**
      * Skill roots that live **inside loaded plugin packages**.
@@ -218,6 +226,24 @@ export declare class SkillMcpService extends Service {
     removeMcpServer(id: string): Promise<void>;
     /** Enable/disable one server without deleting its config. The host does not persist this. */
     setMcpServerEnabled(id: string, enabled: boolean): Promise<void>;
+    /** 技能禁用清单的落盘位置：跟在 DSH_HOME 下，隔离实例各自一份。 */
+    private disabledFile;
+    /**
+     * 读回落盘的禁用清单并重放遮蔽。为什么要自己存：registry 不提供「查看被遮蔽定义」的
+     * API（`The registry still exposes no API to inspect shadowed definitions`），
+     * 不落盘的话重启即失忆，面板开关就成了一次性的。
+     */
+    private loadDisabledSkills;
+    private persistDisabledSkills;
+    /**
+     * 停用一条技能：注册同名占位——runtime rank（250）赢过包内 provider（≈550）与 bundled（600），
+     * 两个 invocation 都为 false，于是模型和人都调不到它，但它仍在 catalog 里、可被面板列出。
+     * 这是包内技能**唯一**可逆的停用方式：改名 / 移目录 / 断链对安装内容都不生效。
+     */
+    private applyShadow;
+    private removeShadow;
+    /** 启用/停用一条技能。停用走占位遮蔽、启用调 disposer——不写 SKILL.md、不重启。 */
+    setSkillEnabled(name: string, enabled: boolean): Promise<void>;
     /** Runtime status per server: upstream `mcpStatus` seam when present, else derived. */
     mcpStatus(): Promise<McpServerStatus[]>;
 }

package/dist/service.js

@@ -135,6 +135,7 @@ export async function scanSkillRoot(root, source, writable = true, provider = 'f
             userInvocable: true,
             writable,
             path: skillPath,
+            enabled: true,
         });
     }
     return skills;
@@ -234,6 +235,12 @@ export class SkillMcpService extends Service {
     officialSkillDirs;
     /** Ids toggled by the panel during this run (in-memory only, by design: the host does not persist it). */
     sessionToggled = new Set();
+    /** Skill names the panel disabled; runtime placeholders shadow the real definitions. */
+    skillsDisabled = new Set();
+    /** Live disposers for those shadow registrations, keyed by skill name. */
+    shadowDisposers = new Map();
+    /** Set once the disabled list has been read from disk and replayed. */
+    shadowsLoaded = false;
     constructor(ctx, config = {}) {
         super(ctx, 'skillMcp');
         this.officialSkillDirs = config.officialSkillDirs ?? [];
@@ -256,6 +263,7 @@ export class SkillMcpService extends Service {
      * bundled inside loaded plugin packages, and any configured official roots.
      */
     async listSkills(cwd) {
+        await this.loadDisabledSkills();
         const skills = [];
         for (const root of SKILL_ROOTS) {
             skills.push(...await scanSkillRoot(root.path, root.source));
@@ -271,7 +279,11 @@ export class SkillMcpService extends Service {
             skills.push(...await scanSkillRoot(dir, 'bundled', false, 'dsh-official'));
         }
         skills.push(...await this.runtimeOnlySkills(skills));
-        return skills;
+        return skills.map(skill => ({
+            ...skill,
+            // 只有「清单里有 + 占位注册成功」才算真禁用：同名冲突会让 register 抛错，那时不能谎报禁用。
+            enabled: !(this.skillsDisabled.has(skill.name) && this.shadowDisposers.has(skill.name)),
+        }));
     }
     /**
      * 补上「运行时注册」的 skill：`ctx.skills.register()` 注册的条目没有 SKILL.md，
@@ -308,6 +320,7 @@ export class SkillMcpService extends Service {
                 userInvocable: entry.invocation.userInvocable,
                 writable: false,
                 path: '',
+                enabled: true,
             });
         }
         return extra;
@@ -335,6 +348,7 @@ export class SkillMcpService extends Service {
             userInvocable: true,
             writable: true,
             path,
+            enabled: true,
         };
     }
     /**
@@ -451,6 +465,85 @@ export class SkillMcpService extends Service {
         // 所以这里改的只是内存态；面板据此显示“重启后恢复”，而不是假装它是持久设置。
         this.sessionToggled.add(id);
     }
+    /** 技能禁用清单的落盘位置：跟在 DSH_HOME 下，隔离实例各自一份。 */
+    disabledFile() {
+        const home = process.env.DSH_HOME ?? join(homedir(), '.dsh');
+        return join(home, 'skill-mcp-center', 'disabled-skills.json');
+    }
+    /**
+     * 读回落盘的禁用清单并重放遮蔽。为什么要自己存：registry 不提供「查看被遮蔽定义」的
+     * API（`The registry still exposes no API to inspect shadowed definitions`），
+     * 不落盘的话重启即失忆，面板开关就成了一次性的。
+     */
+    async loadDisabledSkills() {
+        if (!this.shadowsLoaded) {
+            this.shadowsLoaded = true;
+            try {
+                const raw = JSON.parse(await readFile(this.disabledFile(), 'utf8'));
+                if (Array.isArray(raw.names)) {
+                    for (const name of raw.names)
+                        if (typeof name === 'string')
+                            this.skillsDisabled.add(name);
+                }
+            }
+            catch {
+                // 文件不存在 / 损坏 = 没有禁用项。读失败不该让整个面板打不开。
+            }
+        }
+        // 每次调用都补齐缺失的占位：skills 服务可能晚于本插件就绪，只重放一次会永久失效。
+        for (const name of this.skillsDisabled)
+            this.applyShadow(name);
+    }
+    async persistDisabledSkills() {
+        const file = this.disabledFile();
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(file, `${JSON.stringify({ names: [...this.skillsDisabled].sort() }, null, 2)}\n`, 'utf8');
+    }
+    /**
+     * 停用一条技能：注册同名占位——runtime rank（250）赢过包内 provider（≈550）与 bundled（600），
+     * 两个 invocation 都为 false，于是模型和人都调不到它，但它仍在 catalog 里、可被面板列出。
+     * 这是包内技能**唯一**可逆的停用方式：改名 / 移目录 / 断链对安装内容都不生效。
+     */
+    applyShadow(name) {
+        if (this.shadowDisposers.has(name))
+            return;
+        const skills = this.ctx.get('skills');
+        if (skills === undefined)
+            return;
+        try {
+            this.shadowDisposers.set(name, skills.register({
+                name,
+                description: 'Disabled in the Skill & MCP panel.',
+                source: 'runtime',
+                content: '',
+                invocation: { modelInvocable: false, userInvocable: false },
+            }));
+        }
+        catch {
+            // 名字不合法、或该名字的占位已存在：跳过。面板仍按清单显示禁用态，
+            // 调用方可从 listSkills 的实际 invocation 看出遮蔽没成功。
+        }
+    }
+    removeShadow(name) {
+        const dispose = this.shadowDisposers.get(name);
+        if (dispose === undefined)
+            return;
+        this.shadowDisposers.delete(name);
+        dispose();
+    }
+    /** 启用/停用一条技能。停用走占位遮蔽、启用调 disposer——不写 SKILL.md、不重启。 */
+    async setSkillEnabled(name, enabled) {
+        await this.loadDisabledSkills();
+        if (enabled) {
+            this.skillsDisabled.delete(name);
+            this.removeShadow(name);
+        }
+        else {
+            this.skillsDisabled.add(name);
+            this.applyShadow(name);
+        }
+        await this.persistDisabledSkills();
+    }
     /** Runtime status per server: upstream `mcpStatus` seam when present, else derived. */
     async mcpStatus() {
         const servers = await this.listMcpServers();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-skill-mcp-center",
-  "version": "0.6.5",
+  "version": "0.7.0",
   "description": "Skill & MCP management center for DeepSeek Harness — manage skills and MCP servers in Settings, live MCP status in the sidebar",
   "license": "MIT",
   "publishConfig": {