dsh-vscode-mode 0.11.0 → 0.13.0

package/src/integrate.ts

@@ -4,17 +4,19 @@
  *   ~/.dsh/dsh-vscode-mode/shell/，HKCU\Software\Classes 三类菜单键（`*`/Directory/Directory\Background）。
  * - Linux：dsh-open.sh + GNOME Files（Nautilus）右键脚本 + KDE Dolphin 服务菜单（纯文件写入）。
  * - macOS：dsh-open.sh（Finder 快速操作由用户按配方手动创建，自动检测/移除）。
- * 生命周期：注册成功写 marker（shell/registered.json）→ 插件卸载/reload 清理注册痕迹，
- * 启动时 marker 存在则自动恢复（更新插件不丢注册）；用户显式「移除注册」删 marker 永不自动恢复。
+ * 生命周期：注册成功写 marker；启动按 marker 升级 launcher 文件，不反复重写系统注册。
+ * 用户显式「移除注册」删 marker，后续启动不会恢复。
  * 所有 reg/csc 调用经 subprocess 服务 argv 数组（卸载清理用 child_process 直调，teardown 可靠）。
  * 纯函数（键路径/命令行/ini/脚本内容）可单测。
  * 作者 ddj 2026-09-07
  */
-import { spawn } from 'node:child_process'
+import { childEnv } from './childEnv.js'
 import { chmod, copyFile, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { assetsDirOf, dshHome, PLUGIN_ID } from './paths.js'
+import { findProfileDir } from './devForm.js'
+import { openIni, writeOpenConfig } from './openBridge.js'
 import { INTEGRATION_BASE_DEFAULT, SHELL_MENU_LEAF } from './shared/integration.js'
 import { unitySourceDir } from './unityBridge.js'
 import type { ShellIntegrationStatus, ShellLauncherState, ShellMenuEntry } from './shared/integration.js'
@@ -53,7 +55,7 @@ export const WHALE_ICO = 'dsh-whale.ico'
 interface RunOutcome { code: number | null; output: string }
 
 /** 注册 marker 内容。 */
-interface RegistrationMarker { baseUrl: string; at: string }
+interface RegistrationMarker { baseUrl: string; at: string; transport?: number; profile?: string }
 
 /**
  * reg.exe 路径（SystemRoot 派生；env 可注入便于测试）。
@@ -172,8 +174,8 @@ export function ps1CommandValue(ps1Path: string, token: string = FILE_TOKEN, pow
  * @param baseUrl 深链基址
  * @returns ini 文件全文
  */
-export function iniContent(baseUrl: string): string {
-  return '[dsh]\nbase=' + (baseUrl.trim() || INTEGRATION_BASE_DEFAULT) + '\n'
+export function iniContent(baseUrl: string, metadata: Record<string, string> = {}): string {
+  return openIni(baseUrl, metadata)
 }
 
 /**
@@ -186,7 +188,7 @@ export function nautilusScript(launcherPath: string): string {
   return [
     '#!/usr/bin/env bash',
     '# 由 dsh-vscode-mode 生成：GNOME Files（Nautilus）右键脚本 → DSH 文件编辑',
-    'launcher="$HOME/.dsh/dsh-vscode-mode/shell/' + LAUNCHER_SH + '"',
+    'launcher=' + "'" + launcherPath.replace(/'/g, "'\"'\"'") + "'",
     'args=()',
     'while IFS= read -r line; do',
     '  [ -n "$line" ] && args+=("$line")',
@@ -251,6 +253,7 @@ async function runArgv(ctx: Ctx, argv: string[], cwd = dshHome()): Promise<RunOu
     handle = sub.spawn({
       argv,
       cwd,
+      env: childEnv(),
       stdio: { stdout: 'inherit', stderr: 'inherit', stdin: 'ignore' },
       graceMs: 10000,
     })
@@ -292,17 +295,17 @@ async function keyExists(ctx: Ctx, key: string): Promise<boolean> {
 /** 读注册 marker（缺失/非法 → null）。 */
 async function readMarker(home = dshHome()): Promise<RegistrationMarker | null> {
   try {
-    const data = JSON.parse(await readFile(markerFile(home), 'utf8')) as { baseUrl?: unknown; at?: unknown }
+    const data = JSON.parse(await readFile(markerFile(home), 'utf8')) as { baseUrl?: unknown; at?: unknown; transport?: unknown; profile?: unknown }
     if (typeof data?.baseUrl !== 'string' || !data.baseUrl) return null
-    return { baseUrl: data.baseUrl, at: typeof data.at === 'string' ? data.at : '' }
+    return { baseUrl: data.baseUrl, at: typeof data.at === 'string' ? data.at : '', transport: typeof data.transport === 'number' ? data.transport : undefined, profile: typeof data.profile === 'string' ? data.profile : undefined }
   } catch {
     return null
   }
 }
 
 /** 写注册 marker（父目录已存在）。 */
-async function saveMarker(baseUrl: string, home = dshHome()): Promise<void> {
-  const data: RegistrationMarker = { baseUrl, at: new Date().toISOString() }
+async function saveMarker(baseUrl: string, home = dshHome(), profile?: string): Promise<void> {
+  const data: RegistrationMarker = { baseUrl, at: new Date().toISOString(), transport: 1, profile }
   await writeFile(markerFile(home), JSON.stringify(data, null, 2) + '\n', 'utf8')
 }
 
@@ -310,9 +313,9 @@ async function saveMarker(baseUrl: string, home = dshHome()): Promise<void> {
 async function installPosix(dir: string, baseUrl: string): Promise<void> {
   await copyFile(join(assetsDirOf(import.meta.url), 'shell', LAUNCHER_SH), join(dir, LAUNCHER_SH))
   await chmod(join(dir, LAUNCHER_SH), 0o755)
-  await writeFile(join(dir, INI_NAME), iniContent(baseUrl), 'utf8')
 }
 
+
 /** 写 Nautilus 右键脚本（父目录按需创建 + 执行位）。 */
 async function writeNautilus(home: string, launcherPath: string): Promise<void> {
   const script = nautilusPath(home)
@@ -348,19 +351,6 @@ async function dropFinderMenu(home: string): Promise<void> {
   await rm(dir, { recursive: true, force: true })
 }
 
-/** 卸载清理专用：直调 reg delete（subprocess 服务在 teardown 可能已卸载）。⚠️ stdio 'ignore'：受管环境禁管道。 */
-function regDeleteDirect(key: string): Promise<void> {
-  return new Promise((resolve) => {
-    try {
-      const child = spawn(regExe(), ['delete', key, '/f'], { windowsHide: true, timeout: 5000, stdio: 'ignore' })
-      child.once('close', () => resolve())
-      child.once('error', () => resolve())
-    } catch {
-      resolve()
-    }
-  })
-}
-
 /**
  * 查询系统集成状态（按平台探测条目注册状态 + launcher 安装态）。
  * @author ddj 2026年09月07号
@@ -412,7 +402,6 @@ export async function shellMenuRegister(ctx: Ctx, baseUrl: string): Promise<Shel
   const dir = shellInstallDir()
   await mkdir(dir, { recursive: true })
   if (process.platform === 'win32') {
-    await writeFile(join(dir, INI_NAME), iniContent(baseUrl), 'utf8')
     await installIcon(dir)
     const compiled = await installLauncher(ctx, dir, true)
     if (!(await readMarker())) await backupKeys(ctx, dir)
@@ -426,7 +415,8 @@ export async function shellMenuRegister(ctx: Ctx, baseUrl: string): Promise<Shel
     // macOS 菜单由用户按 Automator 配方手动创建（UI 提供一键复制）；这里仅安装 launcher
     await installPosix(dir, baseUrl)
   }
-  await saveMarker(baseUrl)
+  await writeOpenConfig(ctx, dir, baseUrl)
+  await saveMarker(baseUrl, dshHome(), findProfileDir(ctx))
   return shellMenuStatus(ctx, baseUrl)
 }
 
@@ -454,38 +444,40 @@ export async function shellMenuRemove(ctx: Ctx, baseUrl: string): Promise<ShellI
 
 /**
  * 系统集成生命周期（index.ts 经 ctx.effect 挂载）：
- * 启动时 marker 存在 → 幂等自动恢复注册（插件更新/reload 不丢注册）；
- * 返回的 disposer 在插件卸载/reload 时清理注册痕迹（marker 保留供下次恢复）。
+ * 启动时仅升级用户已注册的 launcher 文件与配置；保留系统注册和明确选中的 profile。
+ * 卸载时取消后续迁移步骤；移除系统注册只由用户显式操作触发。
  * @author ddj 2026年09月07号
  * @param ctx DSH 上下文
  * @returns 卸载清理 disposer
  */
 export function shellMenuLifecycle(ctx: Ctx): () => void {
-  void restoreOnLoad(ctx).catch(() => {})
-  return () => {
-    void cleanupOnUnload().catch(() => {})
-  }
+  let disposed = false
+  void restoreOnLoad(ctx, () => disposed).catch((error) => console.warn('[dsh-vscode-mode] launcher migration failed:', error))
+  return () => { disposed = true }
 }
 
-/** 启动自动恢复：marker 存在才执行（幂等；exe 已存在跳过编译）。 */
-async function restoreOnLoad(ctx: Ctx): Promise<void> {
-  const marker = await readMarker()
-  if (!marker) return
-  await shellMenuRegister(ctx, marker.baseUrl)
-}
-
-/** 卸载清理：marker 存在 → 按平台移除注册痕迹（launcher 文件与 marker 保留）。 */
-async function cleanupOnUnload(): Promise<void> {
+/** @private @author ddj 2026年09月28号
+ * Upgrade installed assets only; OS registration remains user-owned across reloads.
+ * @param ctx Host profile context.
+ * @param disposed Whether lifecycle disposal has started.
+ */
+async function restoreOnLoad(ctx: Ctx, disposed: () => boolean): Promise<void> {
   const marker = await readMarker()
-  if (!marker) return
-  if (process.platform === 'win32') {
-    const paths = menuKeyPaths()
-    for (const key of [paths.files, paths.dir, paths.background]) await regDeleteDirect(key)
-  } else if (process.platform === 'linux') {
-    await removePosixFiles(homedir())
-  } else if (process.platform === 'darwin') {
-    await dropFinderMenu(homedir())
+  if (!marker || disposed()) return
+  const profile = findProfileDir(ctx)
+  if (!profile || (marker.profile && marker.profile !== profile)) return
+  const dir = shellInstallDir()
+  const baseUrl = await storedOpenBase(dir, marker.baseUrl)
+  if (marker.transport !== 1) {
+    if (process.platform === 'win32') {
+      const hadExe = await fileExists(join(dir, LAUNCHER_EXE))
+      const compiled = await installLauncher(ctx, dir, true)
+      if (hadExe && !compiled) throw new Error('旧 launcher 编译升级失败，请在设置中重新注册')
+    } else await installPosix(dir, baseUrl)
   }
+  if (disposed()) return
+  await writeOpenConfig(ctx, dir, baseUrl)
+  if (!disposed()) await saveMarker(baseUrl, dshHome(), profile)
 }
 
 /**
@@ -500,6 +492,7 @@ async function installLauncher(ctx: Ctx, dir: string, force: boolean): Promise<b
   const exe = join(dir, LAUNCHER_EXE)
   if (!force && await fileExists(exe)) return true
   const shellAssets = join(assetsDirOf(import.meta.url), 'shell')
+  await copyFile(join(shellAssets, LAUNCHER_PS1), join(dir, LAUNCHER_PS1))
   for (const candidate of cscCandidates()) {
     if (!(await fileExists(candidate))) continue
     try {
@@ -574,3 +567,16 @@ async function addMenuKey(ctx: Ctx, key: string, iconPath: string, command: stri
   await runArgv(ctx, [reg, 'add', key, '/v', REG_VALUE_NAME_ICON, '/t', 'REG_SZ', '/d', iconPath, '/f'])
   await runArgv(ctx, [reg, 'add', key + '\\command', '/ve', '/t', 'REG_SZ', '/d', command, '/f'])
 }
+
+/** @private @author ddj 2026年09月28号
+ * Preserve a manually configured public URL during launcher migration.
+ * @param dir Launcher directory.
+ * @param fallback Registered legacy address.
+ * @returns Existing base value, or the marker's address.
+ */
+async function storedOpenBase(dir: string, fallback: string): Promise<string> {
+  try {
+    const text = await readFile(join(dir, INI_NAME), 'utf8')
+    return /^base\s*=\s*(.+)$/im.exec(text)?.[1]?.trim() || fallback
+  } catch { return fallback }
+}

package/src/lsp/transport.ts

@@ -1,180 +1,137 @@
-/**
- * dsh-vscode-mode host — LSP 语言服务器进程传输层。
- * 基于 node:child_process.spawn（stdio pipe 双向流）。刻意不用 DSH ctx.subprocess
- * 抽象：LSP 需要持续写 stdin + 流式读 stdout，而该抽象 stdin 不可写、输出为一次性收集。
- * 作者 ddj 2026-08-27
- */
-import { spawn, type ChildProcess } from 'node:child_process'
+/** LSP 双向 stdio 传输；外部进程使用清理后的环境及独立进程组。 */
+import { spawn } from 'node:child_process'
+import type { ChildProcess, ChildProcessWithoutNullStreams } from 'node:child_process'
 import { createFrameParser } from './jsonrpc.js'
+import { childEnv } from '../childEnv.js'
+import { killTree, stopTree } from '../processTree.js'
 
 const STDERR_CAP = 256 << 10
-
 export interface TransportSpec {
   argv: string[]
   cwd?: string
   env?: Record<string, string>
 }
-
 export interface Transport {
-  /** 写一行帧到 stdin（自动加换行）。 */
   write(chunk: Buffer): boolean
-  /** 推送 stdout 解析出的原始消息（内部由帧解析器调用）。 */
   onMessage: ((message: unknown) => void) | null
-  /** stderr 收集缓冲（有界，供诊断）。 */
   stderr(): string
-  /** 进程退出/崩溃回调（code/signal）。 */
   onExit: ((code: number | null, signal: string | null) => void) | null
-  /** 优雅关闭后强杀（Windows 下连带进程树）。 */
   dispose(): void
-  /** 是否仍存活。 */
   readonly alive: boolean
   readonly pid: number | undefined
 }
-
 const running = new Set<ChildProcess>()
 
-/** 当前仍在运行的 LSP 子进程（供 disposeAll / 诊断）。 */
-export function liveChildren(): ReadonlySet<ChildProcess> {
-  return running
-}
+/** 当前仍归本模块管理的进程。 */
+export function liveChildren(): ReadonlySet<ChildProcess> { return running }
 
 /**
- * 启动语言服务器进程。
- * @author ddj 2026年08月27号
- * @param spec 启动参数（argv 数组，不经 shell，Windows 引号安全）
- * @param onMessage stdout 消息回调
- * @param logger 诊断日志（可选）
- * @returns 传输句柄
+ * 建立传输状态与回收路径；根进程退出也立即回收剩余进程组。
+ * @private
+ * @author ddj 2026年09月28号
+ * @param child 新建子进程
+ * @param onMessage 协议消息回调
+ * @param logger 诊断回调
+ * @returns 传输句柄与错误缓冲写入器
  */
-export function spawnServer(spec: TransportSpec, onMessage: (message: unknown) => void, logger?: (line: string) => void): Transport {
-  const { argv, cwd, env } = spec
-  const child = spawn(argv[0], argv.slice(1), {
-    cwd,
-    env: { ...process.env, ...env },
-    stdio: ['pipe', 'pipe', 'pipe'],
-    windowsHide: true,
-  })
-  running.add(child)
-  let stderrBuf = Buffer.alloc(0)
+function makeTransport(child: ChildProcessWithoutNullStreams, onMessage: (message: unknown) => void, logger?: (line: string) => void) {
   let alive = true
-  const parser = createFrameParser()
-
-  child.stderr.on('data', (chunk: Buffer) => {
-    if (stderrBuf.length < STDERR_CAP) {
-      stderrBuf = Buffer.concat([stderrBuf, chunk], Math.min(stderrBuf.length + chunk.length, STDERR_CAP))
-    }
-    logger?.(chunk.toString('utf8'))
-  })
-
-  let exited = false
-  const emitExit = (code: number | null, signal: string | null): void => {
-    if (exited) return
-    exited = true
-    alive = false
-    running.delete(child)
-    transport.onExit?.(code, signal)
-  }
-  child.on('error', (error) => {
-    logger?.('spawn error: ' + String(error))
-    emitExit(null, null)
-  })
-  child.on('exit', (code, signal) => emitExit(code, signal))
-  child.on('close', (code, signal) => emitExit(code, signal))
-
+  let disposed = false
+  let stderrBuf = Buffer.alloc(0)
+  let finish: (() => void) | undefined
   const transport: Transport = {
+    /** @public @author ddj 2026年09月28号 @param chunk 协议帧 @returns 是否可写 */
     write(chunk: Buffer): boolean {
       if (!alive || !child.stdin.writable) return false
       child.stdin.write(chunk)
       return true
     },
     onMessage,
-    stderr(): string {
-      return stderrBuf.toString('utf8')
-    },
+    /** @public @author ddj 2026年09月28号 @returns 有界错误缓冲 */
+    stderr(): string { return stderrBuf.toString('utf8') },
     onExit: null,
+    /** @public @author ddj 2026年09月28号 @description 停止整个进程树，根退出不取消回收。 */
     dispose(): void {
-      if (!alive) return
-      // 先 SIGTERM 让服务器有机会清理，1.5s 后强杀进程树
-      child.kill()
-      const timer = setTimeout(() => {
-        if (!alive) return
-        alive = false
-        running.delete(child)
-        try {
-          if (process.platform === 'win32') {
-            spawn('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' })
-          } else {
-            child.kill('SIGKILL')
-          }
-        } catch (error) {
-          logger?.('force kill error: ' + String(error))
-        }
-      }, 1500)
-      timer.unref?.()
-    },
-    get alive() {
-      return alive
-    },
-    get pid() {
-      return child.pid
+      if (disposed) return
+      disposed = true
+      finish = stopTree(child, logger)
     },
+    get alive() { return alive },
+    get pid() { return child.pid },
+  }
+  /** @private @author ddj 2026年09月28号 @param code 退出码 @param signal 退出信号 */
+  const emitExit = (code: number | null, signal: string | null): void => {
+    if (!alive) return
+    alive = false
+    disposed = true
+    if (finish) finish()
+    else killTree(child, logger)
+    running.delete(child)
+    transport.onExit?.(code, signal)
   }
-  // stdout 帧解析 → onMessage（LSP 响应/通知；onMessage 由 client 接管后动态生效）
+  child.on('error', (error) => { logger?.('spawn error: ' + String(error)); emitExit(null, null) })
+  child.on('exit', emitExit)
+  child.on('close', emitExit)
+  child.stderr.on('data', (chunk: Buffer) => {
+    if (stderrBuf.length < STDERR_CAP) stderrBuf = Buffer.concat([stderrBuf, chunk], Math.min(stderrBuf.length + chunk.length, STDERR_CAP))
+    logger?.(chunk.toString('utf8'))
+  })
+  return transport
+}
+
+/**
+ * 启动语言服务器并接入协议流，显式 env 在父环境清理后覆盖。
+ * @public
+ * @author ddj 2026年09月28号
+ * @param spec 启动参数，不经 shell
+ * @param onMessage stdout 协议消息回调
+ * @param logger 诊断日志
+ * @returns 传输句柄
+ * @throws spawn 的同步参数错误
+ */
+export function spawnServer(spec: TransportSpec, onMessage: (message: unknown) => void, logger?: (line: string) => void): Transport {
+  const child = spawn(spec.argv[0], spec.argv.slice(1), {
+    cwd: spec.cwd,
+    env: childEnv(spec.env),
+    stdio: ['pipe', 'pipe', 'pipe'],
+    windowsHide: true,
+    detached: process.platform !== 'win32',
+  })
+  running.add(child)
+  const transport = makeTransport(child, onMessage, logger)
+  const parser = createFrameParser()
   child.stdout.on('data', (chunk: Buffer) => {
     for (const message of parser.push(chunk)) transport.onMessage?.(message)
   })
+  // 写入管道在退出竞态中可能异步 EPIPE，必须监听以免宿主未处理异常。
+  child.stdin.on('error', (error) => logger?.('stdin error: ' + String(error)))
   return transport
 }
 
-/** 强杀全部运行中的 LSP 子进程（插件卸载/退出用）。 */
-export function disposeAllServers(): void {
-  for (const child of running) {
-    try {
-      if (process.platform === 'win32' && child.pid) {
-        spawn('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' })
-      } else {
-        child.kill('SIGKILL')
-      }
-    } catch (error) {
-      /* 忽略单个清理失败 */
-    }
-  }
+/**
+ * 回收本模块所有进程树。
+ * @public
+ * @author ddj 2026年09月28号
+ * @param sync 宿主 exit 钩子使用同步 taskkill
+ */
+export function disposeAllServers(sync = false): void {
+  for (const child of running) killTree(child, undefined, sync)
   running.clear()
 }
 
-/** 进程退出回收是否已注册（防重复挂监听）。 */
 let exitHooked = false
-
 /**
- * 宿主进程退出时回收 LSP 子进程（幂等）。
- *
- * 为什么需要：插件的 ctx.effect 清理只在卸载/重载时触发，宿主进程退出不触发，
- * 于是 emmylua_ls / dotnet 等服务器会成为跨重启的孤儿常驻（实测孤儿启动时间早于宿主，
- * 长期占用内存与工作区文件句柄）。
- *
- * ⚠️ 只回收、不退出：宿主自身已注册 SIGINT/SIGTERM 处理（DSH profile-boot 走
- * shutdown.interrupt → 优雅关闭 + 状态落盘），这里若调 process.exit 会打断该流程。
- * 因此仅在信号到达时顺带回收子进程，退出时机与退出码仍由宿主决定。
- *
- * ⚠️ 信号监听只在宿主已有监听时才挂：Node 的默认信号语义（终止进程）会被首个监听器
- * 取代，若本插件是唯一监听者，挂上去反而让 Ctrl+C 不再退出宿主。无既有监听即跳过，
- * 交由 'exit' 事件兜底。
- *
- * exit 事件下只能同步执行，Windows 的 child.kill 不走进程树，故复用
- * disposeAllServers 的 taskkill /T /F 强杀路径；best-effort，失败不阻塞退出。
- * @author ddj 2026年09月11号
+ * 注册宿主退出回收；不夺取宿主原有信号退出语义。
+ * @public
+ * @author ddj 2026年09月28号
+ * @description exit 用同步回收；仅在宿主已有信号监听时追加收尾。
  */
 export function hookExitReclaim(): void {
   if (exitHooked) return
   exitHooked = true
-  const reclaim = (): void => {
-    try {
-      disposeAllServers()
-    } catch (error) { /* 退出路径静默 */ }
-  }
-  process.on('exit', reclaim)
+  process.on('exit', () => disposeAllServers(true))
   for (const signal of ['SIGINT', 'SIGTERM'] as const) {
     if (process.listenerCount(signal) === 0) continue
-    process.on(signal, reclaim)
+    process.on(signal, () => disposeAllServers())
   }
 }

package/src/mcp.ts

@@ -12,6 +12,7 @@ import {
 } from './compat.js'
 import type { MpcConfig, MpcServer, MpcTool } from './shared/mcp.js'
 import type { Ctx } from './store.js'
+import { checkMcpName } from './mcpProject.js'
 
 export { LEGACY_PROJECT_PREFIX, MCP_PACKAGE, PROJECT_ENTRY_PREFIX, isProjectEntryId }
 
@@ -31,10 +32,17 @@ export function publicConfig(config: Record<string, unknown>): MpcConfig {
   return out as unknown as MpcConfig
 }
 
-/** 从工具注册表读取服务器命名空间下的工具摘要。 */
-export function toolsOf(ctx: Ctx, serverName: string): MpcTool[] {
+/**
+ * Read tool summaries from the caller's exact visible scope.
+ * @public @author ddj 2026年09月28号
+ * @param ctx Host tools service.
+ * @param serverName Server namespace.
+ * @param agent Optional agent scope; omitted for global entries.
+ * @returns Scoped tool summaries, allowing resource-only servers to have zero tools.
+ */
+export function toolsOf(ctx: Ctx, serverName: string, agent?: any): MpcTool[] {
   const tools = ctx.get('tools')
-  const view = tools?.view?.(void 0)
+  const view = tools?.view?.(agent)
   const visible = view?.visible
   if (!(visible instanceof Map)) return []
   const prefix = `mcp__${serverName}__`
@@ -44,7 +52,37 @@ export function toolsOf(ctx: Ctx, serverName: string): MpcTool[] {
   }))
 }
 
-/** 将 loader entry 映射为设置页摘要。 */
+/**
+ * Restore unchanged masked values without inventing credentials for new keys.
+ * @public @author ddj 2026年09月28号
+ * @param next Submitted configuration, including editable unknown fields.
+ * @param previous Last persisted configuration.
+ * @returns Detached configuration with unchanged secrets restored; throws for an orphan mask.
+ */
+export function mergeSecrets(next: Record<string, unknown>, previous: Record<string, unknown>): Record<string, unknown> {
+  const merged = { ...next }
+  for (const field of ['env', 'headers']) {
+    const values = next[field]
+    if (!values || typeof values !== 'object' || Array.isArray(values)) continue
+    const old = previous[field] as Record<string, unknown> | undefined
+    const restored: Record<string, unknown> = Object.create(null)
+    for (const [key, value] of Object.entries(values)) {
+      if (value !== '••••••') { restored[key] = value; continue }
+      if (!old || !Object.hasOwn(old, key)) throw new Error('脱敏凭据没有原值，请重新填写：' + key)
+      restored[key] = old[key]
+    }
+    merged[field] = restored
+  }
+  return merged
+}
+
+/**
+ * Summarize a global entry without treating plugin activation as a successful handshake.
+ * @public @author ddj 2026年09月28号
+ * @param ctx Host services.
+ * @param entry Global loader entry.
+ * @returns Masked status and globally visible tools.
+ */
 export function serverOf(ctx: Ctx, entry: any): MpcServer {
   const config = (entry.options?.config ?? {}) as Record<string, unknown>
   const serverName = typeof config.serverName === 'string' ? config.serverName : entry.options?.id ?? 'unknown'
@@ -53,10 +91,12 @@ export function serverOf(ctx: Ctx, entry: any): MpcServer {
   return {
     id: String(entry.id ?? entry.options?.id ?? serverName),
     serverName,
-    enabled: entry.disabled !== true,
+    enabled: entry.disabled !== true && entry.options?.disabled !== true,
     transport: config.transport === 'streamable-http' ? 'streamable-http' : 'stdio',
     config: publicConfig(config),
-    status: state === 2 ? 'connected' : state === 1 ? 'connecting' : 'error',
+    status: entry.disabled === true || entry.options?.disabled === true ? 'disabled'
+      : state === 2 ? 'unverified' : state === 1 || state === 0 ? 'connecting' : state === 3 ? 'error' : 'configured',
+    instanceCount: entry.fiber ? 1 : 0,
     toolCount: tools.length,
     tools,
     error: state === 3 ? 'MCP 插件未正常运行' : undefined,
@@ -75,17 +115,26 @@ export function listMcp(ctx: Ctx): { servers: MpcServer[] } {
   return { servers: entriesOf(ctx).filter((entry) => !isProjectEntryId(String(entry.id ?? entry.options?.id ?? ''))).map((entry) => serverOf(ctx, entry)) }
 }
 
-/** 保存 MCP 服务配置并触发 loader 热更新。 */
+/**
+ * Save a global loader entry while preserving advanced options and unchanged secrets.
+ * @public @author ddj 2026年09月28号
+ * @param ctx Host loader context.
+ * @param config Submitted global configuration.
+ * @returns Masked server status; project name collisions reject before writing.
+ */
 export async function saveMcp(ctx: Ctx, config: MpcConfig): Promise<MpcServer> {
   validateConfig(config)
+  await checkMcpName(ctx, config.serverName)
   const loader = ctx.get('loader')
   if (!loader) throw new Error('缺少 loader 服务')
   const existing = entriesOf(ctx).find((entry) => !isProjectEntryId(String(entry.id ?? entry.options?.id ?? '')) && entry.options?.config?.serverName === config.serverName)
+  const previous = existing?.options?.config ?? {}
+  const next = mergeSecrets({ ...previous, ...config }, previous)
   if (existing) {
-    await loader.update(existing.id, { config: { ...config } })
+    await loader.update(existing.id, { config: next })
     return serverOf(ctx, loader.resolve(existing.id))
   }
-  const id = await loader.create({ name: MCP_PACKAGE, config: { ...config } })
+  const id = await loader.create({ name: MCP_PACKAGE, config: next })
   return serverOf(ctx, loader.resolve(id))
 }