dsh-remote-bridge 2.6.1 → 2.7.0

package/lib/index.d.ts

@@ -1096,9 +1096,29 @@ interface LlmLike {
    * `this.ctx.llm.resolveModelInfo(...)` 再查 `inputModalities`）。入口要与内核
    * 得出同一个结论，只能查同一份元数据 —— 名字、前缀、家族表都是启发式，会漂。
    */
-  resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<{
-    inputModalities?: readonly string[];
-  } | undefined>;
+  resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfoLike | undefined>;
+}
+/**
+ * `ctx.llm.resolveModelInfo()` 返回值里桥消费的那几个字段。
+ *
+ * 内核的 `LlmResolvedModelInfo` 比这更宽（还有 `reasoning` / `systemPromptUpdate`
+ * / `toolUpdate`），这里只声明真正读的：上下文容量与默认输出上限。
+ *
+ * **为什么必须从 `resolveModelInfo` 拿、而不是从 `modelCatalog()` 拿**：
+ * 0.2.x 的 `ModelCatalogModel` 只有 `{ id, name, description?, reasoning? }` ——
+ * 目录里**没有** `contextWindow` / `maxTokens` / `inputModalities`。这三个只在
+ * `LlmResolvedModelInfo`（= `LlmModelInfo` + `context` + `defaultMaxTokens`）里。
+ * 目录条目自带这两个字段是 1.x 的旧形状，2.x 拆开了。
+ */
+interface LlmResolvedModelInfoLike {
+  /** 输入模态；`undefined` = 未知，显式缺 `image` = 负能力。 */
+  readonly inputModalities?: readonly string[];
+  /** 上下文容量（请求 + 响应合计 token 上限）；内核不知道时不存在。 */
+  readonly context?: {
+    readonly contextWindow: number;
+  };
+  /** 调用方不显式给上限时，adapter 会用的每请求输出上限。 */
+  readonly defaultMaxTokens?: number;
 }
 /** Host services the bridge consumes; assembled by `src/index.ts` from `ctx`. */
 interface Dsh02HostServices {
@@ -1651,6 +1671,19 @@ interface ChatSessionView {
   origin?: 'subagent';
   pendingInteraction?: 'approval';
 }
+/**
+ * 建会话的可选参数。
+ *
+ * `reuseBlank` 是**桥**加的语义，不是内核字段：DSH 0.2.1 起桌面端点「新会话」会回到
+ * 那个工作区已有的空白会话，而内核 RPC 不做这层挑选（见 `reusableBlankId`）。
+ * 桥默认照桌面语义走（省略即 `true`），但留一个 `false` 让调用方要「无论如何新建一个」
+ * 时能要得到 —— 老客户端从来不带这个字段，行为因此是**新增**而不是**变更**。
+ */
+interface CreateSessionOptions {
+  sessionId?: string;
+  agentPreset?: string;
+  reuseBlank?: boolean;
+}
 interface PendingApprovalView {
   id: string;
   sessionId: string;
@@ -1806,20 +1839,49 @@ declare class DshChatAdapter {
     defaultPreset: string;
   }>;
   selectAgentPreset(principal: Principal, sessionId: string, agentPreset: string): Promise<string>;
-  createSessionInWorkspace(principal: Principal, workspaceId: string, options: {
-    sessionId?: string;
-    agentPreset?: string;
-  }): Promise<{
+  createSessionInWorkspace(principal: Principal, workspaceId: string, options: CreateSessionOptions): Promise<{
     id: string;
     agentPreset?: string;
   }>;
-  createSession(principal: Principal, rootId: string, relativePath: string, options: {
-    sessionId?: string;
-    agentPreset?: string;
-  }): Promise<{
+  createSession(principal: Principal, rootId: string, relativePath: string, options: CreateSessionOptions): Promise<{
     id: string;
     agentPreset?: string;
   }>;
+  /**
+   * 挑一个可复用的空白会话 —— DSH 0.2.1 起桌面端的「New Session 回到空白会话」语义。
+   *
+   * **内核自己不做这件事。** `sessionController.create` 只有调用方显式传了 `sessionId`
+   * 才会走 `claim` / `reuseLive` 去复用；不传就无条件 `createMinted` 新建一个。
+   * 「跳过 preset 不匹配的空白会话」那层挑选写在**客户端**（`dsh-client-ui-workspace`
+   * 的 `connectWorkspace` → `createInWorkspace`）里，而桥走 REST 直连内核，没有这一层 ——
+   * 于是手机端每点一次「新会话」就多一个空白会话，攒成一串永远没人用的空壳。
+   *
+   * 这里把客户端那条判据原样搬过来（`blank && cwd 匹配 && 未归档 && preset 匹配`），
+   * 取用顺序也照抄：**按内核返回的列表顺序取第一个**，不自己按时间排序 —— 同一份数据
+   * 在桌面与手机上应当落到同一条会话上，桥没有理由发明第三种顺序。
+   *
+   * preset 的口径也与内核一致：空白会话**没声明** preset 时对任何预设都算可用
+   * （只有 `typeof listed === 'string'` 才比较）。「没声明」不等于「声明了别的」——
+   * 把前者当成不匹配会让所有老会话都挑不中。
+   */
+  private reusableBlankId;
+  /**
+   * 工作区维度上找一个可复用的空白会话。
+   *
+   * 归属判据用**内核自己的两个字段**：`session.cwd === workspace.path` 且
+   * `workspace.sessionIds` 含它 —— 与客户端 `createInWorkspace` 逐字同义。
+   * 这里重新拉一次原始 workspace 列表（而不是复用 `listWorkspaces` 的投影结果），
+   * 因为 `ChatWorkspaceView` 刻意不含 `sessionIds` 与绝对路径。
+   */
+  private blankSessionInWorkspace;
+  /**
+   * 绝对路径维度上找一个可复用的空白会话（老客户端的 `rootId` + `path` 入口）。
+   *
+   * 这里没有 workspace 摘要可用，判据就只剩「同一 cwd」—— 与客户端按 workspace
+   * 挑选相比少了两道（`sessionIds` 归属、workspace 存在性），但那两道在
+   * `rootId` + `path` 这条路上本来就由授权根解析替代了。
+   */
+  private blankSessionAtPath;
   history(principal: Principal, sessionId: string, options: {
     beforeSeq?: number;
     maxMessages?: number;

package/lib/index.js

@@ -2748,6 +2748,92 @@ function readArchivedSessionIds(registry) {
 	return value.filter((item) => typeof item === "string");
 }
 /**
+* 容量元数据的缓存寿命。
+*
+* 与内核 `dsh-llm` 的 `DEFAULT_MODELS_MAX_AGE_MS = 600000` 对齐：那边是模型
+* **列表**的新鲜度，这边是**单个模型容量**的新鲜度，同一批配置变动（改
+* baseURL、换 API key、升级内核）会同时让两者失效，跟齐一个数量级最不容易
+* 出现「列表变了容量没变」的错配。
+*/
+const MODEL_CAPACITY_TTL_MS = 6e5;
+/** 缓存条目上限；只是防内存无界，正常部署里 provider×model 远小于这个数。 */
+const MODEL_CAPACITY_CACHE_LIMIT = 512;
+const modelCapacityCache = /* @__PURE__ */ new Map();
+/**
+* 把一个模型条目的容量字段补齐。
+*
+* **为什么不能直接从 `modelCatalog()` 拿**：0.2.x 的 `ModelCatalogModel` 只有
+* `{ id, name, description?, reasoning? }` —— 目录里没有 `contextWindow` /
+* `maxTokens` / `inputModalities`。这三个只在 `LlmResolvedModelInfo` 里，得走
+* `llm.resolveModelInfo(provider, model)`。目录条目自带容量是 1.x 的旧形状。
+*
+* 失败一律退回「不填」：模型选择器少显示一行容量，比整张目录报错好得多。
+* 注意**不缓存失败**——一次瞬时 RPC 抖动不该让某个模型十分钟没有容量。
+*/
+async function modelCapacityOf(host, provider, model, signal) {
+	const key = `${provider}\u0000${model}`;
+	const cached = modelCapacityCache.get(key);
+	if (cached !== void 0 && Date.now() - cached.at < MODEL_CAPACITY_TTL_MS) return cached.capacity;
+	let capacity = {};
+	try {
+		const info = await host.llm.resolveModelInfo(provider, model, signal);
+		const contextWindow = info?.context?.contextWindow;
+		const maxTokens = info?.defaultMaxTokens;
+		capacity = {
+			...typeof contextWindow === "number" && contextWindow > 0 ? { contextWindow } : {},
+			...typeof maxTokens === "number" && maxTokens > 0 ? { maxTokens } : {}
+		};
+	} catch {
+		return {};
+	}
+	if (modelCapacityCache.size >= MODEL_CAPACITY_CACHE_LIMIT) {
+		const oldest = modelCapacityCache.keys().next();
+		if (oldest.done !== true) modelCapacityCache.delete(oldest.value);
+	}
+	modelCapacityCache.set(key, {
+		at: Date.now(),
+		capacity
+	});
+	return capacity;
+}
+/**
+* 给一张 provider group 列表补容量字段。
+*
+* 并发查而不是串行：目录动辄几十个模型，串行 RPC 会把模型选择器拖成几秒空白。
+* 单个模型失败不影响其他模型（`modelCapacityOf` 内部吞掉）。
+*
+* 对**形状**宽容：`groups` 是 `unknown`（内核给什么形状就是什么形状，我们只
+* 投影自己认识的字段），认不出来的条目原样透传，保证向前兼容。
+*/
+async function enrichModelGroups(host, groups, signal) {
+	return Promise.all(groups.map(async (group) => {
+		if (typeof group !== "object" || group === null) return group;
+		const view = group;
+		const providerId = typeof view.id === "string" ? view.id : void 0;
+		if (providerId === void 0 || !Array.isArray(view.models)) return group;
+		const models = await Promise.all(view.models.map(async (model) => {
+			if (typeof model !== "object" || model === null) return model;
+			const entry = model;
+			const modelId = typeof entry.id === "string" ? entry.id : void 0;
+			if (modelId === void 0) return model;
+			const capacity = await modelCapacityOf(host, providerId, modelId, signal);
+			const filled = {
+				...entry.contextWindow === void 0 && capacity.contextWindow !== void 0 ? { contextWindow: capacity.contextWindow } : {},
+				...entry.maxTokens === void 0 && capacity.maxTokens !== void 0 ? { maxTokens: capacity.maxTokens } : {}
+			};
+			if (filled.contextWindow === void 0 && filled.maxTokens === void 0) return model;
+			return {
+				...model,
+				...filled
+			};
+		}));
+		return {
+			...group,
+			models
+		};
+	}));
+}
+/**
 * Build the `apiProxy` replacement out of 0.2.x host services.
 *
 * Every method keeps the old `{ rpcId, payload }` request shape and the old
@@ -2942,10 +3028,12 @@ function createDsh02ApiProxy(host, options = {}) {
 				} catch {}
 				const catalog = await host.sessionController.modelCatalog();
 				const selection = (await host.sessionController.projections({ sessionId }, signal))?.values?.["modelSelection"];
+				const current = selection?.next ?? selection?.lastUsed ?? catalog.default;
+				const groups = Array.isArray(catalog.groups) ? catalog.groups : [];
 				return {
-					current: selection?.next ?? selection?.lastUsed ?? catalog.default,
+					current,
 					routable: Array.isArray(catalog.routableProviders) && catalog.routableProviders.length > 0,
-					groups: Array.isArray(catalog.groups) ? catalog.groups : [],
+					groups: await enrichModelGroups(host, groups, signal),
 					failures: Array.isArray(catalog.failures) ? catalog.failures.map((entry) => ({
 						provider: typeof entry.id === "string" ? entry.id : String(entry.name ?? ""),
 						message: typeof entry.message === "string" ? entry.message : ""
@@ -3106,7 +3194,7 @@ function createDsh02ApiProxy(host, options = {}) {
 			models: () => call("llm.models", async (signal) => {
 				const view = await host.sessionController.modelCatalog();
 				return {
-					groups: Array.isArray(view.groups) ? view.groups : [],
+					groups: await enrichModelGroups(host, Array.isArray(view.groups) ? view.groups : [], signal),
 					failures: Array.isArray(view.failures) ? view.failures : []
 				};
 			}),
@@ -3123,7 +3211,7 @@ function createDsh02ApiProxy(host, options = {}) {
 }
 //#endregion
 //#region src/shared/version.ts
-const PLUGIN_VERSION = "2.6.1";
+const PLUGIN_VERSION = "2.7.0";
 //#endregion
 //#region src/host/capabilities.ts
 /**
@@ -3638,9 +3726,10 @@ var DshChatAdapter = class {
 	}
 	async createSessionInWorkspace(principal, workspaceId, options) {
 		if ((await this.listWorkspaces(principal)).find((item) => item.id === workspaceId) === void 0) throw new ApiError(404, "WORKSPACE_NOT_FOUND", "The DSH workspace is not visible to this device.");
+		const sessionId = options.sessionId ?? (options.reuseBlank === false ? void 0 : await this.blankSessionInWorkspace(workspaceId, options.agentPreset));
 		const payload = {
 			workspaceId,
-			...options.sessionId === void 0 ? {} : { sessionId: options.sessionId },
+			...sessionId === void 0 ? {} : { sessionId },
 			...options.agentPreset === void 0 ? {} : { agentPreset: options.agentPreset }
 		};
 		const value = unwrapDsh(await this.api.sessions.create({
@@ -3653,9 +3742,11 @@ var DshChatAdapter = class {
 		};
 	}
 	async createSession(principal, rootId, relativePath, options) {
+		const resolved = await resolveAuthorizedPath(this.requireAuthorizedRoot(principal, rootId).realPath, relativePath);
+		const sessionId = options.sessionId ?? (options.reuseBlank === false ? void 0 : await this.blankSessionAtPath(resolved.absolutePath, options.agentPreset));
 		const payload = {
-			cwd: (await resolveAuthorizedPath(this.requireAuthorizedRoot(principal, rootId).realPath, relativePath)).absolutePath,
-			...options.sessionId === void 0 ? {} : { sessionId: options.sessionId },
+			cwd: resolved.absolutePath,
+			...sessionId === void 0 ? {} : { sessionId },
 			...options.agentPreset === void 0 ? {} : { agentPreset: options.agentPreset }
 		};
 		const value = unwrapDsh(await this.api.sessions.create({
@@ -3667,6 +3758,69 @@ var DshChatAdapter = class {
 			...value.agentPreset === void 0 ? {} : { agentPreset: value.agentPreset }
 		};
 	}
+	/**
+	* 挑一个可复用的空白会话 —— DSH 0.2.1 起桌面端的「New Session 回到空白会话」语义。
+	*
+	* **内核自己不做这件事。** `sessionController.create` 只有调用方显式传了 `sessionId`
+	* 才会走 `claim` / `reuseLive` 去复用；不传就无条件 `createMinted` 新建一个。
+	* 「跳过 preset 不匹配的空白会话」那层挑选写在**客户端**（`dsh-client-ui-workspace`
+	* 的 `connectWorkspace` → `createInWorkspace`）里，而桥走 REST 直连内核，没有这一层 ——
+	* 于是手机端每点一次「新会话」就多一个空白会话，攒成一串永远没人用的空壳。
+	*
+	* 这里把客户端那条判据原样搬过来（`blank && cwd 匹配 && 未归档 && preset 匹配`），
+	* 取用顺序也照抄：**按内核返回的列表顺序取第一个**，不自己按时间排序 —— 同一份数据
+	* 在桌面与手机上应当落到同一条会话上，桥没有理由发明第三种顺序。
+	*
+	* preset 的口径也与内核一致：空白会话**没声明** preset 时对任何预设都算可用
+	* （只有 `typeof listed === 'string'` 才比较）。「没声明」不等于「声明了别的」——
+	* 把前者当成不匹配会让所有老会话都挑不中。
+	*/
+	reusableBlankId(sessions, archived, agentPreset, matches) {
+		for (const session of sessions) {
+			if (!session.blank || archived.has(session.sessionId) || !matches(session)) continue;
+			const listed = session.agentPreset ?? session.projections?.values["agentPreset"];
+			if (agentPreset !== void 0 && typeof listed === "string" && listed !== agentPreset) continue;
+			return session.sessionId;
+		}
+	}
+	/**
+	* 工作区维度上找一个可复用的空白会话。
+	*
+	* 归属判据用**内核自己的两个字段**：`session.cwd === workspace.path` 且
+	* `workspace.sessionIds` 含它 —— 与客户端 `createInWorkspace` 逐字同义。
+	* 这里重新拉一次原始 workspace 列表（而不是复用 `listWorkspaces` 的投影结果），
+	* 因为 `ChatWorkspaceView` 刻意不含 `sessionIds` 与绝对路径。
+	*/
+	async blankSessionInWorkspace(workspaceId, agentPreset) {
+		const [sessionsResponse, workspaceResponse] = await Promise.all([this.api.sessions.list({
+			rpcId: randomUUID(),
+			payload: {}
+		}), this.api.workspace.list({
+			rpcId: randomUUID(),
+			payload: {}
+		})]);
+		const workspaceValue = unwrapDsh(workspaceResponse);
+		const summary = workspaceValue.items.find((item) => item.workspaceId === workspaceId);
+		if (summary === void 0) return void 0;
+		return this.reusableBlankId(unwrapDsh(sessionsResponse).items, new Set(workspaceValue.archivedSessionIds), agentPreset, (session) => session.cwd === summary.path && summary.sessionIds.includes(session.sessionId));
+	}
+	/**
+	* 绝对路径维度上找一个可复用的空白会话（老客户端的 `rootId` + `path` 入口）。
+	*
+	* 这里没有 workspace 摘要可用，判据就只剩「同一 cwd」—— 与客户端按 workspace
+	* 挑选相比少了两道（`sessionIds` 归属、workspace 存在性），但那两道在
+	* `rootId` + `path` 这条路上本来就由授权根解析替代了。
+	*/
+	async blankSessionAtPath(cwd, agentPreset) {
+		const [sessionsResponse, workspaceResponse] = await Promise.all([this.api.sessions.list({
+			rpcId: randomUUID(),
+			payload: {}
+		}), this.api.workspace.list({
+			rpcId: randomUUID(),
+			payload: {}
+		})]);
+		return this.reusableBlankId(unwrapDsh(sessionsResponse).items, new Set(unwrapDsh(workspaceResponse).archivedSessionIds), agentPreset, (session) => session.cwd === cwd);
+	}
 	async history(principal, sessionId, options) {
 		await this.requireSession(principal, sessionId);
 		const payload = {
@@ -6347,6 +6501,40 @@ function defaultDisplayName() {
 //#endregion
 //#region src/host/plugin-inventory.ts
 /**
+* 插件清单（plugin inventory）。
+*
+* ## 为什么需要它
+*
+* 用户在手机上使用时的反馈是「功能单调点，无法查看装的插件情况」：想知道这台机器上
+* 装了哪些插件、有没有出问题的，必须回到电脑前的 WebUI。
+*
+* 而插件的 API 面（`/api/v1`）此前有 10 个端点，**没有任何一个与插件相关**；
+* loopback 管理面（`/manage/status`）也只回 `remote` / `roots` / `devices`。
+* 于是这个信息在远程侧完全不可见。本模块补上这个缺口。
+*
+* ## 数据源为什么是这两个文件
+*
+* DSH 把每个 profile 的插件状态放在两个地方，缺一不可：
+*
+* - `<profiledir>/package.json` 的 `dependencies`：**装了哪些包**（含版本声明）；
+* - 同一个 `package.json` 的 `dsh.profile.bundles`：**实际加载了哪些包**。
+*
+* 两者之差是有意义的信息，而不是噪声：
+*
+* - 在 `dependencies` 里但不在 `bundles` 里 → **装了但没启用**（例如用户装了备用插件先不加载）；
+* - 在 `bundles` 里但 `node_modules` 下找不到 → **声明加载却缺失**，这通常意味着启动会出问题，
+*   是用户最需要被提前告知的状态。
+*
+* 另外，`node_modules/<name>/package.json` 里的 `version` 才是**实际装上的版本**。
+* 只看 `dependencies` 的 `^0.4.5` 无法回答「我现在跑的是哪个版本」。
+*
+* ## 安全边界
+*
+* 本模块只读两个位置的文件，并把结果**限制为**「包名 + 版本 + 状态」三种信息，
+* 不回传任何文件内容、绝对路径之外的系统信息、或 `.env` / 凭据相关内容。
+* `profilePath` 会返回，因为用户需要它来定位问题，且它本来就是本机路径。
+*/
+/**
 * 读包清单时的并发上限。
 *
 * 为什么不是 `Promise.all` 全放：`names` 的长度由用户装了多少插件决定，
@@ -6660,6 +6848,40 @@ function unavailable(profile, profilePath, reason) {
 		items: []
 	};
 }
+/**
+* 启用 / 停用插件（「插件」页的写操作）。
+*
+* ## 为什么不是调 `dsh plugin`
+*
+* `dsh plugin <anything>` 会**原样转发给 pnpm**。实测踩过一次：本想查
+* `dsh plugin enable --help`，结果 pnpm 直接进入安装流程（打出 `Packages: +4 -85`）——
+* 它在**动依赖树**。启用/停用插件根本不需要碰依赖（包已经在 `node_modules` 里了），
+* 走 pnpm 等于为了挪一个字符串去重算整棵依赖，风险与收益完全不成比例。
+*
+* ## 真正该改的是什么
+*
+* 只改 **`dsh.profile.bundles` 数组**。内核源码注释写明：
+*
+* > stack its patch layers (bundle layers in `dsh.profile.bundles` order …)
+*
+* 也就是说这个数组**就是加载清单，且顺序即加载顺序**。加一个名字 = 启用，
+* 删一个名字 = 停用。依赖声明（`dependencies`）原封不动 —— 包仍在磁盘上，
+* 随时可以再启用，不必重新下载。
+*
+* ## 三道安全阀
+*
+* 1. **拒绝改官方包**（`@deepseek-ai/` 前缀）：它们随 DSH 主包安装、不由 profile 管理，
+*    改了 bundles 也加载不出来，反而把清单搞成与实际不符。
+* 2. **写前必备份**：`package.json.bak-<时间戳>` 落在同目录。profile 的 package.json
+*    一旦写坏，dsh 下次**起不来**，而用户此刻在手机上、够不着电脑 —— 备份是唯一退路。
+* 3. **先写临时文件再 rename**：`rename` 在同分区是原子的。直接写原文件的话，
+*    写到一半断电/被杀会留下一个残缺的 JSON，后果同上。
+*
+* ## 必须重启才生效
+*
+* bundles 只在**启动时**读一次。改了文件不等于改了运行中的进程 —— 这一点会原样
+* 回给调用方（`restartRequired: true`），由界面明确告诉用户，别让人以为点了没反应。
+*/
 var PluginToggleError = class extends Error {
 	code;
 	constructor(code, message) {
@@ -7423,7 +7645,8 @@ var ApiRouter = class {
 				}
 				const options = {
 					...typeof body.sessionId === "string" ? { sessionId: body.sessionId } : {},
-					...typeof body.agentPreset === "string" ? { agentPreset: body.agentPreset } : {}
+					...typeof body.agentPreset === "string" ? { agentPreset: body.agentPreset } : {},
+					...typeof body.reuseBlank === "boolean" ? { reuseBlank: body.reuseBlank } : {}
 				};
 				const usesWorkspace = typeof body.workspaceId === "string";
 				const usesLegacyPath = typeof body.rootId === "string" && typeof body.path === "string";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-bridge",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "Versioned REST bridge for DeepSeek Harness: remote access for trusted clients (chat, files, devices) plus a Phone-settings panel inside the DSH WebUI.",
   "type": "module",
   "packageManager": "pnpm@11.19.0",