dsh-plugin-tool-management 0.16.5 → 0.16.6

package/CHANGELOG.md

@@ -10,6 +10,24 @@
 
 ---
 
+## [0.16.6] - 2026-09-30
+
+官方内置技能管理补全 web 侧：web 宿主照注的沙盒诊断技能接入技能页（可见、可停），Office 三件套按裁定在 web 上一并暴露；并补齐接管后缺失的 LibreOffice Kit 路径段。
+
+### 修复
+
+- **web 宿主注入的沙盒诊断技能现在看得见、关得掉了**（0.16.5 的误判）：0.16.5 按「web 不注入官方技能」把 web 整个挡在官方内置管理之外，但官方宿主的沙盒技能门控是 `process.platform === "win32"`（`dsh-sandbox-local` 源码核对）——只看操作系统，web 照样向每个会话注入 diagnose-windows-sandbox-acl，于是 web 上「页面不显示、会话照注入」。现在 web 也物化官方技能并以 rank 599 接管：来源出现在技能页，停用即不注入。
+- **接管后缺「Installed LibreOffice Kit」段**（0.16.5 桌面上已存在）：官方 provider 在返回 office 技能正文时追加一段 LibreOffice Kit 的 node/cli 绝对路径，SKILL.md 明文要求使用这段路径、且禁止自行搜索；以 rank 599 接管后官方 provider 不再被问到，这段就丢了 —— office 技能里的 LibreOffice 渲染/转换命令实际没有可用路径。现在由插件按官方 `officeRuntime()` 契约逐字复刻补上：桌面 node 取宿主自带的独立 node（`<resources>/runtime/primary-runtime/dependencies/node/bin/`，官方明令 packaged 应用必须独立 node，electron 本体不行；`DSH_PRIMARY_RUNTIME` / `DSH_BUNDLED_PRIMARY_RUNTIME` 环境变量优先，SDK 部署照官方取值），cli 取 `app.asar.unpacked` 里的真实文件（独立 node 读不了 asar 内部）；web node 即宿主 node 进程（官方默认 `process.execPath`），cli 走宿主进程解析链。任一路径不是真实文件时改用官方口径的「LibreOffice Kit is disabled in this deployment」降级文案 —— 绝不给跑不起来的路径。
+
+### 变更
+
+- **官方内置技能按宿主形态各物化一份**：物化目录从各宿主共用 `$DSH_HOME/tool-management/official-skills/` 改为 `official-skills/<desktop|web>/` 各写各的 —— 0.16.5 靠「web 完全不参与」压住竞态（web 重建会把桌面物化好的 4 个清成它解析到的 1 个，实测），分形态目录让 web 也能参与管理而不互踩；0.16.5 共享布局的顶层残留按已知名单自动清理。启停状态按技能名记在来源 `official` 下，两种形态共用一份。
+- **web 技能页也暴露 Office 三件套**（用户裁定）：web 宿主不装配 office 插件、不注入，但 npm 包自带完整 assets —— web 上从宿主进程解析链物化后照常列出、可启停（启用后随技能目录注入会话）。
+
+### 说明
+
+- **实测**：官方源码逐处核对（沙盒技能门控 `dsh-sandbox-local` 只看 win32；office 插件仅桌面装配；`officeRuntime()` 契约与桌面装配的 node/cli 落点），本机桌面安装核实独立 node 与 unpacked cli 真实存在。合成夹具四模式全过：web（4 个技能物化，Kit 段 node=宿主进程、cli=解析链包内 cli）、web 无 libreoffice-kit（官方降级文案）、桌面（Kit 段 node=primary-runtime 独立 node、cli=app.asar.unpacked 真实文件）、桌面目录布局不同（office/沙盒全走解析链兜底物化，Kit 降级文案，正文不含指向不存在布局的路径）。
+
 ## [0.16.5] - 2026-09-30
 
 issue #1 收尾与桌面版第二轮适配：兼容页身份比对改为逐包解析、逐包核对（桌面版不再误报「两份不同拷贝」），「全部可用」与「N 项不可用」不再同屏；桌面版注入会话的 4 个官方内置技能接入技能页管理。

package/docs/update.md

@@ -4,6 +4,7 @@
 
 | 版本                         | 发布       | 主题                                                                                                                                                                      |
 | ---------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [0.16.6](#0166---2026-09-30) | 2026-09-30 | 官方内置技能补全 web 侧：web 照注的沙盒诊断技能可见可停 + Office 三件套 web 也暴露 + 补上接管后缺失的 LibreOffice Kit 路径段（0.16.5 桌面已缺） |
 | [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 导入导出、配置体检、最近改动流水、场景绑工具表方案、整机迁移快照；功能总览英文补齐、兼容页收弹窗与界面打磨 |
@@ -25,6 +26,15 @@
 
 ---
 
+## 0.16.6 - 2026-09-30
+
+- **web 上注入的沙盒诊断技能看得见、关得掉了**：官方宿主的沙盒技能门控只看 Windows（web 照样向每个会话注入），0.16.5 却把 web 挡在官方内置管理之外——页面不显示、会话照注入。现在 web 也物化官方技能、以更高优先级接管，停用即不注入。
+- **web 技能页也列出 Office 三件套**：web 宿主不装配 office 插件（不注入），但包里自带完整资源——按裁定照常暴露，可启停（启用后会进会话技能目录）。
+- **补上接管后缺失的 LibreOffice Kit 路径段**：官方 provider 返回 office 技能正文时会追加一段 LibreOffice 的 node/cli 绝对路径（SKILL.md 明文要用、禁止自己找），接管后这段丢了（0.16.5 桌面已缺）——渲染/转换命令实际没有可用路径。现在由插件按官方契约补上：桌面用宿主自带的独立 node + asar 解包出来的真实 cli，web 用宿主 node 进程 + 包内 cli；路径取不到时给官方的「已停用」文案，绝不给跑不起来的路径。
+- **官方内置技能按宿主形态各存一份**（`official-skills/desktop/` 与 `/web/`）：互不覆盖，0.16.5 共享目录的竞态由此根治；旧布局残留自动清理，启停状态两种形态通用。
+
+---
+
 ## 0.16.5 - 2026-09-30
 
 - **桌面版不再误报 5 条「两份不同拷贝」**：宿主侧身份比对把第一个包（cordis）的路径当成其余五个包的，五条全部比成「不同」。现在逐包解析、逐包核对。

package/lib/skills/core.js

@@ -13,7 +13,7 @@
 // 文件写入错误由路由返回给调用方。
 import { homedir } from "node:os";
 import { join, basename, dirname, resolve, isAbsolute, } from "node:path";
-import { promises as fs, existsSync, mkdirSync, readdirSync, copyFileSync, rmSync, } from "node:fs";
+import { promises as fs, existsSync, mkdirSync, readdirSync, copyFileSync, rmSync, statSync, } from "node:fs";
 import { createRequire } from "node:module";
 import { createHash, randomUUID } from "node:crypto";
 import { unzipSync } from "fflate";
@@ -60,25 +60,27 @@ export function resolveAgentsHome() {
 }
 // ── 官方内置技能来源（随宿主注入会话上下文的内置技能）──────────────────────
 //
-// 桌面版把 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 路径读不了。
+// 宿主按形态注入不同的官方技能（官方源码逐一核对，2026-09-30）：
+//   - 桌面版 4 个：office-docx / office-pptx / office-xlsx（dsh-skill-office 只在桌面
+//     宿主装配，assetRoot 指到 `<resources>/runtime/office-skills`）+ diagnose-windows-
+//     sandbox-acl（dsh-sandbox-local 的门控是 `process.platform === "win32"`，rank 600）。
+//   - web 版：沙盒诊断技能由宿主注入（门控只看 win32 —— 用户 2026-09-30 截图实锤，
+//     0.16.5 按「web 不注入」的误判把 web 挡在门外，导致页面不显示、宿主照注）；office
+//     插件 web 宿主不装配、不注入，但用户裁定（2026-09-30）技能页照样把这三个暴露出来
+//     统一管理（npm 包自带完整 assets，接管后可启停）。
 //
-// 因此这里把来源**物化**成插件自有的一份真实目录（`$DSH_HOME/tool-management/
-// official-skills/`）：每次宿主启动从官方源头整目录覆盖拷贝（与官方 provider 的
-// 「私有资源副本」同一做法），扫描、启停、overlay、脚本执行全部落在真实文件上。
+// 它们或住在官方 asar 里、或由官方 provider 复制进临时目录自管，插件直接扫描/接管有两个
+// 坑：宿主子进程里对 asar 的 promises 读法与拦截器解析都出现过时灵时不灵（同机两次启动
+// 一组 4/1、一组全 0，实测）；沙盒技能的脚本要交给 PowerShell 子进程，asar 路径读不了。
+//
+// 因此这里把来源**物化**成插件自有的一份真实目录，**每种宿主形态各一份**
+// （`$DSH_HOME/tool-management/official-skills/<desktop|web>/`）：每次宿主启动从官方源头
+// 整目录覆盖拷贝（与官方 provider 的「私有资源副本」同一做法），扫描、启停、overlay、
+// 脚本执行全部落在真实文件上。599 压过宿主 provider 的 600，停用即不注入。分形态是竞态
+// 教训：0.16.5 之前共用一份目录，web 启动把它解析到的沙盒技能盖进去，桌面物化好的
+// 4 个只剩 1 个（实测）；改成各写各的子目录，互不清对方的账。共享布局的残留（旧条目
+// 直接躺在 official-skills/ 下）按已知名单清理。
 //
-// 两个边界（都出过事）：
-//   - 只有桌面版（有 process.resourcesPath）才允许进来。物化目录在 $DSH_HOME 下
-//     与各宿主**共用**，而 web 宿主进程里的官方模块拦截器能把 @deepseek-ai 裸名
-//     解析到宿主副本 —— web 若也进来重建，会把桌面物化好的整目录清成它解析到的
-//     那几个（2026-09-30 实测：桌面物化好 4 个，web 一启动，两份 UI 同时只剩沙盒
-//     1 个）。所以非桌面在碰目录**之前**就退出，一个技能都不列。
 //   - 预设参考技能（dsh-agent-preset/skills）不注入会话上下文，不列入（用户裁定）。
 //
 // 单个来源、随 DSH 技能之后排列，来源层语义同默认来源（不可移除、无来源开关）。
@@ -133,29 +135,90 @@ function resolvedPackageDir(packageName, subpath) {
     }
 }
 /**
- * office 技能源头。office 只在桌面版由宿主挂载（web 的补丁层没有它），所以只在
- * 桌面环境里找：运行时真实目录优先（官方 assetRoot），其次 asar 包内 assets。
- * 非桌面环境一律 null —— 不把没被注入的技能凭空列出来。
+ * office 技能源头。桌面版由宿主挂载：运行时真实目录优先（官方 assetRoot），其次 asar
+ * 包内 assets。web 宿主不装配 office 插件（不注入），但 npm 包自带完整 assets —— 用户
+ * 裁定（2026-09-30）技能页照样暴露这三个技能，走宿主进程解析链取包内一份。解析不到
+ * 一律 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 注入）。 */
+    if (resources !== 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 resolvedPackageDir("@deepseek-ai/dsh-skill-office", "assets");
+}
+/** 沙盒诊断技能源头（桌面 asar 直连优先，其次宿主进程解析链；宿主门控仅看 win32，web/桌面皆注入）。 */
 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"));
 }
+// ── office 技能的「Installed LibreOffice Kit」段 ────────────────────────────
+//
+// 官方 dsh-office provider 在 get 时给三个 office 技能的正文**追加**一段
+// 「Installed LibreOffice Kit」：SKILL.md 明文要求「使用这段提供的 libreofficeKit.node
+// 与 .cli 绝对路径，禁止自行搜索/猜测」。我们以 599 接管后官方 provider 不再被问到，
+// 这段必须由我们补上 —— 否则模型拿到的 office 技能缺执行 LibreOffice 命令所需的全部
+// 路径（这个缺口 0.16.5 在桌面上就已存在）。文案与 JSON 形状逐字取自官方
+// dsh-skill-office lib/index.js 的 officeRuntime()；node/cli 的落点按宿主形态各自核实：
+//   - 桌面：官方明确要求 packaged 应用必须给**独立 node**（electron 本体不行）。
+//     实测桌面把运行时装在 `<resources>/runtime/primary-runtime/`（DSH_PRIMARY_RUNTIME
+//     指向它，SDK 部署可被同名环境变量改写），node 在其 dependencies/node/bin 下；cli
+//     必须用 `app.asar.unpacked` 里的真实文件 —— 独立 node 读不了 asar 内部。
+//   - web：官方默认 process.execPath（宿主是普通 node 进程），cli 从宿主进程解析链取。
+// 任一路径不是真实文件 → 用官方口径的「已停用」文案（SKILL.md 自有降级分支，模型不会
+// 去猜路径），绝不给一个跑不起来的路径。
+const OFFICE_SKILL_NAMES = new Set([
+    "office-docx",
+    "office-pptx",
+    "office-xlsx",
+]);
+const OFFICE_RUNTIME_DISABLED = "\n\nLibreOffice Kit is disabled in this deployment.";
+let officeRuntimeSectionCache;
+/** 官方 provider 在 get 时追加的 LibreOffice Kit 段（每进程算一次，路径不随会话变）。 */
+function officialOfficeRuntimeSection() {
+    if (officeRuntimeSectionCache === undefined)
+        officeRuntimeSectionCache = computeOfficeRuntimeSection();
+    return officeRuntimeSectionCache;
+}
+function computeOfficeRuntimeSection() {
+    const resources = resourcesDir();
+    let node;
+    let cli;
+    const runtimeRoot = process.env.DSH_PRIMARY_RUNTIME || process.env.DSH_BUNDLED_PRIMARY_RUNTIME;
+    if (runtimeRoot) {
+        // SDK / 容器部署：官方配置从运行时根推导（cordis 装配逐字核对）。
+        node = join(resolve(runtimeRoot), "dependencies", "node", "bin", process.platform === "win32" ? "node.exe" : "node");
+        cli = resolvedPackageDir("@deepseek-ai/libreoffice-kit", "lib/cli.js");
+    }
+    else if (resources !== null) {
+        node = join(resources, "runtime", "primary-runtime", "dependencies", "node", "bin", process.platform === "win32" ? "node.exe" : "node");
+        // 桌面的 cli 只认 unpacked 真实文件（独立 node 读不了 asar；electron 的 fs 补丁
+        // 会让 existsSync 对 asar 内部也返回真，所以这里不用解析链兜底）。
+        cli = join(resources, "app.asar.unpacked", "dsh", "node_modules", "@deepseek-ai", "libreoffice-kit", "lib", "cli.js");
+    }
+    else {
+        node = process.execPath;
+        cli = resolvedPackageDir("@deepseek-ai/libreoffice-kit", "lib/cli.js");
+    }
+    const usable = (path) => {
+        try {
+            return isAbsolute(path) && statSync(path).isFile();
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!usable(node) || cli === null || !usable(cli))
+        return OFFICE_RUNTIME_DISABLED;
+    return `\n\n## Installed LibreOffice Kit\n\nUse these absolute paths for every LibreOffice Kit command. Pass the CLI entry as the first argument to Node.\n\n${JSON.stringify({ libreofficeKit: { node, cli } }, null, 2)}`;
+}
 function copyDirectorySync(from, to) {
     mkdirSync(to, { recursive: true });
     for (const entry of readdirSync(from, { withFileTypes: true })) {
@@ -172,17 +235,40 @@ function copyDirectorySync(from, to) {
  * 每次宿主启动整目录重建（官方包只随宿主更新变化，宿主更新必然重启宿主）。
  */
 let officialRootCache;
+/** 宿主形态子目录名：桌面（有 process.resourcesPath）与 web 等普通 node 进程各物化一份。 */
+function officialFormName() {
+    return resourcesDir() === null ? "web" : "desktop";
+}
+/**
+ * 0.16.5 之前各形态共用一份目录（旧条目直接躺在 official-skills/ 下）；分形态目录后
+ * 这些残留只会变成幽灵条目，按这份已知名单清掉。只清名单内的名字，绝不碰旁边的
+ * `<form>/` 子目录 —— 那是另一种形态物化的现役目录。
+ */
+const LEGACY_OFFICIAL_ENTRY_NAMES = Object.freeze([
+    "office-docx",
+    "office-pptx",
+    "office-xlsx",
+    "scripts",
+    "diagnose-windows-sandbox-acl",
+]);
+function cleanupLegacyOfficialLayout(root) {
+    for (const name of LEGACY_OFFICIAL_ENTRY_NAMES) {
+        try {
+            rmSync(join(root, name), { recursive: true, force: true });
+        }
+        catch {
+            /* 残留清理失败不影响物化，下轮启动再试 */
+        }
+    }
+}
 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");
+    // 每种宿主形态只整目录重建**自己**这份（竞态教训见上方块注释）；对方形态的子目录
+    // 与共享层残留清理互不干涉。
+    const root = join(resolveDshHome(), "tool-management", "official-skills", officialFormName());
     try {
         rmSync(root, { recursive: true, force: true });
         // office：整个 assets 根拷进来（office-*/ 与 scripts/ 的相对结构必须保留 ——
@@ -192,6 +278,7 @@ function materializeOfficialSkills() {
         if (sandbox !== null) {
             copyDirectorySync(sandbox, join(root, basename(sandbox)));
         }
+        cleanupLegacyOfficialLayout(dirname(root));
         return root;
     }
     catch (error) {
@@ -3139,6 +3226,12 @@ export async function getProviderSkill(candidate, options = {}) {
         const summary = entryOf(locator.entryName, entry.kind, entry.docPath, doc);
         if (!summary.loadable || summary.declaredName !== candidate.name)
             return undefined;
+        // 官方 office 技能：补上官方 provider 在 get 时追加的 LibreOffice Kit 段
+        // （SKILL.md 明文引用这段的 node/cli 路径，见上方块注释）。
+        const officeRuntime = locator.rootKey === OFFICIAL_SOURCE_KEY &&
+            OFFICE_SKILL_NAMES.has(locator.entryName)
+            ? officialOfficeRuntimeSection()
+            : "";
         return {
             name: candidate.name,
             description: candidate.description,
@@ -3148,7 +3241,7 @@ export async function getProviderSkill(candidate, options = {}) {
             resourceBase: candidate.resourceBase,
             path: candidate.path,
             metadata: candidate.metadata,
-            content: doc.body.trim(),
+            content: doc.body.trim() + officeRuntime,
         };
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-tool-management",
-  "version": "0.16.5",
+  "version": "0.16.6",
   "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",