diff --git a/src/app/workspace/layout.tsx b/src/app/workspace/layout.tsx
index 8f45055ac4..cef8021bb8 100644
--- a/src/app/workspace/layout.tsx
+++ b/src/app/workspace/layout.tsx
@@ -683,7 +683,7 @@ function MobileFolderWorkspaceShell({
         swipeDirection="down"
         disablePointerDismissal={false}
       >
-        <DrawerContent showCloseButton={false} className="h-[70vh] p-0">
+        <DrawerContent showCloseButton={false} className="h-[95vh] p-0">
           <DrawerTitle className="sr-only">Terminal</DrawerTitle>
           <div className="h-full min-h-0 overflow-hidden">
             <TerminalPanel />
diff --git a/src/components/terminal/term-keybar.test.tsx b/src/components/terminal/term-keybar.test.tsx
new file mode 100644
index 0000000000..1914519299
--- /dev/null
+++ b/src/components/terminal/term-keybar.test.tsx
@@ -0,0 +1,99 @@
+import { fireEvent, render, screen } from "@testing-library/react"
+import { beforeEach, describe, expect, it, vi } from "vitest"
+
+import { TermKeybar } from "./term-keybar"
+
+// next-intl is mocked at module level via vitest config; provide the minimum
+// shape used by `useTranslations` so `t("...")` returns the key path.
+vi.mock("next-intl", () => ({
+  useTranslations: () => (key: string) => key,
+}))
+
+const NO_MODS = { ctrl: false, alt: false }
+
+beforeEach(() => {
+  vi.restoreAllMocks()
+})
+
+describe("<TermKeybar />", () => {
+  it("renders all 12 keys + 2 modifier buttons", () => {
+    render(
+      <TermKeybar mods={NO_MODS} onToggleMod={() => {}} onPressKey={() => {}} />
+    )
+    // Two-row layout, 7 + 7 buttons.
+    const all = screen.getAllByRole("button")
+    expect(all).toHaveLength(14)
+  })
+
+  it("fires onPressKey with the right key on pointerdown, and skips click", () => {
+    const onPressKey = vi.fn()
+    render(
+      <TermKeybar
+        mods={NO_MODS}
+        onToggleMod={() => {}}
+        onPressKey={onPressKey}
+      />
+    )
+
+    // Find the "up" key by its localized label (we mocked useTranslations to
+    // return the key path, so labels are "up", "down", etc.).
+    const upBtn = screen.getByRole("button", { name: "up" })
+    fireEvent.pointerDown(upBtn)
+
+    expect(onPressKey).toHaveBeenCalledTimes(1)
+    expect(onPressKey).toHaveBeenCalledWith("up")
+
+    // Click after pointerdown would double-fire without the swallowClick.
+    fireEvent.click(upBtn)
+    expect(onPressKey).toHaveBeenCalledTimes(1)
+  })
+
+  it("fires onToggleMod('ctrl' | 'alt') on the modifier buttons", () => {
+    const onToggleMod = vi.fn()
+    render(
+      <TermKeybar
+        mods={NO_MODS}
+        onToggleMod={onToggleMod}
+        onPressKey={() => {}}
+      />
+    )
+
+    fireEvent.pointerDown(screen.getByRole("button", { name: "ctrl" }))
+    expect(onToggleMod).toHaveBeenCalledWith("ctrl")
+
+    fireEvent.pointerDown(screen.getByRole("button", { name: "alt" }))
+    expect(onToggleMod).toHaveBeenCalledWith("alt")
+  })
+
+  it("marks CTRL/ALT active when mods prop is true", () => {
+    render(
+      <TermKeybar
+        mods={{ ctrl: true, alt: false }}
+        onToggleMod={() => {}}
+        onPressKey={() => {}}
+      />
+    )
+    // active class includes `bg-primary text-primary-foreground border-primary`
+    const ctrl = screen.getByRole("button", { name: "ctrl" })
+    expect(ctrl.className).toContain("bg-primary")
+
+    // ALT not armed — no accent.
+    const alt = screen.getByRole("button", { name: "alt" })
+    expect(alt.className).not.toContain("bg-primary")
+  })
+
+  it("disables every button when disabled=true", () => {
+    render(
+      <TermKeybar
+        mods={NO_MODS}
+        onToggleMod={() => {}}
+        onPressKey={() => {}}
+        disabled
+      />
+    )
+    const all = screen.getAllByRole("button")
+    for (const btn of all) {
+      expect(btn).toBeDisabled()
+    }
+  })
+})
diff --git a/src/components/terminal/term-keybar.tsx b/src/components/terminal/term-keybar.tsx
new file mode 100644
index 0000000000..b6a641787e
--- /dev/null
+++ b/src/components/terminal/term-keybar.tsx
@@ -0,0 +1,201 @@
+"use client"
+
+import { useTranslations } from "next-intl"
+import type { MouseEvent, PointerEvent } from "react"
+
+import { Button } from "@/components/ui/button"
+import { cn } from "@/lib/utils"
+import { type TermKeyBarKey, type TermMods } from "@/lib/terminal/keybar"
+
+interface TermKeybarProps {
+  /** 当前 CTRL/ALT 闩锁状态（驱动按钮高亮）。 */
+  mods: TermMods
+  /** 切换 CTRL/ALT 闩锁。 */
+  onToggleMod: (mod: "ctrl" | "alt") => void
+  /** 按下普通键（ESC/TAB/方向键 等）——不消费闩锁，由父级在发完字节后复位。 */
+  onPressKey: (key: TermKeyBarKey) => void
+  /** IME 组合进行中时禁用整组按钮（避免送出误触发的控制码）。 */
+  disabled?: boolean
+}
+
+/**
+ * 移动端终端虚拟键栏：两行按钮，覆盖 ESC/TAB/方向键/PgUp/PgDn + CTRL/ALT 闩锁。
+ *
+ * 关键细节：
+ *   · `onPointerDown` 触发 + `preventDefault`：按钮不夺走 xterm helper textarea
+ *     的焦点，软键盘保持弹出。
+ *   · CTRL/ALT 互斥闩锁：armed 状态由父级 state 控制，本组件只渲染高亮。
+ *   · 桌面端由父级用媒体查询（`useMediaQuery("(max-width: 768px)")`）判定，
+ *     此处不再二次过滤，避免 SSR/CSR 不一致导致水合闪烁。
+ */
+export function TermKeybar({
+  mods,
+  onToggleMod,
+  onPressKey,
+  disabled = false,
+}: TermKeybarProps) {
+  const t = useTranslations("Folder.terminal.keybar")
+
+  // onPointerDown handler — preventDefault keeps the soft keyboard open and the
+  // xterm helper textarea focused. Calling preventDefault on the React synthetic
+  // event is enough to suppress the default focus shift; we don't need a native
+  // addEventListener here.
+  const handlePointerDown =
+    (key: TermKeyBarKey) => (e: PointerEvent<HTMLButtonElement>) => {
+      e.preventDefault()
+      onPressKey(key)
+    }
+
+  const handleModPointerDown =
+    (mod: "ctrl" | "alt") => (e: PointerEvent<HTMLButtonElement>) => {
+      e.preventDefault()
+      onToggleMod(mod)
+    }
+
+  // Same handler for click — onPointerDown above already fires the action, so a
+  // click after touchend would re-fire and double the byte. Suppress it.
+  const swallowClick = (e: MouseEvent<HTMLButtonElement>) => {
+    e.preventDefault()
+  }
+
+  return (
+    <div
+      role="toolbar"
+      aria-label={t("label")}
+      className="flex shrink-0 flex-col gap-1.5 border-t pt-1.5 select-none"
+    >
+      <div className="flex gap-1.5">
+        <KeyBtn
+          label={t("esc")}
+          onPointerDown={handlePointerDown("esc")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("slash")}
+          onPointerDown={handlePointerDown("slash")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("dash")}
+          onPointerDown={handlePointerDown("dash")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("home")}
+          onPointerDown={handlePointerDown("home")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("up")}
+          onPointerDown={handlePointerDown("up")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("end")}
+          onPointerDown={handlePointerDown("end")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("pgup")}
+          onPointerDown={handlePointerDown("pgup")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+      </div>
+      <div className="flex gap-1.5">
+        <KeyBtn
+          label={t("tab")}
+          onPointerDown={handlePointerDown("tab")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("ctrl")}
+          active={mods.ctrl}
+          onPointerDown={handleModPointerDown("ctrl")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("alt")}
+          active={mods.alt}
+          onPointerDown={handleModPointerDown("alt")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("left")}
+          onPointerDown={handlePointerDown("left")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("down")}
+          onPointerDown={handlePointerDown("down")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("right")}
+          onPointerDown={handlePointerDown("right")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+        <KeyBtn
+          label={t("pgdn")}
+          onPointerDown={handlePointerDown("pgdn")}
+          onClick={swallowClick}
+          disabled={disabled}
+        />
+      </div>
+    </div>
+  )
+}
+
+interface KeyBtnProps {
+  label: string
+  active?: boolean
+  disabled?: boolean
+  onPointerDown: (e: PointerEvent<HTMLButtonElement>) => void
+  onClick: (e: MouseEvent<HTMLButtonElement>) => void
+}
+
+/**
+ * 键栏单键：
+ *   · `flex-1 min-w-0`：等宽均分剩余空间，超长 label 截断。
+ *   · `active`：CTRL/ALT 闩锁 armed 高亮（accent 背景）。
+ *   · `tabIndex={-1}`：跳过 Tab 焦点环（虚拟键栏不该拦截方向键导航）。
+ */
+function KeyBtn({
+  label,
+  active = false,
+  disabled = false,
+  onPointerDown,
+  onClick,
+}: KeyBtnProps) {
+  return (
+    <Button
+      type="button"
+      tabIndex={-1}
+      variant="outline"
+      size="sm"
+      disabled={disabled}
+      onPointerDown={onPointerDown}
+      onClick={onClick}
+      className={cn(
+        "min-w-0 flex-1 px-1 text-xs font-normal touch-manipulation",
+        "[-webkit-tap-highlight-color:transparent] [transition:transform_0.12s,background-color_0.12s]",
+        "active:scale-95",
+        active && "bg-primary text-primary-foreground border-primary"
+      )}
+    >
+      {label}
+    </Button>
+  )
+}
diff --git a/src/components/terminal/terminal-panel.tsx b/src/components/terminal/terminal-panel.tsx
index 40665ee4e3..1dd81bf685 100644
--- a/src/components/terminal/terminal-panel.tsx
+++ b/src/components/terminal/terminal-panel.tsx
@@ -1,18 +1,66 @@
 "use client"
 
+import { useCallback, useEffect, useState } from "react"
 import { useTerminalContext } from "@/contexts/terminal-context"
+import { useMediaQuery } from "@/hooks/use-media-query"
 import { TerminalTabBar } from "./terminal-tab-bar"
 import { TerminalView } from "./terminal-view"
 
+const KEYBAR_COLLAPSED_STORAGE_KEY = "codeg:term-keybar"
+const MOBILE_BREAKPOINT = "(max-width: 768px)"
+
+/**
+ * 终端面板：顶栏（tab + 折叠键栏开关）+ 所有挂载的 xterm。
+ *
+ * 移动端键栏的可见性在面板层决定：
+ *   · `useMediaQuery` 监听窗口宽度；
+ *   · 折叠态持久化到 localStorage，避免多个终端 tab 各自记一份导致切 tab
+ *     后展开/折叠不一致（与 pios 同样的踩坑修复）。
+ */
 export function TerminalPanel() {
   const { isOpen, tabs, activeTabId, markTerminalExited } = useTerminalContext()
+  const isMobile = useMediaQuery(MOBILE_BREAKPOINT)
+
+  const [keybarCollapsed, setKeybarCollapsed] = useState(() => {
+    if (typeof window === "undefined") return false
+    try {
+      return window.localStorage.getItem(KEYBAR_COLLAPSED_STORAGE_KEY) === "1"
+    } catch {
+      return false
+    }
+  })
+
+  // SSR / 初次客户端渲染时 window.matchMedia 默认 matches=false（test-setup.ts
+  // 的 polyfill），桌面态 hydration 一致后 useMediaQuery 才返回真实值。
+  // localStorage 在 SSR 也是 undefined，所以初次 client render 与 SSR 都
+  // 是「未折叠」——只有用户主动折叠过才改。
+  useEffect(() => {
+    try {
+      window.localStorage.setItem(
+        KEYBAR_COLLAPSED_STORAGE_KEY,
+        keybarCollapsed ? "1" : "0"
+      )
+    } catch {
+      // best effort（隐私模式 / 配额超限时静默放弃）
+    }
+  }, [keybarCollapsed])
+
+  const toggleKeybar = useCallback(() => {
+    setKeybarCollapsed((prev) => !prev)
+  }, [])
+
+  const keybarVisible = isMobile && !keybarCollapsed
 
   return (
     <section
       data-terminal-panel-region="true"
       className="flex h-full min-h-0 flex-col ws-surface"
     >
-      <TerminalTabBar />
+      <TerminalTabBar
+        showKeybarToggle={isMobile}
+        keybarCollapsed={keybarCollapsed}
+        onToggleKeybar={toggleKeybar}
+      />
       <div className="relative flex-1 min-h-0 overflow-hidden">
         {tabs.map((tab) => (
           <TerminalView
@@ -23,6 +71,7 @@ export function TerminalPanel() {
             initialCommand={tab.initialCommand}
             isActive={tab.id === activeTabId}
             isVisible={isOpen}
+            keybarVisible={keybarVisible}
             onProcessExited={markTerminalExited}
           />
         ))}
diff --git a/src/components/terminal/terminal-tab-bar.tsx b/src/components/terminal/terminal-tab-bar.tsx
index 281c8c73ec..63daa7ce15 100644
--- a/src/components/terminal/terminal-tab-bar.tsx
+++ b/src/components/terminal/terminal-tab-bar.tsx
@@ -26,7 +26,20 @@ import {
   TooltipTrigger,
 } from "@/components/ui/tooltip"
 
-export function TerminalTabBar() {
+interface TerminalTabBarProps {
+  /** 移动端折叠/展开键栏的开关。仅 isMobile 时父级才传 true。 */
+  showKeybarToggle?: boolean
+  /** 当前是否已折叠（驱动 ⌨ 按钮的 active 高亮）。 */
+  keybarCollapsed?: boolean
+  /** 点击 ⌨ 按钮的回调。 */
+  onToggleKeybar?: () => void
+}
+
+export function TerminalTabBar({
+  showKeybarToggle = false,
+  keybarCollapsed = false,
+  onToggleKeybar,
+}: TerminalTabBarProps) {
   const t = useTranslations("Folder.terminal")
   const ime = useImeGuard()
   const { shortcuts } = useShortcutSettings()
@@ -156,6 +169,28 @@ export function TerminalTabBar() {
           )}
         </Tooltip>
       </TooltipProvider>
+      {showKeybarToggle && onToggleKeybar && (
+        <TooltipProvider>
+          <Tooltip>
+            <TooltipTrigger asChild>
+              <Button
+                variant="ghost"
+                size="icon"
+                className={`h-6 w-6 shrink-0 ${keybarCollapsed ? "" : "text-primary"}`}
+                onClick={onToggleKeybar}
+                title={keybarCollapsed ? t("keybar.show") : t("keybar.hide")}
+              >
+                <span className="text-[14px] leading-none" aria-hidden>
+                  ⌨
+                </span>
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent side="top">
+              {keybarCollapsed ? t("keybar.show") : t("keybar.hide")}
+            </TooltipContent>
+          </Tooltip>
+        </TooltipProvider>
+      )}
       <Button
         variant="ghost"
         size="icon"
diff --git a/src/components/terminal/terminal-view.tsx b/src/components/terminal/terminal-view.tsx
index e9501011d7..9e5ac1443f 100644
--- a/src/components/terminal/terminal-view.tsx
+++ b/src/components/terminal/terminal-view.tsx
@@ -8,12 +8,20 @@ import {
   terminalResize,
   terminalKill,
 } from "@/lib/api"
-import { createWriteQueue } from "@/lib/terminal/write-queue"
+import { createWriteQueue, type WriteQueue } from "@/lib/terminal/write-queue"
 import { getTerminalTheme } from "@/lib/terminal/theme"
 import {
   copyTerminalSelection,
   isTerminalCopyShortcut,
 } from "@/lib/terminal/shortcuts"
+import {
+  applyTermMods,
+  kbdLiftPx,
+  termKeySeq,
+  type TermKeyBarKey,
+  type TermMods,
+} from "@/lib/terminal/keybar"
+import { TermKeybar } from "@/components/terminal/term-keybar"
 import { useZoomLevel, useTerminalFont } from "@/hooks/use-appearance"
 import { detectPlatform } from "@/hooks/use-platform"
 import type { TerminalEvent } from "@/lib/types"
@@ -64,6 +72,11 @@ interface TerminalViewProps {
   initialCommand?: string
   isActive: boolean
   isVisible: boolean
+  /**
+   * 移动端虚拟键栏可见性。父级基于 `useMediaQuery("(max-width: 768px)")` 判定
+   * 是否折叠；桌面端永远为 false。
+   */
+  keybarVisible?: boolean
   onProcessExited?: (terminalId: string) => void
 }
 
@@ -74,6 +87,7 @@ export function TerminalView({
   initialCommand,
   isActive,
   isVisible,
+  keybarVisible = false,
   onProcessExited,
 }: TerminalViewProps) {
   const containerRef = useRef<HTMLDivElement>(null)
@@ -93,6 +107,80 @@ export function TerminalView({
   const ligaturesAddonRef = useRef<DisposableAddon | null>(null)
   const [loading, setLoading] = useState(true)
 
+  // ---- 移动端虚拟键栏（CTRL/ALT 闩锁 + 软键盘跟随）----
+  // modsRef 是编码真值（xterm.onData 闭包里读它不会过期）；modsUi 只驱动按钮
+  // 高亮。两者经 setMods() 同步，避免 setMods 引用漂移。
+  const [modsUi, setModsUi] = useState<TermMods>({ ctrl: false, alt: false })
+  const modsRef = useRef<TermMods>({ ctrl: false, alt: false })
+  const setMods = (next: TermMods) => {
+    modsRef.current = next
+    setModsUi(next)
+  }
+  // writeQueue 在 init() 里创建，键栏按键也必须走这条队列——否则与软键盘
+  // onData 抢着调 terminalWrite 会让顺序变成不可预期的乱序（FIFO 不再成立）。
+  const writeQueueRef = useRef<WriteQueue | null>(null)
+
+  const toggleMod = (m: "ctrl" | "alt") => {
+    const cur = modsRef.current
+    setMods(
+      m === "ctrl"
+        ? { ctrl: !cur.ctrl, alt: false }
+        : { ctrl: false, alt: !cur.alt }
+    )
+    termRef.current?.focus()
+  }
+
+  const pressKey = (key: TermKeyBarKey) => {
+    const cur = modsRef.current
+    const data = termKeySeq(key, cur)
+    if (cur.ctrl || cur.alt) setMods({ ctrl: false, alt: false }) // 闩锁被消费
+    writeQueueRef.current?.enqueue(data)
+    termRef.current?.focus()
+  }
+
+  // 失活时复位闩锁：避免切走再切回后第一下输入被意外包装成 Ctrl/Alt。
+  useEffect(() => {
+    if (!isActive) setMods({ ctrl: false, alt: false })
+  }, [isActive])
+
+  // ---- 软键盘弹起跟随 ----
+  // 键盘打开时 visualViewport 被压缩：算出底部被遮住的像素数 kbdLift，
+  // 用 max-height 钳制 xterm + 键栏所在的 flex 容器 —— 键栏作为最后一个
+  // flex 子项自然抬到键盘上方；xterm 随容器变小，原有 ResizeObserver 自动
+  // refit + 发 terminal_resize（与 pios 的 drawer 缩高 + fit 同语义）。
+  const [kbdLift, setKbdLift] = useState(0)
+  useEffect(() => {
+    if (!keybarVisible) {
+      setKbdLift(0)
+      return
+    }
+    const vv = window.visualViewport
+    if (!vv) return
+    let raf = 0
+    let last = -1
+    const update = () => {
+      raf = 0
+      const lift = kbdLiftPx(window.innerHeight, vv.height, vv.offsetTop)
+      if (lift !== last) {
+        last = lift
+        setKbdLift(lift)
+      }
+    }
+    const schedule = () => {
+      if (!raf) raf = requestAnimationFrame(update)
+    }
+    vv.addEventListener("resize", schedule)
+    vv.addEventListener("scroll", schedule)
+    window.addEventListener("resize", schedule)
+    update()
+    return () => {
+      if (raf) cancelAnimationFrame(raf)
+      vv.removeEventListener("resize", schedule)
+      vv.removeEventListener("scroll", schedule)
+      window.removeEventListener("resize", schedule)
+    }
+  }, [keybarVisible])
+
   useEffect(() => {
     isActiveRef.current = isActive
     isVisibleRef.current = isVisible
@@ -154,6 +242,8 @@ export function TerminalView({
       // duplicate already-delivered bytes, worse than a drop in a shell. See
       // lib/terminal/write-queue.ts.
       const writeQueue = createWriteQueue((d) => terminalWrite(terminalId, d))
+      // 暴露给键栏按键——必须走这条队列，否则与软键盘输入抢着发会乱序。
+      writeQueueRef.current = writeQueue
 
       // Shell line-editing shortcuts. Sends readline/zle bindings so they
       // work regardless of terminfo.
@@ -216,7 +306,15 @@ export function TerminalView({
         // Some apps toggle focus reporting; don't leak focus in/out sequences
         // into the shell prompt when tabs are switched.
         if (data === "\x1b[I" || data === "\x1b[O") return
-        writeQueue.enqueue(data)
+        // 虚拟键栏闩锁 armed 时包装软键盘输入（CTRL+字母→控制码、ALT→ESC 前缀）
+        const cur = modsRef.current
+        if (cur.ctrl || cur.alt) {
+          const { out, consumed } = applyTermMods(data, cur)
+          if (consumed) setMods({ ctrl: false, alt: false })
+          writeQueue.enqueue(out)
+        } else {
+          writeQueue.enqueue(data)
+        }
       })
 
       // Debounced resize — avoid flooding IPC during drag
@@ -311,6 +409,7 @@ export function TerminalView({
 
       cleanup = () => {
         writeQueue.dispose()
+        writeQueueRef.current = null
         if (resizeTimer) clearTimeout(resizeTimer)
         if (fitTimer) clearTimeout(fitTimer)
         themeObserver.disconnect()
@@ -396,7 +495,32 @@ export function TerminalView({
       }}
       aria-hidden={!isActive}
     >
-      <div ref={containerRef} className="h-full w-full" />
+      {/* xterm + 键栏所在的 flex 列：kbdLift 收缩外层高度，让键栏抬到软键盘上方。
+          keybarVisible 仅移动端为真，桌面端 TermKeybar 内部不渲染。
+          showKeybar 收敛三个条件：移动端命中 + 父级未折叠 + 当前 tab 是活动 tab
+          （否则隐藏 tab 上挂着的死按钮会浪费 DOM 与焦点环）。 */}
+      {(() => {
+        const showKeybar = keybarVisible && isActive && isVisible
+        return (
+          <div
+            className="flex h-full w-full min-h-0 flex-col gap-1"
+            style={
+              showKeybar && kbdLift > 0
+                ? { maxHeight: `calc(100% - ${kbdLift}px)` }
+                : undefined
+            }
+          >
+            <div ref={containerRef} className="min-h-0 flex-1" />
+            {showKeybar && (
+              <TermKeybar
+                mods={modsUi}
+                onToggleMod={toggleMod}
+                onPressKey={pressKey}
+              />
+            )}
+          </div>
+        )
+      })()}
       {loading && isActive && (
         <div className="absolute inset-0 flex items-center justify-center bg-background/80">
           <div className="flex items-center gap-2 text-sm text-muted-foreground">
diff --git a/src/i18n/messages/ar.json b/src/i18n/messages/ar.json
index 622a7892cf..d7ee19baa5 100644
--- a/src/i18n/messages/ar.json
+++ b/src/i18n/messages/ar.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "إغلاق البقية",
       "closeAll": "إغلاق الكل",
       "hideTerminal": "إخفاء الطرفية ({shortcut})",
-      "openFolderFirst": "افتح مجلدا أولا"
+      "openFolderFirst": "افتح مجلدا أولا",
+      "keybar": {
+        "label": "مفاتيح الطرفية الافتراضية",
+        "show": "إظهار المفاتيح الافتراضية",
+        "hide": "إخفاء المفاتيح الافتراضية",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "فتح مجلد",
diff --git a/src/i18n/messages/de.json b/src/i18n/messages/de.json
index f064c3018b..db5ede91ff 100644
--- a/src/i18n/messages/de.json
+++ b/src/i18n/messages/de.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "Andere schließen",
       "closeAll": "Alle schließen",
       "hideTerminal": "Terminal ausblenden ({shortcut})",
-      "openFolderFirst": "Öffnen Sie zuerst einen Ordner"
+      "openFolderFirst": "Öffnen Sie zuerst einen Ordner",
+      "keybar": {
+        "label": "Virtuelle Terminaltasten",
+        "show": "Virtuelle Tasten anzeigen",
+        "hide": "Virtuelle Tasten ausblenden",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "Ordner öffnen",
diff --git a/src/i18n/messages/en.json b/src/i18n/messages/en.json
index f9ca40b375..67723a849b 100644
--- a/src/i18n/messages/en.json
+++ b/src/i18n/messages/en.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "Close Others",
       "closeAll": "Close All",
       "hideTerminal": "Hide Terminal ({shortcut})",
-      "openFolderFirst": "Open a folder first"
+      "openFolderFirst": "Open a folder first",
+      "keybar": {
+        "label": "Terminal virtual keys",
+        "show": "Show virtual keys",
+        "hide": "Hide virtual keys",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "Open Folder",
diff --git a/src/i18n/messages/es.json b/src/i18n/messages/es.json
index 7104bf20d7..919295fcc6 100644
--- a/src/i18n/messages/es.json
+++ b/src/i18n/messages/es.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "Cerrar otros",
       "closeAll": "Cerrar todo",
       "hideTerminal": "Ocultar terminal ({shortcut})",
-      "openFolderFirst": "Abre primero una carpeta"
+      "openFolderFirst": "Abre primero una carpeta",
+      "keybar": {
+        "label": "Teclas virtuales del terminal",
+        "show": "Mostrar teclas virtuales",
+        "hide": "Ocultar teclas virtuales",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "Abrir carpeta",
diff --git a/src/i18n/messages/fr.json b/src/i18n/messages/fr.json
index fd7c47c39c..7723353d2a 100644
--- a/src/i18n/messages/fr.json
+++ b/src/i18n/messages/fr.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "Fermer les autres",
       "closeAll": "Tout fermer",
       "hideTerminal": "Masquer le terminal ({shortcut})",
-      "openFolderFirst": "Ouvrez d'abord un dossier"
+      "openFolderFirst": "Ouvrez d'abord un dossier",
+      "keybar": {
+        "label": "Touches virtuelles du terminal",
+        "show": "Afficher les touches virtuelles",
+        "hide": "Masquer les touches virtuelles",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "Ouvrir un dossier",
diff --git a/src/i18n/messages/ja.json b/src/i18n/messages/ja.json
index 443dd70452..df6d7eaf5d 100644
--- a/src/i18n/messages/ja.json
+++ b/src/i18n/messages/ja.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "他を閉じる",
       "closeAll": "すべて閉じる",
       "hideTerminal": "ターミナルを隠す ({shortcut})",
-      "openFolderFirst": "先にフォルダを開いてください"
+      "openFolderFirst": "先にフォルダを開いてください",
+      "keybar": {
+        "label": "仮想ターミナルキー",
+        "show": "仮想キーを表示",
+        "hide": "仮想キーを隠す",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "フォルダーを開く",
diff --git a/src/i18n/messages/ko.json b/src/i18n/messages/ko.json
index 1e52724fbf..f5d134d362 100644
--- a/src/i18n/messages/ko.json
+++ b/src/i18n/messages/ko.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "다른 항목 닫기",
       "closeAll": "모두 닫기",
       "hideTerminal": "터미널 숨기기 ({shortcut})",
-      "openFolderFirst": "먼저 폴더를 여세요"
+      "openFolderFirst": "먼저 폴더를 여세요",
+      "keybar": {
+        "label": "터미널 가상 키",
+        "show": "가상 키 표시",
+        "hide": "가상 키 숨기기",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "폴더 열기",
diff --git a/src/i18n/messages/pt.json b/src/i18n/messages/pt.json
index bba6e70a26..4c79ca74a6 100644
--- a/src/i18n/messages/pt.json
+++ b/src/i18n/messages/pt.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "Fechar outros",
       "closeAll": "Fechar tudo",
       "hideTerminal": "Ocultar terminal ({shortcut})",
-      "openFolderFirst": "Abra primeiro uma pasta"
+      "openFolderFirst": "Abra primeiro uma pasta",
+      "keybar": {
+        "label": "Teclas virtuais do terminal",
+        "show": "Mostrar teclas virtuais",
+        "hide": "Ocultar teclas virtuais",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "Abrir pasta",
diff --git a/src/i18n/messages/zh-CN.json b/src/i18n/messages/zh-CN.json
index c2a8ba7b7a..bac2027af3 100644
--- a/src/i18n/messages/zh-CN.json
+++ b/src/i18n/messages/zh-CN.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "关闭其它",
       "closeAll": "关闭所有",
       "hideTerminal": "隐藏终端（{shortcut}）",
-      "openFolderFirst": "请先打开一个文件夹"
+      "openFolderFirst": "请先打开一个文件夹",
+      "keybar": {
+        "label": "终端虚拟键",
+        "show": "显示虚拟键",
+        "hide": "隐藏虚拟键",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "打开文件夹",
diff --git a/src/i18n/messages/zh-TW.json b/src/i18n/messages/zh-TW.json
index 62610d2b7d..2246b00e4d 100644
--- a/src/i18n/messages/zh-TW.json
+++ b/src/i18n/messages/zh-TW.json
@@ -2053,7 +2053,26 @@
       "closeOthers": "關閉其它",
       "closeAll": "關閉所有",
       "hideTerminal": "隱藏終端（{shortcut}）",
-      "openFolderFirst": "請先開啟一個資料夾"
+      "openFolderFirst": "請先開啟一個資料夾",
+      "keybar": {
+        "label": "終端虛擬鍵",
+        "show": "顯示虛擬鍵",
+        "hide": "隱藏虛擬鍵",
+        "esc": "ESC",
+        "tab": "TAB",
+        "ctrl": "CTRL",
+        "alt": "ALT",
+        "slash": "/",
+        "dash": "—",
+        "home": "HOME",
+        "end": "END",
+        "pgup": "PGUP",
+        "pgdn": "PGDN",
+        "up": "↑",
+        "down": "↓",
+        "left": "←",
+        "right": "→"
+      }
     },
     "workspaceDialog": {
       "title": "開啟資料夾",
diff --git a/src/lib/terminal/keybar.test.ts b/src/lib/terminal/keybar.test.ts
new file mode 100644
index 0000000000..fac0b1bd80
--- /dev/null
+++ b/src/lib/terminal/keybar.test.ts
@@ -0,0 +1,144 @@
+import { describe, expect, it } from "vitest"
+
+import {
+  applyTermMods,
+  kbdLiftPx,
+  TERM_KEYBAR_SEQ,
+  termKeySeq,
+  type TermMods,
+} from "./keybar"
+
+const OFF: TermMods = { ctrl: false, alt: false }
+
+describe("termKeySeq 基础序列", () => {
+  it("无修饰符时返回原样转义序列", () => {
+    expect(termKeySeq("esc", OFF)).toBe("\x1b")
+    expect(termKeySeq("tab", OFF)).toBe("\t")
+    expect(termKeySeq("slash", OFF)).toBe("/")
+    expect(termKeySeq("dash", OFF)).toBe("-")
+    expect(termKeySeq("home", OFF)).toBe("\x1b[H")
+    expect(termKeySeq("end", OFF)).toBe("\x1b[F")
+    expect(termKeySeq("pgup", OFF)).toBe("\x1b[5~")
+    expect(termKeySeq("pgdn", OFF)).toBe("\x1b[6~")
+    expect(termKeySeq("up", OFF)).toBe("\x1b[A")
+    expect(termKeySeq("down", OFF)).toBe("\x1b[B")
+    expect(termKeySeq("left", OFF)).toBe("\x1b[D")
+    expect(termKeySeq("right", OFF)).toBe("\x1b[C")
+  })
+
+  it("序列表完整覆盖 12 个键", () => {
+    expect(Object.keys(TERM_KEYBAR_SEQ).sort()).toEqual(
+      [
+        "dash",
+        "down",
+        "end",
+        "esc",
+        "home",
+        "left",
+        "pgdn",
+        "pgup",
+        "right",
+        "slash",
+        "tab",
+        "up",
+      ].sort()
+    )
+  })
+})
+
+describe("termKeySeq 闩锁修饰", () => {
+  it("Ctrl+方向键 = ESC[1;5X", () => {
+    expect(termKeySeq("up", { ctrl: true, alt: false })).toBe("\x1b[1;5A")
+    expect(termKeySeq("down", { ctrl: true, alt: false })).toBe("\x1b[1;5B")
+    expect(termKeySeq("right", { ctrl: true, alt: false })).toBe("\x1b[1;5C")
+    expect(termKeySeq("left", { ctrl: true, alt: false })).toBe("\x1b[1;5D")
+  })
+
+  it("Alt+方向键 = ESC[1;3X；Ctrl+Alt = ESC[1;7X", () => {
+    expect(termKeySeq("left", { ctrl: false, alt: true })).toBe("\x1b[1;3D")
+    expect(termKeySeq("up", { ctrl: true, alt: true })).toBe("\x1b[1;7A")
+  })
+
+  it("Home/End 带修饰符走 CSI 1;<m>H/F", () => {
+    expect(termKeySeq("home", { ctrl: true, alt: false })).toBe("\x1b[1;5H")
+    expect(termKeySeq("end", { ctrl: false, alt: true })).toBe("\x1b[1;3F")
+  })
+
+  it("PgUp/PgDn 带修饰符走 ~ 族", () => {
+    expect(termKeySeq("pgup", { ctrl: true, alt: false })).toBe("\x1b[5;5~")
+    expect(termKeySeq("pgdn", { ctrl: false, alt: true })).toBe("\x1b[6;3~")
+    expect(termKeySeq("pgdn", { ctrl: true, alt: true })).toBe("\x1b[6;7~")
+  })
+
+  it("esc/tab/slash/dash 无通用 ctrl 形态：ctrl 原样、alt 走 meta 前缀", () => {
+    expect(termKeySeq("esc", { ctrl: true, alt: false })).toBe("\x1b")
+    expect(termKeySeq("slash", { ctrl: true, alt: false })).toBe("/")
+    expect(termKeySeq("dash", { ctrl: true, alt: false })).toBe("-")
+    expect(termKeySeq("tab", { ctrl: false, alt: true })).toBe("\x1b\t")
+    expect(termKeySeq("esc", { ctrl: false, alt: true })).toBe("\x1b\x1b")
+  })
+})
+
+describe("applyTermMods 软键盘闩锁包装", () => {
+  it("未 armed 时原样透传、不消费", () => {
+    const r = applyTermMods("abc", OFF)
+    expect(r.out).toBe("abc")
+    expect(r.consumed).toBe(false)
+  })
+
+  it("CTRL+小写字母 → 控制码（a→0x01 … z→0x1a）", () => {
+    expect(applyTermMods("c", { ctrl: true, alt: false }).out).toBe("\x03")
+    expect(applyTermMods("d", { ctrl: true, alt: false }).out).toBe("\x04")
+    expect(applyTermMods("l", { ctrl: true, alt: false }).out).toBe("\x0c")
+    expect(applyTermMods("z", { ctrl: true, alt: false }).out).toBe("\x1a")
+  })
+
+  it("CTRL+大写字母同样按字母处理", () => {
+    expect(applyTermMods("C", { ctrl: true, alt: false }).out).toBe("\x03")
+  })
+
+  it("CTRL 只包装首字符，其余保持原样（粘贴串）", () => {
+    expect(applyTermMods("abc", { ctrl: true, alt: false }).out).toBe("\x01bc")
+  })
+
+  it("CTRL+非字母原样透传（仍消费闩锁）", () => {
+    const r = applyTermMods("1", { ctrl: true, alt: false })
+    expect(r.out).toBe("1")
+    expect(r.consumed).toBe(true)
+  })
+
+  it("ALT+输入 → 前缀 ESC", () => {
+    const r = applyTermMods("b", { ctrl: false, alt: true })
+    expect(r.out).toBe("\x1bb")
+    expect(r.consumed).toBe(true)
+  })
+
+  it("空输入不消费闩锁", () => {
+    const r = applyTermMods("", { ctrl: true, alt: false })
+    expect(r.out).toBe("")
+    expect(r.consumed).toBe(false)
+  })
+})
+
+describe("kbdLiftPx 软键盘遮挡估算", () => {
+  it("键盘弹出：overlap = innerHeight - vv.height - offsetTop", () => {
+    // 844 屏，键盘 300px，无页面平移
+    expect(kbdLiftPx(844, 544, 0)).toBe(300)
+    // iOS 把页面上推（offsetTop>0）：遮挡减少相应的量
+    expect(kbdLiftPx(844, 544, 100)).toBe(200)
+  })
+
+  it("键盘收起：overlap ≈ 0 → 返回 0", () => {
+    expect(kbdLiftPx(844, 844, 0)).toBe(0)
+    expect(kbdLiftPx(844, 850, 0)).toBe(0) // 反向异常也夹到 0
+  })
+
+  it("小于 80px 的抖动（地址栏收起等）不算键盘，返回 0", () => {
+    expect(kbdLiftPx(844, 814, 0)).toBe(0)
+    expect(kbdLiftPx(844, 764, 0)).toBe(80) // 恰好 80px 达标
+  })
+
+  it("小数四舍五入", () => {
+    expect(kbdLiftPx(844.4, 514.2, 0.2)).toBe(330)
+  })
+})
diff --git a/src/lib/terminal/keybar.ts b/src/lib/terminal/keybar.ts
new file mode 100644
index 0000000000..211fa19a7e
--- /dev/null
+++ b/src/lib/terminal/keybar.ts
@@ -0,0 +1,114 @@
+/**
+ * 终端虚拟键栏（移动端）纯函数：键栏按键 → PTY 字节序列 + CTRL/ALT 闩锁包装。
+ *
+ * 序列规则对齐服务端 terminals.ts 的 encodeTerminalKey：
+ *   · 方向键/Home/End 带修饰符 → xterm 修饰序列 ESC[1;<m>X（Ctrl+↑=ESC[1;5A）
+ *   · PgUp/PgDn 带修饰符      → ESC[5;<m>~ / ESC[6;<m>~
+ *   · 修饰参数 m = 1 + (alt?2:0) + (ctrl?4:0)
+ *
+ * 闩锁语义：CTRL/ALT 是一次性粘滞键——点一下 armed（按钮高亮，互斥），下一个
+ * 输入（软键盘 onData 或键栏按键）被包装后自动弹起：
+ *   · CTRL + 软键盘字母 → 控制码（a→\x01 … z→\x1a，覆盖 Ctrl+C/D/L/R…）
+ *   · ALT  + 软键盘输入 → 前缀 ESC（meta）
+ */
+
+export type TermKeyBarKey =
+  | "esc"
+  | "tab"
+  | "slash"
+  | "dash"
+  | "home"
+  | "end"
+  | "pgup"
+  | "pgdn"
+  | "up"
+  | "down"
+  | "left"
+  | "right"
+
+/** CTRL/ALT 闩锁状态（键栏按钮高亮与编码共用）。 */
+export interface TermMods {
+  ctrl: boolean
+  alt: boolean
+}
+
+/** 无修饰符时的基础序列。 */
+export const TERM_KEYBAR_SEQ: Record<TermKeyBarKey, string> = {
+  esc: "\x1b",
+  tab: "\t",
+  slash: "/",
+  dash: "-",
+  home: "\x1b[H",
+  end: "\x1b[F",
+  pgup: "\x1b[5~",
+  pgdn: "\x1b[6~",
+  up: "\x1b[A",
+  down: "\x1b[B",
+  left: "\x1b[D",
+  right: "\x1b[C",
+}
+
+function modParam(mods: TermMods): number {
+  return 1 + (mods.alt ? 2 : 0) + (mods.ctrl ? 4 : 0)
+}
+
+/** 键栏按键编码（不消费闩锁——由调用方在发送后复位）。 */
+export function termKeySeq(key: TermKeyBarKey, mods: TermMods): string {
+  const plain = TERM_KEYBAR_SEQ[key]
+  if (!mods.ctrl && !mods.alt) return plain
+  // CSI 1;<m>X 族：方向键 + Home/End
+  const finals: Partial<Record<TermKeyBarKey, string>> = {
+    up: "A",
+    down: "B",
+    right: "C",
+    left: "D",
+    home: "H",
+    end: "F",
+  }
+  const final = finals[key]
+  if (final) return `\x1b[1;${modParam(mods)}${final}`
+  // ~ 族：PgUp/PgDn
+  if (key === "pgup") return `\x1b[5;${modParam(mods)}~`
+  if (key === "pgdn") return `\x1b[6;${modParam(mods)}~`
+  // esc/tab/slash/dash 没有通用 ctrl 形态：alt 仍走 meta 前缀，ctrl 原样
+  if (mods.alt) return `\x1b${plain}`
+  return plain
+}
+
+/**
+ * 用闩锁包装一段软键盘输入。只处理首字符，返回要发送的字节与闩锁是否被消费。
+ * `consumed=true` 时调用方应复位 mods 状态。
+ */
+export function applyTermMods(
+  data: string,
+  mods: TermMods
+): { out: string; consumed: boolean } {
+  if (!data || (!mods.ctrl && !mods.alt)) {
+    return { out: data, consumed: false }
+  }
+  const { ctrl, alt } = mods
+  let out = data
+  if (ctrl) {
+    const code = data[0].toLowerCase().charCodeAt(0)
+    if (code >= 97 && code <= 122) {
+      out = String.fromCharCode(code - 96) + data.slice(1)
+    }
+  } else if (alt) {
+    out = `\x1b${data}`
+  }
+  return { out, consumed: true }
+}
+
+/**
+ * 软键盘遮挡估算：布局视口高 - 可视视口高 - 可视视口下移量 = 底部被键盘遮住的像素。
+ * overlap < minOpen（默认 80px）视为地址栏收起/缩放等抖动，返回 0。
+ */
+export function kbdLiftPx(
+  innerHeight: number,
+  vvHeight: number,
+  vvOffsetTop: number,
+  minOpen = 80
+): number {
+  const overlap = Math.max(0, Math.round(innerHeight - vvHeight - vvOffsetTop))
+  return overlap >= minOpen ? overlap : 0
+}