@deepseek-ai/dsh-client-ui-open-in-app 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,40 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-open-in-app/README.md
-README.md: 138be128c291fc4a0611295c54768a95f33f3ae1
-README.zh.md: b81f62f9dbf8ccfbc1822b8a72df95e7169228c0
+/:
+  en: be11314755d8f4f9
+  zh: dd75b03074eea543
+/deepseek-ai-dsh-client-ui-open-in-app:
+  en: 004b805ac638e884
+  zh: 6ac98df58affefcf
+/deepseek-ai-dsh-client-ui-open-in-app/summary:
+  en: e69e4c6df4ddffa1
+  zh: d1ef0a722f48e9bd
+/deepseek-ai-dsh-client-ui-open-in-app/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 725b47765ee8f30b
+/deepseek-ai-dsh-client-ui-open-in-app/use-this-package:
+  en: 056e2bd9e3c78dd8
+  zh: be35d2ba53be0442
+/deepseek-ai-dsh-client-ui-open-in-app/use-this-package/what-to-expect:
+  en: c93c175a3583820a
+  zh: fa812b70176d3d60
+/deepseek-ai-dsh-client-ui-open-in-app/understand-the-implementation:
+  en: c8ac8873c45eb568
+  zh: fd623c411f79d90f
+/deepseek-ai-dsh-client-ui-open-in-app/further-exploration:
+  en: 9deb509f65b6edfd
+  zh: d6cd63b2abc3731b
+/deepseek-ai-dsh-client-ui-open-in-app/model-experience:
+  en: 5f9e6e0fb0438628
+  zh: fc9a81185ea6cb14
+/deepseek-ai-dsh-client-ui-open-in-app/model-experience/kv-cache-effect:
+  en: ca75c51c89c2c9b0
+  zh: c2241315dc0c89c9
+/deepseek-ai-dsh-client-ui-open-in-app/known-limitations-and-deferred-work:
+  en: 3d77fca62d3c8e86
+  zh: 3125d32a158e690a
+/deepseek-ai-dsh-client-ui-open-in-app/known-limitations-and-deferred-work/dev-note:
+  en: 739fd95270d14d0a
+  zh: d5a6b59133ac6b3f

package/README.md

@@ -31,7 +31,9 @@ Mount this plugin in the Web composition beside [`dsh-host-open-in-app`](../../h
 
 The Session header and document header use the same 24px-high split button with 9px corners. Both headers show only the icon; their tooltip names the default application or the reveal action. Both show the default action’s icon, mark its application with “(default)” in the menu, disable while their own gesture runs, and report failures through a transient toast. The directory adapter uses the existing cross-platform application catalog and remembers the last successful choice in `dsh.open-in-app.choice`; a missing choice falls back to the first available application.
 
-File menus list the discovered associated applications without a separate “Open in default app” row. “Show file location” stays in a fixed footer separated from the scrolling applications. A successful query with only one available action renders a single button without a dropdown. Initial file-association loading uses a gray skeleton icon. When no default application is identified, that row reads “Show file location (default)” and the main button reveals the file. Directory menus have no reveal row. Choosing a file application does not change the system default. An unpreviewable file uses the same menu in a 40px-high split button with an icon and action text; its label is “Open” or “Show file location” according to the default action.
+The **Open locally** shortcut captures the main Session's directory and the same remembered application as the header button. The effective binding appears in the button tooltip and `aria-keyshortcuts`; Web follows the [shortcut service’s platform defaults](../shortcuts/README.md). The command runs only while the Conversation is selected and the header button has a directory and installed application to open. An in-flight launch also blocks the command. Pointer and keyboard gestures share the controller's launch state, so repeated gestures cannot launch twice or change the remembered choice mid-launch.
+
+File menus list the discovered associated applications without a separate “Open in default app” row. “Show file location” stays in a fixed footer separated from the scrolling applications. A successful query with only one available action renders a single button without a dropdown. Initial file-association loading uses a gray skeleton icon. When the Host identifies a default application the menu marks it “(default)” and the main button opens it; otherwise the first associated application takes that place, so the main button reveals the file only when no application is registered. Directory menus have no reveal row. Choosing a file application does not change the system default. An unpreviewable file uses the same menu in a 40px-high split button with an icon and action text; its label is “Open” or “Show file location” according to the default action.
 
 Mounted controls with the same association reader and file share one query and its results; opening either menu refreshes all of them. Releasing the last control cancels the query and discards its state. Cancelled queries cannot replace another file’s results. A failed query displays a menu message and leaves reveal available as the default action. File-association discovery follows [native-command](../../util/native-command/README.md); an empty result, including a platform without a discovery adapter, uses the same reveal fallback without platform branches in the control.
 
@@ -43,7 +45,7 @@ Mounted controls with the same association reader and file share one query and i
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-The plugin registers the split button on `conversation.session.header.utilities` through the standard slot/inject currency and registers the `open-in-app` dictionaries as one effect. A page-lifetime controller ([`src/client/controller.ts`](src/client/controller.ts)) owns the once-per-page availability read, the persisted choice snapshot store, and the launch POST; the component receives both stores through the inject `hooks` compartment, so every Session header shares one truth. Document-relative route forms and wire payload types come from the host package's browser-safe `@deepseek-ai/dsh-host-open-in-app/shared` subpath. In-flight launches are guarded by a ref — repeat clicks and menu picks during a launch are ignored whole (a pick would otherwise persist a choice the gesture never opened) — and the busy/error dress is timer-driven around the `launch` promise.
+The plugin registers the split button on `conversation.session.header.utilities` through the standard slot/inject currency and registers the `open-in-app` dictionaries as one effect. A page-lifetime controller ([`src/client/controller.ts`](src/client/controller.ts)) owns the once-per-page availability read, the persisted choice snapshot store, and the launch POST; the component receives the shared sources through the inject `hooks` compartment, so every Session header shares one truth. Document-relative route forms and wire payload types come from the host package's browser-safe `@deepseek-ai/dsh-host-open-in-app/shared` subpath. The controller guards in-flight launches and publishes their captured directory and status; header controls derive delayed busy and transient error visuals from that source.
 
 The directory and file adapters supply application metadata and operations to [`OpenTargetButton`](src/client/OpenTargetButton.tsx), which owns menu ordering, default markers, icons, sizing, and gesture feedback. The file header and empty state share `FileOpenTarget`, while `OpenPathInjected.applications` queries `session.workspacePathApplications` through [`open-path.ts`](src/client/open-path.ts). Opening uses `session.openWorkspacePath`; the Host revalidates an explicitly selected handler before launch. The directory adapter keeps the existing catalog routes. `FileRouteAction` supplies the same control to delivery cards and change review through `deliverables.file.actions` and `deliverables.review.file.actions`; their authenticated routes retain Session file authorization. A failed or unavailable file query therefore needs no platform-specific UI implementation.
 

package/README.zh.md

@@ -31,7 +31,9 @@ kind: "package-reference"
 
 会话标题栏和文档标题栏共用同一个高 24px、圆角 9px 的分体按钮。两个标题栏都只显示图标，悬停提示显示默认应用名称或文件定位动作。两者都显示默认动作的图标，在菜单的默认应用后标注“（默认）”，仅在自己的操作执行期间禁用，并通过短暂提示报告失败。目录适配器使用已有的跨平台应用列表，将最后一次成功选择保存在 `dsh.open-in-app.choice` 中；原选择不可用时回退到第一个可用应用。
 
-文件菜单列出已发现的关联应用，不单列“用默认应用打开”。“显示文件位置”固定在菜单底部，通过分隔线与滚动的应用列表分开。查询成功且只有一个可用操作时显示单按钮，不再显示下拉箭头。文件关联首次加载时使用灰色骨架图标。未识别到默认应用时，该项显示为“显示文件位置（默认）”，主按钮也执行文件定位。目录菜单不包含定位项。选择文件应用不修改系统默认应用。无法预览文件时，空态使用同一菜单，按钮增大到 40px 高并显示图标和动作文字；根据默认动作显示“打开”或“显示文件位置”。
+**在本地打开**快捷键捕获主会话的目录，并使用与头部按钮相同的已记住应用。按钮 tooltip 和 `aria-keyshortcuts` 显示当前有效绑定；Web 遵循[快捷键服务的平台默认值](../shortcuts/README.zh.md)。只有选中会话界面、且头部按钮有可打开的目录和已安装应用时，命令才执行。启动尚未结束时也会阻止命令。鼠标与键盘操作共享 controller 的启动状态，重复操作不会启动两次，也不会在启动期间更改已记住的选择。
+
+文件菜单列出已发现的关联应用，不单列“用默认应用打开”。“显示文件位置”固定在菜单底部，通过分隔线与滚动的应用列表分开。查询成功且只有一个可用操作时显示单按钮，不再显示下拉箭头。文件关联首次加载时使用灰色骨架图标。Host 识别出默认应用时，菜单将该项标注为“（默认）”，主按钮打开该应用；否则第一个关联应用占据该位置，只有在一个关联应用都没有时主按钮才执行文件定位。目录菜单不包含定位项。选择文件应用不修改系统默认应用。无法预览文件时，空态使用同一菜单，按钮增大到 40px 高并显示图标和动作文字；根据默认动作显示“打开”或“显示文件位置”。
 
 使用同一查询函数和文件的已挂载控件共用查询与结果，打开任一菜单会刷新所有相关控件。最后一个控件释放后取消查询并清除状态。已取消的查询不会覆盖其他文件的结果。查询失败时菜单显示提示，并以文件定位作为默认动作。文件关联查询的平台支持范围见 [native-command](../../util/native-command/README.zh.md)；查询结果为空时，包括平台尚无查询适配器的情况，控件统一使用定位动作，不按操作系统分支处理。
 
@@ -43,7 +45,7 @@ kind: "package-reference"
 <details>
 <summary>实现内幕——点击展开</summary>
 
-插件通过标准 slot/inject 机制把分体按钮注册到 `conversation.session.header.utilities`，并以一个 effect 注册 `open-in-app` 词典。一个页面生命周期的 controller（[`src/client/controller.ts`](src/client/controller.ts)）拥有每页一次的可用性读取、持久化选择的 snapshot store 与启动 POST；组件经 inject 的 `hooks` 隔间接收两个 store，因此所有会话头部共享同一份事实。文档相对的路由形式与 wire 载荷类型来自主机包的浏览器安全子路径 `@deepseek-ai/dsh-host-open-in-app/shared`。飞行中的启动由 ref 守卫——启动期间的重复点击与菜单选择被整体忽略（否则会持久化一个该手势从未打开的选择）——busy/error 视觉由围绕 `launch` promise 的定时器驱动。
+插件通过标准 slot/inject 机制把分体按钮注册到 `conversation.session.header.utilities`，并以一个 effect 注册 `open-in-app` 词典。一个页面生命周期的 controller（[`src/client/controller.ts`](src/client/controller.ts)）拥有每页一次的可用性读取、持久化选择的 snapshot store 与启动 POST；组件经 inject 的 `hooks` 隔间接收共享源，因此所有会话头部共享同一份事实。文档相对的路由形式与 wire 载荷类型来自主机包的浏览器安全子路径 `@deepseek-ai/dsh-host-open-in-app/shared`。controller 守卫执行中的启动，并发布所捕获的目录与状态；头部控件从该源派生延迟出现的等待态和短暂错误态。
 
 目录和文件适配器把应用信息与操作交给 [`OpenTargetButton`](src/client/OpenTargetButton.tsx)，由它统一管理菜单顺序、默认标记、图标、尺寸和操作反馈。文件标题栏和空态共用 `FileOpenTarget`，`OpenPathInjected.applications` 通过 [`open-path.ts`](src/client/open-path.ts) 查询 `session.workspacePathApplications`。打开操作使用 `session.openWorkspacePath`，Host 在启动前重新验证指定的关联应用。`FileRouteAction` 通过 `deliverables.file.actions` 和 `deliverables.review.file.actions` 为交付卡片和变更对比页提供同一控件，其认证路由保留会话文件校验。目录适配器继续使用已有的应用列表路由，文件查询失败或不可用时无需增加平台专用的界面实现。
 

package/lib/client.js

@@ -15,6 +15,45 @@ window.__ModuleLoader__.load({
 		/** Browser-relative form of {@link OPEN_IN_APP_OPEN_PATH}. */
 		const OPEN_IN_APP_OPEN_ROUTE = "/open-in-app/open".slice(1);
 		//#endregion
+		//#region lib/types/client/applications.js
+		/** Label keys for applications supported by this client. */
+		const APP_LABEL_KEY = {
+			finder: "app.finder",
+			explorer: "app.explorer",
+			filemanager: "app.filemanager",
+			cursor: "app.cursor",
+			vscode: "app.vscode",
+			vscodeinsiders: "app.vscodeinsiders",
+			windsurf: "app.windsurf",
+			zed: "app.zed",
+			sublimetext: "app.sublimetext",
+			xcode: "app.xcode",
+			androidstudio: "app.androidstudio",
+			intellij: "app.intellij",
+			pycharm: "app.pycharm",
+			webstorm: "app.webstorm",
+			phpstorm: "app.phpstorm",
+			goland: "app.goland",
+			rider: "app.rider",
+			rustrover: "app.rustrover",
+			fork: "app.fork",
+			sourcetree: "app.sourcetree",
+			github: "app.github",
+			tower: "app.tower",
+			gitkraken: "app.gitkraken",
+			smartgit: "app.smartgit",
+			sublimemerge: "app.sublimemerge",
+			ghostty: "app.ghostty",
+			warp: "app.warp",
+			iterm: "app.iterm",
+			kitty: "app.kitty",
+			terminal: "app.terminal",
+			windowsterminal: "app.windowsterminal",
+			gitbash: "app.gitbash",
+			gnometerminal: "app.gnometerminal",
+			konsole: "app.konsole"
+		};
+		//#endregion
 		//#region lib/types/client/controller.js
 		/** Browser availability/choice state and the launch carrier for the split button. */
 		/**
@@ -28,6 +67,20 @@ window.__ModuleLoader__.load({
 			apps = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(null);
 			/** Last chosen app id, or empty before the first choice, shared across sessions and browser restarts. */
 			choice = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)("", { persist: { name: "dsh.open-in-app.choice" } });
+			/** Current launch, shared by pointer and keyboard gestures. */
+			operation = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
+				phase: "idle",
+				path: null
+			});
+			/**
+			* Resolve the remembered nameable installed application, with the button's first-app fallback.
+			* @returns the installed app id, or undefined while unavailable.
+			*/
+			currentApp() {
+				const apps = (this.apps.getSnapshot() ?? []).filter((id) => APP_LABEL_KEY[id] !== void 0);
+				const choice = this.choice.getSnapshot();
+				return apps.includes(choice) ? choice : apps[0];
+			}
 			loading;
 			/**
 			* @param fetcher - HTTP carrier for the apps read and the launch POST.
@@ -49,25 +102,43 @@ window.__ModuleLoader__.load({
 			* @param appId - catalog id from the availability list.
 			*/
 			choose(appId) {
-				this.choice.set(appId);
+				if (this.operation.getSnapshot().phase !== "busy") this.choice.set(appId);
 			}
 			/**
 			* Launch one installed app on a workspace directory.
 			* @param appId - catalog id from the availability list.
 			* @param path - the session's absolute workspace directory.
+			* Concurrent gestures are ignored until the current Host request settles.
 			* @returns after the host acknowledged the launch; rejects on any failure.
 			*/
 			async launch(appId, path) {
+				if (this.operation.getSnapshot().phase === "busy") return;
+				this.operation.set({
+					phase: "busy",
+					path
+				});
 				const body = {
 					app: appId,
 					path
 				};
-				const response = await this.fetcher(OPEN_IN_APP_OPEN_ROUTE, {
-					method: "POST",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify(body)
-				});
-				if (!response.ok) throw new Error(`open failed: HTTP ${String(response.status)}`);
+				try {
+					const response = await this.fetcher(OPEN_IN_APP_OPEN_ROUTE, {
+						method: "POST",
+						headers: { "content-type": "application/json" },
+						body: JSON.stringify(body)
+					});
+					if (!response.ok) throw new Error(`open failed: HTTP ${String(response.status)}`);
+					this.operation.set({
+						phase: "idle",
+						path
+					});
+				} catch (error) {
+					this.operation.set({
+						phase: "error",
+						path
+					});
+					throw error;
+				}
 			}
 			async run() {
 				let apps = [];
@@ -113,7 +184,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-open-in-app/src/client/OpenTargetButton.module.css.mjs
-		const css = ".OMoRSG_menuAnchor{flex:none;align-self:center;display:inline-flex}.OMoRSG_split{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l4);height:24px;font-family:var(--dsw-font-family);border-radius:9px;align-items:stretch;display:inline-flex;overflow:hidden}.OMoRSG_main,.OMoRSG_chevron{color:var(--dsw-alias-label-primary);white-space:nowrap;cursor:pointer;background:0 0;border:0;justify-content:center;align-items:center;font-size:11px;line-height:16px;display:inline-flex}.OMoRSG_main{gap:4px;padding:3px 5px}.OMoRSG_chevron{border-left:.5px solid var(--dsw-alias-border-l4);color:var(--dsw-alias-label-secondary);padding:3px 4px 3px 3px}.OMoRSG_main:hover:not(:disabled),.OMoRSG_main:focus-visible,.OMoRSG_chevron:hover:not(:disabled),.OMoRSG_chevron:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}.OMoRSG_main:disabled,.OMoRSG_chevron:disabled{cursor:default}.OMoRSG_appIcon{object-fit:contain}.OMoRSG_split[data-size=large]{border-color:var(--dsw-alias-border-l2);border-radius:14px;height:36px}.OMoRSG_split[data-size=large] .OMoRSG_main{gap:6px;padding:6px 14px;font-size:14px}.OMoRSG_split[data-size=large] .OMoRSG_chevron{padding:6px 10px}.OMoRSG_skeleton{background:var(--dsw-alias-interactive-bg-hover);border-radius:3px;flex:none;display:inline-block}";
+		const css = ".OMoRSG_menuAnchor{flex:none;align-self:center;display:inline-flex}.OMoRSG_split{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l4);border-radius:var(--dsw-radius-sm);height:24px;font-family:var(--dsw-font-family);align-items:stretch;display:inline-flex;overflow:hidden}.OMoRSG_main,.OMoRSG_chevron{color:var(--dsw-alias-label-primary);white-space:nowrap;cursor:pointer;background:0 0;border:0;justify-content:center;align-items:center;font-size:11px;line-height:16px;display:inline-flex}.OMoRSG_main{gap:4px;padding:3px 5px}.OMoRSG_chevron{border-left:.5px solid var(--dsw-alias-border-l4);color:var(--dsw-alias-label-secondary);padding:3px 4px 3px 3px}.OMoRSG_main:hover:not(:disabled),.OMoRSG_main:focus-visible,.OMoRSG_chevron:hover:not(:disabled),.OMoRSG_chevron:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}.OMoRSG_main:disabled,.OMoRSG_chevron:disabled{cursor:default}.OMoRSG_appIcon{object-fit:contain}.OMoRSG_split[data-size=large]{border-radius:var(--dsw-radius-md);border-color:var(--dsw-alias-border-l2);height:36px}.OMoRSG_split[data-size=large] .OMoRSG_main{gap:6px;padding:6px 14px;font-size:14px}.OMoRSG_split[data-size=large] .OMoRSG_chevron{padding:6px 10px}.OMoRSG_skeleton{border-radius:var(--dsw-radius-xs);background:var(--dsw-alias-interactive-bg-hover);flex:none;display:inline-block}";
 		const tagId = "@deepseek-ai/dsh-client-ui-open-in-app/OpenTargetButton.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -175,7 +246,8 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
-		* Render identical split buttons for files and directories. File reveal always stays last and becomes the default when no app is selected.
+		* Render identical split buttons for files and directories. File reveal always
+		* stays last; it is the default only when no application is registered.
 		* @param props - target applications, default selection, and operations.
 		* @returns the control and its transient failure feedback.
 		*/
@@ -183,7 +255,7 @@ window.__ModuleLoader__.load({
 			const { applications, defaultId, kind, t } = props;
 			const [menuOpen, setMenuOpen] = (0, react.useState)(false);
 			const { pending, toast, act } = useOpenTargetGesture(props.execute, t);
-			const preferred = applications.find((app) => app.id === defaultId);
+			const preferred = kind === "file" ? applications.find((app) => app.id === defaultId) ?? applications[0] : applications.find((app) => app.id === defaultId);
 			const disabled = pending || props.busy === true || props.loading === true;
 			const hasMenu = props.loading === true || props.failed || applications.length + (kind === "file" ? 1 : 0) > 1;
 			const revealDefault = kind === "file" && preferred === void 0 && props.loading !== true;
@@ -193,7 +265,18 @@ window.__ModuleLoader__.load({
 				act(operation);
 			};
 			const primary = () => {
-				run({ kind: revealDefault ? "reveal" : "default" });
+				if (revealDefault) {
+					run({ kind: "reveal" });
+					return;
+				}
+				if (preferred !== void 0 && preferred.id !== defaultId) {
+					run({
+						kind: "application",
+						id: preferred.id
+					});
+					return;
+				}
+				run({ kind: "default" });
 			};
 			const icon = props.loading === true && preferred === void 0 ? (0, react_jsx_runtime.jsx)("span", {
 				className: OpenTargetButton_module_css_default.skeleton,
@@ -220,7 +303,7 @@ window.__ModuleLoader__.load({
 				items: [...applications.map((app) => ({
 					id: `app:${app.id}`,
 					icon: (0, react_jsx_runtime.jsx)(ApplicationIcon, { source: app.icon }, app.icon),
-					label: app.id === defaultId ? t("path.appDefault", { app: app.name }) : app.name
+					label: app.id === preferred?.id ? t("path.appDefault", { app: app.name }) : app.name
 				})), ...props.failed ? [{
 					id: "unavailable",
 					label: t("path.appsError"),
@@ -246,6 +329,7 @@ window.__ModuleLoader__.load({
 					children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 						portal: true,
 						label: primaryLabel,
+						shortcutKeys: props.shortcut?.keys,
 						side: "bottom",
 						delayMs: 500,
 						children: (0, react_jsx_runtime.jsxs)("button", {
@@ -253,6 +337,7 @@ window.__ModuleLoader__.load({
 							className: OpenTargetButton_module_css_default.main,
 							disabled,
 							"aria-label": props.prominent ? void 0 : primaryLabel,
+							"aria-keyshortcuts": props.shortcut?.aria,
 							"data-open-path-open": kind === "file" && !props.prominent ? "" : void 0,
 							"data-open-path-unpreviewable": props.prominent ? "" : void 0,
 							onClick: primary,
@@ -278,47 +363,6 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/OpenInAppAction.js
 		/**
-		* Label keys per catalog id: the browser renders only ids it can name, so a
-		* host catalog extension without a matching dictionary entry stays invisible
-		* instead of showing a raw id.
-		*/
-		const APP_LABEL_KEY = {
-			finder: "app.finder",
-			explorer: "app.explorer",
-			filemanager: "app.filemanager",
-			cursor: "app.cursor",
-			vscode: "app.vscode",
-			vscodeinsiders: "app.vscodeinsiders",
-			windsurf: "app.windsurf",
-			zed: "app.zed",
-			sublimetext: "app.sublimetext",
-			xcode: "app.xcode",
-			androidstudio: "app.androidstudio",
-			intellij: "app.intellij",
-			pycharm: "app.pycharm",
-			webstorm: "app.webstorm",
-			phpstorm: "app.phpstorm",
-			goland: "app.goland",
-			rider: "app.rider",
-			rustrover: "app.rustrover",
-			fork: "app.fork",
-			sourcetree: "app.sourcetree",
-			github: "app.github",
-			tower: "app.tower",
-			gitkraken: "app.gitkraken",
-			smartgit: "app.smartgit",
-			sublimemerge: "app.sublimemerge",
-			ghostty: "app.ghostty",
-			warp: "app.warp",
-			iterm: "app.iterm",
-			kitty: "app.kitty",
-			terminal: "app.terminal",
-			windowsterminal: "app.windowsterminal",
-			gitbash: "app.gitbash",
-			gnometerminal: "app.gnometerminal",
-			konsole: "app.konsole"
-		};
-		/**
 		* Adapt the installed directory catalog to the shared opening control.
 		* @param props - workspace state, installed catalog, and launch operations.
 		* @returns the shared control, or null without an eligible application and directory.
@@ -328,6 +372,8 @@ window.__ModuleLoader__.load({
 			const cwd = useSessions((state) => state.byId[sessionId]?.cwd);
 			const available = useOpenInAppApps((apps) => apps);
 			const choice = useOpenInAppChoice((id) => id);
+			const operation = props.useOpenInAppLaunch((value) => value);
+			const shortcut = props.useShortcuts((rows) => rows.find((row) => row.id === "workspace.openLocal"));
 			const apps = (available ?? []).flatMap((id) => {
 				const key = APP_LABEL_KEY[id];
 				return key === void 0 ? [] : [{
@@ -344,6 +390,8 @@ window.__ModuleLoader__.load({
 				defaultId: preferred.id,
 				failed: false,
 				t,
+				busy: operation.phase === "busy",
+				shortcut,
 				execute: async (operation) => {
 					const id = operation.kind === "application" ? operation.id : preferred.id;
 					try {
@@ -654,6 +702,9 @@ window.__ModuleLoader__.load({
 			"open.title": "用 {app} 打开",
 			"path.appDefault": "{app}（默认）",
 			"path.appsError": "无法获取应用列表",
+			"shortcut.busy": "正在打开工作区",
+			"shortcut.unavailable": "当前工作区或本地应用不可用",
+			"open.tooltip": "在本地打开",
 			"path.open": "打开",
 			"path.more": "更多打开方式",
 			"path.reveal": "显示文件位置",
@@ -670,6 +721,9 @@ window.__ModuleLoader__.load({
 			"open.title": "Open in {app}",
 			"path.appDefault": "{app} (default)",
 			"path.appsError": "Could not load applications",
+			"shortcut.busy": "Opening workspace",
+			"shortcut.unavailable": "Current workspace or local application unavailable",
+			"open.tooltip": "Open locally",
 			"path.open": "Open",
 			"path.more": "More ways to open",
 			"path.reveal": "Show file location",
@@ -688,13 +742,15 @@ window.__ModuleLoader__.load({
 		* delivery cards, and changed-file review. Directory choices persist in the browser;
 		* file defaults and application lists come from the serving Host desktop.
 		*/
-		/** Required services: sessions, the slot registry, copy, and the Remote carrier with its `session` namespace. */
+		/** Required services: sessions, layout selection, the slot registry, copy, Remote calls, and shortcuts. */
 		const inject = [
 			"sessions",
 			"slots",
 			"locale",
 			"remote",
-			"remote.session"
+			"remote.session",
+			"shortcuts",
+			"layout"
 		];
 		/**
 		* Client plugin body: register the dictionaries, the header split button, and
@@ -709,6 +765,64 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "open-in-app: dictionaries");
+			const t = ctx.locale.bind(NS);
+			const target = () => {
+				if (ctx.layout.panelInfo.getSnapshot().activePanelId !== null) return void 0;
+				const session = Object.values(ctx.sessions.list.getSnapshot().byId).find((row) => (row.retainedBy.mainView ?? 0) > 0);
+				const appId = controller.currentApp();
+				return session?.cwd && appId !== void 0 ? {
+					appId,
+					path: session.cwd
+				} : void 0;
+			};
+			ctx.effect(() => ctx.shortcuts.register({
+				id: "workspace.openLocal",
+				label: () => t("open.tooltip"),
+				aliases: ["open workspace locally", "open in app"],
+				defaults: {
+					"desktop:macos": {
+						code: "KeyO",
+						modifiers: ["primary", "alt"]
+					},
+					"desktop:windows": {
+						code: "KeyO",
+						modifiers: ["primary", "alt"]
+					},
+					"desktop:linux": {
+						code: "KeyO",
+						modifiers: ["primary", "alt"]
+					},
+					"web:macos": {
+						code: "KeyO",
+						modifiers: ["primary", "shift"]
+					},
+					"web:windows": {
+						code: "KeyO",
+						modifiers: ["primary", "shift"]
+					}
+				},
+				regions: ["page", "editable"],
+				modals: [],
+				resolve: () => {
+					if (controller.operation.getSnapshot().phase === "busy") return {
+						status: "blocked",
+						reason: t("shortcut.busy")
+					};
+					const selected = target();
+					if (selected === void 0) return {
+						status: "blocked",
+						reason: t("shortcut.unavailable")
+					};
+					return {
+						status: "handled",
+						run: () => {
+							controller.launch(selected.appId, selected.path).catch((error) => {
+								console.warn("workspace open rejected:", error);
+							});
+						}
+					};
+				}
+			}), "open-in-app: workspace command");
 			ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
 				name: "conversation.session.header.utilities",
 				id: "open-in-app",
@@ -717,7 +831,9 @@ window.__ModuleLoader__.load({
 				inject: () => ({
 					hooks: {
 						openInAppApps: controller.apps,
-						openInAppChoice: controller.choice
+						openInAppChoice: controller.choice,
+						openInAppLaunch: controller.operation,
+						shortcuts: ctx.shortcuts.catalog
 					},
 					launch: (appId, path) => controller.launch(appId, path),
 					choose: (appId) => {

package/lib/types/client/OpenInAppAction.d.ts

@@ -1,11 +1,15 @@
 import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { OpenInAppLaunchState } from './controller.ts';
+import type { ShortcutCatalogEntry } from '@deepseek-ai/dsh-client-shortcuts/client';
 import { NS } from './locales.ts';
 /** Browser operations and state injected into the Session Header contribution. */
 export interface OpenInAppActionInjected {
     hooks: {
         openInAppApps: ObservableSnapshot<readonly string[] | null>;
         openInAppChoice: ObservableSnapshot<string>;
+        openInAppLaunch: ObservableSnapshot<OpenInAppLaunchState>;
+        shortcuts: ObservableSnapshot<readonly ShortcutCatalogEntry[]>;
     };
     launch: (appId: string, path: string) => Promise<void>;
     choose: (appId: string) => void;

package/lib/types/client/OpenTargetButton.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { ShortcutCatalogEntry } from '@deepseek-ai/dsh-client-shortcuts/client';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { OpenInAppPathFailure } from './open-path.ts';
 import type { NS } from './locales.ts';
@@ -19,6 +20,7 @@ export type OpenTargetOperation = {
 };
 /** Inputs shared by both target adapters and the file empty-state action. */
 export interface OpenTargetButtonProps {
+    readonly shortcut?: Pick<ShortcutCatalogEntry, 'keys' | 'aria'> | undefined;
     readonly kind: 'file' | 'directory';
     readonly applications: readonly OpenTargetApplication[];
     readonly defaultId: string | undefined;
@@ -42,7 +44,8 @@ export declare function useOpenTargetGesture(execute: OpenTargetButtonProps['exe
     act: (operation: OpenTargetOperation) => void;
 };
 /**
- * Render identical split buttons for files and directories. File reveal always stays last and becomes the default when no app is selected.
+ * Render identical split buttons for files and directories. File reveal always
+ * stays last; it is the default only when no application is registered.
  * @param props - target applications, default selection, and operations.
  * @returns the control and its transient failure feedback.
  */

package/lib/types/client/applications.d.ts

@@ -0,0 +1,5 @@
+/** Nameable application ids shared by the button and its keyboard command. */
+import type { OpenInAppKey } from './locales.ts';
+/** Label keys for applications supported by this client. */
+export declare const APP_LABEL_KEY: Record<string, OpenInAppKey | undefined>;
+//# sourceMappingURL=applications.d.ts.map

package/lib/types/client/controller.d.ts

@@ -1,5 +1,10 @@
 /** Browser availability/choice state and the launch carrier for the split button. */
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+/** Shared launch status for controls targeting the captured workspace path. */
+export interface OpenInAppLaunchState {
+    readonly phase: 'idle' | 'busy' | 'error';
+    readonly path: string | null;
+}
 type Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
 /**
  * Owns the once-per-page availability read, the persisted last choice, and
@@ -12,6 +17,13 @@ export declare class OpenInAppController {
     readonly apps: SnapshotStore<readonly string[] | null>;
     /** Last chosen app id, or empty before the first choice, shared across sessions and browser restarts. */
     readonly choice: SnapshotStore<string>;
+    /** Current launch, shared by pointer and keyboard gestures. */
+    readonly operation: SnapshotStore<OpenInAppLaunchState>;
+    /**
+     * Resolve the remembered nameable installed application, with the button's first-app fallback.
+     * @returns the installed app id, or undefined while unavailable.
+     */
+    currentApp(): string | undefined;
     private loading;
     /**
      * @param fetcher - HTTP carrier for the apps read and the launch POST.
@@ -32,6 +44,7 @@ export declare class OpenInAppController {
      * Launch one installed app on a workspace directory.
      * @param appId - catalog id from the availability list.
      * @param path - the session's absolute workspace directory.
+     * Concurrent gestures are ignored until the current Host request settles.
      * @returns after the host acknowledged the launch; rejects on any failure.
      */
     launch(appId: string, path: string): Promise<void>;

package/lib/types/client/index.d.ts

@@ -15,7 +15,7 @@ export type { OpenInAppActionInjected, OpenInAppActionProps } from './OpenInAppA
 export type { OpenInAppPathAction, OpenInAppPathFailure, OpenInAppPathRemote } from './open-path.ts';
 export type { OpenPathActionProps, OpenPathInjected } from './OpenPathAction.tsx';
 export type { OpenPathEmptyActionProps } from './OpenPathEmptyAction.tsx';
-/** Required services: sessions, the slot registry, copy, and the Remote carrier with its `session` namespace. */
+/** Required services: sessions, layout selection, the slot registry, copy, Remote calls, and shortcuts. */
 export declare const inject: string[];
 /**
  * Client plugin body: register the dictionaries, the header split button, and

package/lib/types/client/locales.d.ts

@@ -40,6 +40,9 @@ export declare const zh: {
     readonly 'open.title': "用 {app} 打开";
     readonly 'path.appDefault': "{app}（默认）";
     readonly 'path.appsError': "无法获取应用列表";
+    readonly 'shortcut.busy': "正在打开工作区";
+    readonly 'shortcut.unavailable': "当前工作区或本地应用不可用";
+    readonly 'open.tooltip': "在本地打开";
     readonly 'path.open': "打开";
     readonly 'path.more': "更多打开方式";
     readonly 'path.reveal': "显示文件位置";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-open-in-app",
   "description": "Web \"Open In...\" controls: the Session-header split button opening the workspace directory in an installed application, and the document preview's default-application controls for one file",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -38,7 +38,9 @@
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-shortcuts",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-session",
         "@deepseek-ai/dsh-client-ui-sidebar-documentpreview"
@@ -52,23 +54,25 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-native-command": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-deliverables": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-host-open-in-app": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-native-command": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-open-in-app": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-shortcuts": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-deliverables": "0.1.7-rc.2"
   },
   "scripts": {
     "bundle": "tsdown",