dsh-armory 2.4.4 → 2.4.5

package/README.en.md

@@ -112,6 +112,8 @@ Experts (WorkBuddy expert center, 429 experts / 15 industries; category filter +
 - **WB Market (direct installs)**: a third board tab with two markets in one place —
   - **Connectors (MCP)**: reads the official WorkBuddy distribution ZIP (`static.workbuddy.cn`, the same source the WorkBuddy desktop app uses) on demand — 316 connectors, 242 installable (mostly streamable-http), while 74 CLI-based or WorkBuddy-token-dependent ones are honestly labeled "view only" with the reason. Installing = merging the connector's `mcpServers` into your MCP config through the same pipeline as "Import JSON" (admission, duplicate skip, entry-id reservation), in either global or project scope. The ZIP is ETag-cached under `~/.dsh/wb-market/` and decompressed with Node's built-in zlib — **zero new runtime dependencies**. Before installing, a connector that pins a local executable is checked first: a missing file or unsupported platform is blocked with the exact path instead of being written and then losing its tools after ten reconnect attempts (issue #3). Cards report the **real connection state** — connected / needs authorization / not connected — and a 401/403 offers Re-authorize instead of a reconnect that cannot help; details show the authorization expiry and can refresh it, writing the new credential back to the config
   - **Community MCP (official Registry, new in 2.4.4)**: switch the Connectors tab to community entries from the official MCP Registry, with no WorkBuddy account; keyword search, cursor pagination, an "only directly runnable (npx / uvx)" filter, details with the launch command, args, environment variables and runnability, and "Add MCP" that only prefills the form and writes nothing until you confirm. Community entries are not reviewed by the Armory, and a permanent notice says so; the data layer accepts only active, runnable entries and https repository links
+  - **The community badge shows the size of the whole catalog (since 2.4.5)**: the Community MCP badge on the Connectors tab stays on screen and shows the **total number of catalog entries**, not how many rows this query read. The official Registry returns no total, so the panel counts page by page in the background (up to 12 pages per session, progress kept locally so the next visit resumes): an exact number once it reaches the end, an "N+" lower bound while counting, and "..." before it starts. The toolbar still shows the rows read by the current query, and both tooltips spell out which measure you are looking at
+  - **MCP entries you add now start on Windows (2.4.5)**: the host spawns stdio servers without a shell, while `npx` / `npm` on Windows are `.cmd` wrappers, so a bare spawn exits with `ENOENT` in milliseconds (the panel just shows "Connection closed" until the reconnect budget runs out). The single write boundary rewrites a bare `npx` / `npm` into the absolute `node.exe` on that machine plus the CLI entry script, and injects a writable npm cache directory (an existing `npm_config_cache` setting is never overwritten). Non-Windows commands, absolute paths, `uvx`, `${VAR}` and `!!js` are passed through untouched. **Trade-off**: the rewritten command is specific to that machine, so moving the config elsewhere means adding the connector again, and every rewrite is reported in the install notice
   - **Skills (SkillHub)**: reads the public SkillHub API (`api.skillhub.cn`, 190k+ skills) with keyword search, four sort orders, and pagination; details include publisher verification and security-scan status. Installing = downloading file-by-file, verifying each against the manifest's sha256, and writing into `~/.agents/skills/` (the same discovery scope as the official skill subsystem) — effective immediately. Installed skills show an "installed" badge, support one-click uninstall, and reinstalling updates them. After an install or uninstall the **Skill** tab's count badge and board list realign with the new set immediately — no tab switch or panel reopen needed. Downloads sorting is now done **within the current page** (the upstream `sortBy=downloads` hangs), while the other sorts still go remote; each request gives up after 15s and reports a localized error
   - Skills belong to their respective authors. Both upstreams are third-party interfaces whose fields may change; the panel carries a persistent note saying so
 - **Experts (direct, 1.9.0)** — a dedicated board tab (the sidebar entry is renamed **Skills · MCP · Experts**):

package/README.md

@@ -103,6 +103,8 @@ dsh plugin --profile web add github:2026heshao/dsh-armory
 - **WB 市场（直连安装，1.8.0 新增）**：看板第四个分类，两个市场一处浏览——
   - **连接器（MCP）**：直读 WorkBuddy 官方分发 ZIP（`static.workbuddy.cn`，与 WorkBuddy 桌面端同一数据源），316 个连接器按需解析；可安装的 242 个（streamable-http 为主），CLI 型 / 需 WorkBuddy token 注入的 74 个如实标注「仅展示」并给出原因。安装 = 把该连接器的 `mcpServers` 合并写入 MCP 配置，与「导入 JSON」同一链路（准入、同名跳过、entry id 预留一致），全局与项目作用域都可选；ZIP 按 ETag 缓存在 `~/.dsh/wb-market/`，解压用 Node 内置 zlib，**零新增运行时依赖**。安装前预检本地客户端型连接器写死的本机程序——缺文件 / 平台不符直接拦住并说明缺哪个路径，不再写进配置后重连十次注销工具（issue #3）；卡片状态按**真实连接态**区分「已连接 / 需授权 / 未连接」，401/403 就地给「重新授权」而不是让你反复重连，详情可看授权有效期并「刷新授权」把新凭据写回配置
   - **社区 MCP（官方 Registry，2.4.4 新增）**：连接器页可切到官方 MCP Registry 的社区条目，不依赖 WorkBuddy 账号；关键词搜索 + 游标分页 + 「只看可直接运行（npx / uvx）」，详情给出启动命令、参数、环境变量与可运行性，点「加入 MCP」只预填表单、确认后才写盘。社区条目未经军械库审核，来源行与详情常驻声明；数据层只接受 active 且可运行的条目，仓库链接仅放行 https
+  - **社区角标显示全库总数（2.4.5 起）**：连接器页「社区 MCP」角标常驻，显示的是**社区目录全库条目总数**而不是本次读到的条数——官方 Registry 不返回总数，插件在后台逐页统计（每次会话最多 12 页，进度存本机、下次打开续爬）：数到底是精确值，没数到底是「N+」下界，还没开爬是「…」；工具条继续显示本次查询的「已读取 N 条」，两处口径在悬浮说明里写清
+  - **Windows 上加入的 MCP 不再必然连不上（2.4.5）**：宿主起 stdio 服务不走 shell，而 `npx` / `npm` 在 Windows 上是 `.cmd` 壳，裸 spawn 直接 `ENOENT` 秒退（面板表现为「连接已关闭」且重连耗尽后永久失败）。写入配置的唯一边界会把裸 `npx` / `npm` 归成本机绝对 `node.exe` + 入口 JS，并注入可写的 npm 缓存目录（你配过 `npm_config_cache` 就不动）；非 Windows、绝对路径、`uvx`、`${VAR}`、`!!js` 原样放行。**副作用**：归一后的命令是本机专属路径，换机导入需重新「加入 MCP」；改动会如实写进安装提示
   - **技能（SkillHub）**：直读 SkillHub 公开 API（`api.skillhub.cn`，19 万+ 技能），支持搜索（`keyword`）、排序（下载/安装/星标/评分）、分页；详情含发布方认证与安全扫描状态。安装 = 逐文件下载并按清单 sha256 校验后写入 `~/.agents/skills/`（与官方 skill 子系统同一发现范围），装完即刻生效；已装的显示「已安装」，可一键卸载、重装即更新。下载量排序在**当前页内**本地完成（上游 `sortBy=downloads` 现在会挂起），其余排序照常走远程；单次请求 15 秒超时，超时文案已中文化
   - 技能版权归原作者所有；两个均为第三方接口，字段可能随上游改版变化（面板顶部有常驻说明）
 - **专家直连（1.9.0 新增，体验对齐 WorkBuddy 专家中心）**：看板独立分类「专家」（侧栏入口同步更名「技能 · MCP · 专家」）——
@@ -292,7 +294,7 @@ dsh plugin --profile web remove dsh-armory
 
 ```sh
 npm install --no-save yaml@2 eslint@9   # 测试与风格检查的唯一裸依赖（运行依赖全部由宿主提供）
-npm test                                # 全 65 套件（与 CI / 发版门槛同一条）
+npm test                                # 全 67 套件（与 CI / 发版门槛同一条）
 npm run lint                            # ESLint：no-undef / no-unused-vars / no-empty 等
 npm run test:e2e                        # 可选：用宿主补丁算法验证专家预设进入组合树
 dsh --profile web --dump-config         # 看 profile 的有效配置
@@ -311,6 +313,7 @@ dsh web                                 # 起 Web 做真实操作验证
 | 自定义套件（2.2.0） | `suites-registry` `suites-client` | 整集合覆盖 / 幂等 / 拒绝与截断两态；id 归属契约（保存后不分裂）、引用套件展开为多个 `/name`、三级写通道降级 |
 | 技能集合（2.2.0） | `skill-remove` `skill-refresh` | 卸载来源白名单与路径边界（根自身 / `..` 穿越 / 跨来源根 / 符号链接只删链接）；装 / 卸后角标与看板实时刷新、乱序回包守卫 |
 | 社区 MCP（2.4.4） | `mcp-community` `community-pager` `community-detail` | Registry 映射 / active 与可运行过滤 / 游标 / 缓存重算 serverName / 4xx 与 5xx 分流；已读取总数与游标栈；详情字段、焦点与「加入 MCP」动作 |
+| Windows 启动器与全库计数（2.4.5） | `win32-stdio-launch` `community-count` | 裸 `npx` / `npm` 归一（探测可注入、非 win32 不介入、幂等、降级如实报错）；有界续爬 / 游标链 / 失败不清进度 / 统计口径 == 列表口径 / 常驻徽标三态 |
 | 技能禁用（2.4.4） | `skill-disable` | frontmatter 手术（重复键收敛 / CRLF / 空块 / 无闭行）；来源白名单、根包含、realpath、BOM 与无合法 frontmatter 拒绝；幂等重放不写盘 |
 | 连接器体检（2.4.4） | `connector-auth-health` `wb-connector-local` | 真实连接态 / 已安装但未连接 / 需授权（401/403）/ 安装闸 / 授权状态；本机固定依赖 found / missing / platform 与安装前拦截 |
 | 项目 MCP 与系统打开（2.4.4） | `workspace-runtime` `system-open-spawn-guard` | 会话登记不依赖配置文件存在、对齐并入存活但未登记的会话；headless 缺 `xdg-open` 不拖走进程（含旧写法必崩的反向自测） |

package/lib/client.js

@@ -1181,6 +1181,13 @@ const EN_US_MESSAGES = {
   "读取授权状态失败": "Couldn't read authorization status",
   "正在重连…": "Reconnecting…",
   "已请求重连": "Reconnect requested",
+  "重连失败": "Reconnect failed",
+  // 顶部进度浮层（安装 / 加入 MCP / 重连共用一枚浮层，分组只换措辞）。
+  "正在处理 {0} 个 MCP 任务…": "Handling {0} MCP task(s)…",
+  "MCP 任务已结束": "MCP tasks finished",
+  "写入配置中…": "Writing config…",
+  "已加入 · 宿主自动连接中": "Added · the host is connecting",
+  "加入失败": "Add failed",
   "正在刷新授权…": "Refreshing authorization…",
   "{0}：授权已刷新，正在把新凭据写回配置…": "{0}: authorization refreshed, writing the new credential back to the config…",
   "刷新授权失败": "Couldn't refresh authorization",
@@ -1229,6 +1236,14 @@ const EN_US_MESSAGES = {
   "正在加载…": "Loading…",
   "已经到底了": "No more results",
   "第 {0} 页": "Page {0}",
+  // 社区目录全库总数（徽标常驻）：官方 Registry 不返回总数，只能逐页统计，所以分「共 N 条」
+  // 与「至少 N 条」两种口径，别让下界被读成上限。
+  "正在后台统计社区目录条目数，稍后自动显示…": "Counting the community catalog in the background — it shows up shortly…",
+  "社区目录共 {0} 条（逐页统计；官方 Registry 不返回总数）": "The community catalog holds {0} entries (counted page by page; the official Registry returns no total)",
+  "社区目录至少 {0} 条，仍在后台续爬统计（官方 Registry 不返回总数）": "The community catalog holds at least {0} entries - still counting in the background (the official Registry returns no total)",
+  "本次查询已逐页读取的条数；上方徽标显示的是社区目录全库总数": "Entries read page by page for this query; the badge above shows the whole community catalog",
+  "WorkBuddy 官方目录里的连接器总数": "Total connectors in the official WorkBuddy catalog",
+  "正在读取连接器列表…": "Loading the connector list…",
   "加入 MCP": "Add MCP",
   "已加入": "Added",
   "已加入 ": "Added ",
@@ -1420,6 +1435,58 @@ function writeAwesomeProbeAt(value) {
   try { localStorage.setItem(AWESOME_PROBE_AT_KEY, String(value)); } catch { /* 隐私模式：退化为不节流 */ }
 }
 
+// ── 社区目录「全库总数」：连接器页那枚常驻徽标上的数 ─────────────────────────
+// 为什么不是直接问上游要：官方 Registry 不给总数——实测 `metadata.count` 就是本页条数
+// （limit=1 时 1、limit=100 时 100），`/v0/servers/count` 与 `/v0/registry/stats` 都是
+// 404，`limit>100` 直接 422。要数出来只能顺游标一页页爬，而全库实测 ≥13,000 条
+// （130 页仍未到底）、单页 2.4–8s，一次爬完要十几分钟和约 9MB，绝不能挡在用户面前。
+// 所以做成「有界 + 可续爬」：每次打开面板最多数 COMMUNITY_COUNT_PAGE_BUDGET 页，进度落
+// 在这里，下次接着数；数到底显示精确值，没到底显示下界「N+」。
+// 为什么值得为它写持久化：徽标原先显示的是「已读取 98 条」，用户会读成"社区一共只有 98 个"
+// （2026-10-30 用户反馈）。一个会慢慢长对的「1200+」比一个看起来像总数的「98」诚实得多。
+const COMMUNITY_COUNT_KEY = KEY_PREFIX + '.communityCount.v1';
+/** 数据层单块页数（lib/mcp-community.js 的 COMMUNITY_COUNT_CHUNK_PAGES 同值，靠测试钉住）。 */
+const COMMUNITY_COUNT_CHUNK_PAGES = 3;
+/** 一次面板会话的页数预算：4 块 × 3 页 = 12 页 = 1200 条，约 0.9MB。 */
+const COMMUNITY_COUNT_PAGE_BUDGET = 12;
+/** 空记录：还没数过。徽标显示「…」而不是消失——数字常驻才不会被当成"这一页就是全部"。 */
+const emptyCommunityCount = () => ({ counted: 0, cursor: '', done: false, at: 0 });
+
+function readCommunityCount() {
+  try {
+    const raw = localStorage.getItem(COMMUNITY_COUNT_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    const counted = Number(parsed?.counted);
+    if (!Number.isFinite(counted) || counted < 0) return null;
+    return {
+      counted: Math.floor(counted),
+      cursor: typeof parsed.cursor === 'string' ? parsed.cursor : '',
+      done: parsed.done === true,
+      at: Number(parsed.at) || 0,
+    };
+  } catch { return null; }
+}
+
+function writeCommunityCount(record) {
+  // 只存四个标量（约 120 字节），不进快照那套 4.5MB 预算。
+  try { localStorage.setItem(COMMUNITY_COUNT_KEY, JSON.stringify(record)); } catch { /* 隐私模式：下次进面板重数 */ }
+}
+
+/** 徽标文本：没数过 / 数为 0 且没到底 → 「…」；数到底 → 精确值；否则 → 下界「N+」。 */
+function communityCountBadgeText(record) {
+  if (!record) return '…';
+  if (record.done) return String(record.counted);
+  return record.counted > 0 ? `${record.counted}+` : '…';
+}
+
+/** 徽标 tooltip：把「这个数是什么口径」写清楚，别让 1200+ 被读成"只能看到 1200 个"。 */
+function communityCountBadgeTitle(record) {
+  if (!record || !record.counted) return t('正在后台统计社区目录条目数，稍后自动显示…');
+  if (record.done) return t('社区目录共 {0} 条（逐页统计；官方 Registry 不返回总数）', [String(record.counted)]);
+  return t('社区目录至少 {0} 条，仍在后台续爬统计（官方 Registry 不返回总数）', [String(record.counted)]);
+}
+
 // ── 安装轻提示：挂在 document.body 上的常驻浮层 ─────────────────────────────
 // 安装进度此前只存在组件本地 state（busy / busyLabel）：用户一切到别的面板或窗口，
 // 组件卸载 → 进度消失 → 看起来像「安装被取消了」。这个浮层直接挂 document.body，
@@ -1428,10 +1495,42 @@ function writeAwesomeProbeAt(value) {
 // 写插件名，不拼 innerHTML。
 const INSTALL_TOAST_ID = KEY_PREFIX + '-install-toast';
 const INSTALL_TOAST_CSS_ID = KEY_PREFIX + '-install-toast-css';
-// name → { name, phase: 'running' | 'ok' | 'fail', at }
+// key → { name, phase: 'running' | 'ok' | 'fail', at, group, labels }
+//   plugin 组的 key 就是插件名：isInstallRunning(名字) 靠它禁用「安装」按钮，这个约定不能改；
+//   MCP 组的 key 带 'mcp:<动作>:<名称>' 前缀，既不会被同名插件顶掉一行，也不参与按钮禁用。
 const installTasks = new Map();
 const installTimers = new Map();
 let installToastNode = null;
+/** 浮层分组：决定标题措辞。 */
+const PROGRESS_GROUP_PLUGIN = 'plugin';
+const PROGRESS_GROUP_MCP = 'mcp';
+// 状态文案一律写成「渲染时才调 t()」的函数：语言在模块加载之后还可能切换，
+// 提前求值会把首次加载那一刻的 locale 钉进常量里（顺带也满足全文件中文包裹不变式）。
+const PLUGIN_TASK_LABELS = {
+  running: () => t('安装中…'),
+  ok: () => t('已安装'),
+  fail: () => t('安装失败'),
+};
+const MCP_ADD_TASK_LABELS = {
+  running: () => t('写入配置中…'),
+  ok: () => t('已加入 · 宿主自动连接中'),
+  fail: () => t('加入失败'),
+};
+const MCP_RECONNECT_TASK_LABELS = {
+  running: () => t('正在重连…'),
+  ok: () => t('已请求重连'),
+  fail: () => t('重连失败'),
+};
+const PROGRESS_TITLES = {
+  [PROGRESS_GROUP_PLUGIN]: {
+    running: (count) => t('正在安装 {0} 个插件…', [count]),
+    done: () => t('安装任务已结束'),
+  },
+  [PROGRESS_GROUP_MCP]: {
+    running: (count) => t('正在处理 {0} 个 MCP 任务…', [count]),
+    done: () => t('MCP 任务已结束'),
+  },
+};
 function installToastCss() {
   if (typeof document === 'undefined' || document.getElementById(INSTALL_TOAST_CSS_ID)) return;
   const style = document.createElement('style');
@@ -1439,17 +1538,25 @@ function installToastCss() {
   style.textContent = [
     '.dsh-mcp-install-toast{position:fixed;top:64px;left:50%;transform:translate(-50%,-14px);z-index:2147483000;',
     'display:none;flex-direction:column;gap:6px;min-width:220px;max-width:min(420px,calc(100vw - 32px));',
-    'padding:10px 14px 11px;border-radius:12px;pointer-events:none;',
-    'background:var(--dsw-alias-bg-elevated,rgba(32,33,36,.92));color:var(--dsw-alias-text-primary,#f3f4f6);',
-    'border:1px solid var(--dsw-alias-border-subtle,rgba(255,255,255,.12));',
-    'box-shadow:0 10px 30px rgba(0,0,0,.28);backdrop-filter:blur(14px) saturate(160%);',
+    'padding:10px 14px 11px;border-radius:12px;pointer-events:none;text-align:start;',
+    // 与底部 .dsh-mcp-toast 同一对自持色（--mcp-tip-*）：宿主 token 里
+    // --dsw-alias-bg-elevated / --dsw-alias-text-primary 本皮根本没定义，全靠这里的 fallback
+    // 撑着；一旦宿主基础样式给其中一个赋值，就会重演「深蓝字压深蓝底」。fallback 值与
+    // --mcp-tip-bg/--mcp-tip-fg 同色，两处浮层从此共用一套对比度已实测的色面。
+    'background:var(--mcp-tip-bg,rgba(23,38,63,.93));color:var(--mcp-tip-fg,#f4f7fd);',
+    'border:1px solid var(--mcp-tip-line,rgba(255,255,255,.18));',
+    'box-shadow:var(--mcp-tip-shadow,0 10px 30px rgba(0,0,0,.30));backdrop-filter:blur(14px) saturate(160%);',
     'font-size:12px;line-height:1.45;opacity:0;transition:opacity .18s ease,transform .18s ease}',
     '.dsh-mcp-install-toast.on{display:flex;opacity:1;transform:translate(-50%,0)}',
     '.dsh-mcp-install-toast-title{font-weight:600;font-size:12px;letter-spacing:.01em}',
     '.dsh-mcp-install-toast-row{display:flex;align-items:center;gap:8px;min-width:0}',
-    '.dsh-mcp-install-toast-dot{flex:0 0 auto;width:7px;height:7px;border-radius:50%;background:var(--dsw-alias-accent-primary,#4d9fff);animation:dsh-mcp-install-pulse 1.1s ease-in-out infinite}',
-    '.dsh-mcp-install-toast-row[data-phase="ok"] .dsh-mcp-install-toast-dot{animation:none;background:var(--dsw-alias-status-success,#35c46a)}',
-    '.dsh-mcp-install-toast-row[data-phase="fail"] .dsh-mcp-install-toast-dot{animation:none;background:var(--dsw-alias-status-danger,#f0616b)}',
+    // 状态圆点同样走自持色：宿主 --dsw-alias-accent-primary / -status-success / -status-danger
+    // 三个键在本皮都不存在（皮肤用的是 state-*-primary 命名），旧写法一直吃 fallback。
+    // 7px 的点属非文本信息，但它是「进行中/成功/失败」的唯一视觉差异，必须在深色面上站得住
+    // （#7fb2ff / --mcp-tip-ok / --mcp-tip-err 对 #17263f 实测 6.7:1 以上）。
+    '.dsh-mcp-install-toast-dot{flex:0 0 auto;width:7px;height:7px;border-radius:50%;background:#7fb2ff;animation:dsh-mcp-install-pulse 1.1s ease-in-out infinite}',
+    '.dsh-mcp-install-toast-row[data-phase="ok"] .dsh-mcp-install-toast-dot{animation:none;background:var(--mcp-tip-ok,#7ee0a1)}',
+    '.dsh-mcp-install-toast-row[data-phase="fail"] .dsh-mcp-install-toast-dot{animation:none;background:var(--mcp-tip-err,#ff8a8a)}',
     '.dsh-mcp-install-toast-name{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
     '.dsh-mcp-install-toast-status{flex:0 0 auto;opacity:.72;font-variant-numeric:tabular-nums}',
     '@keyframes dsh-mcp-install-pulse{0%,100%{opacity:.35;transform:scale(.85)}50%{opacity:1;transform:scale(1)}}',
@@ -1472,16 +1579,28 @@ function ensureInstallToast() {
   installToastNode = node;
   return node;
 }
+/** 行内状态文案：取该任务所属组的 labels，按当前 phase 调对应的 t() 函数。 */
+function taskStatusLabel(task) {
+  const label = (task.labels || PLUGIN_TASK_LABELS)[task.phase];
+  return typeof label === 'function' ? label() : '';
+}
 function renderInstallToast() {
   const node = ensureInstallToast();
   if (!node) return;
   const tasks = [...installTasks.values()];
   node.replaceChildren();
   if (!tasks.length) { node.classList.remove('on'); return; }
-  const running = tasks.filter((task) => task.phase === 'running').length;
+  const runningTasks = tasks.filter((task) => task.phase === 'running');
+  // 标题按「正在跑的那一组」措辞；两组同时在跑（装插件的同时点 MCP 重连）很罕见，
+  // 取第一条进行中的分组就够，不为它另设一套文案。
+  const group = (runningTasks[0] || tasks[0]).group || PROGRESS_GROUP_PLUGIN;
+  const titles = PROGRESS_TITLES[group] || PROGRESS_TITLES[PROGRESS_GROUP_PLUGIN];
+  // 计数只数「标题所指的这一组」：两组同时在跑时说「正在安装 2 个插件」而其中一个是 MCP
+  // 就是假计数。另一组的任务不消失，仍在下面的行里逐条列出。
+  const groupRunning = runningTasks.filter((task) => (task.group || PROGRESS_GROUP_PLUGIN) === group).length;
   const title = document.createElement('div');
   title.className = 'dsh-mcp-install-toast-title';
-  title.textContent = running ? t('正在安装 {0} 个插件…', [String(running)]) : t('安装任务已结束');
+  title.textContent = groupRunning ? titles.running(String(groupRunning)) : titles.done();
   node.appendChild(title);
   for (const task of tasks.slice(0, 3)) {
     const row = document.createElement('div');
@@ -1494,37 +1613,53 @@ function renderInstallToast() {
     name.textContent = task.name;
     const status = document.createElement('span');
     status.className = 'dsh-mcp-install-toast-status';
-    status.textContent = task.phase === 'running' ? t('安装中…') : task.phase === 'ok' ? t('已安装') : t('安装失败');
+    status.textContent = t(taskStatusLabel(task));
     row.appendChild(dot); row.appendChild(name); row.appendChild(status);
     node.appendChild(row);
   }
   node.classList.add('on');
 }
-function installToastStart(name) {
-  const key = String(name || '');
-  if (!key) return;
-  const pending = installTimers.get(key);
-  if (pending) { clearTimeout(pending); installTimers.delete(key); }
-  installTasks.set(key, { name: key, phase: 'running', at: Date.now() });
+/**
+ * 通用进度浮层入口：key 唯一标识一个在跑的任务（重复开装顶掉同一行，不叠两行）。
+ * 挂的是 document.body，面板卸载、切标签页、切窗口都还在——这正是它存在的全部理由。
+ */
+function progressToastStart(key, name, group, labels) {
+  const taskKey = String(key || '');
+  if (!taskKey) return;
+  const pending = installTimers.get(taskKey);
+  if (pending) { clearTimeout(pending); installTimers.delete(taskKey); }
+  installTasks.set(taskKey, {
+    name: String(name || taskKey),
+    phase: 'running',
+    at: Date.now(),
+    group: group || PROGRESS_GROUP_PLUGIN,
+    labels: labels || PLUGIN_TASK_LABELS,
+  });
   renderInstallToast();
 }
-function installToastFinish(name, phase) {
-  const key = String(name || '');
-  const task = installTasks.get(key);
+function progressToastFinish(key, phase) {
+  const taskKey = String(key || '');
+  const task = installTasks.get(taskKey);
   if (!task) return;
   task.phase = phase;
   task.at = Date.now();
   renderInstallToast();
-  // 结果态留 4.2s 让用户看清「装完了 / 失败了」，再淡出；期间同一插件重新开装会取消这个定时器。
+  // 结果态留 4.2s 让用户看清「装完了 / 失败了」，再淡出；期间同一任务重新开跑会取消这个定时器。
   const timer = setTimeout(() => {
-    installTimers.delete(key);
-    const current = installTasks.get(key);
+    installTimers.delete(taskKey);
+    const current = installTasks.get(taskKey);
     if (current && current.phase !== 'running' && Date.now() - current.at >= 4000) {
-      installTasks.delete(key);
+      installTasks.delete(taskKey);
       renderInstallToast();
     }
   }, 4200);
-  installTimers.set(key, timer);
+  installTimers.set(taskKey, timer);
+}
+function installToastStart(name) {
+  progressToastStart(name, name, PROGRESS_GROUP_PLUGIN, PLUGIN_TASK_LABELS);
+}
+function installToastFinish(name, phase) {
+  progressToastFinish(name, phase);
 }
 
 // 面板卸载后组件的 busy 会归零，但模块级的 installTasks 还在跑：按钮禁用要同时看它，
@@ -1983,12 +2118,17 @@ function renderReadmeBlocks(markdown, base) {
 const FAB_SIZE = 50;
 const FAB_EDGE = 22;
 
-const MCP_CSS = `body{--mcp-cat-all:var(--dsw-alias-label-primary);--mcp-cat-uncat:var(--dsw-alias-label-primary);--mcp-cat-dev:var(--dsw-static-deepseek-500);--mcp-cat-design:var(--dsw-static-blue-400);--mcp-cat-office:var(--dsw-static-green-500);--mcp-cat-auto:var(--dsw-static-amber-500);--mcp-cat-ops:var(--dsw-static-neutral-bluish-500);--mcp-accent:var(--dsw-alias-brand-primary);--mcp-ok:var(--dsw-alias-state-success-primary);--mcp-err:var(--dsw-alias-state-error-primary);--mcp-warn:var(--dsw-alias-state-warn-primary);--mcp-mut:var(--dsw-alias-label-secondary);--mcp-bg-1:var(--dsw-alias-bg-layer-1);--mcp-bg-2:var(--dsw-alias-bg-layer-2);--mcp-bg-3:var(--dsw-alias-bg-layer-3);--mcp-line:var(--dsw-alias-border-l2);--mcp-mono:var(--ds-font-family-code,ui-monospace,SFMono-Regular,Menlo,monospace);--mcp-r-xs:var(--dsw-radius-xs);--mcp-r-sm:var(--dsw-radius-sm);--mcp-r-md:var(--dsw-radius-md);--mcp-r-lg:var(--dsw-radius-lg);--mcp-r-xl:var(--dsw-radius-xl);--mcp-r-panel:var(--dsw-radius-panel)}
+const MCP_CSS = `body{--mcp-cat-all:var(--dsw-alias-label-primary);--mcp-cat-uncat:var(--dsw-alias-label-primary);--mcp-cat-dev:var(--dsw-static-deepseek-500);--mcp-cat-design:var(--dsw-static-blue-400);--mcp-cat-office:var(--dsw-static-green-500);--mcp-cat-auto:var(--dsw-static-amber-500);--mcp-cat-ops:var(--dsw-static-neutral-bluish-500);--mcp-accent:var(--dsw-alias-brand-primary);--mcp-ok:var(--dsw-alias-state-success-primary);--mcp-err:var(--dsw-alias-state-error-primary);--mcp-warn:var(--dsw-alias-state-warn-primary);--mcp-mut:var(--dsw-alias-label-secondary);--mcp-bg-1:var(--dsw-alias-bg-layer-1);--mcp-bg-2:var(--dsw-alias-bg-layer-2);--mcp-bg-3:var(--dsw-alias-bg-layer-3);--mcp-line:var(--dsw-alias-border-l2);--mcp-mono:var(--ds-font-family-code,ui-monospace,SFMono-Regular,Menlo,monospace);--mcp-r-xs:var(--dsw-radius-xs);--mcp-r-sm:var(--dsw-radius-sm);--mcp-r-md:var(--dsw-radius-md);--mcp-r-lg:var(--dsw-radius-lg);--mcp-r-xl:var(--dsw-radius-xl);--mcp-r-panel:var(--dsw-radius-panel);--mcp-tip-bg:#17263fec;--mcp-tip-fg:#f4f7fd;--mcp-tip-line:#ffffff2e;--mcp-tip-err:#ff8a8a;--mcp-tip-ok:#7ee0a1;--mcp-tip-shadow:0 10px 28px rgba(0,0,0,.30)}
 /* Skill 看板升级 · 分类色（决策 10：只从宿主既有色相取，只用于色点与徽标）。
    暗色套与宿主 ui-theme 同构（body[data-ds-dark-theme]，取证见进度文档 §七）；
    分类色永远与文字标签成对出现，不单独用颜色传达信息。 */
-body[data-ds-dark-theme]{--mcp-cat-dev:var(--dsw-static-deepseek-400);--mcp-cat-design:var(--dsw-static-blue-300);--mcp-cat-office:var(--dsw-static-green-400);--mcp-cat-auto:var(--dsw-static-amber-400);--mcp-cat-ops:var(--dsw-static-neutral-bluish-400)}
-.dsh-mcp-wrap,.dsh-mcp-panel-overlay,.dsh-mcp-overlay,.dsh-mcp-fab,.dsh-mcp-footer-action,.dsh-mcp-toast{color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-family,inherit)}
+body[data-ds-dark-theme]{--mcp-cat-dev:var(--dsw-static-deepseek-400);--mcp-cat-design:var(--dsw-static-blue-300);--mcp-cat-office:var(--dsw-static-green-400);--mcp-cat-auto:var(--dsw-static-amber-400);--mcp-cat-ops:var(--dsw-static-neutral-bluish-400);--mcp-tip-bg:#0c1a34e6}
+/* 浮层提示（底部 toast / 顶部进度 pill）不跟页面主文字色：它们的底是插件自持的深色面
+   （--mcp-tip-bg）。皮肤把 --dsw-alias-toast-bg 定成深蓝、把 --dsw-alias-label-primary 定成
+   近黑 Navy（whale-song 浅色皮 #1a3a7a / #0a1e4a，实测 1.49:1），两者一组就是「深蓝字压深蓝底」，
+   用户读不清。所以这里把浮层从 label-primary 的分组选择器里摘出来，只留字体族。 */
+.dsh-mcp-wrap,.dsh-mcp-panel-overlay,.dsh-mcp-overlay,.dsh-mcp-fab,.dsh-mcp-footer-action,.dsh-mcp-toast{font-family:var(--dsw-font-family,inherit)}
+.dsh-mcp-wrap,.dsh-mcp-panel-overlay,.dsh-mcp-overlay,.dsh-mcp-fab,.dsh-mcp-footer-action{color:var(--dsw-alias-label-primary)}
 .dsh-mcp-wrap{box-sizing:border-box;display:flex;flex-direction:column;height:100%;min-height:0;gap:14px;padding:4px 2px;font-size:13px;-webkit-font-smoothing:antialiased}
 .dsh-mcp-wrap ::-webkit-scrollbar{width:8px;height:8px}
 .dsh-mcp-wrap ::-webkit-scrollbar-thumb{background:var(--dsw-alias-scrollbar-bg-l2);border-radius:999px;corner-shape:round;border:2px solid transparent;background-clip:padding-box}
@@ -2244,9 +2384,9 @@ body[data-ds-dark-theme]{--mcp-cat-dev:var(--dsw-static-deepseek-400);--mcp-cat-
 .dsh-mcp-import-group>b{flex:0 0 auto;color:var(--mcp-mut)}
 .dsh-mcp-import-group>b.warn{color:var(--mcp-warn)}
 .dsh-mcp-import-group-note{font-size:11px;line-height:1.5;color:var(--mcp-mut);overflow-wrap:anywhere;margin-top:2px}
-.dsh-mcp-toast{position:fixed;bottom:24px;left:50%;transform:translateX(-50%);background:var(--dsw-alias-toast-bg);backdrop-filter:blur(10px);border:0;color:var(--dsw-alias-label-primary);padding:10px 18px;border-radius:var(--mcp-r-lg);font-size:12.5px;z-index:300;box-shadow:var(--dsw-shadow-lv3);max-width:70vw;animation:mcpPop .16s ease-out}
-.dsh-mcp-toast.err{border:1px solid var(--dsw-alias-state-error-primary)}
-.dsh-mcp-toast.ok{border:1px solid var(--dsw-alias-state-success-primary)}
+.dsh-mcp-toast{position:fixed;bottom:24px;left:50%;transform:translateX(-50%);background:var(--mcp-tip-bg);backdrop-filter:blur(10px);border:1px solid var(--mcp-tip-line);color:var(--mcp-tip-fg);padding:9px 16px;border-radius:var(--mcp-r-lg);font-size:12.5px;line-height:1.5;text-align:center;z-index:300;box-shadow:var(--mcp-tip-shadow);max-width:min(560px,calc(100vw - 32px));overflow-wrap:anywhere;animation:mcpPop .16s ease-out}
+.dsh-mcp-toast.err{border-color:var(--mcp-tip-err)}
+.dsh-mcp-toast.ok{border-color:var(--mcp-tip-ok)}
 .dsh-mcp-toggle{position:relative;width:34px;height:19px;box-sizing:border-box;border-radius:999px;border:0;cursor:pointer;background:var(--dsw-alias-border-l3);transition:background .18s,border-color .18s;flex:none;box-shadow:none;corner-shape:round}
 .dsh-mcp-toggle[aria-checked='true']{background:var(--mcp-accent);border-color:transparent}
 .dsh-mcp-toggle:disabled{opacity:.65;cursor:not-allowed}
@@ -2905,7 +3045,7 @@ body[data-ds-dark-theme]{--mcp-cat-dev:var(--dsw-static-deepseek-400);--mcp-cat-
 .dsh-mcp-seg-item{flex:none;white-space:nowrap;display:inline-flex;align-items:center;gap:5px;padding:3px 10px;border:0;border-radius:var(--mcp-r-md);background:transparent;color:var(--dsw-alias-label-secondary);font-size:12px;font-family:inherit;cursor:pointer;transition:background 120ms ease,color 120ms ease}
 .dsh-mcp-seg-item:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}
 .dsh-mcp-seg-item[aria-selected="true"]{background:var(--mcp-bg-1);color:var(--dsw-alias-label-primary);font-weight:600;box-shadow:0 1px 2px rgba(16,32,48,.08)}
-.dsh-mcp-seg-count{font-size:10px;padding:0 4px;border-radius:var(--mcp-r-xs);background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);line-height:14px;font-variant-numeric:tabular-nums}
+.dsh-mcp-seg-count{font-size:10px;padding:0 4px;border-radius:var(--mcp-r-xs);background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);line-height:14px;font-variant-numeric:tabular-nums;white-space:nowrap;flex:0 0 auto}
 .dsh-mcp-seg-item[aria-selected="true"] .dsh-mcp-seg-count{background:var(--mcp-accent);color:var(--dsw-alias-label-on-brand,#fff)}
 .dsh-mcp-seg-item:focus-visible{outline:2px solid var(--mcp-accent);outline-offset:-1px}
 @media (prefers-reduced-motion:reduce){.dsh-mcp-seg-item{transition:none}}
@@ -10513,6 +10653,13 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
   // 「缓存结果」：断网 / 上游变慢时保留上次内存结果并如实标注，而不是清空列表。
   const [communityStale, setCommunityStale] = useState(false);
   const [communityOnlyRunnable, setCommunityOnlyRunnable] = useState(true);
+  // 社区目录「全库总数」（连接器页徽标常驻显示的那个数）。口径与续爬策略见模块级
+  // COMMUNITY_COUNT_KEY 一节：上游不给总数，只能有界地一段一段数，进度存本地。
+  const [communityCount, setCommunityCount] = useState(readCommunityCount);
+  const communityCountRef = useRef(communityCount);
+  // 本次面板会话已花掉的统计页数（不是累计条数）：预算用尽就不再占网络，下次开面板接着来。
+  const communityCountPagesRef = useRef(0);
+  const communityCountBusyRef = useRef(false);
   // 社区条目的「加入 MCP」草稿：预填 AddEditModal，用户确认后才写盘。
   const [communityDraft, setCommunityDraft] = useState(null);
   // 社区卡片详情：点整卡打开，交互与插件 README 弹层一致（遮罩 / Esc 关闭、焦点陷阱）。
@@ -10792,9 +10939,12 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
   const communityCursorsRef = useRef([]);
   const communityReadKeysRef = useRef(new Set());
   const communityReadQueryRef = useRef(null);
+  // 后台统计要让路给列表请求：循环里读到的是最新值，所以每次渲染同步一次。
+  const communityLoadingRef = useRef(false);
   // 每次渲染同步最新值：loadCommunity 不把 rows/query/已装列表塞进依赖——
   // 否则 MCP 列表一刷新就重建回调，让防抖 / 懒加载 effect 误触发第二次请求。
   communityRowsRef.current = communityRows;
+  communityLoadingRef.current = communityLoading;
   communityQueryRef.current = communityQuery;
   communityNamesRef.current = mcpServerRows.map((row) => String(row?.serverName || '')).filter(Boolean);
 
@@ -10861,13 +11011,71 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
     loadCommunity({ cursor: '' });
   }, [connectorFeed, communityQuery, loadCommunity]);
 
+  // ── 社区目录全库总数：有界、可续爬的后台统计 ──
+  // 进连接器页 + 停在社区源时才开，而且先用 scheduleIdle 让列表请求走前面；然后一块一块数
+  // （每块 3 页），本次会话最多 12 页 —— 全库实测 ≥13,000 条，一次爬完要十几分钟和约 9MB，
+  // 不能占住用户的网络。每数完一块立刻落盘并更新徽标，所以用户看到的是数字在慢慢长准。
+  // 上游失败就保住已数到的部分直接收工（不重试、不清进度），下次进面板从记录的游标接着来。
+  useEffect(() => {
+    if (tab !== 'connector' || connectorFeed !== 'community') return undefined;
+    let cancelled = false;
+    let pauseTimer = null;
+    const runChunks = async () => {
+      if (cancelled || communityCountBusyRef.current) return; // 同一面板里只允许一条统计流水
+      communityCountBusyRef.current = true;
+      try {
+        while (!cancelled && communityCountPagesRef.current < COMMUNITY_COUNT_PAGE_BUDGET) {
+          const record = communityCountRef.current || emptyCommunityCount();
+          if (record.done) break;
+          const res = await call('wbMcpCommunityCount', {
+            cursor: record.cursor || '',
+            pages: Math.min(COMMUNITY_COUNT_CHUNK_PAGES, COMMUNITY_COUNT_PAGE_BUDGET - communityCountPagesRef.current),
+          });
+          if (cancelled) break; // 面板已切走 / 卸载：结果不要，进度也不回滚
+          if (!res || res.ok !== true) break;
+          const done = res.done === true;
+          const next = {
+            counted: record.counted + Math.max(0, Number(res.counted) || 0),
+            // 数到底就不留游标，避免下次又误以为"还有活要干"。
+            cursor: done ? '' : String(res.nextCursor || record.cursor || ''),
+            done,
+            at: Date.now(),
+          };
+          communityCountPagesRef.current += Math.max(1, Number(res.pages) || 1);
+          communityCountRef.current = next; // 不等 re-render：下一块必须用最新游标
+          setCommunityCount(next);
+          writeCommunityCount(next);
+          if (done) break;
+          // 列表请求在飞就多让一拍；没在飞也歇一下，别把公共 API 当自家目录连着打。
+          await new Promise((resolve) => {
+            pauseTimer = setTimeout(resolve, communityLoadingRef.current ? 1500 : 400);
+          });
+        }
+      } catch { /* 徽标那枚数字而已：任何异常都不该把社区列表带崩 */ }
+      finally { communityCountBusyRef.current = false; }
+    };
+    const cancelIdle = scheduleIdle(runChunks, 3000);
+    return () => { cancelled = true; if (pauseTimer) clearTimeout(pauseTimer); cancelIdle(); };
+  }, [tab, connectorFeed, call]);
+
   const communityVisibleRows = communityOnlyRunnable ? communityRows.filter((row) => row.runnable) : communityRows;
   const communityHiddenCount = communityRows.length - communityVisibleRows.length;
   // 上一页的游标来自游标栈（第 N-1 页的入口游标）；第 1 页没有上一页。
   const communityPrevCursor = communityPage > 1 ? (communityCursorsRef.current[communityPage - 2] || '') : null;
   // 「已加入」只按 serverName 命中现有 MCP 列表：社区条目没有 WorkBuddy 代注入，
   // 不存在「已安装 · 需授权」这种工作流。
-  const communityJoined = (row) => mcpServerRows.some((server) => String(server?.serverName || '') === row.serverName);
+  // 「已加入」比的是**原始名**，不是带冲突后缀的预填名（baseServerName，见 lib/mcp-community.js）。
+  // 用 serverName 比是死锁：装完 adeu 之后 taken 里就有 adeu，下一轮列表把这条预填成 adeu-2，
+  // adeu-2 永远不等于任何已装名 → 徽标与按钮禁用一起失效，用户以为没装、再点一次装出第二条。
+  const communityJoined = (row) => {
+    const base = String(row?.baseServerName || row?.serverName || '');
+    const prefill = String(row?.serverName || '');
+    if (!base) return false;
+    return mcpServerRows.some((server) => {
+      const installed = String(server?.serverName || '');
+      return installed === base || installed === prefill;
+    });
+  };
 
   // 「加入 MCP」= 预填草稿，用户在弹层里确认后才由宿主写盘（与连接器一键安装不同语义）。
   const openCommunityDraft = (row) => {
@@ -10886,19 +11094,26 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
   };
   const submitCommunityDraft = async (spec, setFormError) => {
     setBusy(true);
+    // 进度浮层：写盘 + 宿主自动连接这两段都在 RPC 之后才发生，弹层一关就没了现场。
+    // key 带动作前缀，重连同一台服务器不会顶掉这条「加入」行（也不是插件名，不参与按钮禁用）。
+    const taskKey = spec?.name ? 'mcp:add:' + String(spec.name) : '';
+    progressToastStart(taskKey, spec?.name, PROGRESS_GROUP_MCP, MCP_ADD_TASK_LABELS);
     try {
       const res = await call('add', spec);
       if (res && res.ok) {
         setCommunityDraft(null);
         setNote(t('已加入 ') + spec.name);
+        progressToastFinish(taskKey, 'ok');
         // 宿主写盘后列表刷新有一拍延迟：先立即刷一次，再补一次让「已加入」稳定亮起。
         loadMcpServerRows();
         communityDraftRefreshRef.current = setTimeout(() => { loadMcpServerRows(); }, 1200);
       } else {
         setFormError((res && res.error) || t('添加失败'));
+        progressToastFinish(taskKey, 'fail');
       }
     } catch (e) {
       setFormError(String(e?.message || e));
+      progressToastFinish(taskKey, 'fail');
     } finally {
       setBusy(false);
     }
@@ -10974,24 +11189,36 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
     const authRow = rows.find((row) => row.authRequired);
     if (authRow) { await beginConnectorAuth(item, authRow.serverName); return; }
     setBusy(true); setBusyLabel(t('正在重连…')); setError('');
+    // 与「加入 MCP」同一枚进度浮层（顶部、跨面板卸载存活）：重连是逐台串行的，
+    // 一台一行，用户切走再回来还能看到到底哪台在跑、哪台没成。
+    const serverNames = Array.isArray(item.serverNames) ? item.serverNames : [];
+    const taskKeys = new Map();
+    for (const name of serverNames) {
+      const key = 'mcp:reconnect:' + String(name);
+      taskKeys.set(String(name), key);
+      progressToastStart(key, String(name), PROGRESS_GROUP_MCP, MCP_RECONNECT_TASK_LABELS);
+    }
     try {
       let lastNote = '';
       const failed = [];
-      for (const name of (Array.isArray(item.serverNames) ? item.serverNames : [])) {
+      for (const name of serverNames) {
         const res = await call('reconnect', String(name));
         // call() 把宿主失败收敛成 {ok:false, error}，这里必须看 ok，否则一条都没连上也会
         // 显示「已请求重连」。
         if (res && res.ok === false) {
           failed.push(name + ': ' + (res.error || t('调用失败')));
+          progressToastFinish(taskKeys.get(String(name)), 'fail');
           continue;
         }
         lastNote = res?.note || lastNote;
+        progressToastFinish(taskKeys.get(String(name)), 'ok');
       }
       if (failed.length) setError(t('{0}：{1}', [item.name, failed.join('; ')]));
       else setNote(t('{0}：{1}', [item.name, lastNote || t('已请求重连')]));
       await loadMcpServerRows();
     } catch (e) {
       setError(String(e?.message || e));
+      for (const key of taskKeys.values()) progressToastFinish(key, 'fail');
     } finally {
       setBusy(false); setBusyLabel('');
     }
@@ -11770,7 +11997,12 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
               onClick: () => setConnectorFeed('wb'),
             },
               t('WorkBuddy 连接器'),
-              connectors.length ? h('span', { className: 'dsh-mcp-seg-count' }, connectors.length) : null,
+              // 徽标常驻：数字一隐藏就会被读成"这一页就是全部"。连接器是一次返回全量，
+              // 所以这个数就是总数；没取到之前显示「…」而不是空着。
+              h('span', {
+                className: 'dsh-mcp-seg-count',
+                title: connectors.length ? t('WorkBuddy 官方目录里的连接器总数') : t('正在读取连接器列表…'),
+              }, connectors.length || '…'),
             ),
             h('button', {
               type: 'button', role: 'tab', 'aria-selected': connectorFeed === 'community', className: 'dsh-mcp-seg-item',
@@ -11778,7 +12010,10 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
               onClick: () => setConnectorFeed('community'),
             },
               t('社区 MCP'),
-              communityReadTotal ? h('span', { className: 'dsh-mcp-seg-count' }, communityReadTotal) : null,
+              // 这里显示的是**全库总数**（数到底）或**下界**（还在续爬，形如 1200+），
+              // 不再是「已读取 98 条」——那个数会被读成"社区一共只有 98 个"（2026-10-30 用户
+              // 反馈）。查询内的已读累计仍在下面那行工具条里，两个数各有各的口径。
+              h('span', { className: 'dsh-mcp-seg-count', title: communityCountBadgeTitle(communityCount) }, communityCountBadgeText(communityCount)),
             ),
           ),
         )
@@ -11803,7 +12038,7 @@ const WorkBuddyMarket = ({ call, pluginManager }) => {
             h('input', { type: 'checkbox', checked: communityOnlyRunnable, onChange: (e) => setCommunityOnlyRunnable(e.target.checked) }),
             t('只看可直接运行（npx / uvx）'),
           ),
-          h('span', { className: 'dsh-mcp-builtin-count' },
+          h('span', { className: 'dsh-mcp-builtin-count', title: t('本次查询已逐页读取的条数；上方徽标显示的是社区目录全库总数') },
             t('已读取 {0} 条', [communityReadTotal]) + (communityStale ? t(' · 缓存结果') : '')),
           communityOnlyRunnable && communityHiddenCount > 0
             ? h('span', { className: 'dsh-mcp-builtin-count', title: t('这些条目只有远程地址，需要自备令牌') },
@@ -14000,6 +14235,9 @@ const MCP_CONTRIBUTION = {
     // 社区 MCP（官方 MCP Registry v0，只读）：连接器页第二个来源。payload {search, cursor,
     // limit, takenNames}，返回 {ok, rows, nextCursor, fetchedAt, cached}。三处同步，漏一处恒 404。
     { id: 'dsh-armory#mcpManager/wbMcpCommunityList', service: 'mcpManager', namespace: 'mcpManager', method: 'wbMcpCommunityList', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('WbMcpCommunityResult') },
+    // 社区目录全库总数的有界统计（面板徽标常驻显示用）。payload {cursor, pages}，
+    // 返回 {ok, counted, nextCursor, done, pages}。漏这一行 = 面板调它恒 404。
+    { id: 'dsh-armory#mcpManager/wbMcpCommunityCount', service: 'mcpManager', namespace: 'mcpManager', method: 'wbMcpCommunityCount', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('WbMcpCommunityCountResult') },
     // 社区元信息（仓库维护信号）：payload {repos, refresh}，返回 {repos:{repo:{...}}}。
     { id: 'dsh-armory#mcpManager/wbRepoMeta', service: 'mcpManager', namespace: 'mcpManager', method: 'wbRepoMeta', invocation: { kind: 'direct' }, parameters: [mcpParam('payload', 'ImportPayload')], result: mcpCodec('WbRepoMetaResult') },
     // npm 近 30 天下载量：payload {packages, refresh}，返回 {packages:{pkg:{ok,downloads,...}}}。

package/lib/index.js

@@ -8,6 +8,7 @@ import { withFileLock, writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { basename, dirname, isAbsolute, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { normalizeMcpImport, readManagedMcpServers, setManagedMcpDisabled, updateManagedMcpPatch } from "./mcp-config.js";
+import { describeLaunchRewrite } from "./win32-stdio.js";
 import { admitImportedServers } from "./import-admission.js";
 import { collectImportLocations, missingEnvNames, resolveImportLocation } from "./mcp-import-sources.js";
 import { deriveMcpPhase, formatMcpLog, sanitizeMcpLog } from "./mcp-observability.js";
@@ -29,7 +30,7 @@ import { readRegistry, upsertMarketplace } from "./wb-registry.js";
 // T06/Awesome：DSH 社区插件市场（awesome-dsh-plugins）的宿主侧数据层。
 import { wbAwesomeCatalog, wbAwesomeDetail, wbAwesomeReadme, wbAwesomeUpdateCheck } from "./wb-awesome-market.js";
 // 社区 MCP：官方 MCP Registry（registry.modelcontextprotocol.io）只读取数，数据层在 lib/mcp-community.js。
-import { wbMcpCommunityList } from "./mcp-community.js";
+import { wbMcpCommunityList, wbMcpCommunityCount } from "./mcp-community.js";
 // 社区元信息（维护者 / 最近提交 / issue / star）：打开详情时按需查，6 小时缓存。
 import { wbRepoMeta } from "./community-meta.js";
 // npm 近 30 天下载量：插件卡片底栏的「↓N」，目录里没有这个字段，只能去 npm 统计接口取。
@@ -1515,7 +1516,7 @@ let McpManagerGateway = (() => {
 				const state = await managedState(this.ctx);
 				if (hasExternalMcpName(this.ctx, state, normalized.name) || state.byName.has(normalized.name)) throw new Error("MCP already exists: " + normalized.name);
 				await writePatch(state, updateManagedMcpPatch(state.content, [normalized], { replace: false, reservedIds: reservedEntryIds(this.ctx) }));
-				return { note: "已添加到 profile patch，正在热加载" };
+				return { note: "已添加到 profile patch，正在热加载" + describeLaunchRewrite(spec?.command, normalized.command) };
 			});
 		}
 		async update(spec) {
@@ -1527,7 +1528,7 @@ let McpManagerGateway = (() => {
 				const normalized = normalizeOne(restoreRedactedSpec(spec, current));
 				if (!Object.hasOwn(normalized, "disabled") && current.disabled) normalized.disabled = true;
 				await writePatch(state, updateManagedMcpPatch(state.content, [normalized], { replace: false, reservedIds: reservedEntryIds(this.ctx, new Set([state.entryIds.get(normalized.name)].filter(Boolean))) }));
-				return { note: "已更新 profile patch，正在热加载" };
+				return { note: "已更新 profile patch，正在热加载" + describeLaunchRewrite(spec?.command, normalized.command) };
 			});
 		}
 		async removeServer(name) {
@@ -2306,6 +2307,12 @@ let McpManagerGateway = (() => {
 	async wbMcpCommunityList(payload) {
 		return wbMcpCommunityList(payload || {});
 	}
+	// 社区目录全库总数的有界统计：payload {cursor, pages}，返回 {ok, counted, nextCursor, done, pages}。
+	// 官方 Registry 不给总数，只能顺游标数，所以这里一次最多 12 页；进度由面板侧存 localStorage、
+	// 跨会话续爬。同样只 GET：不写盘、不执行命令、不落凭据、不进任何缓存。
+	async wbMcpCommunityCount(payload) {
+		return wbMcpCommunityCount(payload || {});
+	}
 	// ── 社区元信息：仓库「人味」信号（维护者 / 最近提交 / issue / star）────────
 	// 详情弹层按需调用，只读公开接口，6 小时缓存；不接收也不保存任何凭据。
 	async wbRepoMeta(payload) {

package/lib/mcp-community.js

@@ -8,6 +8,9 @@
 // 为什么不做全量快照：实测 60 页 × 100 = 6000 条仍未翻完、逐页约 2.4s。社区列表按
 // 「首屏 + 搜索 + 游标翻页」按需取，与 SkillHub 的远程分页同构；数据层只负责一次
 // 游标请求的映射，累计条数上限由面板侧控制。
+// 2026-10-30 复测：全库至少 13,000 条（130 页 × 100 仍未到底，本机串行 2.4–8s/页、
+// 约 9MB），所以「一次爬完做快照」依然不成立；总数只能由 `wbMcpCommunityCount`
+// 做**有界、可续爬**的分片统计（见该函数注释）。
 //
 // 安全底线：只 GET；不探测 npm 包、不跑 npx/uvx；env 的 default 原样展示、绝不落盘。
 
@@ -177,6 +180,10 @@ export function mapRegistryServer(entry, options = {}) {
     runnable,
     transport: runnable ? 'stdio' : 'http',
     serverName: sanitizeServerName(name, takenNames),
+    // 冲突后缀之前的原名，专门给「已加入」判定用。serverName 带后缀（-2、-3）是「预填什么名字」，
+    // 而「这条是不是已经装了」比较的是原始名：装完 adeu 之后 taken 里就有 adeu，下一次列表里
+    // serverName 会变成 adeu-2，拿它去比已装名永远不相等——「已加入」因此永远点不亮。
+    baseServerName: sanitizeServerName(name, []),
     command: runnable ? command : '',
     args: runnable ? args : [],
     env,
@@ -351,3 +358,82 @@ export async function wbMcpCommunityList(payload = {}, options = {}) {
   writeCache(key, value);
   return { ok: true, rows, nextCursor, fetchedAt: value.fetchedAt, cached: false };
 }
+
+/** 单次统计请求最多翻几页（3 页 = 300 条）。面板侧还会再套一层会话预算。 */
+export const COMMUNITY_COUNT_CHUNK_PAGES = 3;
+/** 一次统计调用允许的页数上限（12 页 = 1200 条）：防止 payload 被塞一个巨大值把上游打穿。 */
+export const COMMUNITY_COUNT_MAX_PAGES = 12;
+
+/** 页数钳制：非法 / < 1 → 默认 3 页，> 上限 → 上限。 */
+function clampCountPages(value) {
+  const number = Number(value);
+  if (!Number.isFinite(number) || number < 1) return COMMUNITY_COUNT_CHUNK_PAGES;
+  return Math.min(COMMUNITY_COUNT_MAX_PAGES, Math.floor(number));
+}
+
+/**
+ * 社区目录「全库总数」的**有界**统计：从给定游标起顺着翻页，最多翻 `pages` 页，
+ * 返回这一段数到的条目数与下一步该从哪儿接着数。
+ *
+ * 为什么要有这个函数：官方 Registry 不返回总数（实测 `metadata.count` 就是本页条数、
+ * `/v0/servers/count` 与 `/v0/registry/stats` 均 404、`limit>100` 直接 422），而面板
+ * 徽标只显示「已读取 98 条」会被用户读成"社区一共只有 98 个"（2026-10-30 用户反馈）。
+ * 唯一的真数只能靠顺游标爬，所以做成**可续爬的分片统计**：每次只花几页的预算，
+ * 进度由面板侧持久化，跨会话继续，爬到尽头就给精确值、没到尽头就给下界（`N+`）。
+ *
+ * 口径与列表严格一致：走同一个 `buildRegistryUrl`（含 `version=latest`）与同一个
+ * `mapRegistryServer`（非 active / 既跑不起来又没合法远程地址 / oci 包都会被丢弃），
+ * 所以这个数就是"用户翻页能翻到的条目数"，不是上游数据库行数。
+ *
+ * 刻意**不写内存缓存**：一次全库要 130+ 页，塞进 50 条上限的翻页缓存会把用户真正
+ * 在看的那几页挤掉，反而拖慢列表。
+ *
+ * 跨块不去重（游标链本身互斥，上游若真返回重叠页，最坏是把下界算高一点点）；
+ * 单块内按 `key` 去重，与面板侧「已读取」累计口径同源。
+ *
+ * 与 `wbMcpCommunityList` 同纪律：永不抛错，失败收敛成 `{ok:false, error}`，
+ * 并把已经数到的部分如实带回去（中断不该把前面的工作清零）。
+ *
+ * @param {{cursor?: string, pages?: number}} payload
+ * @param {{fetchImpl?: Function, timeoutMs?: number}} options
+ * @returns {Promise<{ok:true, counted:number, nextCursor:string|null, done:boolean, pages:number}
+ *                   | {ok:false, error:string, counted:number, nextCursor:string|null, done:false, pages:number}>}
+ */
+export async function wbMcpCommunityCount(payload = {}, options = {}) {
+  const input = payload && typeof payload === 'object' ? payload : {};
+  const budget = clampCountPages(input.pages);
+  let cursor = asString(input.cursor).trim();
+  let counted = 0;
+  let walked = 0;
+  const seen = new Set();
+  for (let round = 0; round < budget; round += 1) {
+    let raw;
+    try {
+      raw = await fetchJson(buildRegistryUrl({ cursor, limit: COMMUNITY_PAGE_LIMIT }), options);
+    } catch (cause) {
+      return {
+        ok: false,
+        error: String(cause?.message || cause),
+        counted,
+        nextCursor: cursor || null,
+        done: false,
+        pages: walked,
+      };
+    }
+    const { servers, nextCursor } = normalizeRegistryResponse(raw);
+    walked += 1;
+    for (const entry of servers) {
+      const row = mapRegistryServer(entry, {});
+      if (!row || !row.key || seen.has(row.key)) continue;
+      seen.add(row.key);
+      counted += 1;
+    }
+    // 两种「到底」都要认：没游标了，或上游给了游标但这一页是空的——只认前一种的话，
+    // 遇到「空页 + 残留游标」的实现会在续爬时原地打转。
+    if (!servers.length || !nextCursor) {
+      return { ok: true, counted, nextCursor: null, done: true, pages: walked };
+    }
+    cursor = nextCursor;
+  }
+  return { ok: true, counted, nextCursor: cursor || null, done: false, pages: walked };
+}

package/lib/mcp-config.js

@@ -1,5 +1,6 @@
 import { parseDocument, Scalar, YAMLMap, YAMLSeq, isMap, isSeq } from 'yaml'
 import { isSafeExpression, makeEnvExpression, makeExpression } from './env-expression.js'
+import { isCmdShellCommand, planStdioLaunch, win32LaunchContext } from './win32-stdio.js'
 
 export const MCP_PLUGIN_NAME = '@deepseek-ai/dsh-mcp-client'
 const JS_TAG = 'tag:yaml.org,2002:js'
@@ -183,6 +184,20 @@ function normalizeEntry(name, input, warnings) {
       if (typeof raw.cwd !== 'string') throw new Error(`${serverName}.cwd 必须是字符串`)
       if (raw.cwd) result.cwd = expressionValue(raw.cwd)
     }
+    // win32 上裸 npx / npm 是 .cmd 壳，宿主 `spawn(command, args, {shell:false})` 直接 ENOENT，
+    // 子进程起不来 → 面板只剩「SdkError: Connection closed」。写入前归一成绝对 node.exe + 入口 JS；
+    // 非 win32、绝对路径、${VAR} / !!js 表达式一律原样放行（判据与实测见 lib/win32-stdio.js）。
+    const launchContext = win32LaunchContext()
+    const launch = planStdioLaunch(result, launchContext)
+    if (launch.rewritten) {
+      warnings.push(`${serverName}：Windows 上裸 ${result.command} 无法 spawn，已改用本机 Node 启动器`)
+      result.command = launch.spec.command
+      result.args = launch.spec.args
+      if (launch.spec.env !== undefined) result.env = launch.spec.env
+    } else if (launchContext.probeError && isCmdShellCommand(result.command)) {
+      // 探测层异常时如实说明「本该归一但没归」，别让条目带着裸 npx 落盘后只剩一句连接失败。
+      warnings.push(`${serverName}：本机 Node 启动器探测失败（${launchContext.probeError}），命令已按原样写入，Windows 上可能无法启动`)
+    }
   } else {
     const normalizedUrl = hasUrl ? expressionValue(url.trim()) : ''
     if (!hasUrl) throw new Error(`${serverName} 的 HTTP 配置需要 http(s):// URL`)

package/lib/typert.js

@@ -122,6 +122,9 @@ export const TYPERT = {
     // 社区 MCP：官方 MCP Registry v0 只读列表（数据层 lib/mcp-community.js）。
     // 与上面 wb* 系列同一宽容度：payload 形状由数据层校验，契约层 $any。
     mv('wbMcpCommunityList', [payloadParam], 'WbMcpCommunityResult'),
+    // 社区目录全库总数（有界、可续爬的分片统计）：Registry 不返回总数，面板徽标要常驻
+    // 显示"到底有多少条"只能顺游标数。payload $any（{cursor, pages}），结果 {counted, nextCursor, done}。
+    mv('wbMcpCommunityCount', [payloadParam], 'WbMcpCommunityCountResult'),
     mv('wbAwesomeDetail', [payloadParam], 'AwesomeDetailResult'),
     // README 预览：点击卡片按需取一次（npm registry / GitHub raw），落盘缓存 7 天。
     mv('wbAwesomeReadme', [payloadParam], 'AwesomeReadmeResult'),

package/lib/whats-new-en.js

@@ -502,6 +502,24 @@ export const WHATS_NEW_EN = {
       where: 'Market / Security',
     },
   ],
+  '2.4.5': [
+    {
+      text: '**The Community MCP badge now shows the size of the whole catalog, and stays on screen**: it used to show how many rows this query had read, which reads as "this is all there is". The official Registry returns no total, so the panel counts the catalog page by page in the background (up to 12 pages per session, progress kept locally so the next visit resumes): an exact number once the crawl finishes, a "N+" lower bound while it is still running, and "..." before counting starts — the badge never disappears again. The tooltip says which of the two you are looking at, and the toolbar keeps showing the rows read by the current query',
+      where: 'Market -> Connectors -> Community MCP',
+    },
+    {
+      text: '**MCP servers added from the market or the community now start on Windows**: the host spawns stdio servers without a shell, but `npx` / `npm` on Windows are `.cmd` wrappers, so a bare spawn dies with `ENOENT` in milliseconds and the panel is left with "Connection closed" until the reconnect budget runs out. The single write boundary now rewrites a bare `npx` / `npm` into the absolute `node.exe` on this machine plus the CLI entry script, and injects a writable npm cache directory (an existing `npm_config_cache` setting is never overwritten, in any casing). Non-Windows, absolute paths, `uvx`, `${VAR}` and `!!js` are passed through untouched, saving twice is idempotent, and every rewrite is reported in the install notice. Know the trade-off: the rewritten command is specific to this machine, so moving the config to another machine means adding the connector again',
+      where: 'Market -> Connectors -> Add MCP',
+    },
+    {
+      text: '**Community cards now mark what you already added**: the list name carries a collision suffix (installing a second entry with the same id shows up as `xxx-2`), so comparing it against the installed command never matched — the badge stayed dark, the button stayed enabled, and clicking again silently created a duplicate. The comparison now uses the name with the suffix removed',
+      where: 'Market -> Connectors -> Community MCP',
+    },
+    {
+      text: '**Lightweight feedback when installing or reconnecting, and the dark-blue notice is finally readable**: adding or reconnecting a community MCP opens a small loading toast, and progress and result now travel through the same path. The old notice paired dark text with a deep blue background at a measured 1.49:1 contrast (WCAG AA asks 4.5:1 for body text); it is now 11.6:1 on light and 16.1:1 on dark, with both palettes carried by the overlay itself instead of drifting with the host background',
+      where: 'Market -> Connectors / Skills',
+    },
+  ],
 };
 
 /**

package/lib/whats-new.js

@@ -579,4 +579,25 @@ export const WHATS_NEW = [
       },
     ],
   },
+  {
+    version: '2.4.5',
+    items: [
+      {
+        text: '**社区 MCP 角标改成「全库总数」并常驻**：角标原本显示本次已读取的条数，很容易被读成「社区目录一共只有这么多」。官方 Registry 不返回总数，插件改为在后台逐页统计全库条目（每次会话最多 12 页，进度记在本机、下次打开接着数）：数到底显示精确值，没到底显示「N+」下界，还没开始数显示「…」，角标不再随列表消失；悬浮说明写清当前是精确值还是下界，工具条继续显示本次查询的「已读取 N 条」',
+        where: '市场 → 连接器 → 社区 MCP',
+      },
+      {
+        text: '**Windows 上从市场 / 社区加入的 MCP 不再必然连不上**：宿主起 stdio 服务时不走 shell，而 `npx` / `npm` 在 Windows 上是 `.cmd` 壳——直接 spawn 必然 `ENOENT` 秒退，面板只剩「连接已关闭」，重连次数耗尽后永久失败。写入配置的唯一边界现在把裸 `npx` / `npm` 归成本机绝对路径的 `node.exe` + 入口 JS，并注入一个可写的 npm 缓存目录（你配过 `npm_config_cache` 就不动，任意大小写都认）；非 Windows、已是绝对路径、`uvx`、`${VAR}`、`!!js` 原样放行，重复保存幂等，改写内容会如实写进安装提示。副作用要清楚：归一后的命令是本机专属路径，换机导入需重新「加入 MCP」',
+        where: '市场 → 连接器 → 加入 MCP',
+      },
+      {
+        text: '**社区条目的「已加入」会亮了**：列表名带着防撞名的后缀（同名再装会显示成 `xxx-2`），拿它比已装命令名永远不相等——徽标不亮、按钮不禁用、再点一次装出第二条。现在按去掉后缀的原始名比较',
+        where: '市场 → 连接器 → 社区 MCP',
+      },
+      {
+        text: '**安装与重连有轻提示，深蓝提示窗文字改到能读**：加入 / 重连社区 MCP 时弹出小 loading 浮层，进度与结果走同一条链；原先深蓝底配深色文字实测对比度只有 1.49:1（WCAG AA 要求正文 4.5:1），现在浅底 11.6:1、深底 16.1:1，深浅两套由浮层自带配色决定，不再随宿主背景漂移',
+        where: '市场 → 连接器 / 技能',
+      },
+    ],
+  },
 ]

package/lib/win32-stdio.js

@@ -0,0 +1,194 @@
+/**
+ * Windows 下 stdio MCP 的「可执行化」——把裸 `npx` 换成真正能 spawn 的形式。
+ *
+ * 为什么需要这一层（2026-10-30 本机实测，不是推测）：
+ *   宿主 `@deepseek-ai/dsh-mcp-client` 用 `child_process.spawn(command, args, { shell: false })`
+ *   拉起 stdio 子进程。win32 上 Node 不做 PATHEXT 解析，而 npm 的 `npx` 实际是 `npx.cmd`
+ *   （批处理壳，必须经 cmd.exe 才有解释器）：
+ *     - spawn('npx', …, {shell:false})   → ENOENT，实测 6ms 内子进程根本没起来
+ *     - spawn('npx.cmd', …, {shell:false}) → EINVAL（Node ≥ 24 明确拒绝直接 spawn .cmd）
+ *   子进程起不来 → stdin/stdout 管道立刻关闭 → SDK 侧只剩一句
+ *   `SdkError: Connection closed`，再按 `reconnect.maxAttempts: 10` 重试到耗尽，面板永久「连接失败」。
+ *   官方 MCP Registry 的 npm 条目给出的命令恰恰就是裸 `npx`，所以 Windows 上「社区 MCP 选哪一条都连不上」
+ *   与条目本身无关，是命令形态问题。同机唯一两条能连上的（mcp-windows / mcp-rea）都是绝对 `.exe`——
+ *   CreateProcess 对无扩展名的命令只补 `.exe`，所以裸 `node` / `python` 反而没事，出事的是 `.cmd` 壳。
+ *
+ * 这一层只改**命令形态**，不改语义：`npx -y pkg` → `node.exe npx-cli.js -y pkg`，
+ * 参数顺序、包名、附加参数一律原样保留；非 win32、绝对路径、`${VAR}` / `!!js` 表达式全部放行不改。
+ * 改写是幂等的：改写后的绝对 node.exe 再进这里不会被二次包装，读回配置也不会漂移。
+ *
+ * 顺带处理第二层拦路石（同样实测）：本机全局 npm 缓存目录不可写时，`npx -y <pkg>` 会在
+ * 下载阶段 `EPERM` 失败——spawn 已经成功，但包拿不下来。所以为改写过的条目注入一个
+ * 属于军械库的可写缓存目录；用户自己配过缓存键时绝不覆盖。
+ *
+ * 边界：`uvx` / `uv` 在 Windows 上是真 `.exe`（astral 直接发二进制），不属于 `.cmd` 壳问题，
+ * 本机又未安装 uv，无法实测 → 本层不动它，避免把没验证过的路径写成规则。
+ */
+import { existsSync, mkdirSync, statSync } from 'node:fs';
+import { win32 as winpath } from 'node:path';
+import { homedir } from 'node:os';
+
+/** 会被 npm 装成 `.cmd` 壳、因而 spawn 不了的命令名。 */
+const CMD_SHELL_COMMANDS = new Set(['npx', 'npm']);
+/** `.cmd` 壳 → 同目录 npm 包里的真正入口 JS。 */
+const LAUNCHER_ENTRY = { npx: 'npx-cli.js', npm: 'npm-cli.js' };
+/** 交给宿主求值的表达式命令：形态不是我们能静态决定的，禁止改写。 */
+const EXPRESSION_RE = /^\s*(?:!!js\b|\$\{)/;
+/** 绝对路径 / UNC / 带引号的路径：本来就可 spawn。 */
+const ABSOLUTE_RE = /^\s*"?\s*(?:[A-Za-z]:[\\/]|\\\\|\/)/;
+
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+
+/** 取命令尾段并小写：`C:\a\b\npx.cmd` 与 `npx` 都归到 `npx`。 */
+export function commandBase(command) {
+  if (typeof command !== 'string') return '';
+  const text = command.trim().replace(/^"|"$/g, '');
+  const segments = text.split(/[\\/]/).filter(Boolean);
+  const tail = (segments.length ? segments[segments.length - 1] : text).toLowerCase();
+  return tail.replace(/\.exe$/, '').replace(/\.cmd$/, '');
+}
+
+/** 这条命令是不是 npm 装出来的 `.cmd` 壳（探测失败时要不要提醒，就按这个判）。 */
+export function isCmdShellCommand(command) {
+  return CMD_SHELL_COMMANDS.has(commandBase(command));
+}
+
+/**
+ * 纯函数：按注入的上下文决定这条 stdio spec 该怎么写。
+ * 不做任何 fs / process 访问，便于零成本单测与跨平台运行。
+ *
+ * @param {{command:string,args?:string[],env?:object}} spec 已归一化的 stdio spec（就地不改，返回新对象）
+ * @param {{applicable?:boolean,node?:{exe:string,npxCli:string}|null,cacheDir?:string|null}} context
+ * @returns {{spec:object, rewritten:boolean, reason:string}}
+ *   reason: 'not-win32' | 'not-stdio-command' | 'expression' | 'already-normalized'
+ *         | 'already-absolute' | 'unsupported-command' | 'node-not-found' | 'rewritten'
+ */
+export function planStdioLaunch(spec, context = {}) {
+  if (!isObject(spec) || typeof spec.command !== 'string' || !spec.command.trim()) {
+    return { spec, rewritten: false, reason: 'not-stdio-command' };
+  }
+  if (context.applicable !== true) return { spec, rewritten: false, reason: 'not-win32' };
+  // 表达式（`${NODE_BIN}`、`!!js …`）由宿主在挂载时求值，形态我们无法静态判定 → 放行。
+  if (EXPRESSION_RE.test(spec.command)) return { spec, rewritten: false, reason: 'expression' };
+  const inArgs = Array.isArray(spec.args) ? spec.args : [];
+  // 幂等护栏：已经是「node.exe + …/npx-cli.js」或「裸 node + …/npx-cli.js」形态的，不再包第二层
+  // （读回配置、反复保存、项目 MCP 重挂都会重新走一遍这里）。
+  if ((commandBase(spec.command) === 'node' || ABSOLUTE_RE.test(spec.command))
+    && inArgs.some((arg) => typeof arg === 'string' && /(?:npx|npm)-cli\.js$/i.test(arg))) {
+    return { spec, rewritten: false, reason: 'already-normalized' };
+  }
+  const base = commandBase(spec.command);
+  if (!CMD_SHELL_COMMANDS.has(base)) {
+    // 绝对路径本来就是我们要的样子；其余（node / python / 自定义 exe）走 CreateProcess 的 .exe 补齐。
+    if (ABSOLUTE_RE.test(spec.command)) return { spec, rewritten: false, reason: 'already-absolute' };
+    return { spec, rewritten: false, reason: 'unsupported-command' };
+  }
+  const node = isObject(context.node) ? context.node : null;
+  const entry = LAUNCHER_ENTRY[base];
+  if (!node || !node.exe || (entry === 'npx-cli.js' && !node.npxCli)) {
+    // 找不到本机 Node：宁可不改。改写成一个不存在的路径会把「连不上」换成更难的「找不到文件」。
+    return { spec, rewritten: false, reason: 'node-not-found' };
+  }
+  // 入口 JS 必须是探测到的真实路径；缺了就当找不到，绝不拼一个没验证过的路径出去写盘。
+  const cli = entry === 'npx-cli.js' ? node.npxCli : node.npmCli;
+  if (!cli) return { spec, rewritten: false, reason: 'node-not-found' };
+  const args = inArgs.filter((item) => typeof item === 'string');
+  const next = { ...spec, command: node.exe, args: [cli, ...args] };
+  if (context.cacheDir) {
+    const env = isObject(spec.env) ? { ...spec.env } : {};
+    // 用户显式配过缓存（任意大小写）时以用户为准，不覆盖。
+    const hasCacheKey = Object.keys(env).some((key) => key.toLowerCase() === 'npm_config_cache');
+    if (!hasCacheKey) env.npm_config_cache = context.cacheDir;
+    if (Object.keys(env).length) next.env = env;
+  }
+  return { spec: next, rewritten: true, reason: 'rewritten' };
+}
+
+/**
+ * 探测本机 Node 启动器。所有输入均可注入，便于在任意平台上跑同一份逻辑。
+ * 只在 win32 返回 applicable:true；其余平台一律 applicable:false（本层完全不介入）。
+ */
+export function detectWin32LaunchContext({
+  platform = process.platform,
+  env = process.env,
+  home = homedir(),
+  exists = existsSync,
+  isFile = (value) => {
+    try {
+      return statSync(value).isFile();
+    } catch {
+      return false;
+    }
+  },
+  mkDir = mkdirSync,
+} = {}) {
+  if (platform !== 'win32') return { applicable: false, platform, node: null, cacheDir: null };
+  const rawPath = env.PATH || env.Path || env.path || '';
+  const dirs = rawPath.split(';').map((dir) => dir.trim()).filter(Boolean);
+  let fallback = null;
+  for (const dir of dirs) {
+    const exe = winpath.join(dir, 'node.exe');
+    if (!isFile(exe)) continue;
+    const npmBin = winpath.join(dir, 'node_modules', 'npm', 'bin');
+    const npxCli = winpath.join(npmBin, 'npx-cli.js');
+    const npmCli = winpath.join(npmBin, 'npm-cli.js');
+    if (isFile(npxCli) && isFile(npmCli)) {
+      // 同目录成对命中：这是官方安装包的标准布局，优先采用。
+      return { applicable: true, platform, node: { exe, npxCli, npmCli }, cacheDir: armoryNpmCacheDir(home, mkDir) };
+    }
+    if (!fallback) fallback = { exe, npxCli: isFile(npxCli) ? npxCli : '', npmCli: isFile(npmCli) ? npmCli : '' };
+  }
+  return { applicable: true, platform, node: fallback, cacheDir: armoryNpmCacheDir(home, mkDir) };
+}
+
+/** 军械库专用 npm 缓存目录；建不出来就返回 null（不注入，保持原样而不是指向一个坏路径）。 */
+function armoryNpmCacheDir(home, mkDir) {
+  if (typeof home !== 'string' || !home) return null;
+  const dir = winpath.join(home, '.dsh', 'armory', 'mcp-npm-cache');
+  try {
+    mkDir(dir, { recursive: true });
+  } catch {
+    return null;
+  }
+  return dir;
+}
+
+let cachedContext;
+
+/**
+ * 进程内缓存的启动器上下文（首次用到才探测；探测失败不重试到写盘热路径上）。
+ *
+ * 这里的 try/catch 是**窄闸门**，不是兜底吞异常：本函数站在「加入 MCP」的唯一写入路径上，
+ * 探测层任何未预见的异常都不该让用户的添加动作整体失败。降级方向是回到修复前的行为
+ * （不改写、原样写入），并把降级原因如实带在 `probeError` 上交给调用方上报，
+ * 而不是静默成「这条不需要归一」。
+ */
+export function win32LaunchContext(force = false, detect = detectWin32LaunchContext) {
+  if (cachedContext === undefined || force === true) {
+    try {
+      cachedContext = detect();
+    } catch (error) {
+      cachedContext = { applicable: false, platform: process.platform, node: null, cacheDir: null, probeError: String(error?.message || error) };
+    }
+  }
+  return cachedContext;
+}
+
+/** 测试与热修入口：注入假上下文 / 清空缓存。 */
+export function setWin32LaunchContext(value) {
+  cachedContext = value;
+}
+
+export function resetWin32LaunchContext() {
+  cachedContext = undefined;
+}
+
+/**
+ * 给用户看的改写完说明：只比较「进」与「出」的命令，不往 spec 上挂任何多余字段
+ * （多余字段会被 workspace 配置序列化进 .dsh/mcp.json，污染用户文件）。
+ */
+export function describeLaunchRewrite(originalCommand, finalCommand) {
+  if (typeof originalCommand !== 'string' || typeof finalCommand !== 'string') return '';
+  if (originalCommand.trim() === finalCommand.trim()) return '';
+  return `；Windows 启动器已改用本机 Node（${finalCommand}），裸 ${originalCommand.trim()} 在 win32 无法 spawn`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-armory",
-  "version": "2.4.4",
+  "version": "2.4.5",
   "description": "Unified Skill + MCP + Expert + Plugin board for DeepSeek Harness (desktop app and Web GUI) — custom skill suites, skill install/uninstall with live refresh, global panel page, JSON import, WorkBuddy connector & SkillHub & Expert & DSH community plugin market installs, MCP OAuth authorization, tool-usage tailor with wire-tax trends, and profile-backed Host Remote management.",
   "repository": {
     "type": "git",