dsh-toolbox-ui 1.6.0 → 1.6.1

package/README.en.md

@@ -52,10 +52,10 @@ An **MCP management panel and skills manager** for DeepSeek Harness Web: click t
 
 ```sh
 # Recommended: install from npm — `dsh plugin update` then upgrades within ^1.x automatically
-dsh plugin --profile web add dsh-toolbox-ui@^1.6.0
+dsh plugin --profile web add dsh-toolbox-ui@^1.6.1
 
 # Or pin a GitHub release tag (no automatic upgrades; re-add with a new tag to upgrade)
-dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.0
+dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.1
 ```
 
 Then **restart `dsh web`**. To upgrade:

package/README.md

@@ -50,10 +50,10 @@ DeepSeek Harness Web 的 **MCP 管理面板 + 技能管理面板**：右下角
 
 ```sh
 # 推荐：npm 安装 —— 之后 `dsh plugin update` 会在 ^1.x 内自动升到最新小版本
-dsh plugin --profile web add dsh-toolbox-ui@^1.6.0
+dsh plugin --profile web add dsh-toolbox-ui@^1.6.1
 
 # 或固定 GitHub release tag（不会自动跨版本，升级要换 tag 重新 add）
-dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.0
+dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.1
 ```
 
 装完**重启 `dsh web`**。升级：

package/docs/installation.md

@@ -15,14 +15,14 @@
 推荐用 npm 安装：包里的 `^1.x` 范围让后续 `dsh plugin update` 能自动升级小版本。
 
 ```sh
-dsh plugin --profile web add dsh-toolbox-ui@^1.6.0
+dsh plugin --profile web add dsh-toolbox-ui@^1.6.1
 ```
 
 也可以固定 GitHub release tag（适合需要锁定某个具体版本时）：
 
 ```sh
 # 固定 release tag
-dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.0
+dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.6.1
 
 # 或固定某个 commit
 dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#<commit>
@@ -73,7 +73,7 @@ dsh plugin --profile web update dsh-toolbox-ui
 
 | 安装规格 | `update` 的效果 | 怎么跨版本 |
 |---|---|---|
-| `dsh-toolbox-ui@^1.6.0`（npm，推荐） | 在 `^1.x` 内自动升到最新小版本，不会跨到 2.0.0 | 已是自动；跨大版本显式安装 `@^2` |
+| `dsh-toolbox-ui@^1.6.1`（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 门槛） |
@@ -112,7 +112,7 @@ dsh web    # 打开面板点一遍
 # 3) 提交并推 tag（CI 会校验 tag 与 version 一致，不一致就拒绝发布）
 git add -A && git commit -m "..."
 git push origin main
-git tag -a v1.6.0 -m "v1.4.2 ..." && git push origin v1.6.0
+git tag -a v1.6.1 -m "v1.4.2 ..." && git push origin v1.6.1
 ```
 
 推 tag 后 CI 依次做：校验版本 → `pnpm install --frozen-lockfile` → `npm test` → `npm publish`（trusted publishing，无需 token）→ `gh release create`。
@@ -131,7 +131,7 @@ git tag -a v1.6.0 -m "v1.4.2 ..." && git push origin v1.6.0
 
 ```sh
 npm publish          # 会弹 2FA 挑战；若用 bypass-2FA 的 granular token 则非交互
-gh release create v1.6.0 --title "dsh-toolbox-ui v1.6.0" --notes-file <notes>
+gh release create v1.6.1 --title "dsh-toolbox-ui v1.6.1" --notes-file <notes>
 ```
 
 `npm login` 的会话 token 只有 2 小时，超时需要重新登录；classic token 已被 npm 永久吊销，能非交互发布的只剩勾了 **Bypass 2FA** 的 granular access token——但它正在被 npm 收窄（已不能做账号/包管理类操作，且 2027-01 起将失去直接发布能力），所以长期方案是上面的 trusted publishing。

package/lib/client.js

@@ -3048,7 +3048,11 @@ const McpTab = (props) => {
       }
       const r = res.value || {};
       if (r.application === 'failed' || r.application === 'cancelled') {
-        setUpgradeState({ phase: 'failed', text: upgradeFailureText(r.error, r.packageResult && r.packageResult.exitCode) });
+        // 三个参数：未知错误码时要靠 pnpm 的原文解释失败（见 upgradeFailureText）。
+        setUpgradeState({
+          phase: 'failed',
+          text: upgradeFailureText(r.error, r.packageResult && r.packageResult.exitCode, r.packageResult && r.packageResult.output),
+        });
         return;
       }
       // applied / restart-required / overridden 都算装上了。宿主代码在进程内执行，升级已存在的包
@@ -3764,13 +3768,13 @@ const McpFooterAction = ({ wide }) => {
     {
       type: 'button',
       className: 'dsh-mcp-footer-action' + (wide ? '' : ' rail'),
-      title: 'MCP 市场面板',
-      'aria-label': '打开 MCP 市场面板',
+      title: '工具箱面板',
+      'aria-label': '打开工具箱面板',
       'aria-expanded': open,
       onClick: () => panelVisibility.set(true),
     },
     h(Icon, { d: ICONS.plug, size: wide ? 16 : 18 }),
-    wide ? h('span', { className: 'dsh-mcp-footer-name' }, 'MCP') : null,
+    wide ? h('span', { className: 'dsh-mcp-footer-name' }, '工具箱') : null,
   );
 };
 
@@ -3834,17 +3838,50 @@ function upgradePlan({ service, hint, bundle }) {
   };
 }
 
+/**
+ * 从官方 `packageResult.output` 里挑出**pnpm 自己说的那句话**。
+ *
+ * 为什么不直接把 output 贴上去：它整段是 pnpm 的完整输出（进度行、`npm notice` 噪声、
+ * 可能还有 ANSI 颜色码），几千字符贴进横幅等于没说话。这里只取"有信息量"的末尾几行。
+ *
+ * 为什么值得做：真机实测过一次失败，面板只显示「错误码 operation-error，pnpm 退出码
+ * 3221226505」（那个退出码是 Windows 上的崩溃码），而 pnpm 原文写得很清楚：
+ * `ERR_PNPM_NO_MATCHING_VERSION … The latest release of <包名> is "1.5.3"`。
+ * 官方早就把这段放在 `packageResult.output` 里回给我们了，之前一直没用。
+ */
+function pnpmOutputTail(output, limit = 3) {
+  const text = typeof output === 'string' ? output : '';
+  if (!text) return '';
+  const lines = text
+    // eslint-disable-next-line no-control-regex
+    .replace(/\u001b\[[0-9;]*m/g, '')
+    .split('\n')
+    .map((line) => line.trim())
+    .filter((line) => line && !/^npm (notice|warn)\b/.test(line) && !/^Progress:/.test(line));
+  if (lines.length === 0) return '';
+  // 从**最后一条报错行**起取（含它后面那几行）：pnpm 把结论写在报错行的紧后面——
+  // `[ERR_PNPM_NO_MATCHING_VERSION] No matching version found for <包名>@1.6.0` 的下一行就是
+  // `The latest release of <包名> is "1.5.3".`，那句才是用户最需要的。只挑含 error 的行会把它丢掉。
+  // 没有报错行时取末尾几行（pnpm 同样把结论放在最后）。
+  const errorAt = lines.reduce((found, line, index) => (/ERR_|error|Error|failed|ENOENT|ETIMEDOUT|ENOTFOUND|E404|EACCES/.test(line) ? index : found), -1);
+  const picked = errorAt >= 0 ? lines.slice(errorAt, errorAt + limit) : lines.slice(-limit);
+  const joined = picked.join(' ').replace(/\s+/g, ' ').trim();
+  return joined.length > 300 ? joined.slice(0, 297) + '…' : joined;
+}
+
 /**
  * 升级失败时给用户看的话。
  *
  * 为什么不能只写「升级失败」：desktop 直接改当前 profile 且**没有自动回滚**（见
  * deepseek-harness 的 desktop-in-place-profile 决策），用户必须知道发生了什么、下一步做什么。
- * 这些码来自 plugin-manager 的 ManagementError.code，逐个给出可操作的解释。
+ * 这些码来自 plugin-manager 的 ManagementError.code，逐个给出可操作的解释；**未知码**则把
+ * 码、退出码和 pnpm 的原文一起带出来——只写一个崩溃码，用户和我们都不无从查起。
  * @param {object|null} error - ChangeResult.error（{code, diagnostic?}）。
  * @param {number|null} exitCode - pnpm 退出码。
+ * @param {string|null} output - ChangeResult.packageResult.output（pnpm 的原始输出）。
  * @returns {string} 中文说明。
  */
-function upgradeFailureText(error, exitCode) {
+function upgradeFailureText(error, exitCode, output) {
   const code = error?.code;
   const known = {
     'incompatible-version': '新版本与当前 DSH 不兼容，未升级。',
@@ -3863,6 +3900,9 @@ function upgradeFailureText(error, exitCode) {
   const bits = [];
   if (code) bits.push('错误码 ' + code);
   if (typeof exitCode === 'number' && exitCode !== 0) bits.push('pnpm 退出码 ' + exitCode);
+  const tail = pnpmOutputTail(output);
+  // 已知码的解释已经说清了原因，就不再拿 pnpm 的输出淹没它；未知码才把原文接上。
+  if (tail) return (bits.length ? '升级失败（' + bits.join('，') + '）：' : '升级失败：') + tail;
   return bits.length ? '升级失败（' + bits.join('，') + '）。' : '升级失败。';
 }
 
@@ -4832,8 +4872,8 @@ const McpOverlay = ({ call, callSkills, timer, pluginManager }) => {
         ref: fabRef,
         type: 'button',
         className: 'dsh-mcp-fab',
-        title: 'MCP 市场面板（可拖拽移动）',
-        'aria-label': '打开 MCP 市场面板',
+        title: '工具箱面板（可拖拽移动）',
+        'aria-label': '打开工具箱面板',
         'aria-expanded': false,
         style,
         onClick: handleClick,
@@ -5035,7 +5075,7 @@ async function apply(ctx) {
     if (conflict) {
       // 只渲染提示、不注册入口。样式仍要注入，否则提示没有排版。
       ctx.slots.inject('shell.overlay', () =>
-        ctx.slots.register({ name: 'shell.overlay', id: 'mcp-handover', order: 1000, label: 'MCP' }, () => h(HandoverNotice, { conflict })),
+        ctx.slots.register({ name: 'shell.overlay', id: 'mcp-handover', order: 1000, label: '工具箱' }, () => h(HandoverNotice, { conflict })),
       );
       return cleanup;
     }
@@ -5043,13 +5083,16 @@ async function apply(ctx) {
       || (ctx.remote && ctx.remote[UPGRADE_NAMESPACE])
       || null;
     ctx.slots.inject('shell.overlay', () =>
-      ctx.slots.register({ name: 'shell.overlay', id: 'mcp-fab', order: 1000, label: 'MCP', inject: () => ({ call, callSkills, timer, pluginManager }) }, McpOverlay),
+      ctx.slots.register({ name: 'shell.overlay', id: 'mcp-fab', order: 1000, label: '工具箱', inject: () => ({ call, callSkills, timer, pluginManager }) }, McpOverlay),
     );
     // 官方标准侧栏入口（sidebar.footer.action，0.1.5 起声明）：与悬浮按钮共享同一个
       // 面板和开关状态。用 inject 而不是直接 register：它声明感知，会等侧边栏把 slot 声明出来
       // （插件加载顺序不保证晚于侧边栏）。
+    // ⚠️ label 就是侧栏里**看得见的那几个字**（slot 的 label 由外壳渲染）。这里从 'MCP' 改成
+    // '工具箱'：面板早就不是只有 MCP 了（还有技能面与技能市场），而 name/包名是 dsh-toolbox-ui
+    // ——入口上写着 MCP、点开却是 MCP + 技能，用户第一眼就会问"名字怎么还是 MCP"。
     ctx.slots.inject('sidebar.footer.action', () =>
-      ctx.slots.register({ name: 'sidebar.footer.action', id: 'mcp-manager', order: 100, label: 'MCP' }, McpFooterAction),
+      ctx.slots.register({ name: 'sidebar.footer.action', id: 'mcp-manager', order: 100, label: '工具箱' }, McpFooterAction),
     );
     return cleanup;
   } catch (error) {

package/lib/whats-new.js

@@ -171,4 +171,17 @@ export const WHATS_NEW = [
       },
     ],
   },
+  {
+    version: '1.6.1',
+    items: [
+      {
+        text: '**入口改名「工具箱」**：侧栏入口与悬浮按钮原来说「MCP」，可点开是 MCP **加**技能两个能力面——名字对不上东西。现在统一叫「工具箱」，能力层枚举里的「MCP / 技能」保持不动（那说的是能力，不是产品名）',
+        where: '侧栏入口与右下角悬浮按钮',
+      },
+      {
+        text: '**安装失败时说清原因**：以前只显示一个错误码（在 Windows 上还可能是个崩溃码），现在把 pnpm 自己的那句话带出来——例如「No matching version found … The latest release is 1.5.3」，装不上时你直接知道是版本、网络还是权限的问题',
+        where: '升级/安装失败的那条提示',
+      },
+    ],
+  },
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-toolbox-ui",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Responsive MCP management UI and skills manager for DeepSeek Harness Web — floating panel, JSON import, profile-backed Host Remote management, and a skill market with a hard license gate.",
   "repository": {
     "type": "git",