@sunshaobei/dsh-mcp-manager 0.4.0 → 0.6.1

package/lib/server/api/routes.d.ts

@@ -20,8 +20,8 @@ import type { ServerResponse } from "node:http";
 import { queryParam } from "./routes-helpers.js";
 export { ROUTES };
 export { queryParam };
-/** 组装 /api/dsh-mcp/* 路由。cwd 参数仅用于兼容旧调用（不再被路由使用）。 */
-export declare function makeRoutes(manager: RoutesManager, _cwd?: string): WebRoute[];
+/** Assemble routes in contract order; cwd selects a request-owned workspace without rebinding other requests. */
+export declare function makeRoutes(manager: RoutesManager, _cwd?: string, scoped?: boolean): WebRoute[];
 /** 配置变更 SSE 帧：客户端收到后重新 GET /api/dsh-mcp/config 就地更新浮窗位置。 */
 export declare function uiConfigChangedFrame(): string;
 /**

package/lib/server/catalog/search.d.ts

@@ -31,7 +31,7 @@ export declare function scoreTerms(terms: string[], haystack: string): {
  * 单 root 实现（searchCatalogMulti 循环调用；兼容既有测试）。
  * truncated：任一服务器存在被 limit 裁掉的结果即 true（B10 截断事实，
  * 供调用方精确标注「是否因 limit 裁掉」——恰好命中 limit 不误报）。 */
-export declare function searchCatalog(units: Map<string, ProjectUnit>, root: string, query: string, limit: number): {
+export declare function searchCatalog(units: Map<string, ProjectUnit>, root: string, query: string, limit: number, serverEnabled?: (root: string, name: string) => boolean): {
     results: SearchHit[];
     unavailable: Array<{
         server: string;
@@ -43,7 +43,7 @@ export declare function searchCatalog(units: Map<string, ProjectUnit>, root: str
  * 与 searchCatalog 同语义，仅数据源扩展为多个 root。
  * 单 root 直接委托 searchCatalog（保持原顺序，不引入跨单元排序变化）；
  * 多 root 合并后统一排序并按全局 limit 截断（truncated=合并后曾有超限结果）。 */
-export declare function searchCatalogMulti(units: Map<string, ProjectUnit>, roots: readonly string[], query: string, limit: number): {
+export declare function searchCatalogMulti(units: Map<string, ProjectUnit>, roots: readonly string[], query: string, limit: number, serverEnabled?: (root: string, name: string) => boolean): {
     results: SearchHit[];
     unavailable: Array<{
         server: string;
@@ -65,7 +65,7 @@ export declare function isToolDisabledForEntry(disabledTools: DisabledToolsMap |
  *    命中条目在工具行标注禁用（供模型感知）。
  * @throws 全名 root 不属于当前 roots → 路由一致性错误（与 ws_mcp_call 口径一致）。
  */
-export declare function listCatalog(units: Map<string, ProjectUnit>, roots: readonly string[], serverFilter: string | undefined, toolLimit: number, emptyHint: string, disabledTools?: DisabledToolsMap): ListCatalogResult;
+export declare function listCatalog(units: Map<string, ProjectUnit>, roots: readonly string[], serverFilter: string | undefined, toolLimit: number, emptyHint: string, disabledTools?: DisabledToolsMap, serverEnabled?: (root: string, name: string) => boolean): ListCatalogResult;
 /** 每服务器工具条数上限：非有限数或非正回落缺省；正数向下取整（历史口径）。 */
 export declare function safeToolLimit(toolLimit: number): number;
 /** 该 root 是否参与盘点：显式过滤集命中即参与，无过滤集则全参与。 */

package/lib/server/config/sources-sync.d.ts

@@ -3,8 +3,8 @@
  *
  * 纯解析在 sources.ts（本模块消费它）；这里回答「生效表如何无损落进运行面」：
  *   - 每个生效名按其来源 scope 走 add/update（同名已存在即 update，等效覆盖）
- *   - 被遮蔽（同名落选）的名字：若出现在对应 scope store 里则移除并断开
- *     （互斥 = 全局与项目两个运行面都只保留生效来源那份）
+ *   - 全局来源只更新共享全局配置，项目来源只更新指定项目的配置；
+ *     同名互斥按工作区投影，不删除其他工作区仍需使用的全局配置。
  *   - 项目 store 需要 session（projectStoreOrThrow）；无 session 时项目侧
  *     跳过并在摘要里说明，不抛错（面板会在有会话后重新同步）
  *

package/lib/server/connection/interface.d.ts

@@ -17,6 +17,7 @@
 import type { SseHub } from "../../vendor/shared/sse-hub.js";
 import type { ClientUiConfig } from "../../shared/interface.js";
 import type { ServerConfig } from "../config/interface.js";
+import type { ParsedSource, SourceId } from "../config/sources.js";
 import type { McpStore } from "../store/interface.js";
 export type { McpManager } from "./orchestrator/interface.js";
 export type { ProjectUnit, ConnectionEntry } from "./runtime/interface.js";
@@ -28,6 +29,12 @@ export interface SupervisorLite {
 }
 /** routes 使用的 McpManager 最小面（避免 index↔routes 循环 import）。 */
 export interface RoutesManager {
+    sourceSnapshot?(): {
+        sources: ParsedSource[];
+        prefs: ReadonlyMap<string, SourceId>;
+    } | undefined;
+    sourcesChanged?(): Promise<void>;
+    forWorkspace?(cwd?: string): Promise<RoutesManager>;
     setSession(cwd: string | undefined): Promise<void>;
     refreshFromDisk(): Promise<void>;
     uiConfig(): ClientUiConfig;
@@ -57,6 +64,8 @@ export interface RoutesManager {
     store: McpStore;
     /** 当前会话项目根（tool-disable 路由一致性校验用）。 */
     projectRoot?: string;
+    /** 孤儿禁用痕清扫：生效表之外的 userDisabled 记录移除（互斥同步收口用）。 */
+    sweepOrphanUserDisabled?(validGlobal: ReadonlySet<string>, validProject: ReadonlySet<string>): Promise<void>;
     /** 设置命名空间写入 sink（apply 注入；config 写路由落盘用）。 */
     uiUpdate?: (patch: Record<string, unknown>) => Promise<unknown>;
     /**

package/lib/server/connection/orchestrator/manager.d.ts

@@ -16,6 +16,7 @@ import type { Context, LoggerService } from "@deepseek-ai/cordis";
 import type { ServerConfig } from "../../config/interface.js";
 import type { ClientUiConfig, ServerState } from "../../../shared/interface.js";
 import type { CatalogCache, CatalogServer } from "../../catalog/interface.js";
+import type { RoutesManager } from "../interface.js";
 import type { McpStore } from "../../store/interface.js";
 import type { McpStatsCollector } from "../../stats/interface.js";
 import type { McpMiddleware } from "../runtime/interface.js";
@@ -88,7 +89,7 @@ export declare function reloadStoreQuietly(store: McpStore, onFail: (error: unkn
  */
 export declare function touchUnitInBackground(middleware: McpMiddleware, target: string, onFail: (error: unknown) => void): void;
 /** 池内不再需要的连接（配置里已无 / 已禁用）释放；返回是否释放过。 */
-export declare function releaseUndesiredConnections(middleware: McpMiddleware | undefined, desired: DesiredServers): boolean;
+export declare function releaseUndesiredConnections(middleware: McpMiddleware | undefined, desired: DesiredServers, projectRoot?: string): boolean;
 /**
  * 该 (root, 裸名) 是否还不在池里（= 连接集合变化）。中间层缺失时**不算**变化：
  * 实例缺失时什么都触达不了，记变化只会让状态广播空转。
@@ -279,6 +280,9 @@ export declare class McpManager {
     initMiddleware(): Promise<McpMiddleware>;
     /** userDisabled 映射（root → Set<server>），中间层单元创建时合并。 */
     disabledByRoot: Map<string, Set<string>>;
+    /** Workspace-local switches for shared global transports (stored with the existing root state). */
+    globalEnabledFor(root: string, name: string): boolean;
+    private setGlobalEnabled;
     /** 工具级禁用（root → server → Set<tool>）；root=@global 跨工作空间共享。 */
     disabledTools: DisabledToolsMap;
     /**
@@ -294,6 +298,7 @@ export declare class McpManager {
     setToolDisabled(root: string, server: string, tool: string, disabled: boolean): Promise<void>;
     /** 读取/复用某项目根的 store（工作区缓存命中直接返回，不重复读盘）。 */
     projectStoreFor(root: string | undefined): Promise<McpStore | undefined>;
+    private loadProjectStore;
     /**
      * 会话目录数据源：全局服务器 + 该 cwd 所属项目的项目级服务器（**配置层面**，
      * 与 host 当前 setSession 状态解耦）。此前直接用 manager.supervisors（实时
@@ -327,12 +332,18 @@ export declare class McpManager {
         server: ServerConfig;
         scope: string;
     }>): Promise<CatalogCache>;
-    /**
-     * 会话切换：只切 currentRoot + fire-and-forget 惰性启动（不 await 任何连接）。
-     * 变更点驱动（#111/#228）：POST /api/dsh-mcp/session 永不挂起——连接/发现
-     * 由中间层惰性驱动（per-root in-flight 去重），此处零连接副作用。
-     * 单池后项目级连接恒由中间层池按 root 常驻，切走不断开。
-     */
+    /** Cached workspace resolution and preparation never wait for a remote MCP server. */
+    private workspaceRoots;
+    private selectionVersion;
+    private touchedRoots;
+    private projectStoreLoads;
+    sourceSnapshot?: RoutesManager["sourceSnapshot"];
+    sourcesChanged?: RoutesManager["sourcesChanged"];
+    prepareWorkspace?: (cwd?: string) => Promise<void>;
+    private workspaceRoot;
+    /** A request owns its workspace view; asynchronous requests cannot change another request's root. */
+    forWorkspace(cwd?: string): Promise<McpManager>;
+    /** Selection changes pointers only. Source sync/connection checks belong to background preparation. */
     setSession(cwd: string | undefined): Promise<void>;
     /**
      * 切回前台可用性恢复：对本次请求工作空间连接的非强制恢复（对齐 SSE forceReconnect 的
@@ -378,6 +389,7 @@ export declare class McpManager {
      * @returns {boolean} 连接集合是否变化（释放了在册连接，或触达了尚未在册的服务器）
      */
     reconcileServers(): boolean;
+    private transportStore;
     startAll(): Promise<void>;
     /**
      * 启动一个服务器的连接（单池后唯一的连接路径）。
@@ -415,9 +427,8 @@ export declare class McpManager {
      */
     private ensureMiddlewareServer;
     /**
-     * 拆除中间层池中该 server 的连接（update/remove 配置变更后强制重建；
-     * 不写 userDisabled——与 disconnect 的禁用语义区分）。此前 update/remove 仅
-     * 处理项目单元，@global 池连接与目录残留导致「已删服务器仍可调用」。
+     * 只拆除目标 (root, server) 的连接与目录，不影响其他工作区的同名服务器。
+     * 不写 userDisabled——配置变更与用户主动断开的语义不同。
      */
     private dropMiddlewareConnection;
     /**
@@ -470,6 +481,13 @@ export declare class McpManager {
      * 拆除只发起不等结算（裁定 V）：官方 dispose 会等在途首连，挂死的服务器能把它拖到 SDK 的 60s 超时。
      */
     disconnect(name: string, scope?: string): Promise<void>;
+    /**
+     * 孤儿禁用痕清扫：userDisabled 里挂着但对应 scope 的生效表已无此名的记录
+     * 一律移除。早期互斥清理经 disconnect 落下的污染痕（同名切走后残留）会让
+     * 之后切回/重启时的 start 静默短路（userDisabled 命中不连），表现为「经常
+     * 连接不全」；生效表已是唯一事实，孤儿痕无语义。
+     */
+    sweepOrphanUserDisabled(validGlobal: ReadonlySet<string>, validProject: ReadonlySet<string>): Promise<void>;
     reconnect(name: string, scope?: string): Promise<void>;
     /** 面板数据：配置 + 实时状态 + 工具列表 + 项目信息。 */
     summary(): Record<string, unknown>;

package/lib/server/connection/runtime/deps.d.ts

@@ -104,6 +104,7 @@ export interface ManagerLite {
 }
 /** 中间层宿主最小面（McpManager 实现；McpMiddleware 构造注入）。 */
 export interface MiddlewareHost {
+    serverEnabledFor?(root: string, target: string, name: string): boolean;
     ctx: Pick<Context, "tools">;
     logger: LoggerService;
     /** 按 root 读取项目级服务器配置（惰性；root 无标记 → undefined）。 */

package/lib/server/connection/runtime/middleware.d.ts

@@ -92,6 +92,8 @@ export declare class McpMiddleware {
      */
     forwarding: Set<ToolExecutionToken>;
     constructor(host: MiddlewareHost);
+    /** Authorization belongs to the caller workspace, independently of the shared connection root. */
+    serverEnabledFor(root: string, target: string, name: string): boolean;
     /** 读取/创建 root 的单元（root 无项目标记 → undefined）。 */
     projectUnitFor(root: string | undefined): Promise<ProjectUnit | undefined>;
     /** 连接一个服务器（in-flight 去重；失败后台重连）。
@@ -109,7 +111,7 @@ export declare class McpMiddleware {
      *  全部吞掉，且旧 attempt 收敛时命中让位/disposed 守卫静默返回、无人补连 → 这段时间内
      *  该服务器无法重连。拆除时必须同步废弃标记；旧 attempt 稍后收敛由 connectInternal
      *  的让位/disposed 守卫兜底，无副作用。 */
-    abandonInFlight(serverName: string): void;
+    abandonInFlight(serverName: string, root?: string): void;
     private connectInternal;
     /**
      * 装载面：注册面视图 / 工具元信息 / 脱敏都是本类方法的转发，形状与调用点无关——

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sunshaobei/dsh-mcp-manager",
-  "version": "0.4.0",
+  "version": "0.6.1",
   "description": "Manage MCP servers (stdio / streamable-http) for dsh web; tools are reached only through four middleware tools. DSH MCP 管理器：Web 侧边栏「MCP」入口，面板按状态分级展示 MCP 服务器（运行中/连接中/已配置/失败），支持快速接入（stdio / streamable-http 表单）与粘贴 mcpServers JSON 导入。已连接服务器的工具一律经中间层工具（ws_mcp_search / ws_mcp_detail / ws_mcp_call / ws_mcp_list）访问：宿主注册名 mcp__<id>__<tool> 是内部标识（id 按 (工作空间, 服务器名) 分配、不可由服务器名推导），不对模型可见，禁止直呼。",
   "type": "module",
   "main": "lib/index.js",
@@ -152,11 +152,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "ssh://git@git.lbk.world:8022/eren.sun/dsh-mcp-manager.git",
-    "directory": "packages/dsh-mcp-manager"
+    "url": "git+https://github.com/sunshaobei/dsh-mcp-manager.git"
   },
   "bugs": {
-    "url": "ssh://git@git.lbk.world:8022/eren.sun/dsh-mcp-manager.git"
+    "url": "https://github.com/sunshaobei/dsh-mcp-manager/issues"
   },
   "keywords": [
     "dsh",