This commit is contained in:
LZX committed 2026-09-13 16:41:19 +08:00
1 parent 87e03ce0d8
commit e932c60dbd
47 files changed
+4417 -923

No files matched your search

+142 -29
View File
@@ -1,56 +1,169 @@
import 'dart:async';
import 'dart:convert';
import 'package:code_editor/services/distro_manager.dart';
import 'package:flutter/material.dart';
import 'package:flutter_pty/flutter_pty.dart';
import 'package:xterm/xterm.dart';
/// 单个终端会话的数据与状态模型
/// 单个真实交互式终端会话的数据与状态模型(基于 原生 Unix PTY 伪终端)
class TerminalSession {
final String id;
String name;
final String distroId;
final DateTime createdAt;
final List<String> outputLines;
final TextEditingController inputController;
final ScrollController scrollController;
final Terminal terminal;
final FocusNode focusNode;
Pty? _pty;
StreamSubscription? _ptyOutputSub;
bool _isProcessRunning = false;
String _inputBuffer = '';
TerminalSession({
required this.id,
this.name = '会话',
this.distroId = 'alpine',
DateTime? createdAt,
List<String>? initialOutput,
int maxLines = 10000,
bool autoStartProcess = false,
}) : createdAt = createdAt ?? DateTime.now(),
outputLines = initialOutput ?? <String>[],
inputController = TextEditingController(),
scrollController = ScrollController(),
focusNode = FocusNode();
/// 向终端输出追加内容
void appendOutput(String line) {
outputLines.add(line);
_autoScrollToBottom();
terminal = Terminal(maxLines: maxLines),
focusNode = FocusNode() {
_initTerminalEvents();
if (autoStartProcess) {
unawaited(startProcess());
}
}
/// 自动滚动到终端最底部
void _autoScrollToBottom() {
WidgetsBinding.instance.addPostFrameCallback((_) {
if (scrollController.hasClients) {
scrollController.animateTo(
scrollController.position.maxScrollExtent,
duration: const Duration(milliseconds: 100),
curve: Curves.easeOut,
);
bool get isProcessRunning => _isProcessRunning;
/// 获取终端缓冲区当前全部可见文本(常用于测试与日志断言)
String get bufferText => terminal.buffer.getText();
void _initTerminalEvents() {
// 监听输入直接送往 PTY
terminal.onOutput = (data) {
if (_pty != null && _isProcessRunning) {
try {
_pty!.write(utf8.encode(data));
} catch (_) {}
} else {
_handleLocalEcho(data);
}
});
};
// 监听终端视口尺寸变化并同步给底层 PTY
terminal.onResize = (width, height, pixelWidth, pixelHeight) {
if (_pty != null && _isProcessRunning) {
try {
_pty!.resize(height, width);
} catch (_) {}
}
};
}
/// 清屏
/// 当无底层进程挂接时的本地简易交互回显支持(保证脱机/本地开发时的基础交互与光标跳动)
void _handleLocalEcho(String data) {
for (int i = 0; i < data.length; i++) {
final char = data[i];
if (char == '\r' || char == '\n') {
terminal.write('\r\n');
_executeLocalCommand(_inputBuffer.trim());
_inputBuffer = '';
} else if (char == '\x7f' || char == '\b') {
// 退格键
if (_inputBuffer.isNotEmpty) {
_inputBuffer = _inputBuffer.substring(0, _inputBuffer.length - 1);
terminal.write('\b \b');
}
} else if (char.codeUnitAt(0) >= 32) {
_inputBuffer += char;
terminal.write(char);
}
}
}
void _executeLocalCommand(String cmd) {
if (cmd.isEmpty) {
terminal.write('\$ ');
return;
}
if (cmd == 'clear') {
clear();
terminal.write('\$ ');
return;
}
terminal.write('\x1b[33m[Host fallback]: executed "$cmd"\x1b[0m\r\n');
terminal.write('\$ ');
}
/// 启动底层真实 PTY 进程(连接 PRoot 容器或 Host Shell)
Future<void> startProcess({DistroManager? distroManager, String? workspacePath}) async {
final manager = distroManager ?? DistroManager();
try {
final config = await manager.buildLaunchConfig(
systemName: distroId,
workspacePath: workspacePath,
);
final initialRows = terminal.viewHeight > 0 ? terminal.viewHeight : 24;
final initialCols = terminal.viewWidth > 0 ? terminal.viewWidth : 80;
// 使用真实 Unix 伪终端 (PTY) 启动子进程
_pty = Pty.start(
config.executable,
arguments: config.arguments,
environment: config.environment,
workingDirectory: config.workingDirectory,
rows: initialRows,
columns: initialCols,
);
_isProcessRunning = true;
// PTY 输出数据流实时解码并写入终端
_ptyOutputSub = _pty!.output.listen(
(bytes) {
terminal.write(utf8.decode(bytes, allowMalformed: true));
},
onError: (err) {
terminal.write('\r\n\x1b[31m[PTY Output error: $err]\x1b[0m\r\n');
},
onDone: () {
_isProcessRunning = false;
},
);
_pty!.exitCode.then((code) {
_isProcessRunning = false;
terminal.write('\r\n\x1b[33m[Process exited with code $code]\x1b[0m\r\n');
});
} catch (e) {
_isProcessRunning = false;
terminal.write('\x1b[1;36mWelcome to Terminal [$distroId]\x1b[0m\r\n');
terminal.write('\x1b[90m(PTY launch failed: $e. Running in local fallback mode.)\x1b[0m\r\n\r\n');
terminal.write('\$ ');
}
}
/// 向终端写入文本(支持 VT100 / ANSI 转义序列)
void write(String text) {
terminal.write(text);
}
/// 发送标准 ANSI 清屏并复位光标
void clear() {
outputLines.clear();
terminal.write('\x1b[2J\x1b[H');
}
/// 释放资源
/// 释放 PTY 进程与焦点资源
void dispose() {
inputController.dispose();
scrollController.dispose();
_ptyOutputSub?.cancel();
if (_pty != null) {
try {
_pty!.kill();
} catch (_) {}
_pty = null;
}
focusNode.dispose();
}
}