dsh-toolbox-ui 1.6.1 → 1.6.3

package/docs/installation.md

@@ -15,17 +15,17 @@
 推荐用 npm 安装：包里的 `^1.x` 范围让后续 `dsh plugin update` 能自动升级小版本。
 
 ```sh
-dsh plugin --profile web add dsh-toolbox-ui@^1.6.1
+dsh plugin --profile web add dsh-toolbox-ui@^1.6.3
 ```
 
 也可以固定 GitHub release tag（适合需要锁定某个具体版本时）：
 
 ```sh
 # 固定 release tag
-dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.1
+dsh plugin --profile web add github:Imzl-zl/dsh-toolbox-ui#v1.6.3
 
 # 或固定某个 commit
-dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#<commit>
+dsh plugin --profile web add github:Imzl-zl/dsh-toolbox-ui#<commit>
 ```
 
 两种方式的**代码与运行行为完全相同**（包里带预构建的 `lib/`，不需要运行 `prepare`，也不需要配置 `allowBuilds`）；区别只在升级：`^1.x` 范围能被 `dsh plugin update` 自动推进，而 tag/commit 是不可变规格、`update` 只会重新解析同一个规格。
@@ -73,7 +73,7 @@ dsh plugin --profile web update dsh-toolbox-ui
 
 | 安装规格 | `update` 的效果 | 怎么跨版本 |
 |---|---|---|
-| `dsh-toolbox-ui@^1.6.1`（npm，推荐） | 在 `^1.x` 内自动升到最新小版本，不会跨到 2.0.0 | 已是自动；跨大版本显式安装 `@^2` |
+| `dsh-toolbox-ui@^1.6.3`（npm，推荐） | 在 `^1.x` 内自动升到最新小版本，不会跨到 2.0.0 | 已是自动；跨大版本显式安装 `@^2` |
 | `github:...#v1.4.0`（tag） | 重新解析同一个 tag，**不会动** | 换成新 tag 重新 `add`：`... #<新 tag>` |
 | `github:...#<commit>` | 同上，固定在 commit | 用新 commit/tag 重新 `add` |
 | `github:...#main`（分支） | 拉取最新 main | 已是自动；但不推荐生产（无 release 门槛） |
@@ -81,11 +81,11 @@ dsh plugin --profile web update dsh-toolbox-ui
 
 为什么 tag 不会自动跨版本：`dsh plugin` 是 `pnpm` 的薄转发器，`update` 就是「按 package.json 里的 spec 再解析一次」，而 git tag 是不可变规格、没有范围语义（`pnpm update --help`："Updates packages to their latest version **based on the specified range**"）。
 
-面板自带更新提示与一键升级（查 GitHub Releases，每天最多一次、可关闭、不会自己动；点「升级」才装）。npm 安装的用户也可以用命令行 `update` 升级，两者等价。每个 release 都会同时发布到 npm 与 GitHub Releases，两者版本一致。
+面板自带更新提示与一键升级（查 npm registry 上**本包的 latest**，每天最多一次、可关闭、不会自己动；点「升级」才装）。npm 安装的用户也可以用命令行 `update` 升级，两者等价。每个 release 都会同时发布到 npm 与 GitHub Releases，两者版本一致。
 
 ## 发布流程（维护者）
 
-npm 与 GitHub Releases 必须**同一次发布里都更新**：用户从 npm 升级，面板的更新提示查 GitHub Releases。两者版本不一致就会出现「提示说有新版、`update` 却拿不到」。这两件事现在由 `.github/workflows/release.yml` 在推 tag 时自动完成，并且会先校验「tag 与 package.json 版本一致」再跑测试。
+npm 与 GitHub Releases 必须**同一次发布里都更新**：用户从 npm 升级，而面板的更新提示问的正是 npm 上本包的 latest。两者版本不一致就会出现「提示说有新版、`update` 却拿不到」。这两件事现在由 `.github/workflows/release.yml` 在推 tag 时自动完成，并且会先校验「tag 与 package.json 版本一致」再跑测试。
 
 ### 一次性准备（只需做一次）
 
@@ -96,7 +96,8 @@ npm 与 GitHub Releases 必须**同一次发布里都更新**：用户从 npm
    npm publish
    ```
 
-2. 在 npmjs.com 该包的 Settings → **Trusted Publisher** → GitHub Actions，填：organization/user `Imzl-zl`、repository `dsh-mcp-manager-ui`、workflow filename `release.yml`（可另填 environment）。
+2. 在 npmjs.com 该包的 Settings → **Trusted Publisher** → GitHub Actions，填：organization/user `Imzl-zl`、repository `dsh-toolbox-ui`、workflow filename `release.yml`（可另填 environment）。
+   ⚠️ 这里的 repository 是 **GitHub 仓库名**，它必须与仓库当前的 slug 一致——仓库此前叫 `dsh-mcp-manager-ui`，改名之后不同步改这一项，`npm publish` 会被拒（OIDC 凭据里带的就是仓库名）。失败是安全的：CI 那一步会红，不会建 Release。
 3. 之后可选但推荐：把包的 Publishing access 设为 **Require two-factor authentication and disallow tokens** —— trusted publishing 不受该限制影响（它用 OIDC，不是 token），而长期写凭据因此彻底用不上。
 
 ### 每次发布
@@ -112,7 +113,7 @@ dsh web    # 打开面板点一遍
 # 3) 提交并推 tag（CI 会校验 tag 与 version 一致，不一致就拒绝发布）
 git add -A && git commit -m "..."
 git push origin main
-git tag -a v1.6.1 -m "v1.4.2 ..." && git push origin v1.6.1
+git tag -a v1.6.3 -m "dsh-toolbox-ui 1.6.3" && git push origin v1.6.3
 ```
 
 推 tag 后 CI 依次做：校验版本 → `pnpm install --frozen-lockfile` → `npm test` → `npm publish`（trusted publishing，无需 token）→ `gh release create`。
@@ -131,7 +132,7 @@ git tag -a v1.6.1 -m "v1.4.2 ..." && git push origin v1.6.1
 
 ```sh
 npm publish          # 会弹 2FA 挑战；若用 bypass-2FA 的 granular token 则非交互
-gh release create v1.6.1 --title "dsh-toolbox-ui v1.6.1" --notes-file <notes>
+gh release create v1.6.3 --title "dsh-toolbox-ui v1.6.3" --notes-file <notes>
 ```
 
 `npm login` 的会话 token 只有 2 小时，超时需要重新登录；classic token 已被 npm 永久吊销，能非交互发布的只剩勾了 **Bypass 2FA** 的 granular access token——但它正在被 npm 收窄（已不能做账号/包管理类操作，且 2027-01 起将失去直接发布能力），所以长期方案是上面的 trusted publishing。

package/docs/skills.md

@@ -6,9 +6,10 @@
 
 - 技能到底装在哪个作用域（同名技能跨作用域是合法配置，但模型只会收到生效的那一份）；
 - 哪些技能被**停用**了（改名后宿主目录里直接消失，模型和面板都看不见它）——面板会自行扫 `.disabled` 把它们列出来，并给一键恢复；
+- 哪些技能**允许被模型自动调用**，以及就地开关（写的是 `SKILL.md` 的 frontmatter，见[模型自动调用](#允许禁止模型自动调用)）；
 - 装市场里的技能前，你被如实告知了什么、必须确认什么（披露 + 一次显式确认，不做许可判定）。
 
-⚠️ 一个**还没做**的事：宿主对 frontmatter 非法的技能只 `warn` 后跳过，那种技能目前**不会**出现在面板里（要报它得自己扫各根的技能文件并跑一遍校验，见 TODO row 21）。面板不会假装能看到它。
+⚠️ 一个**还没做**的事：宿主对 frontmatter 非法的技能只 `warn` 后跳过，那种技能目前**不会**出现在面板里（要报它得自己扫各根的技能文件并跑一遍校验，见 TODO row 21）。面板不会假装能看到它——所以遇到这种技能时，面板给出的调用权限是「未知」而不是一个猜的值。
 
 ## 打开技能面板
 
@@ -18,7 +19,7 @@
 
 | 模式 | 用途 |
 |---|---|
-| **已安装** | 左列表 + 右详情。看本机已有的技能，启停、删除、查看正文与诊断 |
+| **已安装** | 左列表 + 右详情。看本机已有的技能，启停、改调用权限、删除、查看正文与诊断 |
 | **发现市场** | 卡片网格。**只有一个来源：skillhub.cn**（外部源、直连上游、只做披露 + 显式确认，也是唯一可安装的来源） |
 
 **作用域药丸只在「已安装」模式出现**，而且与列表分组同源（点哪个药丸，就筛出哪一组，
@@ -48,6 +49,26 @@ DSH 的技能没有「disabled」字段（MCP 有，技能没有），所以启
   所以已停用的技能由本面板**自己扫描** `.disabled` 得出，否则你根本看不到它、也没法再启用；
 - 内置（bundled）技能只读，不可启停或删除。
 
+## 允许/禁止模型自动调用
+
+技能可以被**模型自动调用**（模型自己判断该用它），也可以只在你手动点名时才可用。DSH 用 frontmatter 的
+`disable-model-invocation: true` 表达后者；面板把它做成详情页「技能属性」里的一个开关（**模型自动调用**），
+不必再去手工翻 `SKILL.md`。列表行上那个「仅用户可调用」徽章说的就是同一件事。
+
+- **状态一律取自技能文件本身**，不取宿主的发现缓存：宿主对同一个文件的改写会继续报旧值（停用改名就是这样，实测过），
+  而这里正是面板要**写**的东西——写盘后显示回退，用户看到的是「点了没反应」。所以行与详情里的调用权限都是
+  从那个文件里解析出来的，与正文同一份字节。
+- **读不出来就说「不知道」**：frontmatter 非法的技能宿主会整条跳过，此时面板显示「调用权限未知」且开关不可点。
+  编一个「不可调用」出来就是撒谎——**已停用**的技能此前正是这样被显示的（它的权限只有那份 `.disabled` 文件能回答），
+  这个缺陷随本开关一并修掉。
+- **只改那一行，不重排你的文件**：关闭时把那**一行**删掉（缺省就是「允许」，所以关掉不留痕迹，开→关能逐字节还原原文）；
+  打开时若已有该字段就地把值改成 `true`，没有才在 frontmatter **末尾**追加一行。字段顺序、缩进、正文、CRLF 风格都不动。
+- **形状读不准就拒绝**：值是块标量或跨了多行、要在带行尾注释的那一行上**打开**它（关掉是整行删除，
+  边界确定，注释随行而去）、或文件里有宿主会拒绝的驼峰键（`disableModelInvocation`）时，
+  面板会拒绝并在界面上说明原因，让你手工改——猜一个改法等于改坏你的技能文件。
+- **生效时机**：写的是文件，宿主**重新发现**这条技能之后才影响模型（重启 DSH 最稳妥）。面板显示的是磁盘上的值。
+- 内置（bundled）技能只读，开关呈**禁用**（与启停/删除同一约定：渲染出来但点不动）。
+
 ## 安装技能
 
 市场里点「安装」会先给你一份披露（安装确认弹窗）：

package/lib/client.js

@@ -2823,7 +2823,8 @@ const McpTab = (props) => {
     return startVisibilityAwarePolling(typeof document === 'undefined' ? null : document, timer, POLL_INTERVAL_MS, () => load(false));
   }, [load, timer]);
 
-  // 更新提示：Host 每天最多查一次 GitHub Releases；纯增值信息，任何失败都静默，不打扰面板。
+  // 更新提示：Host 每天最多查一次 npm registry（本包的 latest 端点，见 lib/index.js 的
+  // updateLatestUrl）；纯增值信息，任何失败都静默，不打扰面板。
   useEffect(() => {
     let cancelled = false;
     call('updateHint').then((res) => {
@@ -3301,7 +3302,7 @@ const McpTab = (props) => {
           : h('a', {
             key: 'link',
             className: 'dsh-mcp-btn sm',
-            href: (updateHint && updateHint.url) || 'https://github.com/Imzl-zl/dsh-mcp-manager-ui/releases',
+            href: (updateHint && updateHint.url) || 'https://github.com/Imzl-zl/dsh-toolbox-ui/releases',
             target: '_blank',
             rel: 'noreferrer',
           }, upgradeState.phase === 'done' ? '看这次改了什么' : '查看更新方式'),
@@ -3520,6 +3521,8 @@ const McpTab = (props) => {
     sortKey: skillSort,
     onSort: setSkillSort,
     onSummary: onSkillsSummary,
+    // 技能面的行动作失败时要说出宿主的原话（见 SkillsPanel 里 act 的说明）——与 MCP 面共用这一条 flash。
+    flash,
   });
 
   const inner = h(
@@ -4121,12 +4124,16 @@ const SkillGroupHeader = ({ group, collapsed, onToggleCollapse }) => h(
 );
 
 /** 管理模式的右侧详情：元信息 + 正文 + 启停/删除（与 MCP 面同一张详情卡片）。 */
-const SkillDetail = ({ row, shadowedBy, body, busy, onRetry, onToggle, onRemove, tab = 'overview', onTab }) => {
+const SkillDetail = ({ row, shadowedBy, body, busy, onRetry, onToggle, onRemove, onModelInvocable, tab = 'overview', onTab }) => {
   if (!row) return h('div', { className: 'dsh-mcp-detail' }, h('div', { className: 'dsh-mcp-d-empty' },
     h('b', null, '选择左侧的一个技能'),
     h('span', null, '这里会显示它的位置与调用权限、SKILL.md 正文，以及遮蔽或校验失败时的诊断。')));
   const disabled = row.enabled === false;
   const readonly = row.writable === false;
+  // 调用权限的**三态**：true / false / 未知。未知是真实的一态——宿主对 frontmatter 非法的技能
+  // 整条跳过，那时「能不能被模型调用」没有答案。此前它被渲染成「不可调用」，那是凭空的断言
+  // （已停用的行尤其明显：它们的权限只有我们读得到的那份文件能回答）。
+  const invocationKnown = row.modelInvocable === true || row.modelInvocable === false;
   const paneOff = (id) => detailPaneOff(tab, id);
   const tabBtn = (id, label, count) => detailTab(tab, onTab, id, label, count);
   // 「（加载中…）」只能出现在**真的在加载**的时候。之前失败也落到这句兜底文案上
@@ -4156,8 +4163,10 @@ const SkillDetail = ({ row, shadowedBy, body, busy, onRetry, onToggle, onRemove,
         ),
         h('div', { className: 'dsh-mcp-d-meta' },
           h(Badge, { cls: disabled ? 's-off' : shadowedBy ? 's-warn' : 's-on' }, disabled ? '已停用' : shadowedBy ? '被遮蔽' : '已启用'),
-          h(Badge, null, row.modelInvocable ? '模型可调用' : '模型不可调用'),
-          h(Badge, null, row.userInvocable ? '用户可调用' : '用户不可调用'),
+          invocationKnown
+            ? h(Badge, { cls: row.modelInvocable ? null : 's-off' }, row.modelInvocable ? '模型可调用' : '模型不可调用')
+            : h(Badge, { cls: 's-off', title: 'SKILL.md 的 frontmatter 读不出来（宿主会跳过这条技能），无法判断它的调用权限' }, '调用权限未知'),
+          invocationKnown && !row.userInvocable ? h(Badge, { cls: 's-off' }, '用户不可调用') : null,
         ),
         h('p', { className: 'dsh-mcp-d-desc' }, row.description || '（无说明）'),
       ),
@@ -4191,8 +4200,26 @@ const SkillDetail = ({ row, shadowedBy, body, busy, onRetry, onToggle, onRemove,
           // 作用域与根目录合成一行：分组之后「哪一级」已由组头说过，这里只补完整路径。
           h('b', null, '位置'), h('span', null, (row.root || '（未报告）') + '（' + skillScopeLabel(row) + '）'),
           h('b', null, '状态'), h('span', null, disabled ? '已停用（SKILL.md.disabled）' : '已启用'),
-          h('b', null, '模型可调用'), h('span', null, row.modelInvocable ? '是' : '否'),
-          h('b', null, '用户可调用'), h('span', null, row.userInvocable ? '是' : '否'),
+          // 「模型自动调用」是**可操作**的那一项（issue #5：快速改 disable-model-invocation，
+          // 不必手工去翻 SKILL.md）。写在 SKILL.md 的 frontmatter 里，所以只在可写根上给开关；
+          // 权限读不出来时不装懂——开关禁用并写明未知。
+          h('b', null, '模型自动调用'),
+          h('span', null,
+            h(Toggle, {
+              on: row.modelInvocable === true,
+              disabled: busy || readonly || !invocationKnown,
+              label: row.name + '：允许模型自动调用',
+              title: readonly
+                ? '内置技能只读'
+                : invocationKnown
+                  ? '写入 SKILL.md 的 disable-model-invocation；宿主重新发现这条技能后才影响模型（重启 DSH 最稳妥）'
+                  : 'SKILL.md 的 frontmatter 读不出来（宿主会跳过这条技能），无法判断当前状态',
+              onChange: () => onModelInvocable(row, row.modelInvocable !== true),
+            }),
+            ' ',
+            invocationKnown ? (row.modelInvocable ? '允许' : '禁止') : '未知',
+          ),
+          h('b', null, '用户可调用'), h('span', null, invocationKnown ? (row.userInvocable ? '是' : '否') : '未知'),
         ),
       ),
       h('div', { className: 'dsh-mcp-card' + paneOff('text') },
@@ -4403,7 +4430,7 @@ const HubCard = ({ entry, installed, onInstall }) => h(
  */
 // ⚠️ 它**不接** onClose / floating / onMode：悬浮外壳（wrapFloating）与模式分段都归 McpTab，
 // 面板只负责「技能面那具身体」。留着没人用的 prop 会让下一个人以为这里还能控制面板开关。
-const SkillsPanel = ({ call, workspaces, mode = 'manage', scopeFilter = 'all', onScopeFilter, sortKey = 'default', onSort, onSummary }) => {
+const SkillsPanel = ({ call, workspaces, mode = 'manage', scopeFilter = 'all', onScopeFilter, sortKey = 'default', onSort, onSummary, flash }) => {
   const [rows, setRows] = useState([]);
   // ⚠️ 选中存的是**身份**（行 key），行对象从当前 rows **派生**——不存对象本身。
   // 存对象会留住"上一次取数时的那个对象"：面板里刚启停一个技能后列表刷新，详情却还在渲染
@@ -4535,56 +4562,69 @@ const SkillsPanel = ({ call, workspaces, mode = 'manage', scopeFilter = 'all', o
     void loadBody(row);
   }, [loadBody]);
 
-  const toggleRow = useCallback(async (row, enable) => {
-    // 双向：MCP 面每行都有启用/停用开关，技能面必须同样能**恢复**已停用的技能
-    // （原先只有停用单向，已停用条目只能看、没有任何恢复入口）。
-    const next = enable === undefined ? row.enabled === false : enable === true;
+  // 行动作的统一出口——与 MCP 面的 act 同一条纪律：**失败必须说出来**。宿主拒绝时给的是具体
+  // 原因（「这个字段的值跨了多行，请手工修改这一行」这类），吞掉它就只剩「点了没反应」；而技能面
+  // 的动作真的动用户的文件，那句原因正是用户唯一能据以修好的信息。成功才重新取数。
+  // 返回 true = 成功，调用方据此决定要不要做后续（清选中、关弹窗）。
+  const act = useCallback(async (method, payload) => {
     setBusy(true);
     try {
-      // 只送**引用**（source + root + 项目路径），不送 writable：可写与否由服务端判定，
-      // 客户端传什么不算数（否则「只读根不可写」只是客户端的礼貌）。
-      await call('setEnabled', { name: row.name, source: row.source, root: row.root, projectPath: row.cwd, enabled: next });
+      const res = await call(method, payload);
+      if (!res || res.ok !== true) {
+        flash?.((res && res.error) || method + ' 失败', 'err');
+        return false;
+      }
       await load();
+      return true;
     } finally { setBusy(false); }
-  }, [call, load]);
+  }, [call, flash, load]);
+
+  const toggleRow = useCallback(async (row, enable) => {
+    // 双向：MCP 面每行都有启用/停用开关，技能面必须同样能**恢复**已停用的技能
+    // （原先只有停用单向，已停用条目只能看、没有任何恢复入口）。
+    const next = enable === undefined ? row.enabled === false : enable === true;
+    // 只送**引用**（source + root + 项目路径），不送 writable：可写与否由服务端判定，
+    // 客户端传什么不算数（否则「只读根不可写」只是客户端的礼貌）。
+    await act('setEnabled', { name: row.name, source: row.source, root: row.root, projectPath: row.cwd, enabled: next });
+  }, [act]);
+
+  const toggleModelInvocable = useCallback(async (row, modelInvocable) => {
+    // 「允许模型自动调用」的开关：写技能文件里的 disable-model-invocation（issue #5）。
+    // 与启停同一条纪律：只送引用，可写与否由服务端判定。
+    // 重新取数在 act 里：行上的权限来自**磁盘上的那个文件**（宿主侧从文件解析），刷出来的就是
+    // 真正写下去的值；被拒绝时文件没变，开关如实停在原位，而原因由 act 说出来。
+    await act('setModelInvocable', { name: row.name, source: row.source, root: row.root, projectPath: row.cwd, modelInvocable: modelInvocable === true });
+  }, [act]);
 
   const removeRow = useCallback(async (row) => {
     // 「删除技能」是**真删**（宿主 removeSkill：目录捆绑连目录、扁平删文件）。
     // 之前这个菜单项接的是 toggleRow —— 点删除只会把技能停用，还报成功。
     if (!confirm('确认删除技能「' + row.name + '」？' + (row.kind === 'bundle' ? '整个目录（含 scripts/references）' : '该文件') + '会从磁盘移除，不可撤销。')) return;
-    setBusy(true);
-    try {
-      await call('removeSkill', { name: row.name, source: row.source, root: row.root, projectPath: row.cwd });
-      setSelectedKey('');
-      await load();
-    } finally { setBusy(false); }
-  }, [call, load]);
+    // 删成功才清选中：失败时那一行还在，清掉选中只会让用户面对一个空详情、还不知道为什么。
+    if (await act('removeSkill', { name: row.name, source: row.source, root: row.root, projectPath: row.cwd })) setSelectedKey('');
+  }, [act]);
 
   const confirmInstall = useCallback(async (target) => {
-    setBusy(true);
-    try {
-      // 落点按**安装目标的唯一身份**（source + root）解析：两个工作区会有同一个 source，
-      // 按 source `find` 会静默装进第一个（用户以为选了项目 B，实际写进项目 A）。
-      const option = installTargets.find((item) => item.id === scope) || installTargets[0] || {};
-      // writable 是显式声明：宿主默认按可写处理，所以这里的 true 必须与
-      // 「只列可写目标」这个前提一致，不能靠默认值蒙。
-      //
-      // 市场只有外部源这一条路：宿主下载上游 zip 再走**同一个** importSkill 落盘——
-      // 落点因此仍然由面板选，而不是上游说了算。
-      await call('skillHubInstall', {
-        slug: target.slug,
-        version: target.version,
-        // 落点只送引用；`acknowledged` 是**服务端**要求的确认（UI 的勾选框只是它的界面）。
-        source: option.source,
-        root: option.root,
-        projectPath: option.projectPath,
-        acknowledged: true,
-      });
-      setEntry(null);
-      setHubDetail(null);
-      await load();
-    } finally { setBusy(false); }
-  }, [call, installTargets, load, scope]);
+    // 落点按**安装目标的唯一身份**（source + root）解析：两个工作区会有同一个 source，
+    // 按 source `find` 会静默装进第一个（用户以为选了项目 B，实际写进项目 A）。
+    const option = installTargets.find((item) => item.id === scope) || installTargets[0] || {};
+    // writable 是显式声明：宿主默认按可写处理，所以这里的 true 必须与
+    // 「只列可写目标」这个前提一致，不能靠默认值蒙。
+    //
+    // 市场只有外部源这一条路：宿主下载上游 zip 再走**同一个** importSkill 落盘——
+    // 落点因此仍然由面板选，而不是上游说了算。
+    const ok = await act('skillHubInstall', {
+      slug: target.slug,
+      version: target.version,
+      // 落点只送引用；`acknowledged` 是**服务端**要求的确认（UI 的勾选框只是它的界面）。
+      source: option.source,
+      root: option.root,
+      projectPath: option.projectPath,
+      acknowledged: true,
+    });
+    // 装失败时弹窗留在原地（用户要能看到失败原因、能重试），只有成功才收起来。
+    if (ok) { setEntry(null); setHubDetail(null); }
+  }, [act, installTargets, scope]);
 
   // 列表过滤：作用域（第二行的药丸）→ 状态 → 搜索词 → 排序。
   // 顺序有讲究：先按作用域收窄，才知道「这个作用域里有几个已停用」。
@@ -4696,6 +4736,7 @@ const SkillsPanel = ({ call, workspaces, mode = 'manage', scopeFilter = 'all', o
           busy,
           onRetry: () => void loadBody(selected),
           onToggle: toggleRow,
+          onModelInvocable: toggleModelInvocable,
           onRemove: removeRow,
         }),
       )
@@ -4999,6 +5040,7 @@ const MCP_CONTRIBUTION = {
     sk('list', [skParam('payload', 'SkillPayload')], 'SkillListResult'),
     sk('detail', [skParam('payload', 'SkillPayload')], 'SkillDetailResult'),
     sk('setEnabled', [skParam('payload', 'SkillPayload')], 'SkillMutationResult'),
+    sk('setModelInvocable', [skParam('payload', 'SkillPayload')], 'SkillMutationResult'),
     sk('removeSkill', [skParam('payload', 'SkillPayload')], 'SkillMutationResult'),
     sk('importSkill', [skParam('payload', 'SkillPayload')], 'SkillMutationResult'),
     sk('skillTargets', [skParam('payload', 'SkillPayload')], 'SkillTargetsResult'),

package/lib/index.js

@@ -12,8 +12,8 @@ import { admitImportedServers } from "./import-admission.js";
 import { collectImportLocations, missingEnvNames, resolveImportLocation } from "./mcp-import-sources.js";
 import { deriveMcpPhase, formatMcpLog, sanitizeMcpLog } from "./mcp-observability.js";
 import { allMcpEntries, entriesForName, projectToolSchema, revisionOf, toolInventory } from "./mcp-registry.js";
-import { listSkillViews, resolveTargetReference, skillRowKey, skillTargetsView } from "./skills-registry.js";
-import { importSkill, readSkillFile, removeSkill, resolveSkillTarget, scanDisabledSkills, setSkillEnabled } from "./skills-file-ops.js";
+import { invocationOf, listSkillViews, resolveTargetReference, skillRowKey, skillTargetsView } from "./skills-registry.js";
+import { importSkill, readSkillDocument, removeSkill, resolveSkillTarget, scanDisabledSkills, setSkillEnabled, setSkillModelInvocable } from "./skills-file-ops.js";
 import { downloadHubArchive, hubCategories, hubSkillDetail, searchHubSkills } from "./skillhub.js";
 import { setOwn } from "./own-property.js";
 import { WHATS_NEW } from "./whats-new.js";
@@ -300,10 +300,18 @@ function containsRedactedValue(value) {
 	return false;
 }
 // ---------- 更新提示（被动、可关闭、绝不自动更新） ----------
-// 面板打开时客户端会调一次 updateHint：Host 每天最多向 GitHub Releases 发一次查询
-// （进程内缓存），有新版时返回供面板显示可关闭的提示条。查询失败、超时、限流或
-// 被 DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK 禁用时静默无提示——这是有意设计：
-// 更新提示是纯增值信息，不允许影响面板可用性；除这一条 GET 外不发送任何数据。
+// 面板打开时客户端会调一次 updateHint：Host 每天最多向 npm registry 发一次查询（进程内缓存），
+// 有新版时返回供面板显示可关闭的提示条。查询失败、超时、限流或被
+// DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK 禁用时静默无提示——这是有意设计：更新提示是纯增值信息，
+// 不允许影响面板可用性；除这一条 GET 外不发送任何数据。
+//
+// ⚠️ 问的是**本包在 npm 上的 latest**，不是本仓库的 `/releases/latest`：同一个仓库承载两条产品线
+// （本线 `dsh-toolbox-ui` 与老线那个包——两个名字见 release.yml），而仓库级 "latest" 是**共用**的单个
+// 槽位，且必须留给老线——老线（≤1.5.3）面板的「升级」按钮读的正是那里，下发的却是**它自己那个包名**的
+// 版本，所以本线的 Release 一直带 `--prerelease`（见 release.yml 的说明），让 latest 停在老线的
+// 版本上。本线若也读那个 feed，读到的永远是旧线的版本号 → 提示恒为「已是最新」：新版本发出去，
+// 装了本线的用户什么也看不到（v1.6.1 → v1.6.2 就这样哑掉过一次）。
+// 包名由 package.json 派生（pluginName）：写死任何一个包名都会在另一条线上静默错。
 /**
  * 让位检测（`conflictingManager`）的自身判据：**loader 条目的 `name` 等于本包名**。
  *
@@ -333,12 +341,20 @@ function isMcpManagerPluginName(name) {
 	return lower.includes("mcp") && lower.includes("manager");
 }
 
-const UPDATE_CHECK_URL = "https://api.github.com/repos/Imzl-zl/dsh-mcp-manager-ui/releases/latest";
 const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_CHECK_TIMEOUT_MS = 5000;
 const UPDATE_CHECK_DISABLED_ENV = "DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK";
 let updateCheckState = { checkedAt: 0, result: null };
 
+/** 本包在 npm 上的 latest 端点；包名读不到就没有端点（当作无提示，不猜一个包名）。 */
+function updateLatestUrl() {
+  const name = pluginName();
+  return name === "" ? null : `https://registry.npmjs.org/${encodeURIComponent(name)}/latest`;
+}
+
+/** 说明页：两条线的 tag 都是 vX.Y.Z，故由版本号拼本仓库的 release 页（与老线的 updateHint 一致）。 */
+const releasePageOf = (version) => `https://github.com/Imzl-zl/dsh-toolbox-ui/releases/tag/v${version}`;
+
 function pluginVersion() {
   try {
     return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version ?? "";
@@ -376,15 +392,22 @@ async function checkForUpdate(now = Date.now(), force = false) {
   if (!force && cached && now - updateCheckState.checkedAt < UPDATE_CHECK_INTERVAL_MS && cached.current === current) return cached;
   let latest = null;
   let url = null;
+  const endpoint = updateLatestUrl();
   try {
-    const response = await fetch(UPDATE_CHECK_URL, {
-      headers: { accept: "application/vnd.github+json" },
-      signal: AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS),
-    });
-    if (response.ok) {
-      const body = await response.json();
-      if (typeof body?.tag_name === "string") latest = body.tag_name.replace(/^v/, "");
-      if (typeof body?.html_url === "string") url = body.html_url;
+    if (endpoint !== null) {
+      const response = await fetch(endpoint, {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS),
+      });
+      if (response.ok) {
+        const body = await response.json();
+        // npm 的 `/<包名>/latest` 只给版本号，没有页面链接——提示条要指得出「更新了什么」，
+        // 所以由版本号拼 release 页（两线共用 vX.Y.Z 的 tag 命名）。
+        if (typeof body?.version === "string" && body.version !== "") {
+          latest = body.version;
+          url = releasePageOf(latest);
+        }
+      }
     }
   } catch {
     // 离线/超时/限流：视作无新版，提示缺失比面板报错更可接受。
@@ -1425,7 +1448,7 @@ let McpManagerGateway = (() => {
 let SkillsManagerGateway = (() => {
 	let _classSuper = TypertRemoteService;
 	let _instanceExtraInitializers = [];
-	let _list_decorators, _detail_decorators, _setEnabled_decorators, _removeSkill_decorators, _importSkill_decorators, _skillTargets_decorators, _skillHubSearch_decorators, _skillHubDetail_decorators, _skillHubCategories_decorators, _skillHubInstall_decorators, _conflictingManager_decorators;
+	let _list_decorators, _detail_decorators, _setEnabled_decorators, _setModelInvocable_decorators, _removeSkill_decorators, _importSkill_decorators, _skillTargets_decorators, _skillHubSearch_decorators, _skillHubDetail_decorators, _skillHubCategories_decorators, _skillHubInstall_decorators, _conflictingManager_decorators;
 	return class SkillsManagerGateway extends _classSuper {
 		static {
 			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
@@ -1435,6 +1458,8 @@ let SkillsManagerGateway = (() => {
 			__esDecorate(this, null, _detail_decorators, { kind: "method", name: "detail", static: false, private: false, access: { has: (obj) => "detail" in obj, get: (obj) => obj.detail }, metadata: _metadata }, null, _instanceExtraInitializers);
 			_setEnabled_decorators = [Remote("setEnabled")];
 			__esDecorate(this, null, _setEnabled_decorators, { kind: "method", name: "setEnabled", static: false, private: false, access: { has: (obj) => "setEnabled" in obj, get: (obj) => obj.setEnabled }, metadata: _metadata }, null, _instanceExtraInitializers);
+			_setModelInvocable_decorators = [Remote("setModelInvocable")];
+			__esDecorate(this, null, _setModelInvocable_decorators, { kind: "method", name: "setModelInvocable", static: false, private: false, access: { has: (obj) => "setModelInvocable" in obj, get: (obj) => obj.setModelInvocable }, metadata: _metadata }, null, _instanceExtraInitializers);
 			_removeSkill_decorators = [Remote("removeSkill")];
 			__esDecorate(this, null, _removeSkill_decorators, { kind: "method", name: "removeSkill", static: false, private: false, access: { has: (obj) => "removeSkill" in obj, get: (obj) => obj.removeSkill }, metadata: _metadata }, null, _instanceExtraInitializers);
 			_importSkill_decorators = [Remote("importSkill")];
@@ -1480,6 +1505,10 @@ let SkillsManagerGateway = (() => {
 						source: target.source,
 						cwd: target.projectPath,
 						writable: target.writable !== false,
+						// 调用权限与可见行走**同一处**推导（skills-registry 的 invocationOf）：宿主目录里
+						// 看不到停用件，这个文件是唯一能回答「能不能被模型调用」的地方。缺了它，客户端
+						// 会把「未知」渲染成「不可调用」——一个凭空的断言。
+						...(await invocationOf({ name: row.name, root: target.root, scope: target.scope })),
 					});
 				}
 			}
@@ -1519,10 +1548,15 @@ let SkillsManagerGateway = (() => {
 				scope: target.scope,
 				writable: target.writable !== false,
 			});
+			// 正文与调用权限来自**同一次读**（readSkillDocument 的契约）：分两次读会配错版本，
+			// 用户看到的就是「这份正文 + 别人的权限」。
+			const document = await readSkillDocument(resolved);
 			return {
 				skill: {
 					name,
-					content: await readSkillFile(resolved),
+					content: document.text,
+					modelInvocable: document.invocation?.modelInvocable ?? null,
+					userInvocable: document.invocation?.userInvocable ?? null,
 					kind: resolved.kind,
 					path: resolved.path,
 					enabled: resolved.disabled !== true,
@@ -1548,6 +1582,23 @@ let SkillsManagerGateway = (() => {
 			});
 			return await setSkillEnabled(resolved, payload?.enabled !== false);
 		}
+		async setModelInvocable(payload) {
+			// 「允许模型自动调用」的开关：写技能文件的 disable-model-invocation。纪律与 setEnabled
+			// 完全一致——wire 只送引用、服务端核对自己算出来的目标、只读根拒绝；改写的形状规则在
+			// lib/skills-frontmatter.js，读不准时那个错误原样上抛给用户。
+			const target = await resolveTargetReference(this.ctx, {
+				source: payload?.source,
+				root: payload?.root,
+				projectPath: payload?.projectPath,
+			});
+			const resolved = await resolveSkillTarget({
+				name: String(payload?.name ?? ""),
+				root: target.root,
+				scope: target.scope,
+				writable: target.writable !== false,
+			});
+			return await setSkillModelInvocable(resolved, payload?.modelInvocable !== false);
+		}
 		async removeSkill(payload) {
 			const target = await resolveTargetReference(this.ctx, {
 				source: payload?.source,

package/lib/skills-file-ops.js

@@ -14,9 +14,9 @@ import { cp, lstat, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFi
 import { randomBytes } from 'node:crypto'
 import { tmpdir } from 'node:os'
 import { join, relative } from 'node:path'
-import { withFileLock } from '@deepseek-ai/dsh-atomic-write'
+import { withFileLock, writeFileAtomic } from '@deepseek-ai/dsh-atomic-write'
 import { MAX_ARCHIVE_BYTES, extractArchive } from './skills-archive.js'
-import { diagnoseSkill } from './skills-frontmatter.js'
+import { diagnoseSkill, setFrontmatterBoolean } from './skills-frontmatter.js'
 
 // 与宿主同一套名字语法（dsh-skill 的 SKILL_NAME）。它天然排除 '.'、'/'、'\\'，
 // 所以合法名字不可能跳出根目录——但越界校验仍然保留，因为这是系统边界。
@@ -166,12 +166,53 @@ export async function scanDisabledSkills(input) {
 }
 
 /**
- * 读取技能文件正文。
- * @param {object} target
- * @returns {Promise<string>}
+ * 读一个技能文件：正文**和它在磁盘上的调用权限**一次给出。
+ *
+ * 为什么合成一个入口：分两次读会读到两个版本（改动正好落在两次读之间），面板于是显示一份正文
+ * 配一个不属于它的权限。调用权限一律从**这份读到的字节**里解析出来，所以它天然与正文同源。
+ *
+ * 解析不出来时 `invocation` 是 `null`——**不知道就说不知道**。非法 frontmatter 的技能会被宿主
+ * 整条跳过，此时「模型能不能调用它」没有答案，编一个布尔值就是让面板撒谎。
+ *
+ * @param {object} target - resolveSkillTarget 的结果。
+ * @returns {Promise<{ text: string, invocation: null | { modelInvocable: boolean, userInvocable: boolean } }>}
+ */
+export async function readSkillDocument(target) {
+  const text = await readFile(target.path, 'utf8')
+  return { text, invocation: diagnoseSkill(text).invocation ?? null }
+}
+
+/**
+ * 改一个技能的「模型自动调用」权限——写的是它 frontmatter 里的 disable-model-invocation。
+ *
+ * 与启停同一套纪律：只读根拒绝、同一把锁（root + name，见 setSkillEnabled 的说明）、
+ * 读-改-写全在锁内、原子提交（writeFileAtomic 写临时文件再 rename）。改写规则本身在
+ * lib/skills-frontmatter.js：形状读不准时它抛错，本层**原样放行那个错误**——拒绝的原因
+ * 只有那一处知道，包一层只会把「哪一行不对」这类信息丢掉。
+ *
+ * @param {object} target - resolveSkillTarget 的结果（已停用的技能也收，权限与启用态无关）。
+ * @param {boolean} modelInvocable - true 允许模型自动调用，false 禁止。
+ * @returns {Promise<{ changed: boolean, modelInvocable: boolean }>}
  */
-export async function readSkillFile(target) {
-  return await readFile(target.path, 'utf8')
+export async function setSkillModelInvocable(target, modelInvocable) {
+  if (target.writable === false) {
+    throw new Error('该技能来自只读根（bundled），不可修改调用权限')
+  }
+  const next = modelInvocable !== false
+  // 锁键与启停/删除/导入一致：同名技能上的这些操作必须彼此串行，否则「读到旧内容 → 写回」
+  // 会把另一次操作的结果覆盖掉（例如与删除交错时把技能文件重新写出来）。
+  return await withFileLock(join(target.root, target.name), async () => {
+    const text = await readFile(target.path, 'utf8')
+    // 字段名说的是「禁止」而不是「允许」：modelInvocable === false ⇔ disable-model-invocation: true。
+    const written = setFrontmatterBoolean(text, 'disable-model-invocation', !next)
+    if (written.changed) {
+      // 原子替换是「写临时文件再 rename」，新文件的权限位会退回默认值。技能文件是用户自己的
+      // 资产，动它一个字不该顺手把它的权限也改掉——照抄 profile 写盘的纪律，保留原 mode。
+      const { mode } = await stat(target.path)
+      await writeFileAtomic(target.path, written.text, { mode })
+    }
+    return { changed: written.changed, modelInvocable: next }
+  })
 }
 
 /**