dsh-single-terminal 0.1.3 → 0.1.4

package/README.md

@@ -43,18 +43,25 @@ see [preview.md](preview.md).
 
 ## Features
 
-- **Header entry** (`conversation.session.header.utilities`): a panel-bottom
-  icon button in the session header's utilities row toggles
-  the drawer. Hovering shows a bubble tooltip (the host `Tooltip` component)
-  with the shortcut; `Alt+C` toggles from anywhere except while typing inside
-  the terminal (there `Alt+C` is passed to the shell as `ESC c`).
+- **Drawer-handle entry** (rendered inside the drawer in `shell.overlay`): a
+  `>_` prompt tab stuck to the drawer's top-right outer edge — the terminal's
+  entry button. It rides the drawer's own slide animation: expanded it sticks
+  to the terminal's top-right corner like a drawer handle; minimized it settles
+  at the page's bottom-right corner. Clicking toggles the drawer; `Alt+C`
+  toggles from anywhere except while typing inside the terminal (there `Alt+C`
+  is passed to the shell as `ESC c`).
+- **Invisible session bridge** (`conversation.session.header.utilities`): a
+  `null`-rendering component that only syncs the current session's workspace
+  root into the controller (so new terminals start there); the header shows no
+  visible UI for this plugin.
 - **Drawer** (`shell.overlay`): a frame-level bottom drawer with
   - a tab strip — one PTY session per tab, independent shells, close button
     per tab (terminates the whole process tree; the pid is verified gone),
-  - a `＋` button (new tab with the default shell) and a `▸` menu
-    (all shells found on this machine; unavailable ones are not listed),
+  - one `＋` button whose dropdown lists all shells found on this machine
+    (unavailable ones are not listed), the default shell pinned first and
+    marked,
   - a mode switch (*Docked* / *Overlay*), a connection status dot and a
-    collapse button,
+    minimize (`−`) button,
   - a drag handle on the top edge (pointer-capture drag, min 140px).
 - **Docked mode** pushes the app frame up with `padding-bottom` on the frame
   root element (no host hook exists for bottom docks); when the anchor cannot
@@ -83,7 +90,8 @@ profile `cordis.patch.yml`:
             args: []
 ```
 
-- `defaultShell` — shell used by the `＋` button; when unavailable it falls
+- `defaultShell` — shell preselected in the `＋` dropdown (pinned first and
+  marked "Default"); when unavailable it falls
   back (`powershell` on Windows, `$SHELL`/`bash` on POSIX).
 - `defaultCwd` — start directory when there is no workspace context: `home`
   (default) starts in the user home; `workspace` is reserved (currently
@@ -157,7 +165,7 @@ pnpm run verify        # simulate the host seed table to check lib/client.js loa
 ```
 ├── src/                # Source
 │   ├── host/           # Host half: index.ts (entry, ws route + config), hub.ts (session hub + frame protocol), shells.ts (registry + probing), types.ts
-│   └── client/         # Browser half: plugin.tsx (slots), drawer.tsx, term.tsx, controller.ts, ws.ts, styles.ts, theme.ts, toggle.tsx, i18n.ts ...
+│   └── client/         # Browser half: plugin.tsx (slots), drawer.tsx (drawer + entry handle), term.tsx, controller.ts, ws.ts, styles.ts, theme.ts, scope.tsx (session bridge), i18n.ts ...
 ├── lib/                # Build artifacts (committed: git installs need no build)
 │   ├── index.js        # Host half (tsdown, ESM)
 │   ├── client.js       # Browser half (tsdown → __ModuleLoader__ factory, xterm inlined)
@@ -211,4 +219,5 @@ pnpm run verify        # simulate the host seed table to check lib/client.js loa
   a translucent terminal background under the frosted blur in every mode —
   the WebGL addon was removed rather than swapped at runtime.
 - **The official `deepseek-harness` project is not modified**; all UI sits in
-  existing slots (`shell.overlay`, `conversation.session.header.utilities`).
+  existing slots (`shell.overlay` for the drawer and its entry handle,
+  `conversation.session.header.utilities` for the invisible session bridge).

package/README.zh.md

@@ -32,17 +32,20 @@ Web 应用底部挂一条交互式 PTY 终端（xterm.js）——可以正常敲
 
 ## 功能
 
-- **会话头部入口**（`conversation.session.header.utilities`）：会话头部
-  utilities 区的「底部面板」(panel-bottom) 图标按钮，点击开合抽屉；悬停显示
-  宿主 `Tooltip`
-  气泡（含快捷键提示）。`Alt+C` 全局开合抽屉；焦点在终端输入区内时放行
-  （`Alt+C` 作为 `ESC c` 发给 shell）。
+- **抽屉把手入口**（渲染在 `shell.overlay` 的抽屉内部）：`>_` 提示符小标签
+  吸附在抽屉右上角外沿——即终端入口按钮。它随抽屉自身的滑动动画移动：
+  展开时像抽屉把手一样吸附在终端右上角；最小化后落在页面右下角。点击开合
+  抽屉；`Alt+C` 全局开合，焦点在终端输入区内时放行（`Alt+C` 作为 `ESC c`
+  发给 shell）。
+- **隐形会话桥**（`conversation.session.header.utilities`）：渲染 null 的
+  组件，只负责把当前会话的工作区根目录同步给 controller（新建终端落在该
+  目录）；会话头部不显示本插件任何可见 UI。
 - **抽屉**（`shell.overlay`）：frame 级底部抽屉，包含
   - 标签条 —— 每标签一条独立 PTY 会话，可独立选择 shell；每标签有关闭按钮
     （终止整棵进程树，已实测 pid 消失）；
-  - `＋` 按钮（默认 shell 新建标签）与 `▸` 菜单（列出本机探测到的全部 shell，
-    不可用的不显示）；
-  - 模式切换（占高度 / 浮层）、连接状态点、收起按钮；
+  - 单一 `＋` 按钮 —— 下拉列出本机探测到的全部 shell（不可用的不显示），
+    默认 shell 置顶并标记；
+  - 模式切换（占高度 / 浮层）、连接状态点、最小化（`−`）按钮；
   - 顶边拖拽条（pointer capture 拖拽，最小 140px）。
 - **占高度模式** 通过对框架根元素设 `padding-bottom` 把内容顶起（宿主没有底部
   停靠钩子）；找不到锚点元素时静默降级为浮层。
@@ -70,8 +73,8 @@ Schemastery `Config`（宿主 Plugins 设置页自动渲染），和 / 或 profi
             args: []
 ```
 
-- `defaultShell` —— `＋` 按钮使用的 shell；不可用时自动回退（Windows 回退
-  `powershell`，POSIX 回退 `$SHELL`/`bash`）。
+- `defaultShell` —— `＋` 下拉菜单中预选的 shell（置顶并标记「默认」）；不可用
+  时自动回退（Windows 回退 `powershell`，POSIX 回退 `$SHELL`/`bash`）。
 - `defaultCwd` —— 无工作区上下文时的启动目录：`home`（默认）从用户主目录启动；
   `workspace` 预留（当前等同 home）；绝对路径必须存在。当前会话归属工作区时
   优先使用工作区根目录（见上）。
@@ -137,7 +140,7 @@ pnpm run verify        # 模拟宿主 seed 表检查 lib/client.js 可加载
 ```
 ├── src/                # 源码
 │   ├── host/           # 宿主半边：index.ts（入口，ws 路由 + 配置）、hub.ts（会话 Hub + 帧协议）、shells.ts（注册表 + 探测）、types.ts
-│   └── client/         # 浏览器半边：plugin.tsx（slots）、drawer.tsx、term.tsx、controller.ts、ws.ts、styles.ts、theme.ts、toggle.tsx、i18n.ts ...
+│   └── client/         # 浏览器半边：plugin.tsx（slots）、drawer.tsx（抽屉 + 入口把手）、term.tsx、controller.ts、ws.ts、styles.ts、theme.ts、scope.tsx（会话桥）、i18n.ts ...
 ├── lib/                # 构建产物（入库：git 安装无需本地构建）
 │   ├── index.js        # 宿主半边（tsdown，ESM）
 │   ├── client.js       # 浏览器半边（tsdown → __ModuleLoader__ 工厂，xterm 已内联）
@@ -183,4 +186,5 @@ pnpm run verify        # 模拟宿主 seed 表检查 lib/client.js 可加载
   WebGL canvas 不支持 alpha）。两种模式共用磨砂样式，因此统一保持 DOM 渲染器 +
   半透明终端背景置于磨砂模糊之上——不做运行时渲染器切换，WebGL 插件已移除。
 - **不修改官方 `deepseek-harness` 项目**；全部 UI 落在既有插槽
-  （`shell.overlay`、`conversation.session.header.utilities`）。
+  （抽屉与其入口把手在 `shell.overlay`，隐形会话桥在
+  `conversation.session.header.utilities`）。

package/lib/client.js

@@ -6,7 +6,6 @@ var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).expor
 //#endregion
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
-let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 //#region src/client/storage.ts
 /**
 * dsh-single-terminal —— 浏览器侧 UI 状态持久化（localStorage，JSON 容错）。
@@ -376,8 +375,9 @@ const DICT = {
 		"terminal.title": "终端",
 		"terminal.toggleTip": "打开终端面板 Alt+C",
 		"terminal.new": "新建终端",
+		"terminal.defaultShell": "默认",
 		"terminal.closeTab": "关闭终端",
-		"terminal.closeDrawer": "收起抽屉",
+		"terminal.minimize": "最小化",
 		"terminal.mode.dock": "占高度",
 		"terminal.mode.overlay": "浮层",
 		"terminal.mode.toggle": "切换抽屉模式",
@@ -386,7 +386,7 @@ const DICT = {
 		"terminal.status.reconnecting": "重连中…",
 		"terminal.status.disconnected": "已断开",
 		"terminal.exited": "已退出",
-		"terminal.empty": "暂无终端会话，点击右上角 + 新建",
+		"terminal.empty": "暂无终端会话，点击 ＋ 新建",
 		"terminal.error.limit": "终端数量已达上限",
 		"terminal.error.spawn": "终端启动失败"
 	},
@@ -394,8 +394,9 @@ const DICT = {
 		"terminal.title": "Terminal",
 		"terminal.toggleTip": "Open terminal panel Alt+C",
 		"terminal.new": "New terminal",
+		"terminal.defaultShell": "Default",
 		"terminal.closeTab": "Close terminal",
-		"terminal.closeDrawer": "Collapse drawer",
+		"terminal.minimize": "Minimize",
 		"terminal.mode.dock": "Docked",
 		"terminal.mode.overlay": "Overlay",
 		"terminal.mode.toggle": "Toggle drawer mode",
@@ -7850,9 +7851,27 @@ function TerminalView(props) {
 *   模式只决定停靠行为，样式两种模式统一（磨砂半透明，见 styles.ts）；
 * - 顶部拖拽条调高度（pointer capture + 帧节流），localStorage 持久化 mode/height；
 * - 组件常挂载（关闭时 transform 滑出 + visibility 隐藏，布局不变），保证
-*   xterm 缓冲与会话不因抽屉开合丢失；开合动画见 styles.ts。
+*   xterm 缓冲与会话不因抽屉开合丢失；开合动画见 styles.ts；
+* - 终端入口按钮 = 抽屉把手（.dst-entry，见 styles.ts）：挂在抽屉内、贴在抽屉
+*   右上角外沿，随抽屉一同滑动——展开时吸附在终端右上角，收起后停在页面
+*   右下角（把手覆写 visibility，收起后仍可见可点）。
 */
 const HEIGHT_MIN = 140;
+/** 终端提示符图标（>_）：填充路径，与宿主图标同风格（currentColor、直角）。 */
+const TERMINAL_PROMPT_PATH = "M2.2 3 L8.2 8 L2.2 13 L2.2 10.9 L5.7 8 L2.2 5.1 Z M9 11.6 H13.8 V13.4 H9 Z";
+function TerminalIcon(props) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+		width: props.size ?? 16,
+		height: props.size ?? 16,
+		viewBox: "0 0 16 16",
+		fill: "none",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+			d: TERMINAL_PROMPT_PATH,
+			fill: "currentColor"
+		})
+	});
+}
 function findFrameElement() {
 	const frame = document.querySelector("[data-shell-overlay]")?.parentElement;
 	return frame instanceof HTMLElement ? frame : null;
@@ -7884,12 +7903,17 @@ function TerminalDrawer() {
 		const onPointerDown = (event) => {
 			if (menuRef.current !== null && !menuRef.current.contains(event.target)) setMenuOpen(false);
 		};
+		const onKeyDown = (event) => {
+			if (event.key === "Escape") setMenuOpen(false);
+		};
 		document.addEventListener("pointerdown", onPointerDown);
+		document.addEventListener("keydown", onKeyDown);
 		return () => {
 			document.removeEventListener("pointerdown", onPointerDown);
+			document.removeEventListener("keydown", onKeyDown);
 		};
 	}, [menuOpen]);
-	const availableShells = state.shells.filter((shell) => shell.available);
+	const menuShells = [...state.shells.filter((shell) => shell.available)].sort((a, b) => (a.id === state.defaultShell ? -1 : 0) - (b.id === state.defaultShell ? -1 : 0));
 	const startDrag = (event) => {
 		event.preventDefault();
 		const handle = event.currentTarget;
@@ -7916,6 +7940,16 @@ function TerminalDrawer() {
 		className: `dst-drawer${state.open ? " open" : ""}`,
 		style: { "--dst-height": `${state.height}px` },
 		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: "dst-entry",
+				"aria-label": state.open ? t("terminal.minimize") : t("terminal.toggleTip"),
+				title: state.open ? t("terminal.minimize") : t("terminal.toggleTip"),
+				onClick: () => {
+					terminal.toggle();
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TerminalIcon, { size: 16 })
+			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "dst-drag",
 				onPointerDown: startDrag,
@@ -7967,51 +8001,48 @@ function TerminalDrawer() {
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								style: { position: "relative" },
 								ref: menuRef,
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-										className: "dst-iconbtn",
-										onClick: () => {
-											terminal.newTerminal(state.defaultShell);
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									className: "dst-iconbtn",
+									"aria-haspopup": "menu",
+									"aria-expanded": menuOpen,
+									onClick: () => {
+										setMenuOpen((open) => !open);
+									},
+									title: t("terminal.new"),
+									children: "＋"
+								}), menuOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dst-menu",
+									role: "menu",
+									children: [menuShells.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: "dst-menuitem",
+										style: {
+											cursor: "default",
+											opacity: .6
 										},
-										title: `${t("terminal.new")}（${availableShells.find((shell) => shell.id === state.defaultShell)?.name ?? state.defaultShell}）`,
-										children: "＋"
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-										className: "dst-iconbtn",
-										style: { width: 18 },
+										children: "—"
+									}), menuShells.map((shell) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+										type: "button",
+										role: "menuitem",
+										className: "dst-menuitem",
 										onClick: () => {
-											setMenuOpen((open) => !open);
+											setMenuOpen(false);
+											terminal.newTerminal(shell.id);
 										},
-										title: t("terminal.new"),
-										children: "▸"
-									}),
-									menuOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-										className: "dst-menu",
-										children: [availableShells.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-											className: "dst-menuitem",
-											style: {
-												cursor: "default",
-												opacity: .6
-											},
-											children: "—"
-										}), availableShells.map((shell) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-											className: "dst-menuitem",
-											onClick: () => {
-												setMenuOpen(false);
-												terminal.newTerminal(shell.id);
-											},
-											children: shell.name
-										}, shell.id))]
-									})
-								]
+										children: [shell.name, shell.id === state.defaultShell && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "dst-menudfl",
+											children: t("terminal.defaultShell")
+										})]
+									}, shell.id))]
+								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								className: "dst-iconbtn",
 								onClick: () => {
 									terminal.setOpen(false);
 								},
-								title: t("terminal.closeDrawer"),
-								children: "▾"
+								title: t("terminal.minimize"),
+								"aria-label": t("terminal.minimize"),
+								children: "−"
 							})
 						]
 					})
@@ -8040,6 +8071,33 @@ function TerminalDrawer() {
 	});
 }
 //#endregion
+//#region src/client/scope.tsx
+/**
+* dsh-single-terminal —— 会话作用域桥（conversation.session.header.utilities 插槽）。
+*
+* 终端入口按钮已移入抽屉（drawer.tsx 的 .dst-entry 把手：吸附抽屉右上角，
+* 收起后落在页面右下角），会话头部不再渲染可见 UI。这里保留一个渲染 null
+* 的不可见锚点组件：借助会话作用域标准 props（sessionId + 全局
+* useWorkspaces）解析当前会话归属的工作区根目录并同步给 controller，让新建
+* 终端（含自动新建）落在工作区路径。渲染 null 后 utilities 容器命中宿主
+* `.headerUtilities:empty { display: none }` 规则，头部不留空位。
+*/
+const noWorkspaces = () => null;
+function SessionWorkspaceBridge(props) {
+	const { sessionId, useWorkspaces = noWorkspaces } = props;
+	const workspacePath = useWorkspaces((snapshot) => {
+		if (sessionId === void 0) return null;
+		return snapshot.items.find((row) => row.sessionIds.includes(sessionId))?.path ?? null;
+	});
+	(0, react.useEffect)(() => {
+		terminal.setWorkspaceCwd(workspacePath);
+		return () => {
+			terminal.setWorkspaceCwd(null);
+		};
+	}, [workspacePath]);
+	return null;
+}
+//#endregion
 //#region src/client/xterm-css.ts
 /**
 * xterm.css（@xterm/xterm 5.x 自带样式）· 生成期内嵌。
@@ -8276,6 +8334,7 @@ const XTERM_CSS = `/**
 * alpha canvas，WebGL 已移除）。开合动画走 transform 滑出 +
 * visibility（布局常驻，xterm 不因开合重排），曲线用宿主
 * --ds-ease-in-out / --ds-transition-duration-slow，并尊重系统减动效设置。
+* 终端入口按钮为吸附抽屉右上角的把手（.dst-entry），随抽屉滑动。
 */
 const DRAWER_CSS = `
 .dst-drawer {
@@ -8364,7 +8423,7 @@ const DRAWER_CSS = `
 }
 .dst-modebtn:hover { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }
 .dst-menu {
-  position: absolute; right: 8px; bottom: 44px; min-width: 170px;
+  position: absolute; right: 0; bottom: calc(100% + 6px); min-width: 170px;
   background: var(--dsw-specific-menu); border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px;
   padding: 4px; z-index: 10; box-shadow: 0 8px 24px rgba(0, 0, 0, 0.3);
 }
@@ -8375,6 +8434,8 @@ const DRAWER_CSS = `
   cursor: pointer; text-align: left;
 }
 .dst-menuitem:hover { background: var(--dsw-alias-interactive-bg-hover); }
+/* 默认 shell 标记：菜单项右端的浅色小字。 */
+.dst-menudfl { margin-left: auto; padding-left: 16px; opacity: 0.55; font-size: 11px; }
 /* 终端区不带背景：直接透出抽屉容器的磨砂底色，与头部一致。 */
 .dst-body { flex: 1; min-height: 0; position: relative; padding: 2px 6px 6px; }
 /* 半透明底（合成层）使浏览器放弃亚像素抗锯齿、字形偏细；用 currentColor 细描边
@@ -8393,13 +8454,36 @@ const DRAWER_CSS = `
   color: var(--dsw-alias-state-error-primary); font-size: 12px;
   overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
 }
-.dst-headbtn {
-  display: inline-flex; align-items: center; justify-content: center;
-  width: 26px; height: 26px; padding: 0;
-  border: none; border-radius: 6px; background: transparent;
-  color: inherit; cursor: pointer;
+/* 终端入口按钮 = 抽屉把手：贴在抽屉右上角外沿（bottom: 100%），随抽屉的
+   transform 一同滑动——展开时吸附在终端右上角，收起后停在 frame 右下角。
+   抽屉收起态整树 visibility: hidden，这里显式覆写 visible，保证收起后把手
+   仍可见可点（visibility 的子树覆写语义）。背景与抽屉同为磨砂半透明，
+   收起时浮在页面内容之上；底部无边框，与抽屉顶边框线自然闭合。 */
+.dst-entry {
+  position: absolute;
+  right: 12px;
+  bottom: 100%;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 26px;
+  padding: 0;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-bottom: none;
+  border-radius: 8px 8px 0 0;
+  background: color-mix(in srgb, var(--dsw-alias-bg-layer-1) 75%, transparent);
+  -webkit-backdrop-filter: blur(22px) saturate(1.4);
+  backdrop-filter: blur(22px) saturate(1.4);
+  color: var(--dsw-alias-label-secondary);
+  cursor: pointer;
+  visibility: visible;
+  z-index: 2;
+}
+.dst-entry:hover {
+  background: color-mix(in srgb, var(--dsw-alias-bg-layer-1) 92%, transparent);
+  color: var(--dsw-alias-label-primary);
 }
-.dst-headbtn:hover, .dst-headbtn.active { background: var(--dsw-alias-interactive-bg-active); }
 `;
 let injected = false;
 function injectStyles() {
@@ -8411,69 +8495,14 @@ function injectStyles() {
 	document.head.appendChild(style);
 }
 //#endregion
-//#region src/client/toggle.tsx
-/**
-* dsh-single-terminal —— 会话头部开关按钮（conversation.session.header.utilities 插槽）。
-*
-* 图标为 panel-bottom（面板底部条填充）样式：横长矩形（16×12，高 < 宽）、
-* 直角无圆角，与宿主图标同风格（currentColor 填充）；hover 气泡用宿主
-* Tooltip（label 传 thunk，气泡显示时求值，语言切换即生效）。
-*
-* 会话作用域标准 props 带 sessionId 与全局 useWorkspaces：据此解析当前会话
-* 归属的工作区根目录并同步给 controller，让新建终端自动落在工作区路径。
-*/
-const noWorkspaces = () => null;
-/** 外框 16×12（y 2→14）+ 上部镂空窗（壁 1.4），底部条 4.2 填充；全部直角。 */
-const PANEL_BOTTOM_PATH = "M0 2 H16 V14 H0 Z M1.4 3.4 H14.6 V9.8 H1.4 Z";
-function PanelBottomIcon(props) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
-		width: props.size ?? 16,
-		height: props.size ?? 16,
-		viewBox: "0 0 16 16",
-		fill: "none",
-		"aria-hidden": "true",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
-			d: PANEL_BOTTOM_PATH,
-			fillRule: "evenodd",
-			clipRule: "evenodd",
-			fill: "currentColor"
-		})
-	});
-}
-function TerminalToggle(props) {
-	const state = useDrawerState();
-	const { sessionId, useWorkspaces = noWorkspaces } = props;
-	const workspacePath = useWorkspaces((snapshot) => {
-		if (sessionId === void 0) return null;
-		return snapshot.items.find((row) => row.sessionIds.includes(sessionId))?.path ?? null;
-	});
-	(0, react.useEffect)(() => {
-		terminal.setWorkspaceCwd(workspacePath);
-		return () => {
-			terminal.setWorkspaceCwd(null);
-		};
-	}, [workspacePath]);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-		label: () => t("terminal.toggleTip"),
-		side: "bottom",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-			type: "button",
-			className: `dst-headbtn${state.open ? " active" : ""}`,
-			"aria-label": t("terminal.toggleTip"),
-			onClick: () => {
-				terminal.toggle();
-			},
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PanelBottomIcon, { size: 16 })
-		})
-	});
-}
-//#endregion
 //#region src/client/plugin.tsx
 /**
 * dsh-single-terminal —— 浏览器半边插件主体（slots 注册）。
 *
-* - shell.overlay：底部终端抽屉；
-* - conversation.session.header.utilities：会话头部开关按钮（宿主 Tooltip 气泡）；
+* - shell.overlay：底部终端抽屉（抽屉右上角外沿吸附终端入口把手，收起后
+*   把手落在页面右下角）；
+* - conversation.session.header.utilities：不可见的会话作用域桥（渲染 null，
+*   只同步当前会话的工作区 cwd，头部无可见 UI）；
 * - Alt+C 快捷键开关抽屉（ctx.effect 挂窗级监听，卸载自动清理；焦点在终端
 *   输入区时放行，让 shell 收到 ESC c 而不误触）；
 * - 语言跟随宿主 locale 服务（软依赖，缺失时回退 en）。
@@ -8505,9 +8534,9 @@ function createPlugin() {
 			}, TerminalDrawer));
 			slots.inject("conversation.session.header.utilities", () => slots.register({
 				name: "conversation.session.header.utilities",
-				id: "dsh-single-terminal-toggle",
+				id: "dsh-single-terminal-scope",
 				order: 100
-			}, TerminalToggle));
+			}, SessionWorkspaceBridge));
 			ctx.effect(() => {
 				const onKeyDown = (event) => {
 					if (!event.altKey || event.ctrlKey || event.metaKey || event.code !== "KeyC") return;