@morlay/dsh-desktop-shell 0.2.0 → 0.2.2

package/README.md

@@ -1,34 +1,12 @@
 # @morlay/dsh-desktop-shell
 
-dsh 桌面应用的 **Electron 壳**：服务应用自己的 `<name>://` 协议，经字节管道（FD 3/4）把 desktop profile 交给
-host 子进程 [`@morlay/dsh-desktop-host`](../dsh-desktop-host/README.md) 启动，并在首次启动 / 种子指纹变化时把
-profile 种进 `DSH_HOME`。
+dsh 桌面应用的 **Electron 壳**：服务应用自己的 `<name>://` 协议，经字节管道（FD 3/4）把 desktop profile 交给 host 子进程 [`@morlay/dsh-desktop-host`](../dsh-desktop-host/README.md) 启动，并在首次启动 / 种子指纹变化时把 profile 种进 `DSH_HOME`。
+
+## 用法
 
 它**不单独跑**——启动与打包它的是 [`@morlay/dsh-desktopify`](../dsh-desktopify/README.md)：
 
 - `dsh-desktopify dev` 以**本包目录**为 Electron app 启动（Electron 按本包清单的 `main` 找到 `dist/index.mjs`）；
 - `dsh-desktopify bundle` 把本包的 `dist/` 复制成最小壳 app 目录再交给 electron-builder。
 
-边界与拆分理由见[设计 壳独立成包](./.agents/designs/20260924-壳独立成包.md)。
-
-## 出口
-
-| 出口                | 用途                                                                |
-| ------------------- | ------------------------------------------------------------------- |
-| `.`                 | 壳入口（`dist/index.mjs`，Electron 主进程），由 `main` 与它一起指到 |
-| `./appconfig`       | `appconfig.json` 读写与 profile patch 文件名                        |
-| `./dshhome`         | `dshHome` 语义解析（`xdg` / `env` / 路径）                          |
-| `./official`        | 官方包清单与 host 变体包名（壳与工具的同一份事实）                  |
-| `./profile-project` | profile 工程（`pnpm-workspace.yaml`、overrides、清单）              |
-| `./seed`            | 种子布局与指纹                                                      |
-
-后五个是工具侧复用同一份实现的入口——种子、官方包清单、home 解析都只有这一份，壳与 CLI 都引它。
-
-## 依赖边界
-
-壳产物整份进 `app.asar`，那里只有壳自己的字节（`@local/*` 与 `@morlay/dsh-desktop-host` 构建期内联），上游包
-一律留在产物外。因此**壳入口可达的模块只能 import node 内建、`electron` 与那两个内联面**——上游裸引用能过类型
-检查、能打出产物，但装进 asar 后解析不到，只在真机启动时炸。守卫：
-[`shell-import-boundary.spec.ts`](./src/__tests__/shell-import-boundary.spec.ts)。
-
-preload 必须是 CJS（sandboxed preload 的约束），所以它单独一遍构建；壳主进程与它产在同一次 `pnpm build`。
+出口面、依赖边界与拆分理由见[设计 壳独立成包](./.agents/designs/20260924-壳独立成包.md)；传输、启动链与平台标记见[设计 桌面无端口传输与窗口对齐](../dsh-desktopify/.agents/designs/20260920-桌面无端口传输与窗口对齐.md)。

package/dist/{appconfig-B4kozO2F.mjs → appconfig-cvjOFNqE.mjs}

@@ -2,11 +2,6 @@ import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 //#region src/appconfig.ts
 const PROFILE_NAME = "desktop";
-/**
-* profile 自己的 patch 文档名（上游 `PROFILE_PATCH_FILENAME` 的同值）。
-* 常量放在这里而不是 import 上游：`seed.ts` 会被打进壳产物（`app.asar`），
-* 那里解析不到 `@deepseek-ai/*`——上游裸引用会让应用启动即 `ERR_MODULE_NOT_FOUND`。
-*/
 const PROFILE_PATCH_NAME = "cordis.patch.yml";
 function isRecord(value) {
 	return typeof value === "object" && value !== null;

package/dist/appconfig.mjs

@@ -1,2 +1,2 @@
-import { i as writeAppConfig, n as PROFILE_PATCH_NAME, r as loadAppConfig, t as PROFILE_NAME } from "./appconfig-B4kozO2F.mjs";
+import { i as writeAppConfig, n as PROFILE_PATCH_NAME, r as loadAppConfig, t as PROFILE_NAME } from "./appconfig-cvjOFNqE.mjs";
 export { PROFILE_NAME, PROFILE_PATCH_NAME, loadAppConfig, writeAppConfig };

package/dist/{dshhome-C_iyJzc8.mjs → dshhome-Dp89FOr-.mjs}

@@ -7,10 +7,6 @@ function xdgDataHome() {
 	if (configured !== void 0 && configured.trim() !== "") return resolve(configured);
 	return join(homedir(), ".local", "share");
 }
-/**
-* 解析 `dshHome` 的三态：`xdg`（平台数据目录 + app 名）、`env`（交给环境，这里没有具体路径）、
-* 绝对路径。打包壳与 dev CLI（`--home`）共用这一份，措辞与校验只写在这里。
-*/
 function resolveConfiguredHome(name, spec) {
 	if (spec === "env") return void 0;
 	if (spec === "xdg") return join(xdgDataHome(), name);

package/dist/dshhome.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDshHome, r as xdgDataHome, t as resolveConfiguredHome } from "./dshhome-C_iyJzc8.mjs";
+import { n as resolveDshHome, r as xdgDataHome, t as resolveConfiguredHome } from "./dshhome-Dp89FOr-.mjs";
 export { resolveConfiguredHome, resolveDshHome, xdgDataHome };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { r as loadAppConfig } from "./appconfig-B4kozO2F.mjs";
-import { n as resolveDshHome } from "./dshhome-C_iyJzc8.mjs";
-import { t as DESKTOP_HOST_PACKAGE } from "./official-C8RFHQyT.mjs";
-import { a as runtimeOverrides, i as installProfile, o as workspaceWithOverrides, r as PROFILE_WORKSPACE_NAME } from "./profile-project-CEAT8PEX.mjs";
-import { i as ensureSeedProfile, r as SEED_RUNTIME_DIR_NAME } from "./seed-Bg2S14hM.mjs";
+import { r as loadAppConfig } from "./appconfig-cvjOFNqE.mjs";
+import { n as resolveDshHome } from "./dshhome-Dp89FOr-.mjs";
+import { t as DESKTOP_HOST_PACKAGE } from "./official-Cz9Mry1n.mjs";
+import { a as runtimeOverrides, i as installProfile, o as workspaceWithOverrides, r as PROFILE_WORKSPACE_NAME } from "./profile-project-BgQILDbu.mjs";
+import { i as ensureSeedProfile, r as SEED_RUNTIME_DIR_NAME } from "./seed-DEd-kuvi.mjs";
 import { access, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -15,32 +15,21 @@ import { randomBytes } from "node:crypto";
 const DESKTOP_IPC = {
 	directoryPick: "dsh-desktop:directory-pick",
 	nativeThemeSet: "dsh-desktop:native-theme-set",
-	/** 桌面流载体：页面把 Gateway 的流请求交给主进程，主进程用标准 Request 喂宿主。 */
 	streamOpen: "dsh-desktop:stream-open",
 	streamCancel: "dsh-desktop:stream-cancel",
-	/** 逻辑流的上行项（客户端 → 宿主），主进程把它们写成宿主请求体的后续行。 */
 	streamUplink: "dsh-desktop:stream-uplink",
-	/** 上行结束：主进程据此结束宿主请求体。 */
 	streamUplinkEnd: "dsh-desktop:stream-uplink-end",
 	streamChunk: "dsh-desktop:stream-chunk",
 	streamEnd: "dsh-desktop:stream-end",
 	streamError: "dsh-desktop:stream-error",
-	/** 桌面快捷键：设备偏好的读写 / 录制状态（渲染进程 → 主进程）。 */
 	shortcutsGet: "dsh-desktop:shortcuts-get",
 	shortcutsEdit: "dsh-desktop:shortcuts-edit",
 	shortcutsRecording: "dsh-desktop:shortcuts-recording",
 	shortcutsCloseWindow: "dsh-desktop:shortcuts-close-window",
-	/** 命中的原生按键手势（主进程 → 渲染进程）；渲染侧的 native keyboard 适配器消费。 */
 	shortcutsInput: "dsh-desktop:shortcuts-input",
-	/** 配置快照变化（主进程 → 渲染进程）。 */
 	shortcutsChanged: "dsh-desktop:shortcuts-changed"
 };
-/** preload 从渲染进程 argv 里读回 scheme 的参数名（主进程与 preload 共用一份）。 */
 const DESKTOP_SCHEME_ARGUMENT = "--dsh-desktop-scheme";
-/**
-* 应用页面的自定义协议：取 app 工作区 package.json 的 name 派生，避免与官方桌面应用
-* 共用同一个 scheme。去 scope 前缀、转小写、非法字符换成 `-`；派生不出合法 scheme 就报错。
-*/
 function desktopScheme(name) {
 	const bare = name.slice(name.lastIndexOf("/") + 1).toLowerCase().replaceAll(/[^a-z0-9+.-]/gu, "-");
 	if (!/^[a-z][a-z0-9+.-]*$/u.test(bare)) throw new Error(`dsh desktop: application name "${name}" does not yield a usable URL scheme (${bare})`);
@@ -72,23 +61,16 @@ function installDesktopDirectoryPicker(getWindow, scheme) {
 		return result;
 	});
 }
-/** 桌面流的宿主路径：页面/主进程都用它（两侧共享一份，避免路径写两处）。 */
 const DESKTOP_STREAM_PATH = "/.dsh/remote-stream";
-/**
-* 桌面流请求体的首行：定下这条逻辑流的 endpoint 与 payload，后续行都是上行项
-* （客户端 → 宿主；`$events` 这类宿主自己的流被上游释放，不会读到它们）。
-*/
 function encodeDesktopStreamOpen(endpoint, payload) {
 	return `${JSON.stringify({
 		endpoint,
 		payload
 	})}\n`;
 }
-/** 桌面流请求体里的一道上行项。 */
 function encodeDesktopStreamItem(item) {
 	return `${JSON.stringify(item)}\n`;
 }
-/** 单个 data 帧携带的最大原始字节数。 */
 const DESKTOP_PIPE_CHUNK_BYTES = 65536;
 const FRAME_MAGIC = 1146308659;
 const FRAME_HEADER_BYTES = 13;
@@ -125,19 +107,15 @@ function encodeFrame(type, streamId, payload, dataType, direction) {
 function jsonPayload(type, streamId, value, dataType, direction) {
 	return encodeFrame(type, streamId, Buffer.from(JSON.stringify(value), "utf8"), dataType, direction);
 }
-/** 编码开启一个请求流的元数据帧（壳侧）。 */
 function encodeDesktopRequestStart(streamId, request) {
 	return jsonPayload(REQUEST_FRAME_START, streamId, request, REQUEST_FRAME_DATA, "request");
 }
-/** 编码一个受限的请求体原始分片（壳侧）。 */
 function encodeDesktopRequestData(streamId, data) {
 	return encodeFrame(REQUEST_FRAME_DATA, streamId, Buffer.from(data), REQUEST_FRAME_DATA, "request");
 }
-/** 编码请求体正常结束（壳侧）。 */
 function encodeDesktopRequestEnd(streamId) {
 	return encodeFrame(REQUEST_FRAME_END, streamId, Buffer.alloc(0), REQUEST_FRAME_DATA, "request");
 }
-/** 编码取消一个请求及其响应（壳侧）。 */
 function encodeDesktopRequestCancel(streamId) {
 	return encodeFrame(REQUEST_FRAME_CANCEL, streamId, Buffer.alloc(0), REQUEST_FRAME_DATA, "request");
 }
@@ -163,10 +141,8 @@ function parseJson(payload, subject) {
 function assertEmpty(payload, subject) {
 	if (payload.byteLength !== 0) throw new Error(`dsh desktop: ${subject} frame carried a payload`);
 }
-/** 增量解码壳侧从响应管道收到的响应帧。 */
 var DesktopHostResponseDecoder = class {
 	buffer = Buffer.alloc(0);
-	/** 追加字节并返回所有已完整的响应帧。 */
 	push(chunk) {
 		this.buffer = this.buffer.byteLength === 0 ? chunk : Buffer.concat([this.buffer, chunk]);
 		const frames = [];
@@ -176,7 +152,6 @@ var DesktopHostResponseDecoder = class {
 			frames.push(frame);
 		}
 	}
-	/** EOF 落在帧中间时报错。 */
 	finish() {
 		if (this.buffer.byteLength !== 0) throw new Error("dsh desktop: response pipe ended inside a frame");
 	}
@@ -227,7 +202,6 @@ var DesktopHostResponseDecoder = class {
 		return { message: value.message };
 	}
 };
-/** IPC 事件校验（壳侧）。 */
 function isDesktopHostEvent(value) {
 	if (!isRecord(value)) return false;
 	if (value.type === "ready") return value.protocolVersion === 1;
@@ -253,7 +227,6 @@ async function exitsWithin(exit, milliseconds) {
 		if (timer !== void 0) clearTimeout(timer);
 	}
 }
-/** 桌面 host 子进程：字节管道上的请求/响应载体（FD 3/4）+ Node IPC 生命周期。 */
 var DesktopHostProcess = class {
 	node;
 	runtimeDir;
@@ -285,7 +258,6 @@ var DesktopHostProcess = class {
 		this.inspectPort = inspectPort;
 		this.options = options;
 	}
-	/** 启动子进程一次；`ready` 之后才解析。 */
 	async start() {
 		if (this.child !== void 0) return this.readyPromise;
 		const entry = join(this.runtimeDir, "node_modules", ...DESKTOP_HOST_PACKAGE.split("/"), "lib", "index.js");
@@ -377,7 +349,6 @@ var DesktopHostProcess = class {
 		});
 		return this.readyPromise;
 	}
-	/** 把一个应用协议请求（`<scheme>://app/*`）交给子进程，响应体边收边出。 */
 	async fetch(request) {
 		await this.start();
 		const child = this.child;
@@ -419,7 +390,6 @@ var DesktopHostProcess = class {
 			});
 		});
 	}
-	/** 请求优雅退出，再等子进程收尾。 */
 	async stop() {
 		const child = this.child;
 		if (child === void 0) return;
@@ -1206,14 +1176,6 @@ async function writeFileAtomic(filename, content, options) {
 }
 //#endregion
 //#region src/keybindings.ts
-/** 设备本地的快捷键偏好（Electron userData 下）：原子替换、单写者协调。 */
-/**
-* 打开设备配置（原子替换）。
-* @param userData - Electron 的 userData 目录，不接受渲染进程给的路径。
-* @param platform - 本机输入平台。
-* @param publish - 提交后更新原生绑定索引与受信页面。
-* @returns 单写者事务协调器。
-*/
 function desktopKeybindings(userData, platform, publish) {
 	const path = join(userData, "keybindings.json");
 	return new ShortcutPersistence({
@@ -1233,21 +1195,6 @@ function desktopKeybindings(userData, platform, publish) {
 }
 //#endregion
 //#region src/shortcuts.ts
-/**
-* 桌面快捷键的原生侧：设备偏好持久化 + 原生按键转发 + 关闭窗口动作。
-*
-* 上游 `@deepseek-ai/dsh-client-shortcuts` 在 `data-platform` 存在时按 desktop 运行时起服务，
-* 并**强制要求** `window.dshDesktop.keyboard`（缺了就构造失败）——这里就是那份契约的实现：
-* 主进程按已绑定键过滤物理按键，把命中的手势经 IPC 交给渲染进程派发。
-*/
-/**
-* 装上桌面快捷键的原生侧。
-* @param getWindow - 当前主窗口。
-* @param userData - Electron 的 userData 目录。
-* @param platform - 本机输入平台。
-* @param scheme - 产品页面的自定义协议（校验 IPC 来源）。
-* @returns 窗口接入与释放操作。
-*/
 function installDesktopShortcuts(getWindow, userData, platform, scheme) {
 	let definitions = [];
 	let recording = false;
@@ -1454,7 +1401,6 @@ function shellWrappedSpawn(command, args, options) {
 //#endregion
 //#region src/index.ts
 let focusPrimaryWindow = () => {};
-/** appconfig.json 的位置：打包形态只看 resources，dev 形态由 CLI 指到构建目录。 */
 function appConfigDir() {
 	const configured = process.env.DSH_DESKTOP_APPCONFIG_DIR;
 	return app.isPackaged || configured === void 0 || configured === "" ? process.resourcesPath : configured;
@@ -1467,7 +1413,6 @@ function startupFailure(error) {
 	throw error instanceof Error ? error : new Error(message);
 }
 const appConfig = await loadAppConfig(appConfigDir()).catch((error) => startupFailure(error));
-/** 自定义协议取自 app 名：与官方桌面应用（`dsh-app`）错开。 */
 const SCHEME = (() => {
 	try {
 		return desktopScheme(appConfig.name);
@@ -1488,7 +1433,6 @@ protocol.registerSchemesAsPrivileged([{
 }]);
 const WEB_FRONTEND_PACKAGE = "@deepseek-ai/dsh-web-frontend";
 const APPLICATION_URL = `${SCHEME}://app/`;
-/** Windows 自绘标题栏高度（DIP），与 preload 写入的 CSS 变量一致。 */
 const WINDOWS_TITLEBAR_HEIGHT = 40;
 async function pathExists(path) {
 	try {
@@ -1528,7 +1472,6 @@ function developmentProject() {
 	if (app.isPackaged) throw new Error("dsh desktop: development project override is unavailable in packaged applications");
 	return resolve(configured);
 }
-/** 窗口形态：macOS 走 sidebar vibrancy + hiddenInset（交通灯落在侧边栏内），Windows 自绘 caption。 */
 function windowFrame() {
 	if (process.platform === "darwin") return {
 		titleBarStyle: "hiddenInset",
@@ -1666,7 +1609,6 @@ async function main() {
 	let nextStreamId = 1;
 	const streamEncoder = new TextEncoder();
 	const activeStreams = /* @__PURE__ */ new Map();
-	/** 结束宿主请求体：已取消/已结束的流上 close 会抛，这里只当收尾。 */
 	const closeStreamUplink = (stream) => {
 		const uplink = stream.uplink;
 		if (uplink === void 0) return;

package/dist/{official-C8RFHQyT.mjs → official-Cz9Mry1n.mjs}

@@ -1,10 +1,4 @@
 //#region src/official-packages.generated.ts
-/**
-* GENERATED by scripts/gen-official-packages.ts — do not edit by hand.
-* 桌面组合加载的官方插件包：dsh-base 与 dsh-web-app bundle 的 cordis.patch.yml
-* 非禁用条目引用的 @deepseek-ai/* 包（子路径行归到包名）。上游升级后重跑：
-*   pnpm --filter @morlay/dsh-desktop-shell run gen:official-packages
-*/
 const OFFICIAL_PROFILE_PACKAGES = [
 	"@deepseek-ai/cordis-plugin-timer",
 	"@deepseek-ai/dsh-agent",
@@ -28,6 +22,7 @@ const OFFICIAL_PROFILE_PACKAGES = [
 	"@deepseek-ai/dsh-client-hmr",
 	"@deepseek-ai/dsh-client-locale",
 	"@deepseek-ai/dsh-client-modules",
+	"@deepseek-ai/dsh-client-product-analytics",
 	"@deepseek-ai/dsh-client-resources",
 	"@deepseek-ai/dsh-client-shortcuts",
 	"@deepseek-ai/dsh-client-ui-agent-preset",
@@ -59,6 +54,7 @@ const OFFICIAL_PROFILE_PACKAGES = [
 	"@deepseek-ai/dsh-client-ui-settings-models",
 	"@deepseek-ai/dsh-client-ui-settings-plugin-inventory",
 	"@deepseek-ai/dsh-client-ui-settings-plugins",
+	"@deepseek-ai/dsh-client-ui-settings-session-log",
 	"@deepseek-ai/dsh-client-ui-settings-shell",
 	"@deepseek-ai/dsh-client-ui-settings-subagent",
 	"@deepseek-ai/dsh-client-ui-settings-web-search",
@@ -95,6 +91,7 @@ const OFFICIAL_PROFILE_PACKAGES = [
 	"@deepseek-ai/dsh-host-directory-picker-auto",
 	"@deepseek-ai/dsh-host-open-in-app",
 	"@deepseek-ai/dsh-host-plugin-inventory",
+	"@deepseek-ai/dsh-host-product-telemetry-otel",
 	"@deepseek-ai/dsh-host-webserver",
 	"@deepseek-ai/dsh-jobs-local",
 	"@deepseek-ai/dsh-llm",
@@ -105,6 +102,7 @@ const OFFICIAL_PROFILE_PACKAGES = [
 	"@deepseek-ai/dsh-mcp-resources",
 	"@deepseek-ai/dsh-message-feedback",
 	"@deepseek-ai/dsh-office-to-pdf",
+	"@deepseek-ai/dsh-otel",
 	"@deepseek-ai/dsh-permission-presets",
 	"@deepseek-ai/dsh-plugin-manager",
 	"@deepseek-ai/dsh-plugin-package-inventory-deepseek",
@@ -158,7 +156,6 @@ const OFFICIAL_PROFILE_PACKAGES = [
 ];
 //#endregion
 //#region src/official.ts
-/** 工具自带的桌面 host 变体包（不是上游 private 应用）：部署里按这个名字落位，壳按 `<pkg>/lib/index.js` 启动。 */
 const DESKTOP_HOST_PACKAGE = "@morlay/dsh-desktop-host";
 const OFFICIAL_RUNTIME_PACKAGES = [
 	"@deepseek-ai/dsh",

package/dist/official.mjs

@@ -1,2 +1,2 @@
-import { i as OFFICIAL_PROFILE_PACKAGES, n as OFFICIAL_PROFILE_BUNDLES, r as OFFICIAL_RUNTIME_PACKAGES, t as DESKTOP_HOST_PACKAGE } from "./official-C8RFHQyT.mjs";
+import { i as OFFICIAL_PROFILE_PACKAGES, n as OFFICIAL_PROFILE_BUNDLES, r as OFFICIAL_RUNTIME_PACKAGES, t as DESKTOP_HOST_PACKAGE } from "./official-Cz9Mry1n.mjs";
 export { DESKTOP_HOST_PACKAGE, OFFICIAL_PROFILE_BUNDLES, OFFICIAL_PROFILE_PACKAGES, OFFICIAL_RUNTIME_PACKAGES };

package/dist/preload-app.cjs

@@ -1,17 +1,14 @@
 let electron = require("electron");
-/** Web UI 写入的主题来源属性。 */
 const THEME_SOURCE_ATTRIBUTE = "data-ds-theme-source";
 function whenRootReady(root, run) {
 	if (root.documentElement === null) root.defaultView?.addEventListener("DOMContentLoaded", run, { once: true });
 	else run();
 }
-/** 标记页面平台：macOS 布局（侧边栏顶部拖拽条与 logo 下沉）据此启用。 */
 function markDocumentPlatform(platform, root) {
 	whenRootReady(root, () => {
 		root.documentElement.dataset.platform = platform;
 	});
 }
-/** Windows 自绘 caption 标记：布局据此留出标题栏高度、把控制按钮位置让开。 */
 function markWindowsTitlebar(platform, root) {
 	if (platform !== "win32") return;
 	whenRootReady(root, () => {
@@ -19,7 +16,6 @@ function markWindowsTitlebar(platform, root) {
 		root.documentElement.style.setProperty("--dsh-windows-titlebar-height", `${String(40)}px`);
 	});
 }
-/** macOS：把主题来源转发给主进程，窗口 vibrancy 才会跟随应用配色。 */
 function syncNativeTheme(platform, root, send) {
 	if (platform !== "darwin") return;
 	let sent;
@@ -41,31 +37,23 @@ function syncNativeTheme(platform, root, send) {
 const DESKTOP_IPC = {
 	directoryPick: "dsh-desktop:directory-pick",
 	nativeThemeSet: "dsh-desktop:native-theme-set",
-	/** 桌面流载体：页面把 Gateway 的流请求交给主进程，主进程用标准 Request 喂宿主。 */
 	streamOpen: "dsh-desktop:stream-open",
 	streamCancel: "dsh-desktop:stream-cancel",
-	/** 逻辑流的上行项（客户端 → 宿主），主进程把它们写成宿主请求体的后续行。 */
 	streamUplink: "dsh-desktop:stream-uplink",
-	/** 上行结束：主进程据此结束宿主请求体。 */
 	streamUplinkEnd: "dsh-desktop:stream-uplink-end",
 	streamChunk: "dsh-desktop:stream-chunk",
 	streamEnd: "dsh-desktop:stream-end",
 	streamError: "dsh-desktop:stream-error",
-	/** 桌面快捷键：设备偏好的读写 / 录制状态（渲染进程 → 主进程）。 */
 	shortcutsGet: "dsh-desktop:shortcuts-get",
 	shortcutsEdit: "dsh-desktop:shortcuts-edit",
 	shortcutsRecording: "dsh-desktop:shortcuts-recording",
 	shortcutsCloseWindow: "dsh-desktop:shortcuts-close-window",
-	/** 命中的原生按键手势（主进程 → 渲染进程）；渲染侧的 native keyboard 适配器消费。 */
 	shortcutsInput: "dsh-desktop:shortcuts-input",
-	/** 配置快照变化（主进程 → 渲染进程）。 */
 	shortcutsChanged: "dsh-desktop:shortcuts-changed"
 };
-/** preload 从渲染进程 argv 里读回 scheme 的参数名（主进程与 preload 共用一份）。 */
 const DESKTOP_SCHEME_ARGUMENT = "--dsh-desktop-scheme";
 //#endregion
 //#region src/stream-uplink.ts
-/** 造一条上行通道；`send` / `end` 是主进程方向的投递函数。 */
 function createStreamUplink(send, end) {
 	let streamId;
 	let closed = false;
@@ -92,7 +80,6 @@ function createStreamUplink(send, end) {
 }
 //#endregion
 //#region src/preload-app.ts
-/** scheme 取自 app 名，只有主进程知道；sandboxed preload 里只能从 argv 读回。 */
 const scheme = process.argv.find((argument) => argument.startsWith(`${DESKTOP_SCHEME_ARGUMENT}=`))?.slice(21);
 if (scheme !== void 0 && scheme !== "" && location.protocol === `${scheme}:` && location.hostname === "app") {
 	electron.contextBridge.exposeInMainWorld("__DSH_DIRECTORY_PICKER__", { pick: () => electron.ipcRenderer.invoke(DESKTOP_IPC.directoryPick) });

package/dist/{profile-project-CEAT8PEX.mjs → profile-project-BgQILDbu.mjs}

@@ -2,26 +2,10 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { spawn } from "node:child_process";
 //#region src/profile-project.ts
-/** Desktop profile project: the files the seed ships and the package operations the launcher runs on them.
-*
-* 种子里只带 app 自己的 bundle（`file:` 指向随包 `vendor/` 副本）；官方包与 dsh 由不可变的
-* runtime 提供，profile 里对这些包的依赖通过 `overrides` 以 `link:` 指回 runtime，因此安装
-* 不需要 registry，也不复制运行时闭包。
-*/
-/** Profile pnpm settings file the launcher appends run-time `overrides` to. */
 const PROFILE_WORKSPACE_NAME = "pnpm-workspace.yaml";
-/** Seed-written report naming the runtime packages the profile resolves through `overrides`. */
 const PROFILE_RUNTIME_REPORT_NAME = "desktop-runtime-packages.json";
-/** Profile directory holding the `file:` sources of the profile's own bundles. */
 const PROFILE_VENDOR_DIR_NAME = "vendor";
 const TOP_LEVEL_KEY = /^([A-Za-z_][A-Za-z0-9_-]*):(?:[ \t]|$)/u;
-/**
-* Read the seed's runtime package report and point each entry at the installed runtime.
-* @param profileDir - profile directory holding the seed-written report.
-* @param runtimeDir - runtime root the report's paths are relative to.
-* @returns one `link:` override per reported package, in report order.
-* @throws when the report is missing, malformed, or holds an invalid entry.
-*/
 async function runtimeOverrides(profileDir, runtimeDir) {
 	const entries = JSON.parse(await readFile(join(profileDir, PROFILE_RUNTIME_REPORT_NAME), "utf8")).runtimePackages;
 	if (!Array.isArray(entries) || !entries.every(isRuntimePackage)) throw new Error(`dsh desktop: ${PROFILE_RUNTIME_REPORT_NAME} has an invalid runtimePackages list`);
@@ -30,20 +14,11 @@ async function runtimeOverrides(profileDir, runtimeDir) {
 		target: join(runtimeDir, ...entry.path.split("/"))
 	}));
 }
-/** One reported runtime package: its dependency name and its runtime-relative directory. */
 function isRuntimePackage(value) {
 	if (typeof value !== "object" || value === null) return false;
 	const candidate = value;
 	return typeof candidate.name === "string" && candidate.name !== "" && typeof candidate.path === "string" && candidate.path !== "";
 }
-/**
-* Write the runtime overrides into profile pnpm settings, replacing an earlier generation.
-* An empty override list leaves the file untouched, so a hand-edited block survives launches
-* whose seed reported no runtime package.
-* @param text - current profile pnpm settings.
-* @param overrides - runtime packages to link.
-* @returns the settings text to write.
-*/
 function workspaceWithOverrides(text, overrides) {
 	if (overrides.length === 0) return text;
 	const kept = [];
@@ -57,11 +32,6 @@ function workspaceWithOverrides(text, overrides) {
 	const block = ["overrides:", ...overrides.map((entry) => `  ${JSON.stringify(entry.name)}: ${JSON.stringify(`link:${entry.target}`)}`)];
 	return `${[...kept, ...block].join("\n")}\n`;
 }
-/**
-* Install the profile's own bundles offline from the seed's `file:` sources.
-* @param options - bundled executables, profile directory, and process launcher.
-* @throws when pnpm cannot start or exits non-zero, with its diagnostics tail.
-*/
 function installProfile(options) {
 	return new Promise((resolve, reject) => {
 		const child = (options.spawn ?? spawn)(options.node, [

package/dist/profile-project.mjs

@@ -1,2 +1,2 @@
-import { a as runtimeOverrides, i as installProfile, n as PROFILE_VENDOR_DIR_NAME, o as workspaceWithOverrides, r as PROFILE_WORKSPACE_NAME, t as PROFILE_RUNTIME_REPORT_NAME } from "./profile-project-CEAT8PEX.mjs";
+import { a as runtimeOverrides, i as installProfile, n as PROFILE_VENDOR_DIR_NAME, o as workspaceWithOverrides, r as PROFILE_WORKSPACE_NAME, t as PROFILE_RUNTIME_REPORT_NAME } from "./profile-project-BgQILDbu.mjs";
 export { PROFILE_RUNTIME_REPORT_NAME, PROFILE_VENDOR_DIR_NAME, PROFILE_WORKSPACE_NAME, installProfile, runtimeOverrides, workspaceWithOverrides };

package/dist/{seed-Bg2S14hM.mjs → seed-DEd-kuvi.mjs}

@@ -1,10 +1,9 @@
-import { n as PROFILE_PATCH_NAME, t as PROFILE_NAME } from "./appconfig-B4kozO2F.mjs";
+import { n as PROFILE_PATCH_NAME, t as PROFILE_NAME } from "./appconfig-cvjOFNqE.mjs";
 import { access, chmod, copyFile, lstat, mkdir, readFile, readdir, readlink, rm, symlink, unlink, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 //#region src/seed.ts
 const SEED_DIR_NAME = "dsh-home";
 const SEED_HASH_NAME = ".seed-hash";
-/** Seed-relative directory holding the immutable runtime: the host's dsh installation and the Web frontend. */
 const SEED_RUNTIME_DIR_NAME = "runtime";
 const SEED_SKIP_DIRS = /* @__PURE__ */ new Set([
 	".nub-store",
@@ -58,10 +57,6 @@ async function ensureSeedProfile(seedDir, home) {
 	}
 	return true;
 }
-/**
-* Plant one profile subtree. The seed's runtime lives beside the profile and stays in the
-* application's read-only resources, so only `profiles/<name>` is copied into the home.
-*/
 async function copySeed(source, target) {
 	await mkdir(target, { recursive: true });
 	const visit = async (directory, prefix) => {

package/dist/seed.mjs

@@ -1,2 +1,2 @@
-import { i as ensureSeedProfile, n as SEED_HASH_NAME, r as SEED_RUNTIME_DIR_NAME, t as SEED_DIR_NAME } from "./seed-Bg2S14hM.mjs";
+import { i as ensureSeedProfile, n as SEED_HASH_NAME, r as SEED_RUNTIME_DIR_NAME, t as SEED_DIR_NAME } from "./seed-DEd-kuvi.mjs";
 export { SEED_DIR_NAME, SEED_HASH_NAME, SEED_RUNTIME_DIR_NAME, ensureSeedProfile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-desktop-shell",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Electron shell for dsh desktop apps: serves the app's own <name>:// scheme, boots the desktop profile through the @morlay/dsh-desktop-host child over byte pipes, and installs the profile seed on first launch. The CLI that packages a workspace around it is @morlay/dsh-desktopify.",
   "keywords": [
     "desktop",
@@ -35,17 +35,17 @@
     "electron": "^44.3.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-atomic-write": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-shortcuts": "0.1.7-rc.2",
+    "@deepseek-ai/dsh": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-atomic-write": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.0-rc.1",
     "@local/devkit": "0.1.0",
-    "@morlay/dsh-desktop-host": "0.2.0",
+    "@morlay/dsh-desktop-host": "0.2.2",
     "@types/node": "^26.5.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-atomic-write": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-shortcuts": "^0.1.7-rc.2"
+    "@deepseek-ai/dsh-atomic-write": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-shortcuts": "^0.2.0-rc.1"
   },
   "engines": {
     "node": ">=24.11.0"