@mobius-os/mobius 0.3.31 → 0.3.38

package/src/lib/transcript-viewport.ts

@@ -0,0 +1,162 @@
+/**
+ * Pure row-level transcript viewport.
+ *
+ * Entries are materialized lazily through RowAccess.rowsAt(). Navigation keeps
+ * an entry/row anchor, so moving by N rows is exact even when one entry is much
+ * taller than the terminal. No React or Ink dependency belongs in this file.
+ */
+
+export interface RowAnchor {
+  entryId: string
+  entryIndex: number
+  rowIndex: number
+}
+
+export interface ViewportRow<T> {
+  entryId: string
+  entryIndex: number
+  rowIndex: number
+  row: T
+}
+
+export interface RowAccess<T> {
+  length: number
+  idAt: (index: number) => string
+  indexOf: (entryId: string) => number
+  rowsAt: (index: number) => readonly T[]
+}
+
+export interface ViewportSlice<T> {
+  anchor: RowAnchor | null
+  rows: ViewportRow<T>[]
+  hasOlder: boolean
+  hasNewer: boolean
+}
+
+export function createRowAccess<E, T>(
+  entries: readonly E[],
+  getId: (entry: E, index: number) => string,
+  getRows: (entry: E, index: number) => readonly T[],
+): RowAccess<T> {
+  const ids = entries.map(getId)
+  const indexById = new Map(ids.map((id, index) => [id, index]))
+  return {
+    length: entries.length,
+    idAt: (index) => ids[index] ?? '',
+    indexOf: (entryId) => indexById.get(entryId) ?? -1,
+    rowsAt: (index) => index >= 0 && index < entries.length ? getRows(entries[index], index) : [],
+  }
+}
+
+function previousNonEmpty<T>(access: RowAccess<T>, from: number): number {
+  for (let index = from; index >= 0; index--) {
+    if (access.rowsAt(index).length > 0) return index
+  }
+  return -1
+}
+
+function nextNonEmpty<T>(access: RowAccess<T>, from: number): number {
+  for (let index = from; index < access.length; index++) {
+    if (access.rowsAt(index).length > 0) return index
+  }
+  return -1
+}
+
+function resolveAnchor<T>(access: RowAccess<T>, anchor: RowAnchor | null): RowAnchor | null {
+  if (!anchor || access.length === 0) return null
+  let entryIndex = access.indexOf(anchor.entryId)
+  if (entryIndex < 0) entryIndex = Math.max(0, Math.min(access.length - 1, anchor.entryIndex))
+
+  let rows = access.rowsAt(entryIndex)
+  if (rows.length === 0) {
+    const next = nextNonEmpty(access, entryIndex + 1)
+    const previous = previousNonEmpty(access, entryIndex - 1)
+    entryIndex = next >= 0 ? next : previous
+    if (entryIndex < 0) return null
+    rows = access.rowsAt(entryIndex)
+  }
+
+  return {
+    entryId: access.idAt(entryIndex),
+    entryIndex,
+    rowIndex: Math.max(0, Math.min(rows.length - 1, anchor.rowIndex)),
+  }
+}
+
+export function tailAnchor<T>(access: RowAccess<T>, viewportRows: number): RowAnchor | null {
+  let remaining = Math.max(1, Math.floor(viewportRows))
+  let first: RowAnchor | null = null
+  for (let entryIndex = access.length - 1; entryIndex >= 0; entryIndex--) {
+    const rows = access.rowsAt(entryIndex)
+    if (rows.length === 0) continue
+    first = { entryId: access.idAt(entryIndex), entryIndex, rowIndex: 0 }
+    if (rows.length >= remaining) {
+      return { entryId: access.idAt(entryIndex), entryIndex, rowIndex: rows.length - remaining }
+    }
+    remaining -= rows.length
+  }
+  return first
+}
+
+/** Move the top-row anchor by an exact signed row delta. Positive means newer. */
+export function moveAnchorByRows<T>(access: RowAccess<T>, anchor: RowAnchor | null, deltaRows: number): RowAnchor | null {
+  const resolved = resolveAnchor(access, anchor)
+  if (!resolved || deltaRows === 0) return resolved
+
+  let entryIndex = resolved.entryIndex
+  let rowIndex = resolved.rowIndex
+  let remaining = Math.abs(Math.trunc(deltaRows))
+
+  if (deltaRows > 0) {
+    while (remaining > 0) {
+      const rows = access.rowsAt(entryIndex)
+      const within = rows.length - 1 - rowIndex
+      if (remaining <= within) { rowIndex += remaining; remaining = 0; break }
+      remaining -= within
+      const next = nextNonEmpty(access, entryIndex + 1)
+      if (next < 0) { rowIndex = rows.length - 1; break }
+      entryIndex = next
+      rowIndex = 0
+      remaining -= 1
+    }
+  } else {
+    while (remaining > 0) {
+      if (remaining <= rowIndex) { rowIndex -= remaining; remaining = 0; break }
+      remaining -= rowIndex
+      const previous = previousNonEmpty(access, entryIndex - 1)
+      if (previous < 0) { rowIndex = 0; break }
+      entryIndex = previous
+      rowIndex = access.rowsAt(entryIndex).length - 1
+      remaining -= 1
+    }
+  }
+
+  return { entryId: access.idAt(entryIndex), entryIndex, rowIndex }
+}
+
+export function sliceViewport<T>(access: RowAccess<T>, anchor: RowAnchor | null, viewportRows: number): ViewportSlice<T> {
+  const resolved = resolveAnchor(access, anchor)
+  const limit = Math.max(0, Math.floor(viewportRows))
+  if (!resolved || limit === 0) return { anchor: resolved, rows: [], hasOlder: false, hasNewer: false }
+
+  const visible: ViewportRow<T>[] = []
+  let entryIndex = resolved.entryIndex
+  let rowIndex = resolved.rowIndex
+  while (entryIndex < access.length && visible.length < limit) {
+    const rows = access.rowsAt(entryIndex)
+    for (; rowIndex < rows.length && visible.length < limit; rowIndex++) {
+      visible.push({ entryId: access.idAt(entryIndex), entryIndex, rowIndex, row: rows[rowIndex] })
+    }
+    entryIndex = nextNonEmpty(access, entryIndex + 1)
+    rowIndex = 0
+    if (entryIndex < 0) break
+  }
+
+  const hasOlder = resolved.rowIndex > 0 || previousNonEmpty(access, resolved.entryIndex - 1) >= 0
+  const last = visible.at(-1)
+  const hasNewer = !!last && (
+    last.rowIndex < access.rowsAt(last.entryIndex).length - 1 ||
+    nextNonEmpty(access, last.entryIndex + 1) >= 0
+  )
+  return { anchor: resolved, rows: visible, hasOlder, hasNewer }
+}

package/src/markdown.ts

@@ -12,6 +12,30 @@ import chalk from 'chalk'
 import { highlight, supportsLanguage } from 'cli-highlight'
 import { lexer, type Token, type Tokens } from 'marked'
 
+/**
+ * Decode HTML entities that marked's lexer injects into text tokens.
+ * marked encodes `' " < > &` as `&#39; &quot; &lt; &gt; &amp;` even when
+ * only lexing (not rendering to HTML).  The TUI renders to a terminal so
+ * we must reverse that encoding ourselves.
+ */
+const HTML_ENTITY_RE = /&(?:#(x?)([0-9a-fA-F]+)|(amp|lt|gt|quot|#39));/g
+function decodeHtmlEntities(s: string): string {
+  return s.replace(HTML_ENTITY_RE, (_, hex: string | undefined, num: string, named: string | undefined) => {
+    if (named) {
+      switch (named) {
+        case 'amp': return '&'
+        case 'lt': return '<'
+        case 'gt': return '>'
+        case 'quot': return '"'
+        case '#39': return "'"
+        default: return _
+      }
+    }
+    const code = parseInt(num, hex ? 16 : 10)
+    return String.fromCodePoint(code)
+  })
+}
+
 export interface RenderedMarkdownLine {
   text: string
   code: boolean
@@ -43,7 +67,7 @@ function renderInlineOne(t: Token): string {
   const anyT = t as any
   switch (t.type) {
     case 'text':
-      return anyT.tokens ? renderInline(anyT.tokens) : escapeAnsiReset(anyT.text)
+      return anyT.tokens ? renderInline(anyT.tokens) : escapeAnsiReset(decodeHtmlEntities(anyT.text))
     case 'strong':
       return chalk.bold(renderInline(anyT.tokens))
     case 'em':
@@ -51,20 +75,20 @@ function renderInlineOne(t: Token): string {
     case 'del':
       return chalk.dim.strikethrough(renderInline(anyT.tokens))
     case 'codespan':
-      return chalk.cyanBright(anyT.text)
+      return chalk.cyanBright(decodeHtmlEntities(anyT.text))
     case 'link': {
       const label = renderInline(anyT.tokens) || anyT.href
       return anyT.href && label !== anyT.href ? `${chalk.cyan(label)} (${chalk.dim.underline(anyT.href)})` : chalk.cyan(label)
     }
     case 'image':
-      return chalk.magentaBright(`[图片: ${anyT.href || anyT.text}]`)
+      return chalk.magentaBright(`[图片: ${anyT.href || decodeHtmlEntities(anyT.text)}]`)
     case 'br':
       return '\n'
     case 'escape':
     case 'html':
-      return anyT.text ?? ''
+      return anyT.text ? decodeHtmlEntities(anyT.text) : ''
     default:
-      return anyT.text ?? renderInline(anyT.tokens)
+      return anyT.text ? decodeHtmlEntities(anyT.text) : renderInline(anyT.tokens)
   }
 }
 
@@ -74,7 +98,7 @@ function escapeAnsiReset(s: string): string {
 }
 
 function renderTable(t: Tokens.Table): string {
-  const cell = (toks: any) => renderInline(toks?.tokens ?? [{ type: 'text', text: toks?.text ?? '' }])
+  const cell = (toks: any) => renderInline(toks?.tokens ?? [{ type: 'text', text: decodeHtmlEntities(toks?.text ?? '') }])
   const header = t.header.map((h) => cell(h)).join(' | ')
   const rows = t.rows.map((r) => r.map((c) => cell(c)).join(' | ')).join('\n')
   return chalk.bold(header) + '\n' + chalk.dim('-'.repeat(Math.min(header.length, 80))) + '\n' + rows
@@ -121,7 +145,7 @@ function renderBlock(t: Token): string {
     case 'paragraph':
       return renderInline(anyT.tokens)
     case 'code': {
-      return renderCode(anyT.text, anyT.lang)
+      return renderCode(decodeHtmlEntities(anyT.text), anyT.lang)
     }
     case 'blockquote': {
       const inner = (anyT.tokens as Token[]).map(renderBlock).join('\n')
@@ -142,9 +166,9 @@ function renderBlock(t: Token): string {
     case 'space':
       return ''
     case 'html':
-      return chalk.dim(anyT.text ?? '')
+      return chalk.dim(decodeHtmlEntities(anyT.text ?? ''))
     default:
-      return anyT.text ?? renderInline(anyT.tokens)
+      return anyT.text ? decodeHtmlEntities(anyT.text) : renderInline(anyT.tokens)
   }
 }
 
@@ -156,5 +180,5 @@ function renderListItemBody(item: any): string {
       .filter(Boolean)
       .join('\n')
   }
-  return item.text ?? ''
+  return item.text ? decodeHtmlEntities(item.text) : ''
 }

package/src/version.ts

@@ -0,0 +1,21 @@
+/**
+ * The TUI package version has one source of truth: package.json.
+ *
+ * Keep all runtime/UI consumers behind this module so a release cannot show
+ * a stale hard-coded version while the npm package has already been bumped.
+ */
+import { createRequire } from 'node:module'
+
+interface TuiPackageMetadata {
+  name?: string
+  version?: string
+}
+
+const packageJson = createRequire(import.meta.url)('../package.json') as TuiPackageMetadata
+
+if (!packageJson.version) {
+  throw new Error('TUI package.json is missing a version')
+}
+
+export const TUI_VERSION = packageJson.version
+export const TUI_PACKAGE_NAME = packageJson.name ?? '@mobius-os/mobius'

package/tests/aimux.test.tsx

@@ -7,7 +7,7 @@ import os from 'node:os'
 import path from 'node:path'
 import { render } from 'ink-testing-library'
 import { AimuxStatusLine } from '../src/components/AimuxStatus.js'
-import { AimuxSupervisor, probeAimuxBridgeConnection, bundleArch, bundleUrl, spawnLauncher, ensureFromBundle, downloadBundleForTest, reverseConnectArgs, aimuxLogPath, bundleHealthCheckCode } from '../src/aimux.js'
+import { AimuxSupervisor, probeAimuxBridgeConnection, bundleArch, bundleUrl, spawnLauncher, ensureFromBundle, downloadBundleForTest, reverseConnectArgs, aimuxLogPath, bundleHealthCheckCode, tuiAimuxIdentifier } from '../src/aimux.js'
 
 const delay = (ms: number) => new Promise<void>(resolve => setTimeout(resolve, ms))
 let pass = 0, fail = 0
@@ -78,11 +78,11 @@ async function testBundleArchAndUrl() {
   const arch = bundleArch()
   ok(arch === 'linux-x64' || arch === 'win-x64' || arch === 'mac-x64', `bundleArch returns a supported arch on this host (${arch})`)
   const before = bundleUrl('linux-x64')
-  ok(before.includes('mobius-python-linux-x64-v2') && before.endsWith('.zip'), 'bundleUrl follows the fixed filename pattern')
+  ok(before.includes('mobius-python-linux-x64-v3') && before.endsWith('.zip'), 'bundleUrl follows the fixed filename pattern')
   const saved = process.env.MOBIUS_TUI_PYTHON_BUNDLE_URL
   process.env.MOBIUS_TUI_PYTHON_BUNDLE_URL = 'https://example.test/cdn/'
   try {
-    ok(bundleUrl('win-x64') === 'https://example.test/cdn/mobius-python-win-x64-v2.zip', 'MOBIUS_TUI_PYTHON_BUNDLE_URL overrides the CDN base and trims trailing slash')
+    ok(bundleUrl('win-x64') === 'https://example.test/cdn/mobius-python-win-x64-v3.zip', 'MOBIUS_TUI_PYTHON_BUNDLE_URL overrides the CDN base and trims trailing slash')
   } finally { if (saved === undefined) delete process.env.MOBIUS_TUI_PYTHON_BUNDLE_URL; else process.env.MOBIUS_TUI_PYTHON_BUNDLE_URL = saved }
 }
 
@@ -136,17 +136,27 @@ function testReverseConnectArgs() {
   console.log('\n[AIMUX 6] reverse connect Windows shell visibility')
   const win = reverseConnectArgs('https://mobius.test/', 'tui-win', 'jwt-test', 'win32')
   const linux = reverseConnectArgs('https://mobius.test/', 'tui-linux', 'jwt-test', 'linux')
-  ok(win.includes('--silent-shell'), 'Windows reverse connection always requests hidden command shells')
-  ok(!linux.includes('--silent-shell'), 'non-Windows reverse connection does not receive the Windows-only flag')
+  ok(win.includes('--slient-v2'), 'Windows reverse connection always requests the no-console shell mode')
+  ok(!linux.includes('--slient-v2'), 'non-Windows reverse connection does not receive the Windows-only flag')
   ok(win[2] === 'https://mobius.test/aimux_bridge', 'reverse connection normalizes the bridge URL')
 }
 
+function testAimuxIdentifierScopesWorkspace() {
+  console.log('\n[AIMUX 6a] reverse client identifier workspace isolation')
+  const first = tuiAimuxIdentifier('same-host', '/work/project-a')
+  const firstAgain = tuiAimuxIdentifier('same-host', '/work/project-a')
+  const second = tuiAimuxIdentifier('same-host', '/work/project-b')
+  ok(first === firstAgain, 'identifier is stable for the same host and workspace')
+  ok(first !== second, 'different workspaces on one host do not replace each other')
+  ok(/^tui-same-host-[a-f0-9]{10}$/.test(first), 'identifier remains bridge-safe and recognizable')
+}
+
 function testBundleHealthCheck() {
   console.log('\n[AIMUX 6b] bundle dependency health check')
   const win = bundleHealthCheckCode('win32')
   const linux = bundleHealthCheckCode('linux')
   ok(win.includes('aimux.bridge_client') && win.includes('win32_setctime'), 'Windows bundle probe imports the real bridge path and its platform dependency')
-  ok(win.includes("aimux.__version__ == '0.1.21'"), 'bundle probe rejects stale AIMUX versions')
+  ok(win.includes("aimux.__version__ == '0.1.23'"), 'bundle probe rejects stale AIMUX versions')
   ok(!linux.includes('win32_setctime'), 'non-Windows bundle probe does not require the Windows-only package')
 }
 
@@ -199,6 +209,7 @@ async function main() {
   await testBundleArchAndUrl()
   await testSpawnLauncher()
   testReverseConnectArgs()
+  testAimuxIdentifierScopesWorkspace()
   testBundleHealthCheck()
   await testEnsureFromBundleReady()
   await testDownloadBundleStream()

package/tests/flow.test.tsx

@@ -68,9 +68,9 @@ function mockFetch(url: string, init?: RequestInit): Response {
   }
   // issues
   if (url.includes('/api/projects/') && url.includes('/issues') && method === 'POST') return json({ id: IID, project_id: PID, title: '命令行任务' })  // create issue
-  if (url.includes('/api/projects/') && url.includes('/issues') && method === 'GET') return json([{ id: IID, project_id: PID, title: '命令行任务' }]) // list issues
+  if (url.includes('/api/projects/') && url.includes('/issues') && method === 'GET') return json([{ id: IID, project_id: PID, title: '命令行任务', description: '任务说明' }]) // list issues
   // projects
-  if (url.includes('/api/projects') && method === 'GET') return json([{ id: PID, name: '已有项目甲' }])   // list projects
+  if (url.includes('/api/projects') && method === 'GET') return json([{ id: PID, name: '已有项目甲', description: '项目说明' }])   // list projects
   if (url.endsWith('/api/projects') && method === 'POST') return json({ id: PID, name: '测试项目PTY' })   // create project (exact)
   // preference lookups
   if (url.includes('/sessions/model-options')) return json([{ key: 'codex', label: 'GPT-5.5', title: 'GPT-5.5', sub: 'Codex', backend: 'tmux-codex' }])
@@ -165,13 +165,26 @@ async function main() {
     stdin.write('\r')
     ok(await waitFor(lastFrame, '重新配置'), '/config opens the full reconfig flow')
     ok(await waitFor(lastFrame, '选择项目'), '/config shows project picker first')
-    // Pick the first project (created above).
+    ok(await waitFor(lastFrame, '已有项目甲 - 项目说明'), '/config keeps the project explanation on its main row')
+    // Pick the first project (created above), then verify Esc walks back one
+    // level at a time instead of closing the entire config flow.
     stdin.write('\r'); await delay(400)
     ok(await waitFor(lastFrame, '选择任务'), '/config shows issue picker after project')
-    // Pick the first issue.
+    ok((lastFrame() ?? '').includes('命令行任务 - 任务说明'), '/config keeps the issue explanation on its main row')
+    stdin.write('\x1b'); await delay(180)
+    ok(await waitFor(lastFrame, '选择项目'), 'Esc from issue selection returns to project selection')
+    stdin.write('\r'); await delay(400)
+    ok(await waitFor(lastFrame, '选择任务'), 'project selection can be re-entered after Esc')
+
+    // Pick the issue and verify the model step also returns to the issue step.
     stdin.write('\r'); await delay(400)
     ok(await waitFor(lastFrame, '选择模型'), '/config shows model picker after issue')
     ok(await waitFor(lastFrame, 'GPT-5.5'), '/config model list rendered')
+    ok((lastFrame() ?? '').includes('GPT-5.5 （默认） - Codex'), '/config keeps the model explanation on its main row')
+    stdin.write('\x1b'); await delay(180)
+    ok(await waitFor(lastFrame, '选择任务'), 'Esc from model selection returns to issue selection')
+    stdin.write('\r'); await delay(400)
+    ok(await waitFor(lastFrame, '选择模型'), 'issue selection can be re-entered after Esc')
     stdin.write('\r'); await delay(700)                             // pick codex → create session
     ok(await waitFor(lastFrame, '输入问题'), '/config creates a fresh session and returns to chat')
     ok((lastFrame() ?? '').includes('?session=sess-1'), 'reconfigured chat is attached to the new session')
@@ -191,6 +204,14 @@ async function main() {
     ok(await waitFor(lastFrame, '输入问题'), '/model creates a fresh session and returns to chat')
     ok((lastFrame() ?? '').includes('?session=sess-1'), '/model new session attached')
     snap('7-after-model', lastFrame() ?? '')
+
+    // ── /logout ─────────────────────────────────────────────────────────────
+    await delay(400)
+    stdin.write('/logout'); await delay(150)
+    stdin.write('\r')
+    ok(await waitFor(lastFrame, 'Mobius 登录'), '/logout returns to the login form')
+    ok(!fs.existsSync(path.join(TMP_HOME, 'login.json')), '/logout clears the persisted login token')
+    ok((lastFrame() ?? '').includes('http://mock.local') && (lastFrame() ?? '').includes('tester'), '/logout keeps server and username available for the next login')
     snap('6-after-config', lastFrame() ?? '')
   } finally {
     unmount()

package/tests/screen.test.tsx

@@ -20,8 +20,9 @@ import { Box, Text } from 'ink'
 import { render } from 'ink-testing-library'
 import { Screen } from '../src/components/Screen.js'
 import { Select } from '../src/components/primitives.js'
-import { fitTranscript } from '../src/components/Chat.js'
-import type { AnyEntry } from '../src/types.js'
+import { entryScreenRows } from '../src/lib/screen-text.js'
+import { viewsForEntry } from '../src/lib/entry-view.js'
+import { createRowAccess, sliceViewport, tailAnchor } from '../src/lib/transcript-viewport.js'
 
 const delay = (ms: number) => new Promise<void>(r => setTimeout(r, ms))
 const strip = (s: string) => s.replace(/\x1b\[[0-9;?]*[a-zA-Z]/g, '')
@@ -36,17 +37,17 @@ const ROWS = 24
 async function main() {
   console.log('\n[SCREEN] no-residue picker transitions\n')
 
-  // A hidden older entry may contribute only its tail rows when the viewport
-  // has one spare row. That preview must retain the entry's foreground style;
-  // rendering it as a bare dimColor string makes a clipped cyan Markdown link
-  // look gray even though the rest of the message is colored.
-  const styledEntries: AnyEntry[] = [
+  // A partial message is now represented by the same styled ScreenRow as a
+  // complete message. Virtual slicing must preserve its ANSI foreground bytes.
+  const styledEntries = [
     { type: 'assistant', uuid: 'styled-old', message: { role: 'assistant', content: [{ type: 'text', text: '[彩色链接](https://example.com)' }] } },
     { type: 'assistant', uuid: 'styled-new', message: { role: 'assistant', content: [{ type: 'text', text: '最新消息' }] } },
   ]
-  const fitted = fitTranscript(styledEntries, 3, 80)
-  ok(fitted.peekRows.length === 1, 'small viewport exposes one tail row from the hidden message')
-  ok(fitted.peekRows[0]?.styled.includes('\x1b[') && fitted.peekRows[0]?.styled.includes('彩色链接'), 'partial older row keeps its ANSI foreground styling')
+  const rowAccess = createRowAccess(styledEntries, entry => entry.uuid, entry => entryScreenRows(viewsForEntry(entry), 80))
+  const viewport = sliceViewport(rowAccess, tailAnchor(rowAccess, 3), 3)
+  const partial = viewport.rows.find(item => item.entryId === 'styled-old')?.row
+  ok(partial !== undefined, 'small viewport exposes a row from the partial older message')
+  ok(!!partial?.styled.includes('\x1b[') && partial.styled.includes('彩色链接'), 'partial older row keeps its ANSI foreground styling')
 
   // ── 1. Without Screen, a tall frame overflows the terminal (the bug). ───────
   const tall = render(

package/tests/scroll.test.tsx

@@ -138,7 +138,7 @@ async function main() {
     const tailFrame = strip(lastFrame() ?? '')
 
     ok(tailFrame.includes('回答 24'), 'latest entry visible at tail (not hidden)')
-    ok(tailFrame.includes('PageUp'), 'older-records hint offers PageUp (nothing is silently lost)')
+    ok(tailFrame.includes('↑ 还有较早内容') && tailFrame.includes('滚轮 3 行'), 'navigation reports older content and the exact wheel step')
 
     // ── live resize: refit one dynamic frame, never retain old-width output ──
     resize(stdout as unknown as NodeJS.WriteStream, 52, 18)
@@ -157,21 +157,20 @@ async function main() {
     ok(tallAnswers > narrowAnswers, 'larger resize reveals more history in the same viewport')
     ok((tallFrame.match(/>_ Mobius/g) ?? []).length === 1, 'larger resize still has one dynamic header')
 
-    // The "↑ 还有 N 条较早记录" hint must be pinned to the FIRST line below the
-    // header and span the full width — it must not float mid-transcript when the
-    // viewport has spare rows (regression for real terminals, which bound the
-    // transcript box height via stdout.isTTY).
+    // Navigation is a fixed one-row part of the conversation chrome. It must be
+    // the FIRST line below the header and state the exact PageUp/PageDown step.
     const tallLines = tallFrame.split('\n')
-    const hintIdx = tallLines.findIndex(l => l.includes('较早记录'))
-    ok(hintIdx === 1, `older-records hint is the first line under the header (line ${hintIdx}, expected 1)`)
+    const hintIdx = tallLines.findIndex(l => l.includes('滚轮 3 行'))
+    ok(hintIdx === 1, `navigation is the first line under the header (line ${hintIdx}, expected 1)`)
+    ok(/PageUp\/PageDown \d+ 行/.test(tallLines[hintIdx] ?? ''), 'navigation exposes the deterministic page size')
     const messageRows = tallLines.slice(hintIdx + 1).filter(line => line.trim())
-    ok(messageRows.length > 0 && messageRows[0].includes('⋯'), 'older message tail is visible immediately after the history hint')
+    ok(messageRows.length > 0 && messageRows[0].includes('回答'), 'a real virtualized message row follows navigation without a synthetic peek row')
 
     // ── PageUp: viewport scrolls back over history ────────────────────────────
     stdin.write('\x1b[5~')                                   // PageUp
     await delay(300)
     const upFrame = strip(lastFrame() ?? '')
-    ok(upFrame.includes('PageDown'), 'after PageUp: a PageDown hint appears (scrolled up)')
+    ok(upFrame.includes('↓ 较新内容'), 'after PageUp: navigation reports newer content below')
     ok(!upFrame.includes('回答 24'), 'after PageUp: latest entry paged out of view')
     ok(/回答 \d+/.test(upFrame), 'after PageUp: an older entry is visible')
 
@@ -185,7 +184,7 @@ async function main() {
     stdin.write('\x1b[<64;5;5M')                             // wheel up = scroll back
     await delay(300)
     const wheelUp = strip(lastFrame() ?? '')
-    ok(wheelUp.includes('PageDown'), 'wheel up: a PageDown hint appears (scrolled back)')
+    ok(wheelUp.includes('↓ 较新内容'), 'wheel up: navigation reports newer content below')
     ok(!wheelUp.includes('回答 24'), 'wheel up: latest entry paged out of view')
     ok(/回答 \d+/.test(wheelUp), 'wheel up: an older entry is visible')
 
@@ -199,7 +198,7 @@ async function main() {
     stdin.write('\x1b[M' + String.fromCharCode(96, 50, 50))
     await delay(300)
     const legacyUp = strip(lastFrame() ?? '')
-    ok(legacyUp.includes('PageDown'), 'legacy wheel up: a PageDown hint appears (scrolled back)')
+    ok(legacyUp.includes('↓ 较新内容'), 'legacy wheel up: navigation reports newer content below')
     ok(!legacyUp.includes('回答 24'), 'legacy wheel up: latest entry paged out of view')
 
     stdin.write('\x1b[M' + String.fromCharCode(97, 50, 50))  // wheel down Cb = 0x61
@@ -229,13 +228,15 @@ async function main() {
     await bootToChat(second.stdin, second.lastFrame)
     await populateTranscript(second.stdin, emitEntry)
     const before = strip(second.lastFrame() ?? '')
+    const beforeAnswers = before.match(/回答 \d+/g) ?? []
     ok(before.includes('回答 24'), 'disable-mouse: latest entry visible before wheel')
 
     second.stdin.write('\x1b[<64;5;5M')                    // wheel up — must be ignored
     await delay(300)
     const after = strip(second.lastFrame() ?? '')
+    const afterAnswers = after.match(/回答 \d+/g) ?? []
     ok(after.includes('回答 24'), 'disable-mouse: wheel up leaves latest entry in view')
-    ok(!after.includes('PageDown'), 'disable-mouse: wheel up does NOT scroll (no PageDown hint)')
+    ok(JSON.stringify(afterAnswers) === JSON.stringify(beforeAnswers), 'disable-mouse: wheel up leaves the visible row window unchanged')
   } finally {
     second.unmount()
     delete process.env.MOBIUS_TUI_DISABLE_MOUSE

package/tests/selection.test.tsx

@@ -139,7 +139,7 @@ async function main() {
     const row1 = lines.findIndex(l => l.includes('回答 1'))
     const row3 = lines.findIndex(l => l.includes('回答 3'))
     ok(row1 >= 0 && row3 >= 0, `found 回答 1 (row ${row1}) and 回答 3 (row ${row3}) in the transcript`)
-    ok(!frame.includes('PageDown'), 'all entries fit — no paging hints at rest')
+    ok(frame.includes('全部内容') && !frame.includes('↑ 较早内容') && !frame.includes('↓ 还有较新内容'), 'all entries fit — navigation reports the complete transcript')
 
     // press on 回答 1 (col 4 → first content char), drag to 回答 3 (col beyond EOL)
     stdin.write(`\x1b[<0;5;${row1 + 1}M`)                 // left-button press (SGR 1-based)