dsh-gufa-code 0.0.0-stage → 1.0.1

package/scripts/selftest-terminal-client.mjs

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+/**
+ * 客户端终端零件静态自检：不依赖浏览器 / React / 构建产物。
+ *
+ * 做法：
+ *   1. 把 00-core.js + 10-icons.js + 30-terminal.js 按 build-client.mjs 的 factory 头拼接，
+ *      在 vm 沙箱里执行（只拼接、不写 client.js），验证零件可组合、G.TerminalPane 注册成功；
+ *   2. 用最小 hooks 运行时调用 G.TerminalPane / GufaTerminalTab / GufaTerminalView，
+ *      展开渲染树做冒烟测试（白屏/未知组件/条件调用 hooks 这类错误会在这里暴露）；
+ *   3. 关键行为静态断言（xterm 资产地址、WS 地址、业务总线、无 import/export 等）。
+ *
+ * 用法：node scripts/selftest-terminal-client.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import vm from 'node:vm'
+
+let passed = 0
+let failed = 0
+function check(name, condition, detail) {
+  if (condition) {
+    passed += 1
+    console.log(`  ok   ${name}`)
+  } else {
+    failed += 1
+    console.error(`  FAIL ${name}${detail === undefined ? '' : ` — ${detail}`}`)
+  }
+}
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const readPart = (name) => readFileSync(join(packageRoot, 'src', 'client', name), 'utf8')
+
+/* ── 1. 源码静态断言 ───────────────────────────────────────────────────── */
+const terminalSource = readPart('30-terminal.js')
+console.log('30-terminal.js 静态断言')
+check('无 import/export（零件共享 factory 作用域）', !/^\s*(?:import|export)\s/m.test(terminalSource))
+check('xterm.js 走 G.asset', terminalSource.includes("G.asset('xterm/xterm.js')"))
+check('xterm.css 走 G.asset', terminalSource.includes("G.asset('xterm/xterm.css')"))
+check('addon-fit 走 G.asset', terminalSource.includes("G.asset('xterm/addon-fit.js')"))
+check('输出走直连 SSE（票据鉴权）', terminalSource.includes('gufa-code/terminal-stream') && terminalSource.includes('terminal.wsTicket'))
+check('输入走 HTTP terminal.input', terminalSource.includes("G.api('terminal.input'"))
+check('尺寸走 HTTP terminal.resize', terminalSource.includes("G.api('terminal.resize'"))
+check('不再使用 WebSocket', !terminalSource.includes('new WebSocket('))
+check('监听 G.bus terminal:send', terminalSource.includes("G.bus.on('terminal:send'"))
+check('未直接 append 到 document.body', !/document\.body\.append/.test(terminalSource))
+check('未修改 props.height', !/props\.height\s*=(?!=)/.test(terminalSource))
+check('注册 G.TerminalPane', /G\.TerminalPane\s*=\s*function\s+TerminalPane/.test(terminalSource))
+
+/* ── 2. 最小 React hooks 运行时 ────────────────────────────────────────── */
+let currentHooks = null
+function makeHooks() {
+  const hooks = { states: [], refs: [], effects: [], index: 0 }
+  currentHooks = hooks
+  return hooks
+}
+const Fragment = Symbol('Fragment')
+const ReactStub = {
+  Fragment,
+  createElement(type, props, ...children) {
+    const merged = { ...(props === null || props === undefined ? {} : props) }
+    if (children.length === 1) merged.children = children[0]
+    else if (children.length > 1) merged.children = children
+    return { type, props: merged }
+  },
+  useState(initial) {
+    const index = currentHooks.index
+    currentHooks.index += 1
+    if (!(index in currentHooks.states)) currentHooks.states[index] = typeof initial === 'function' ? initial() : initial
+    return [currentHooks.states[index], (next) => {
+      currentHooks.states[index] = typeof next === 'function' ? next(currentHooks.states[index]) : next
+    }]
+  },
+  useRef(initial) {
+    const index = currentHooks.index
+    currentHooks.index += 1
+    if (!(index in currentHooks.refs)) currentHooks.refs[index] = { current: initial }
+    return currentHooks.refs[index]
+  },
+  useEffect(fn) {
+    currentHooks.index += 1
+    currentHooks.effects.push(fn)
+  },
+  useLayoutEffect(fn) {
+    currentHooks.index += 1
+    currentHooks.effects.push(fn)
+  },
+  useCallback(fn) {
+    currentHooks.index += 1
+    return fn
+  },
+  useMemo(fn) {
+    currentHooks.index += 1
+    return fn()
+  },
+}
+
+/** 以独立 hooks 实例渲染一个组件，返回 { vnode, hookCount }。 */
+function renderComponent(component, props) {
+  const hooks = makeHooks()
+  let vnode
+  try {
+    vnode = component(props)
+  } finally {
+    currentHooks = null
+  }
+  return { vnode, hookCount: hooks.index, hooks }
+}
+
+/** 展开渲染树：宿主编元素/文本直接消费，函数组件递归渲染（用于发现未知组件/渲染异常）。 */
+function expand(vnode, depth = 0) {
+  if (depth > 80) throw new Error('渲染树过深（疑似组件递归）')
+  if (vnode === null || vnode === undefined || typeof vnode === 'boolean') return []
+  if (typeof vnode === 'string' || typeof vnode === 'number') return []
+  if (Array.isArray(vnode)) {
+    const list = []
+    for (const item of vnode) list.push(...expand(item, depth + 1))
+    return list
+  }
+  if (typeof vnode !== 'object') return []
+  const type = vnode.type
+  const props = vnode.props === null || vnode.props === undefined ? {} : vnode.props
+  const children = props.children
+  if (typeof type === 'string' || type === Fragment) {
+    if (Array.isArray(children)) {
+      const list = []
+      for (const child of children) list.push(...expand(child, depth + 1))
+      return list
+    }
+    return expand(children, depth + 1)
+  }
+  if (typeof type === 'function') {
+    const rendered = renderComponent(type, props)
+    return expand(rendered.vnode, depth + 1)
+  }
+  throw new Error(`未知 vnode type: ${String(type)}`)
+}
+
+/* ── 3. 在沙箱中执行拼接后的 factory ───────────────────────────────────── */
+const parts = ['00-core.js', '10-icons.js', '30-terminal.js']
+const header = `window.__ModuleLoader__.load({
+  id: 'dsh-gufa-code',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+    const { useState, useEffect, useRef, useMemo, useCallback, useLayoutEffect } = React
+`
+const footer = `
+  ;globalThis.__GUFA_TEST__ = { G, GufaTerminalView, GufaTerminalTab }
+  return { inject: [], apply() {} }
+  },
+})
+`
+const source = header + parts.map((name) => `\n/* ── ${name} ── */\n${readPart(name)}\n`).join('') + footer
+
+function fakeElement(tagName) {
+  return {
+    tagName,
+    dataset: {},
+    style: {},
+    children: [],
+    append() {},
+    remove() {},
+    setAttribute() {},
+    addEventListener() {},
+    removeEventListener() {},
+    querySelector() {
+      return null
+    },
+  }
+}
+const documentStub = {
+  querySelector() {
+    return null
+  },
+  createElement(tagName) {
+    return fakeElement(tagName)
+  },
+  head: { append() {} },
+  body: { hasAttribute() { return false }, append() {} },
+  addEventListener() {},
+  removeEventListener() {},
+}
+const windowStub = {
+  __ModuleLoader__: {
+    load(module) {
+      windowStub.__loaded = module
+    },
+  },
+  addEventListener() {},
+  removeEventListener() {},
+  requestAnimationFrame() {
+    return 0
+  },
+  cancelAnimationFrame() {},
+}
+const sandbox = {
+  window: windowStub,
+  document: documentStub,
+  location: { protocol: 'http:', host: '127.0.0.1:53091' },
+  console,
+  setTimeout,
+  clearTimeout,
+  TextEncoder,
+  URL,
+  MutationObserver: class {
+    observe() {}
+    disconnect() {}
+  },
+  localStorage: {
+    getItem() {
+      return null
+    },
+    setItem() {},
+    removeItem() {},
+  },
+}
+sandbox.globalThis = sandbox
+vm.createContext(sandbox)
+
+let loadedModule
+try {
+  vm.runInContext(source, sandbox, { filename: 'dsh-gufa-code.selftest.js' })
+  loadedModule = windowStub.__loaded
+} catch (error) {
+  failed += 1
+  console.error(`  FAIL 拼接执行失败 — ${error instanceof Error ? error.stack : String(error)}`)
+}
+console.log('拼接 factory / 组件冒烟')
+check('factory 已通过 __ModuleLoader__.load 注册', loadedModule !== undefined)
+if (loadedModule !== undefined) {
+  let plugin
+  try {
+    plugin = loadedModule.factory((name) => {
+      if (name === 'react') return ReactStub
+      throw new Error(`未预期的 require(${name})`)
+    })
+  } catch (error) {
+    console.error('  FAIL factory 执行失败', error)
+  }
+  check('factory 返回 { inject, apply }', plugin !== undefined && Array.isArray(plugin.inject) && typeof plugin.apply === 'function')
+  const exposed = sandbox.__GUFA_TEST__
+  check('G 命名空间暴露给测试', exposed !== undefined && typeof exposed.G === 'object')
+  if (exposed !== undefined) {
+    const G = exposed.G
+    check('G.TerminalPane 是函数组件', typeof G.TerminalPane === 'function')
+    check('GufaTerminalTab / GufaTerminalView 已定义', typeof exposed.GufaTerminalTab === 'function' && typeof exposed.GufaTerminalView === 'function')
+    check('G.translate 可用', typeof G.t === 'function' && G.t('terminal.title') !== '')
+
+    // G.TerminalPane：无项目 / 有项目但 xterm 加载中
+    for (const scenario of [
+      { name: '无项目', props: { root: null, visible: true, height: 220, theme: 'dark', onToggleHeight() {} } },
+      { name: '亮色主题 + 项目 root（资产加载中）', props: { root: '/tmp/gufa-demo', visible: true, height: 300, theme: 'light', onToggleHeight() {} } },
+    ]) {
+      try {
+        const first = renderComponent(G.TerminalPane, scenario.props)
+        const elements = expand(first.vnode)
+        check(`G.TerminalPane 渲染：${scenario.name}`, first.vnode !== undefined && first.vnode !== null)
+        const second = renderComponent(G.TerminalPane, scenario.props)
+        check(`G.TerminalPane hook 数量稳定：${scenario.name}`, first.hookCount === second.hookCount, `${first.hookCount} vs ${second.hookCount}`)
+        expand(second.vnode)
+        check(`G.TerminalPane 渲染树非空：${scenario.name}`, elements.length >= 0)
+      } catch (error) {
+        check(`G.TerminalPane 渲染：${scenario.name}`, false, error instanceof Error ? error.stack : String(error))
+      }
+    }
+
+    // 终端标签
+    try {
+      const session = { id: 'term-1', title: 'zsh', exited: false, exitCode: null }
+      const rendered = renderComponent(exposed.GufaTerminalTab, { session, active: true, onSelect() {}, onClose() {} })
+      expand(rendered.vnode)
+      check('GufaTerminalTab 渲染', rendered.vnode !== undefined && rendered.vnode !== null)
+      const exited = renderComponent(exposed.GufaTerminalTab, { session: { ...session, exited: true }, active: false, onSelect() {}, onClose() {} })
+      expand(exited.vnode)
+      check('GufaTerminalTab 渲染（已退出）', exited.vnode !== undefined && exited.vnode !== null)
+      check('GufaTerminalTab 不调用 hooks', rendered.hookCount === 0 && exited.hookCount === 0)
+    } catch (error) {
+      check('GufaTerminalTab 渲染', false, error instanceof Error ? error.stack : String(error))
+    }
+
+    // 单个终端视图：xterm 资产失败 → 纯文本降级 UI；以及已退出状态
+    const failedAssets = { status: 'failed', Terminal: null, FitAddon: null, error: '模拟 xterm 加载失败' }
+    for (const scenario of [
+      { name: '降级模式（xterm 加载失败）', session: { id: 'term-1', title: 'zsh', exited: false }, assets: failedAssets },
+      { name: '已退出的会话', session: { id: 'term-1', title: 'zsh', exited: true, exitCode: 1 }, assets: failedAssets },
+    ]) {
+      try {
+        const props = {
+          session: scenario.session,
+          root: '/tmp/gufa-demo',
+          active: true,
+          visible: true,
+          theme: 'dark',
+          assets: scenario.assets,
+          register() {},
+          unregister() {},
+          onExit() {},
+          onTitle() {},
+        }
+        const first = renderComponent(exposed.GufaTerminalView, props)
+        expand(first.vnode)
+        const second = renderComponent(exposed.GufaTerminalView, props)
+        check(`GufaTerminalView 渲染：${scenario.name}`, first.vnode !== undefined && first.vnode !== null)
+        check(`GufaTerminalView hook 数量稳定：${scenario.name}`, first.hookCount === second.hookCount, `${first.hookCount} vs ${second.hookCount}`)
+      } catch (error) {
+        check(`GufaTerminalView 渲染：${scenario.name}`, false, error instanceof Error ? error.stack : String(error))
+      }
+    }
+  }
+}
+
+console.log(`\n${passed} passed, ${failed} failed`)
+process.exit(failed === 0 ? 0 : 1)

package/scripts/selftest-terminal-pty.mjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+/**
+ * 真实 PTY 集成自测（可选，需要本机解包后的 DSH 安装目录）。
+ *
+ * 不启动 Harness，而是直接实例化 DSH 的 `LocalSubprocessRuntime`（本地 node-pty 实现），
+ * 用 host/terminal.js 的 register() 走一遍真实链路：
+ *   spawnTerminal → PTY 输出 → WS 广播 → 键盘输入 → resize → exit → close
+ * 并验证环境变量过滤与 `since` 增量回放语义。
+ *
+ * 依赖：/tmp/dsh-asar/dsh（或 GUFA_DSH_ASAR 指定的目录）与 node-pty 的
+ *       prebuilds/darwin-arm64/{pty.node,spawn-helper}（从 app.asar.unpacked 复制）。
+ * 条件不满足时打印 skip 并以 0 退出，不影响常规 CI。
+ *
+ * 用法：node scripts/selftest-terminal-pty.mjs
+ */
+import { existsSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const dshRoot = process.env.GUFA_DSH_ASAR ?? '/tmp/dsh-asar/dsh'
+const modules = join(dshRoot, 'node_modules')
+
+function skip(reason) {
+  console.log(`selftest-terminal-pty: skip — ${reason}`)
+  process.exit(0)
+}
+
+const cordisEntry = join(modules, '@deepseek-ai', 'cordis', 'lib', 'index.js')
+const subprocessEntry = join(modules, '@deepseek-ai', 'dsh-subprocess-local', 'lib', 'index.js')
+const ptyPrebuild = join(modules, 'node-pty', 'prebuilds', `${process.platform}-${process.arch}`)
+if (!existsSync(cordisEntry) || !existsSync(subprocessEntry)) skip(`未找到解包后的 DSH 安装：${dshRoot}`)
+if (!existsSync(join(ptyPrebuild, 'pty.node')) || !existsSync(join(ptyPrebuild, 'spawn-helper'))) {
+  skip(`node-pty 原生模块缺失：${ptyPrebuild}（可从 DSH.app/Contents/Resources/app.asar.unpacked 复制）`)
+}
+
+let passed = 0
+let failed = 0
+function check(name, condition, detail) {
+  if (condition) {
+    passed += 1
+    console.log(`  ok   ${name}`)
+  } else {
+    failed += 1
+    console.error(`  FAIL ${name}${detail === undefined ? '' : ` — ${detail}`}`)
+  }
+}
+
+const { Context } = await import(pathToFileURL(cordisEntry).href)
+const { default: LocalSubprocessRuntime } = await import(pathToFileURL(subprocessEntry).href)
+const { ProjectRegistry } = await import(pathToFileURL(join(packageRoot, 'host', 'context.js')).href)
+const terminal = await import(pathToFileURL(join(packageRoot, 'host', 'terminal.js')).href)
+
+/* ── 假 router / WS 连接（与 selftest-terminal.mjs 一致） ───────────────── */
+function makeRouter() {
+  const router = {
+    methods: new Map(),
+    sockets: [],
+    disposers: [],
+    method(name, fn) {
+      router.methods.set(name, fn)
+    },
+    ws(channel, handler) {
+      router.sockets.push({ channel, handler })
+    },
+    onDispose(fn) {
+      router.disposers.push(fn)
+    },
+  }
+  return router
+}
+function makeConnection() {
+  const handlers = new Map()
+  const connection = {
+    readyState: 1,
+    bufferedAmount: 0,
+    frames: [],
+    send(text) {
+      connection.frames.push(JSON.parse(text))
+    },
+    close() {},
+    ping() {},
+    on(event, fn) {
+      handlers.set(event, fn)
+    },
+    once(event, fn) {
+      handlers.set(event, fn)
+    },
+    emit(event, value) {
+      handlers.get(event)?.(value)
+    },
+  }
+  return connection
+}
+const sleep = (ms) => new Promise((done) => setTimeout(done, ms))
+const textOf = (connection) => connection.frames.filter((frame) => frame.type === 'output').map((frame) => frame.data).join('')
+const lastOutput = (connection) => [...connection.frames].reverse().find((frame) => frame.type === 'output')
+
+/* ── 启动真实 subprocess 服务 ──────────────────────────────────────────── */
+const ctx = new Context()
+ctx.logger = { debug() {}, warn() {}, error: (...args) => console.error('[host]', ...args) }
+const runtime = new LocalSubprocessRuntime(ctx)
+check('ctx.get(subprocess).spawnTerminal 可用', typeof ctx.get('subprocess')?.spawnTerminal === 'function')
+
+const sandboxRoot = mkdtempSync(join(tmpdir(), 'gufa-terminal-pty-'))
+const projectDir = join(sandboxRoot, 'project')
+mkdirSync(projectDir)
+const router = makeRouter()
+const env = { ctx, projects: new ProjectRegistry() }
+const opened = await env.projects.open(projectDir)
+terminal.register(router, env)
+const call = (name, body = {}) => router.methods.get(name)(body, {})
+const wsUrl = (id, since) => new URL(`http://dsh.local/gufa-code/ws?channel=terminal&root=${encodeURIComponent(opened.root)}&id=${encodeURIComponent(id)}${since === undefined ? '' : `&since=${since}`}`)
+const attach = (connection, id, since) => router.sockets.find((socket) => socket.channel === 'terminal').handler(connection, wsUrl(id, since), {})
+
+try {
+  console.log('真实 PTY：create / 输入输出 / resize')
+  process.env.GUFA_TERMINAL_SELFTEST_TOKEN = 'must-not-leak'
+  const created = await call('terminal.create', { root: opened.root, cols: 100, rows: 30 })
+  check('create 返回 title=zsh', created.title === 'zsh', created.title)
+
+  const connection = makeConnection()
+  attach(connection, created.id)
+  await sleep(2500)
+  // 通过 shell 打印敏感变量（应为空）与中间结果，验证环境过滤 + PTY 双向通道
+  connection.emit('message', Buffer.from(JSON.stringify({ type: 'input', data: `printf 'token=[%s]\\n' "$GUFA_TERMINAL_SELFTEST_TOKEN"; echo REAL_PTY_$((6*7))\r` })))
+  await sleep(2000)
+  const streamText = textOf(connection)
+  check('PTY 输出回传（命令结果）', streamText.includes('REAL_PTY_42'))
+  check('敏感环境变量被过滤', streamText.includes('token=[]'), JSON.stringify(streamText.slice(-120)))
+
+  connection.emit('message', Buffer.from(JSON.stringify({ type: 'resize', cols: 120, rows: 40 })))
+  await sleep(400)
+  const resized = await call('terminal.list', { root: opened.root })
+  check('resize 生效', resized.terminals[0]?.cols === 120 && resized.terminals[0]?.rows === 40, JSON.stringify(resized.terminals[0]))
+
+  console.log('真实 PTY：since 增量回放')
+  const bytes1 = lastOutput(connection).offset + Buffer.byteLength(lastOutput(connection).data)
+  connection.emit('close')
+  await sleep(100)
+  const c2 = makeConnection()
+  attach(c2, created.id, bytes1)
+  check('无新输出时 since 重连不重复回放', textOf(c2).length === 0)
+  c2.emit('message', Buffer.from(JSON.stringify({ type: 'input', data: 'echo MARK_AFTER_RECONNECT\r' })))
+  await sleep(1500)
+  check('since 重连后仍可输入输出', textOf(c2).includes('MARK_AFTER_RECONNECT'))
+  const bytes2 = lastOutput(c2).offset + Buffer.byteLength(lastOutput(c2).data)
+  c2.emit('close')
+  await sleep(100)
+
+  // c2 断开期间由另一个连接产生输出，再以 bytes2 重连：只补缺失段
+  const producer = makeConnection()
+  attach(producer, created.id)
+  producer.emit('message', Buffer.from(JSON.stringify({ type: 'input', data: 'echo MISSED_WHILE_OFFLINE\r' })))
+  await sleep(1500)
+  producer.emit('close')
+  await sleep(100)
+  const catchUp = makeConnection()
+  attach(catchUp, created.id, bytes2)
+  const catchUpText = textOf(catchUp)
+  check('since 重连补发缺失输出', catchUpText.includes('MISSED_WHILE_OFFLINE'))
+  check('since 重连不重复已有输出', !catchUpText.includes('MARK_AFTER_RECONNECT'))
+  check('补发帧 offset 等于 since', lastOutput(catchUp)?.offset === bytes2)
+  const latestBytes = lastOutput(catchUp).offset + Buffer.byteLength(lastOutput(catchUp).data)
+  const idle = makeConnection()
+  attach(idle, created.id, latestBytes)
+  check('since 等于最新偏移时无回放', textOf(idle).length === 0)
+
+  console.log('真实 PTY：exit / close')
+  catchUp.emit('message', Buffer.from(JSON.stringify({ type: 'input', data: 'exit\r' })))
+  await sleep(2000)
+  const exitFrame = [...catchUp.frames, ...idle.frames].find((frame) => frame.type === 'exit')
+  check('shell 退出广播 exit 帧', exitFrame !== undefined && typeof exitFrame.code === 'number', JSON.stringify(exitFrame))
+  const closed = await call('terminal.close', { root: opened.root, id: created.id })
+  check('terminal.close 幂等成功', closed.ok === true)
+} finally {
+  for (const dispose of router.disposers) dispose()
+  await sleep(500)
+  rmSync(sandboxRoot, { recursive: true, force: true })
+  // 释放 subprocess 服务（会终止仍存活的 PTY）
+  try {
+    await runtime.disposeManagedProcesses?.()
+  } catch {
+    /* ignore */
+  }
+}
+
+console.log(`\n${passed} passed, ${failed} failed`)
+process.exit(failed === 0 ? 0 : 1)