dsh-plugin-tool-management 0.16.0 → 0.16.5

package/CHANGELOG.md

@@ -10,6 +10,30 @@
 
 ---
 
+## [0.16.5] - 2026-09-30
+
+issue #1 收尾与桌面版第二轮适配：兼容页身份比对改为逐包解析、逐包核对（桌面版不再误报「两份不同拷贝」），「全部可用」与「N 项不可用」不再同屏；桌面版注入会话的 4 个官方内置技能接入技能页管理。
+
+### 修复
+
+- **桌面版兼容页误报 5 条「两份不同拷贝」**：宿主侧的身份比对把「realpath 机制整轮不变」错写成了连**解析结果**一起复用 —— 第一个包（cordis）的宿主侧入口路径被当成其余五个包的宿主侧路径，五条全部比成「与 cordis 不同」→ 5 条假阻塞项，banner「能力 18/18 · 全部可用」与红卡「5 项不可用」同屏（桌面版 0.2.0-rc.2 实测全中）。现在逐包解析、逐包取真实形态 —— 解析本就便宜，Node 自身还有缓存；同日新旧对比实测：旧代码 1 真 / 5 假 + 5 条阻塞，修复后 6 真 / 0 阻塞。
+- **安装形态下的修复指引不再是跑不了的命令**（issue #1 次要问题 1）：阻塞项原文让人去跑 `node scripts/host-deps.mjs --fix`，而 `package.json` 的 `files` 不含 `scripts/`（开发者脚本本就不该随发布走），npm 装出来的用户照做只会拿到 `MODULE_NOT_FOUND` —— 指引指了一条不存在的路。现在按**实际形态**给：源码检出（插件旁边就有 `scripts/host-deps.mjs`）保留原文，并点明要「在插件源码目录」跑；npm 安装形态改说「升级或重装本插件后仍然如此再报」。兼容页底部那句「可运行 node scripts/doctor.mjs 查看」同理分两键，安装形态下不再指命令。
+- **路径取不到真实形态时不再编一个「两份拷贝」的结论**（issue #1 次要问题 2）：`realPathOf()` 以前 `catch { return value }`，把「这条路径不可解析」静默降级成「拿输入去比较」—— 于是路径/权限问题看起来就是「插件与宿主加载的是两份不同拷贝」，用户照着它去修只会白费功夫。现在取不到真实形态就**如实记原因**（`error.code` 与消息原文），这类包给 `sameAsHost = null`（比不了）并单独出一条说明，带包名、哪一侧（`host` / `plugin`）、解析到的路径与失败原因；界面显示「无法比较（路径取不到真实形态）」并列出两侧。
+- **兼容页不再一边「全部可用」一边挂着红卡**：能力注脚与红卡高亮此前把「身份待处理」（两份拷贝这类 —— 不影响能力可用性）混进了能力降级计数。现在两处只看能力降级数；汇总行三分：全可用 / 能力降级 / 身份待处理（新增词典键 `compat.summary.identity`），各说各的。
+
+### 新增
+
+- **官方内置技能接入管理**：桌面版宿主向每个会话注入 4 个官方内置技能（office-docx / office-pptx / office-xlsx / diagnose-windows-sandbox-acl），此前技能页看不见、也关不掉。现在它们以单一「官方内置」来源出现在技能页，紧跟 DSH 技能之后：每次宿主启动从官方源头整目录**物化**成插件自有的一份真实目录（`$DSH_HOME/tool-management/official-skills/`；office 取自桌面运行时目录 `<resources>/runtime/office-skills`，沙盒诊断取自官方 asar 包内资源 —— 官方自己的副本一个在 asar 里、一个由官方 provider 复制进临时目录自管，直接指着读既不稳，也没法让 PowerShell / Python 子进程执行脚本），扫描、启停、脚本执行全部落在真实文件上；单个技能可启停（overlay 以 rank 599 压过官方 provider 的 600），来源层与默认来源同语义（不可移除、无来源开关、源文件只读）。web 宿主不注入任何官方内置技能，这个来源**不出现** —— 物化目录虽与各宿主共用，非桌面宿主绝不进来重建（web 宿主进程里的官方模块拦截器能把 `@deepseek-ai` 裸名解析到宿主副本，若也重建会把桌面物化好的整目录清成它解析到的那几个；2026-09-30 实测两份 UI 同时只剩沙盒 1 个）。预设参考技能（dsh-agent-preset/skills）不注入会话上下文，不列（用户裁定）。
+
+### 变更
+
+- **源码检出与 npm 安装形态的行为差异，只在指引上一处**：`/dsh-plugin-tool-management` 里有没有 `scripts/host-deps.mjs` 决定给哪句指引（本插件不从 `scripts/` 加载任何东西），其余判定完全一致。
+
+### 说明
+
+- **收尾范围**：issue #1 的主因（`import.meta.resolve` 的 URL 未解码，含空格路径必现；macOS 上开头斜杠被一起删掉）已在 0.16.0 随 `fileURLToPath` 修掉，本版带次要两条的收尾、身份比对的逐包核对与官方内置技能管理。
+- **实测**：源码检出与安装形态两种位置的 `isSourceInstall()` 分别得 `true` / `false`；注入一个「能解析、realpath 必失败」的目标跑真实代码，产出 `kind:"realpath"`、`side:"plugin"`、原因的 `ENOENT` 原文，且**不再出现在阻塞项里**；悬空 junction 的语义实测为 `existsSync=false`、`import.meta.resolve` → `ERR_MODULE_NOT_FOUND`（因此走「宿主锚点里找不到它」的 `unverified`，同样不会误报成两份拷贝）。官方内置技能按双模式离线验证：web（无 `process.resourcesPath`）不出现该来源且不触碰共享物化目录，桌面物化 4 个技能、来源紧跟 DSH 技能、office 的共享 `scripts/` 相对结构保留。
+
 ## [0.16.0] - 2026-09-29
 
 ### 修复

package/docs/update.md

@@ -4,6 +4,7 @@
 
 | 版本                         | 发布       | 主题                                                                                                                                                                      |
 | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [0.16.5](#0165---2026-09-30) | 2026-09-30 | 桌面版误报 5 条「两份拷贝」修掉（身份逐包核对）+ 「全部可用」与红卡不再同屏 + 官方内置技能接入管理（桌面版注入的 4 个可启停；web 不出现） |
 | [0.16.0](#0160---2026-09-29) | 2026-09-29 | 桌面版宿主身份误判修好（归档宿主按版本核对，带空格路径的宿主版本不再显示 unknown）+ 兼容页三张指标卡各删一行、适配版本改标 0.2.0-rc.2 + 四个域的行状态统一成名字后面的胶囊（已启用 / 未启用，停用类改灰）+ MCP 体检点挪到名字前 + 体检补端点探测 + 删除同步清引用 + 轮询不空转 + 子智能体补上「已启用」 |
 | [0.15.0](#0150---2026-09-28) | 2026-09-28 | 适配 DSH 0.1.7-rc.2：修好 MCP 列表与注入 + 预设边界与极简兜底注入 + 会话标题 + 设置令牌 + host-deps / doctor；新增 MCP 导入导出、配置体检、最近改动流水、场景绑工具表方案、整机迁移快照；功能总览英文补齐、兼容页收弹窗与界面打磨 |
 | [0.14.0](#0140---2026-09-23) | 2026-09-23 | 场景与记忆分家（共 20 条工具）+ 模型能进入 / 退出场景 + 场景档案对模型可见、改档案会报出被挤掉的项 + 注入只写"现在是什么"（省 21.9%）+ 十五条工具出厂默认关（每轮实发 5 条 ≈1,090）+ 工具表可存方案一键换回 + 人设思考强度 + 改 MCP 配置不碰明文凭据 + 提示词「生效中」修好 |
@@ -24,6 +25,16 @@
 
 ---
 
+## 0.16.5 - 2026-09-30
+
+- **桌面版不再误报 5 条「两份不同拷贝」**：宿主侧身份比对把第一个包（cordis）的路径当成其余五个包的，五条全部比成「不同」。现在逐包解析、逐包核对。
+- **「全部可用」与红卡不再同屏**：身份待处理（不影响能力可用性）不再混进能力降级计数，汇总行按 全可用 / 能力降级 / 身份待处理 分开说。
+- **官方内置技能能管了**：桌面版注入每个会话的 4 个官方技能（Office 三件套 + Windows 沙盒诊断）以「官方内置」来源出现在技能页、紧跟 DSH 技能，单个可启停、脚本照常能跑；web 不注入，这个来源在 web 上不出现。
+- **修复指引按装法给**（issue #1）：那块「两份不同拷贝」以前一律让人去跑 `node scripts/host-deps.mjs --fix`，可 npm 装出来的插件里**没有** `scripts/` 这个目录（发布不带开发脚本），照着做只会 `MODULE_NOT_FOUND`。现在源码检出给原指引（并写明要在源码目录跑），npm 安装形态改说「升级或重装后仍然如此再报」；兼容页底部那句自查命令同样分两种形态。
+- **路径问题不再冒充模块问题**（issue #1）：以前路径取不到真实形态时会静默拿原字符串去比对，于是「读不到路径」被报成「插件与宿主加载的是两份不同拷贝」—— 结论是编的。现在如实说「无法比较（路径取不到真实形态）」，并列出是哪一侧、解析到哪条路径、失败原因原文。
+
+---
+
 ## 0.16.0 - 2026-09-29
 
 - **桌面版不再被误判成「两份不同拷贝」**：桌面版把官方包封在 `resources/app.asar` 里，插件在归档外，位置天生不同 —— 以前兼容页把这当成 6 条阻塞项，还指路一条会把依赖降级到旧宿主的命令。现在归档宿主按**版本**核对：版本一致就只记一句说明（同版本、仅打包方式不同），版本真不一致才报阻塞；顺带修好带空格安装路径下「宿主版本显示 unknown」的老毛病（`import.meta.resolve` 的 `%20` 没解码）。web 版行为不变。

package/lib/client.js

@@ -2359,13 +2359,18 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         // 它自带的 summary 是中文，直接渲染会让英文界面露出中文）。
         const findingsN = Array.isArray(data.findings) ? data.findings.length : 0
         const degradedN = Array.isArray(data.degraded) ? data.degraded.length : 0
+        // 摘要三形态：能力降级 / 仅身份待处理 / 全部可用。仅身份待处理时**不能**说
+        // 「全部可用」—— 横幅已转红（有阻塞项），摘要却报一切正常，两句自相矛盾
+        // （2026-09-30 桌面版实测）。
+        const summaryKey = degradedN > 0 ? 'compat.summary.degraded'
+          : blockedCount > 0 ? 'compat.summary.identity' : 'compat.summary.ok'
         const summaryText = findingsN === 0
           ? (data.summary || '')
-          : t(degradedN === 0 ? 'compat.summary.ok' : 'compat.summary.degraded')
+          : t(summaryKey)
             .replace('{version}', String((data.host && data.host.version) || '?'))
             .replace('{ok}', String(findingsN - degradedN))
             .replace('{total}', String(findingsN))
-            .replace('{count}', String(degradedN))
+            .replace('{count}', String(degradedN > 0 ? degradedN : blockedCount))
         push(React.createElement('div', { className: 'dsm-compat-bar' + (blockedCount > 0 ? ' dsm-compat-bar-warn' : '') },
           React.createElement('span', { className: 'dsm-compat-dot' + (blockedCount > 0 ? ' dsm-compat-dot-warn' : '') }),
           React.createElement('strong', null, blockedCount > 0 ? t('compat.state.blocked') : t('compat.state.ok')),
@@ -2377,13 +2382,16 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         //     「本插件按此版本验证」—— 前者是安装期门槛，后者是同一件事说两遍）；
         //   * 可用能力：全通过时不再写「全部通过」（分子分母已经说了这件事），只在有降级
         //     或有插件自补时说清楚是哪一种（2026-09-29 用户裁定）。
-        const capsNote = blockedCount > 0
-          ? t('compat.caps.degraded').replace('{count}', String(blockedCount))
+        //   * 注脚与红色只跟**能力**降级走（degraded）：身份阻塞项（两份拷贝 / 待处理）
+        //     不是能力不可用 —— 此前用 blockedCount（能力 + 身份）当注脚数，桌面版上出现
+        //     过「可用能力 18/18」旁边标红「5 项不可用」的自相矛盾（2026-09-30 实测）。
+        const capsNote = degraded.length > 0
+          ? t('compat.caps.degraded').replace('{count}', String(degraded.length))
           : (usableCount === findings.length ? null : t('compat.caps.substituted'))
         push(React.createElement('div', { className: 'dsm-compat-grid' },
           card(t('compat.host'), (data.host && data.host.version) || '?', null, false),
           card(t('compat.verified'), data.verifiedVersion || '?', null, false),
-          card(t('compat.caps'), String(usableCount) + '/' + String(findings.length), capsNote, blockedCount > 0)))
+          card(t('compat.caps'), String(usableCount) + '/' + String(findings.length), capsNote, degraded.length > 0)))
 
         // 版本栅栏（B3）：实际宿主与本插件验证过的版本不同时说出来 —— 否则"照旧版本的印象
         // 判断"会让人把探测结果当成 bug。只提示、不拦（peer 保持无上界是既定决策）。
@@ -2490,15 +2498,24 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         })[0]
         const asarPackages = (asarNote && asarNote.packages) || []
         const asarNames = asarPackages.map(function (item) { return String(item && item.name || '') })
+        // 真实形态取不到的包：那一格同样「无法比较」，但原因与归档无关，得分开标。
+        const realpathNoteForPill = identityNotes.filter(function (note) {
+          return note && note.kind === 'realpath'
+        })[0]
+        const realpathNames = ((realpathNoteForPill && realpathNoteForPill.failures) || []).map(function (item) {
+          return String(item && item.name || '')
+        })
         push(section(t('compat.modules'), t('compat.modules.hint'),
           React.createElement('div', { className: 'dsm-compat-mod-list' },
             Object.keys(sameAsHost).map(function (name) {
               const same = sameAsHost[name]
+              const inRealpath = realpathNames.indexOf(name) !== -1
               const inAsar = asarNames.indexOf(name) !== -1
               const cls = same === true ? 'dsm-compat-pill-ok' : same === false ? 'dsm-compat-pill-bad' : ''
               const text = same === true ? t('compat.module.same')
                 : same === false ? t('compat.module.separate')
-                  : inAsar ? t('compat.module.sameVersion') : t('compat.module.unknown')
+                  : inRealpath ? t('compat.module.realpath')
+                    : inAsar ? t('compat.module.sameVersion') : t('compat.module.unknown')
               return React.createElement('div', { className: 'dsm-compat-mod-row', key: name },
                 React.createElement('span', { className: 'dsm-compat-name dsm-compat-mod' }, name),
                 React.createElement('span', { className: 'dsm-compat-pill ' + cls }, text))
@@ -2527,10 +2544,34 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
               .replace('{count}', String(unverified.length))
               .replace('{names}', unverified.join('、'))))
         }
+        // 路径取不到真实形态：这一格是「比不了」，不是「两份拷贝」。必须把原因摆出来 ——
+        // 否则用户只会看到一排「无法比较」，而不知道是路径/权限的问题（issue #1）。
+        const realpathNote = identityNotes.filter(function (note) {
+          return note && note.kind === 'realpath'
+        })[0]
+        if (realpathNote) {
+          const failures = realpathNote.failures || []
+          const names = failures.map(function (item) { return String(item && item.name || '') })
+          const sideText = function (side) {
+            return failures.filter(function (item) { return item && item.side === side })
+              .map(function (item) { return String(item && item.path || '') + '（' + String(item && item.reason || '') + '）' })
+              .join('；')
+          }
+          push(React.createElement('p', { className: 'dsm-help' },
+            t('compat.modules.realpath')
+              .replace('{count}', String(failures.length))
+              .replace('{names}', names.join('、'))))
+          push(React.createElement('p', { className: 'dsm-help' },
+            t('compat.modules.realpathSides')
+              .replace('{host}', sideText('host') || t('compat.modules.realpathNone'))
+              .replace('{plugin}', sideText('plugin') || t('compat.modules.realpathNone'))))
+        }
 
         push(React.createElement('p', { className: 'dsm-help' },
-          t('compat.hint.doctor'),
-          React.createElement('code', { className: 'dsm-compat-code' }, ' node scripts/doctor.mjs')))
+          t(data && data.sourceInstall === true ? 'compat.hint.doctor' : 'compat.hint.doctorRelease'),
+          data && data.sourceInstall === true
+            ? React.createElement('code', { className: 'dsm-compat-code' }, ' node scripts/doctor.mjs')
+            : null))
       }
 
       // 预设注入边界：五类内容（记忆 / 全局提示词 / 技能 / MCP / 子智能体）在**每个 Agent
@@ -3271,7 +3312,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "mcp.inspect.check.badTransport": "transport 取值不认识：{transport}",
         "mcp.inspect.check.noEndpoint": "既没有 command 也没有 url",
         "mcp.inspect.check.nameDup": "服务名「{name}」被 {count} 个不同 id 共用：模型看到的工具名会撞车",
-        "root.dsh": "DSH 技能", "root.hub": "导入技能", "root.agents": "公共 Agent", "root.ccswitch": "CC Switch", "root.projectDsh": "项目 DSH", "root.projectAgents": "项目 Agent", "root.codex": "Codex", "root.claude": "Claude", "root.gemini": "Gemini", "root.opencode": "OpenCode", "root.cursor": "Cursor",
+        "root.dsh": "DSH 技能", "root.hub": "导入技能", "root.official": "官方内置", "root.agents": "公共 Agent", "root.ccswitch": "CC Switch", "root.projectDsh": "项目 DSH", "root.projectAgents": "项目 Agent", "root.codex": "Codex", "root.claude": "Claude", "root.gemini": "Gemini", "root.opencode": "OpenCode", "root.cursor": "Cursor",
         "memory.title": "记忆",
         "tabs.scenes": "场景", "tabs.skills": "技能", "tabs.subagents": "子智能体", "tabs.prompts": "提示词", "tabs.memory": "记忆", "tabs.sessions": "会话", "tabs.compat": "兼容",
         "compat.title": "宿主兼容", "compat.desc": "本插件与 DSH 的对接体检（只读）。",
@@ -3321,6 +3362,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.state.ok": "一切正常", "compat.state.blocked": "有需要处理的问题",
         "compat.checking": "检查中…", "compat.empty": "尚未检查", "compat.failed": "检查失败",
         "compat.summary.ok": "宿主 {version} · 能力 {ok}/{total} · 全部可用", "compat.summary.degraded": "宿主 {version} · 能力 {ok}/{total} · 降级 {count} 项",
+        "compat.summary.identity": "宿主 {version} · 能力 {ok}/{total} · 身份 {count} 项待处理",
         "compat.host": "宿主版本", "compat.verified": "插件适配版本",
         "compat.caps": "可用能力", "compat.caps.degraded": "{count} 项不可用",
         "compat.caps.substituted": "缺口由插件自补",
@@ -3333,7 +3375,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.others": "其它能力项", "compat.others.hint": "不算降级：宿主没有这些入口时，由插件自己顶上",
         "compat.fallback.substituted": "插件适配层（宿主无此入口）",
         "compat.fallback.native": "改走原生入口", "compat.fallback.refuse": "该操作会被拒绝", "compat.fallback.blocked": "相关按钮已禁用", "compat.fallback.inform": "不影响写入",
-        "compat.modules": "模块实体（插件 vs 宿主）", "compat.modules.hint": "同一份模块才谈得上适配", "compat.module.same": "同一份模块", "compat.module.separate": "两份拷贝（需修复）", "compat.module.sameVersion": "同版本（分处归档内外）", "compat.module.unknown": "无法比较", "compat.modules.unverified": "有 {count} 个包没能比对（宿主的解析锚点里找不到：{names}）—— 这不是「两份拷贝」，而是这项校验没做成。可运行 node scripts/doctor.mjs 查看。",
+        "compat.modules": "模块实体（插件 vs 宿主）", "compat.modules.hint": "同一份模块才谈得上适配", "compat.module.same": "同一份模块", "compat.module.separate": "两份拷贝（需修复）", "compat.module.sameVersion": "同版本（分处归档内外）", "compat.module.unknown": "无法比较", "compat.module.realpath": "无法比较（路径取不到真实形态）", "compat.modules.realpath": "有 {count} 个包**比不了**：它们的路径取不到真实形态（{names}）—— 这不是「两份拷贝」，而是这项校验没做成。", "compat.modules.realpathSides": "宿主侧：{host}；插件侧：{plugin}。修好路径（权限 / 路径长度 / 重新安装）后重新打开本页即重算。", "compat.modules.realpathNone": "无", "compat.modules.unverified": "有 {count} 个包没能比对（宿主的解析锚点里找不到：{names}）—— 这不是「两份拷贝」，而是这项校验没做成。可运行 node scripts/doctor.mjs 查看。",
         "compat.modules.asarHost": "宿主是桌面版：官方包装在 {name} 里，插件在归档外，两边不可能是同一份文件。下面 {count} 个包按版本核对：{version}，一致。",
         "compat.modules.asarHostPackages": "同版本、仅打包方式不同的 {count} 个包（{version}）：{names}。本机不要跑 host-deps.mjs --fix —— 那条命令会把插件依赖指向 npx 缓存里旧版宿主，而不是归档里的当前宿主。",
         "compat.blockers": "阻塞项（按此修复）",
@@ -3537,6 +3579,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.reach.tools.2": "场景 / 记忆 / MCP / 技能 / 子智能体 / 提示词 —— 由本插件按上面的「注入」块补齐。",
         "compat.reach.tools.3": "提示词与技能官方自己也会送；官方有的不重复送，官方缺的（如极简）由本插件补上。",
         "compat.hint.doctor": "命令行体检：",
+        "compat.hint.doctorRelease": "本插件是从 npm 安装的（不带开发脚本）；要命令行自查请在插件源码目录运行 node scripts/doctor.mjs。",
         "scenes.title": "场景", "scenes.desc": "管理场景：预设 MCP、技能、子智能体与记忆的组合，一键切换。",
         "scenes.stat.total": "个场景", "scenes.stat.active": "个已启用", "scenes.stat.archives": "个有档案",
         "scenes.noDesc": "还没有描述",
@@ -3831,7 +3874,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "mcp.inspect.check.badTransport": "Unrecognized transport: {transport}",
         "mcp.inspect.check.noEndpoint": "Neither command nor URL",
         "mcp.inspect.check.nameDup": "Server name “{name}” is shared by {count} different ids — the model sees colliding tool names",
-        "root.dsh": "DSH skills", "root.hub": "Imported skills", "root.agents": "Shared Agent", "root.ccswitch": "CC Switch", "root.projectDsh": "Project DSH", "root.projectAgents": "Project Agent", "root.codex": "Codex", "root.claude": "Claude", "root.gemini": "Gemini", "root.opencode": "OpenCode", "root.cursor": "Cursor",
+        "root.dsh": "DSH skills", "root.hub": "Imported skills", "root.official": "Official built-in", "root.agents": "Shared Agent", "root.ccswitch": "CC Switch", "root.projectDsh": "Project DSH", "root.projectAgents": "Project Agent", "root.codex": "Codex", "root.claude": "Claude", "root.gemini": "Gemini", "root.opencode": "OpenCode", "root.cursor": "Cursor",
         "memory.title": "Memories",
         "tabs.scenes": "Scenes", "tabs.skills": "Skills", "tabs.subagents": "Subagents", "tabs.prompts": "Prompts", "tabs.memory": "Memories", "tabs.sessions": "Sessions", "tabs.compat": "Host",
         "compat.title": "Host compatibility", "compat.desc": "How this plugin attaches to DSH (read-only).",
@@ -3881,6 +3924,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.state.ok": "All good", "compat.state.blocked": "Needs attention",
         "compat.checking": "Checking…", "compat.empty": "Not checked yet", "compat.failed": "Check failed",
         "compat.summary.ok": "host {version} · capabilities {ok}/{total} · all usable", "compat.summary.degraded": "host {version} · capabilities {ok}/{total} · {count} degraded",
+        "compat.summary.identity": "host {version} · capabilities {ok}/{total} · {count} identity issue(s) to resolve",
         "compat.host": "Host version", "compat.verified": "Verified against",
         "compat.caps": "Usable capabilities", "compat.caps.degraded": "{count} unavailable",
         "compat.caps.substituted": "gaps covered by the plugin",
@@ -3893,7 +3937,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.others": "Other capability slots", "compat.others.hint": "not degraded: the plugin supplies its own implementation when the host has no such entry",
         "compat.fallback.substituted": "Plugin adapter (no host entry)",
         "compat.fallback.native": "Falls back to native entry", "compat.fallback.refuse": "Operation refused", "compat.fallback.blocked": "Affected buttons disabled", "compat.fallback.inform": "Writes unaffected",
-        "compat.modules": "Module identity (plugin vs host)", "compat.modules.hint": "adapting only works on one shared module", "compat.module.same": "same module", "compat.module.separate": "separate copy (repair needed)", "compat.module.sameVersion": "same version (inside/outside the archive)", "compat.module.unknown": "not comparable", "compat.modules.unverified": "{count} package(s) could not be compared (not resolvable from the host anchor: {names}) — that is not \"a separate copy\", it means the check could not run. Try node scripts/doctor.mjs.",
+        "compat.modules": "Module identity (plugin vs host)", "compat.modules.hint": "adapting only works on one shared module", "compat.module.same": "same module", "compat.module.separate": "separate copy (repair needed)", "compat.module.sameVersion": "same version (inside/outside the archive)", "compat.module.unknown": "not comparable", "compat.module.realpath": "not comparable (real path unavailable)", "compat.modules.realpath": "{count} package(s) could **not be compared**: their real path could not be read ({names}) — that is not \"a separate copy\", it means the check could not run.", "compat.modules.realpathSides": "Host side: {host}; plugin side: {plugin}. Fix the path (permissions / path length / reinstall) and reopen this page to re-check.", "compat.modules.realpathNone": "none", "compat.modules.unverified": "{count} package(s) could not be compared (not resolvable from the host anchor: {names}) — that is not \"a separate copy\", it means the check could not run. Try node scripts/doctor.mjs.",
         "compat.modules.asarHost": "The host is the desktop app: the official packages live inside {name} while the plugin sits outside the archive, so the two can never be the same file. The {count} package(s) below were checked by version: {version} on both sides.",
         "compat.modules.asarHostPackages": "{count} package(s) at the same version ({version}), differing only in packaging: {names}. Do not run host-deps.mjs --fix on this machine — it would point the plugin's dependencies at an older host in the npx cache instead of the running one inside the archive.",
         "compat.blockers": "Blockers (fix these)",
@@ -4093,6 +4137,7 @@ html,body{scrollbar-gutter:stable}.dsm-settings-scroll-host{overflow-y:scroll!im
         "compat.reach.tools.2": "Scene / memory / MCP / skills / subagents / prompt — filled in by this plugin according to the Injection block above.",
         "compat.reach.tools.3": "The prompt and the skill catalog also come from the official rows; this plugin only fills in what they miss (e.g. under Minimal).",
         "compat.hint.doctor": "Command-line check:",
+        "compat.hint.doctorRelease": "This plugin was installed from npm, which does not ship the developer scripts; to run a command-line check, use node scripts/doctor.mjs inside a source checkout.",
         "scenes.title": "Scenes", "scenes.desc": "Manage scenes: preset combinations of MCP, skills, subagents and memories, switch with one click.",
         "scenes.stat.total": "scene(s)", "scenes.stat.active": "enabled", "scenes.stat.archives": "with a profile",
         "scenes.noDesc": "No description yet",

package/lib/compat/probe.js

@@ -42,6 +42,18 @@ export const IDENTITY_PACKAGES = [
     '@deepseek-ai/dsh-storage-domain',
     '@deepseek-ai/dsh-spill-local',
 ];
+/**
+ * 本插件是不是从**源码检出**跑起来的（仓库里那份，`scripts/host-deps.mjs` 就躺在旁边）。
+ *
+ * 用来决定「两份拷贝」那条阻塞项给什么修复指引：`scripts/` 不在 `package.json` 的
+ * `files` 里（发布形态本就不该带开发者脚本），所以 npm 装出来的用户照那条指引去跑
+ * 只会拿到 `MODULE_NOT_FOUND` —— 这是 issue #1 的次要问题之一。指引必须按实际形态给。
+ */
+const SOURCE_INSTALL = existsSync(join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'scripts', 'host-deps.mjs'));
+/** 供界面决定修复指引：`true` = 源码检出（`scripts/` 就在旁边），`false` = npm 安装形态。 */
+export function isSourceInstall() {
+    return SOURCE_INSTALL;
+}
 /**
  * peer range 与已验证版本。官方全程走 prerelease 渠道（x.y.z-rc.N），semver 的
  * 预发布规则（prerelease 版本只匹配同 [major,minor,patch] 元组的比较器）意味着**每一代
@@ -110,15 +122,21 @@ function isAsarPath(value) {
  * realpath to one file ARE the same module — which is exactly the property
  * this plugin depends on, and the reason `@deepseek-ai/*` is junctioned into
  * the host installation instead of being copied.
+ *
+ * 取不到真实形态时**不再拿输入去比**（issue #1 要求）：那会把「路径不可解析」
+ * 伪装成「两份不同拷贝」，给出一个编出来的结论。改由调用方把原因报成说明。
  */
-function realPathOf(value) {
+function realPathWithReason(value) {
     if (value === null)
-        return null;
+        return { reason: '路径为空' };
     try {
-        return realpathSync.native !== undefined ? realpathSync.native(value) : realpathSync(value);
+        return { path: realpathSync.native !== undefined ? realpathSync.native(value) : realpathSync(value) };
     }
-    catch {
-        return value;
+    catch (error) {
+        const detail = error;
+        const code = typeof detail.code === 'string' ? detail.code : '';
+        const message = typeof detail.message === 'string' ? detail.message : String(error);
+        return { reason: code === '' ? message : `${code} ${message}` };
     }
 }
 /** Read a package version from a resolvable manifest. */
@@ -835,6 +853,10 @@ export function assessHost(ctx) {
     const hostIsAsar = isAsarPath(hostRoot);
     // 桌面版（宿主在 app.asar 里）两组「版本」的容器：插件自己解析到的、宿主锚点解析到的。
     const asarHostPackages = [];
+    // realpath 失败（路径取不到真实形态）：两侧各算一次就够，与是哪个包无关。
+    const realpathFailures = [];
+    let hostRealpathNote = null;
+    let pluginRealpathNote = null;
     let asarHostVersion = null;
     let asarPluginVersion = null;
     for (const name of IDENTITY_PACKAGES) {
@@ -852,15 +874,36 @@ export function assessHost(ctx) {
         }
         // Resolve the same name from the host installation's own anchor, then
         // compare PHYSICAL files: a junction is the same module, not a copy.
+        //
+        // 逐包解析、逐包取真实形态。realpath 的**机制**确实整轮不变，但上一版曾把
+        // 这句话错写成连**解析结果**一起复用：第一个包（cordis）的宿主侧入口路径被当成
+        // 其余五个包的宿主侧路径，于是五条全部比成「与 cordis 不同」→ 假「两份不同拷贝」
+        // （官方桌面版 0.2.0-rc.2 实测，2026-09-30；解析本就便宜，节点自身还有缓存）。
         let hostResolved = null;
+        let hostRealpath = null;
         try {
-            const hostRequire = createRequire(join(dirname(hostRoot), 'package.json'));
-            hostResolved = hostRequire.resolve(name);
+            hostResolved = createRequire(join(dirname(hostRoot), 'package.json')).resolve(name);
+            hostRealpath = realPathWithReason(hostResolved);
         }
         catch {
             hostResolved = null;
         }
-        const same = hostResolved === null ? null : realPathOf(hostResolved) === realPathOf(resolved);
+        // 真实形态取不到 → 这一格是「比不了」，不是「两份拷贝」。理由如实上报，
+        // 绝不把路径问题说成模块问题（issue #1 的次要问题之二）。
+        if (hostRealpath !== null && 'reason' in hostRealpath) {
+            sameAsHost[name] = null;
+            hostRealpathNote = hostRealpathNote ?? hostRealpath.reason;
+            realpathFailures.push({ name, side: 'host', path: hostResolved ?? '(未解析到)', reason: hostRealpath.reason });
+            continue;
+        }
+        const pluginRealpath = realPathWithReason(resolved);
+        if ('reason' in pluginRealpath) {
+            sameAsHost[name] = null;
+            pluginRealpathNote = pluginRealpathNote ?? pluginRealpath.reason;
+            realpathFailures.push({ name, side: 'plugin', path: resolved, reason: pluginRealpath.reason });
+            continue;
+        }
+        const same = hostResolved === null ? null : hostRealpath.path === pluginRealpath.path;
         // 归档宿主：路径必然不同（归档 vs 磁盘），能比的是版本。相同 → 这一格是
         // 「比不了（同版本、打包方式不同）」，记进说明并从 unverified 里摘出来（那句
         // 「宿主的解析锚点里找不到它」对它不成立 —— 锚点找得到，在归档里）；不同 →
@@ -877,13 +920,27 @@ export function assessHost(ctx) {
             }
         }
         sameAsHost[name] = same;
-        if (same === false)
-            blockers.push(`${name}：插件与宿主加载的是两份不同拷贝（运行 node scripts/host-deps.mjs --fix）`);
+        if (same === false) {
+            // 指引按**实际形态**给：`scripts/host-deps.mjs` 只存在于源码检出里
+            // （`files` 不含 `scripts/`，npm 安装形态下没有这个文件），
+            // 发布形态照那条指引去跑必然 `MODULE_NOT_FOUND` —— issue #1 的次要问题之一。
+            blockers.push(SOURCE_INSTALL
+                ? `${name}：插件与宿主加载的是两份不同拷贝（在插件源码目录运行 node scripts/host-deps.mjs --fix）`
+                : `${name}：插件与宿主加载的是两份不同拷贝（升级或重装本插件后仍然如此再报）`);
+        }
         // 解析得到、却比不了：宿主锚点里找不到它。不能静默 —— 否则整块身份校验等于没做，
         // 而页头仍报「全部可用」（pnpm 的 .pnpm 隔离目录就是这种情形，见 hostPackageRoot）。
         if (same === null)
             unverified.push(name);
     }
+    if (realpathFailures.length > 0) {
+        notes.push({
+            kind: 'realpath',
+            failures: realpathFailures,
+            ...(hostRealpathNote === null ? {} : { hostReason: hostRealpathNote }),
+            ...(pluginRealpathNote === null ? {} : { pluginReason: pluginRealpathNote }),
+        });
+    }
     if (asarHostPackages.length > 0 && hostRoot !== null) {
         notes.push({
             kind: 'asar-host',
@@ -949,9 +1006,12 @@ function hostPackageRoot() {
     if (asarHost !== null)
         candidates.push(asarHost);
     for (const anchor of IDENTITY_PACKAGES) {
-        const resolved = realPathOf(safeResolve(anchor));
-        if (resolved === null)
+        // 锚点候选只认**真实形态**：取不到就跳过（这里没有可比的对象，如实跳过即可，
+        // 与身份比对不同 —— 那边取不到必须报出来，见 assessHost 的 realpath 说明）。
+        const real = realPathWithReason(safeResolve(anchor));
+        if ('reason' in real)
             continue;
+        const resolved = real.path;
         let dir = dirname(resolved);
         for (let i = 0; i < 4; i += 1) {
             if (dir.endsWith(join('node_modules', '@deepseek-ai'))) {

package/lib/mcp/manager.js

@@ -1655,7 +1655,7 @@ export function createMcpManager(deps) {
             return { ok: true, removed: total, ids: removed, files };
         });
     }
-    // ---------- 配置体检（0.15.0 B1；0.16.1 起 streamable-http 含端点探测）--------------
+    // ---------- 配置体检（0.15.0 B1；0.16.5 起 streamable-http 含端点探测）--------------
     // 对补丁文件**只读**：不写盘、不拉起子进程。对外调用两处 ——
     //   · `where` / `which` 查 PATH：只查「这个命令名能不能找到」，绝不执行配置里的命令本身；
     //   · streamable-http 行对配置地址发一次 GET 连通性探测（带配置的鉴权头、5 秒超时、
@@ -1777,7 +1777,7 @@ export function createMcpManager(deps) {
             else if (!/^https?:\/\//.test(url))
                 checks.push({ id: 'badUrl', level: 'warn', params: { url } });
             else {
-                // 格式对了再做一次真实探测（0.16.1）：此前的体检止步于格式校验，一条编造的
+                // 格式对了再做一次真实探测（0.16.5）：此前的体检止步于格式校验，一条编造的
                 // 地址也能拿绿点 —— 绿点承诺的「没发现问题」其实只覆盖了一半（2026-09-29 实测）。
                 const probe = await probeHttpEndpoint(url, row.headers);
                 if (!probe.reachable)

package/lib/ops/compat.js

@@ -6,7 +6,7 @@
 //
 // 边界纪律：本文件只负责「op 的实现」，不负责 ops 表之外的接线（MCP 写后刷新、场景锁定
 // 守卫仍作用在组装后的整张表上，见 index.ts）。
-import { EXPECTED_MIN_HOST_VERSION, EXPECTED_PEER_RANGE, VERIFIED_HOST_VERSION, routeFor, summarize, } from '../compat/probe.js';
+import { EXPECTED_MIN_HOST_VERSION, EXPECTED_PEER_RANGE, VERIFIED_HOST_VERSION, isSourceInstall, routeFor, summarize, } from '../compat/probe.js';
 import { INJECT_DOMAIN_KEYS } from '../context-inject.js';
 import { assessPresetReach } from '../compat/preset-reach.js';
 import { runtimeNotes } from '../compat/runtime-notes.js';
@@ -64,9 +64,13 @@ export function buildCompatOps(deps) {
                     host: { version: assessment.identity.version, modules: assessment.identity.modules },
                     sameAsHost: assessment.identity.sameAsHost,
                     unverified: assessment.identity.unverified,
-                    // 身份校验的说明（目前只有「宿主在 app.asar 里」一种）：不是阻塞项，界面据此
-                    // 解释那一排「无法比较」，而不是留给用户一句「两份拷贝，去 --fix」。
+                    // 身份校验的说明：不是阻塞项，界面据此解释那一排「无法比较」，而不是留给
+                    // 用户一句「两份拷贝，去 --fix」。两种来源 —— 宿主在 app.asar 里（桌面版）、
+                    // 路径取不到真实形态（realpath 失败，issue #1）。
                     notes: assessment.identity.notes,
+                    // 修复指引按实际形态给：`scripts/` 不在 `files` 里，npm 安装形态下没有
+                    // `scripts/doctor.mjs` 与 `scripts/host-deps.mjs`，指了也跑不了。
+                    sourceInstall: isSourceInstall(),
                     findings,
                     degraded,
                     blockers: assessment.identity.blockers,

package/lib/skills/core.js

@@ -13,7 +13,8 @@
 // 文件写入错误由路由返回给调用方。
 import { homedir } from "node:os";
 import { join, basename, dirname, resolve, isAbsolute, } from "node:path";
-import { promises as fs } from "node:fs";
+import { promises as fs, existsSync, mkdirSync, readdirSync, copyFileSync, rmSync, } from "node:fs";
+import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { unzipSync } from "fflate";
 import { discoverReadonlyEntries, validDiscoveryName, } from "./readonly-discovery.js";
@@ -57,13 +58,180 @@ export function resolveDshHome() {
 export function resolveAgentsHome() {
     return process.env.DSH_AGENTS_HOME || join(homedir(), ".agents");
 }
+// ── 官方内置技能来源（随宿主注入会话上下文的内置技能）──────────────────────
+//
+// 桌面版把 4 个官方技能注入每个会话（用户 2026-09-30 实测目录）：office-docx /
+// office-pptx / office-xlsx（dsh-skill-office，桌面宿主把 assetRoot 指到
+// `<resources>/runtime/office-skills`）与 diagnose-windows-sandbox-acl
+// （dsh-sandbox-windows-acl，source 'bundled'，rank 600）。web 宿主一个都不注入
+// （用户裁定：web 用不上这个功能）。它们或住在官方 asar 里、或由官方 provider
+// 复制进临时目录自管，插件直接扫描/接管有两个坑：宿主子进程里对 asar 的 promises
+// 读法与拦截器解析都出现过时灵时不灵（同机两次启动一组 4/1、一组全 0，实测）；
+// 沙盒技能的脚本要交给 PowerShell 子进程，asar 路径读不了。
+//
+// 因此这里把来源**物化**成插件自有的一份真实目录（`$DSH_HOME/tool-management/
+// official-skills/`）：每次宿主启动从官方源头整目录覆盖拷贝（与官方 provider 的
+// 「私有资源副本」同一做法），扫描、启停、overlay、脚本执行全部落在真实文件上。
+//
+// 两个边界（都出过事）：
+//   - 只有桌面版（有 process.resourcesPath）才允许进来。物化目录在 $DSH_HOME 下
+//     与各宿主**共用**，而 web 宿主进程里的官方模块拦截器能把 @deepseek-ai 裸名
+//     解析到宿主副本 —— web 若也进来重建，会把桌面物化好的整目录清成它解析到的
+//     那几个（2026-09-30 实测：桌面物化好 4 个，web 一启动，两份 UI 同时只剩沙盒
+//     1 个）。所以非桌面在碰目录**之前**就退出，一个技能都不列。
+//   - 预设参考技能（dsh-agent-preset/skills）不注入会话上下文，不列入（用户裁定）。
+//
+// 单个来源、随 DSH 技能之后排列，来源层语义同默认来源（不可移除、无来源开关）。
+const OFFICIAL_SOURCE_KEY = "official";
+/** electron 的 resources 目录；非桌面宿主（web 等普通 node 进程）没有这个属性。 */
+function resourcesDir() {
+    const resources = process.resourcesPath;
+    return typeof resources === "string" && resources !== "" ? resources : null;
+}
+/** 桌面版官方 asar 里的包内目录（同步 fs 对 asar 的支持经过实测可靠）。 */
+function desktopPackageDir(packageName, subpath) {
+    const resources = resourcesDir();
+    if (resources === null)
+        return null;
+    const dir = join(resources, "app.asar", "dsh", "node_modules", ...packageName.split("/"), ...subpath.split("/"));
+    return existsSync(dir) ? dir : null;
+}
+/**
+ * 从插件自身的解析链找官方包内目录（web 等非桌面宿主的途径；宿主进程里的裸名
+ * 解析由官方模块拦截器路由到宿主副本）。包不可解析（旧宿主 / 单测环境）返回 null。
+ */
+function resolvedPackageDir(packageName, subpath) {
+    try {
+        const require = createRequire(import.meta.url);
+        let manifest;
+        try {
+            manifest = require.resolve(`${packageName}/package.json`);
+        }
+        catch {
+            // exports 未暴露 ./package.json 的包：从入口文件向上找同名 manifest。
+            manifest = "";
+            let dir = dirname(require.resolve(packageName));
+            for (let i = 0; i < 6; i += 1) {
+                const candidate = join(dir, "package.json");
+                if (existsSync(candidate)) {
+                    manifest = candidate;
+                    break;
+                }
+                const parent = dirname(dir);
+                if (parent === dir)
+                    break;
+                dir = parent;
+            }
+            if (manifest === "")
+                return null;
+        }
+        const dir = join(dirname(manifest), ...subpath.split("/"));
+        return existsSync(dir) ? dir : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * office 技能源头。office 只在桌面版由宿主挂载（web 的补丁层没有它），所以只在
+ * 桌面环境里找：运行时真实目录优先（官方 assetRoot），其次 asar 包内 assets。
+ * 非桌面环境一律 null —— 不把没被注入的技能凭空列出来。
+ */
+function officialOfficeSource() {
+    const resources = resourcesDir();
+    if (resources === null)
+        return null;
+    const runtimeDir = join(resources, "runtime", "office-skills");
+    if (existsSync(join(runtimeDir, "office-docx")))
+        return runtimeDir;
+    const asarDir = desktopPackageDir("@deepseek-ai/dsh-skill-office", "assets");
+    if (asarDir !== null && existsSync(join(asarDir, "office-docx")))
+        return asarDir;
+    return null;
+}
+/** 沙盒诊断技能源头（桌面版 asar 直连优先，其次本机解析链；仅 Windows 注入）。 */
+function officialSandboxSource() {
+    if (process.platform !== "win32")
+        return null;
+    return (desktopPackageDir("@deepseek-ai/dsh-sandbox-windows-acl", "assets/diagnose-windows-sandbox-acl") ??
+        resolvedPackageDir("@deepseek-ai/dsh-sandbox-windows-acl", "assets/diagnose-windows-sandbox-acl"));
+}
+function copyDirectorySync(from, to) {
+    mkdirSync(to, { recursive: true });
+    for (const entry of readdirSync(from, { withFileTypes: true })) {
+        const source = join(from, entry.name);
+        const target = join(to, entry.name);
+        if (entry.isDirectory())
+            copyDirectorySync(source, target);
+        else if (entry.isFile())
+            copyFileSync(source, target);
+    }
+}
+/**
+ * 物化官方内置技能到插件自有目录，返回该目录；无可用源头或拷贝失败返回 null。
+ * 每次宿主启动整目录重建（官方包只随宿主更新变化，宿主更新必然重启宿主）。
+ */
+let officialRootCache;
+function materializeOfficialSkills() {
+    // 非桌面宿主（web 等普通 node 进程）一个官方技能都不注入，也不许碰共享的物化
+    // 目录 —— 否则 web 启动会把它解析到的那几个盖进目录，桌面版物化好的就没了
+    // （见上方块注释）。必须在任何 fs 访问之前退出。
+    if (resourcesDir() === null)
+        return null;
+    const office = officialOfficeSource();
+    const sandbox = officialSandboxSource();
+    if (office === null && sandbox === null)
+        return null;
+    const root = join(resolveDshHome(), "tool-management", "official-skills");
+    try {
+        rmSync(root, { recursive: true, force: true });
+        // office：整个 assets 根拷进来（office-*/ 与 scripts/ 的相对结构必须保留 ——
+        // SKILL.md 用 `<skill-directory>/../scripts/check_office.py` 引用检查脚本）。
+        if (office !== null)
+            copyDirectorySync(office, root);
+        if (sandbox !== null) {
+            copyDirectorySync(sandbox, join(root, basename(sandbox)));
+        }
+        return root;
+    }
+    catch (error) {
+        console.error("[dsh-plugin-tool-management] official skills materialization failed:", String((error && error.message) || error));
+        return null;
+    }
+}
+function officialSkillRoot() {
+    if (officialRootCache !== undefined)
+        return officialRootCache;
+    const dir = materializeOfficialSkills();
+    officialRootCache =
+        dir === null
+            ? null
+            : {
+                key: OFFICIAL_SOURCE_KEY,
+                path: dir,
+                label: "官方内置",
+                localeKey: "official",
+                mutable: false,
+                deletable: false,
+                // 来源层无开关（同默认来源），单个技能可启停；overlay 以 599 压过官方
+                // provider 的 600，脚本从物化副本的真实路径执行。
+                toggleable: true,
+                native: false,
+                scope: "user",
+                rank: 599,
+            };
+    return officialRootCache;
+}
 /**
  * DSH 与外部 Agent 的用户级技能目录（4 个来源；外部来源由 manager provider 接入）。
  *
  * rank 与官方 filesystem provider 的用户级优先级衔接：DSH=400、Agents=500。
  * manager provider 以 450 接管公共 Agents（仍低于 DSH），Codex/Claude 依次排在其后。
+ * DSH 之后紧随官方内置来源（随宿主注入会话的内置技能，见 materializeOfficialSkills；
+ * 无可用源头时自然缺席）。
  */
 export function userRoots() {
+    const official = officialSkillRoot();
     return [
         {
             key: "dsh",
@@ -78,6 +246,8 @@ export function userRoots() {
             native: true,
             rank: 400,
         },
+        // 官方内置紧随 DSH 技能之后（用户裁定）：同为一眼要看的来源，排在导入技能之前。
+        ...(official === null ? [] : [official]),
         {
             // v0.4：插件**新建/导入**的技能落到 hub 内（用户要求：插件产生的文件收在
             // $DSH_HOME/tool-management/）。rank 高于 DSH 技能，同名时 hub 版本遮蔽官方目录里的；
@@ -139,8 +309,8 @@ export function userRoots() {
  *
  * 一句话记法：**`mutable` 与 `deletable` 同向，`removable` 与 `mutable` 反向。**
  */
-const DEFAULT_SOURCE_KEYS = Object.freeze(["dsh", "hub"]);
-/** 是否为默认来源。接受 root 对象或 key 字符串；`dsh` / `hub` 的所有特判都走这里。 */
+const DEFAULT_SOURCE_KEYS = Object.freeze(["dsh", "hub", OFFICIAL_SOURCE_KEY]);
+/** 是否为默认来源。接受 root 对象或 key 字符串；`dsh` / `hub` / `official` 的所有特判都走这里。 */
 export function isDefaultSkillSource(rootOrKey) {
     const key = rootOrKey && typeof rootOrKey === "object"
         ? rootOrKey.key
@@ -582,7 +752,9 @@ function reservedSourceError(root) {
     const key = root && root.key ? root.key : "";
     const origin = key === "dsh"
         ? "DSH 技能目录是默认来源，必须读取"
-        : "导入技能目录是默认来源、插件新建/导入的落点，必须读取";
+        : key === "hub"
+            ? "导入技能目录是默认来源、插件新建/导入的落点，必须读取"
+            : "官方内置技能目录随宿主发布，不能移除（移除只会让插件失去管理权）";
     return {
         ok: false,
         code: "error.source.reserved",
@@ -2894,11 +3066,13 @@ export async function listProviderCandidates(options = {}) {
             provider: "dsh-plugin-tool-management-external",
             source: project
                 ? root.kind
-                : root.key === "dsh"
-                    ? "user-dsh"
-                    : CUSTOM_ROOT_KEY_RE.test(root.key)
-                        ? "custom"
-                        : `agent-${root.key}`,
+                : root.key === "official"
+                    ? "bundled"
+                    : root.key === "dsh"
+                        ? "user-dsh"
+                        : CUSTOM_ROOT_KEY_RE.test(root.key)
+                            ? "custom"
+                            : `agent-${root.key}`,
             rank: project
                 ? root.rank - 1
                 : root.key === "dsh"

package/lib/skills/service.js

@@ -410,7 +410,11 @@ export function createSkillsService(ctx) {
             console.error('[dsh-plugin-tool-management] agent-scoped provider setup failed:', message(e));
         }
         try {
-            const watchPaths = roots.map((root) => String((root && root.path) || '')).filter(Boolean);
+            const watchPaths = roots
+                // 官方内置来源是宿主启动时物化的只读副本，不会中途变化，不起 watcher。
+                .filter((root) => root.key !== 'official')
+                .map((root) => String((root && root.path) || ''))
+                .filter(Boolean);
             disposers.push(watchDirectories(watchPaths, invalidateSkills));
             // 自定义目录在状态文件里，注册时读取一次并一并监听（后添加的目录由
             // provider 首次 list 天然覆盖，等插件重载后才有 watcher）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-tool-management",
-  "version": "0.16.0",
+  "version": "0.16.5",
   "description": "DSH plugin: one settings panel for MCP servers, skills, scenes, memories, subagent personas and AGENTS.md presets — a scene switches the whole environment, and the model can drive it from chat too.",
   "repository": {
     "type": "git",