Baobhan Sith
488 lines
20 KiB
Vue
488 lines
20 KiB
Vue
<script setup lang="ts">
|
|
import { ref, onMounted, onBeforeUnmount, watch, nextTick } from 'vue';
|
|
import { ITheme } from 'xterm';
|
|
import { Terminal, ITerminalAddon, IDisposable } from 'xterm'; // +++ 导入 ITerminalAddon 和 IDisposable +++
|
|
import { useAppearanceStore } from '../stores/appearance.store'; // 导入外观 store
|
|
import { useSettingsStore } from '../stores/settings.store'; // +++ 导入设置 store +++
|
|
import { storeToRefs } from 'pinia'; // 导入 storeToRefs
|
|
import { FitAddon } from 'xterm-addon-fit';
|
|
import { WebLinksAddon } from 'xterm-addon-web-links';
|
|
import { SearchAddon, type ISearchOptions } from '@xterm/addon-search'; // *** 更新导入路径 ***
|
|
import 'xterm/css/xterm.css'; // 引入 xterm 样式
|
|
// *** 移除无效的 CSS 导入 ***
|
|
|
|
// 定义 props 和 emits
|
|
const props = defineProps<{
|
|
sessionId: string; // 会话 ID
|
|
isActive: boolean; // 新增：标记此终端是否为活动标签页
|
|
stream?: ReadableStream<string>; // 用于接收来自 WebSocket 的数据流 (可选)
|
|
options?: object; // xterm 的配置选项
|
|
}>();
|
|
|
|
const emit = defineEmits<{
|
|
(e: 'data', data: string): void; // 用户输入事件
|
|
(e: 'resize', dimensions: { cols: number; rows: number }): void; // 终端大小调整事件
|
|
// *** 更新 ready 事件 payload，包含 searchAddon ***
|
|
(e: 'ready', payload: { sessionId: string; terminal: Terminal; searchAddon: SearchAddon | null }): void;
|
|
}>();
|
|
|
|
const terminalRef = ref<HTMLElement | null>(null); // 终端容器的引用
|
|
let terminal: Terminal | null = null;
|
|
let fitAddon: FitAddon | null = null;
|
|
let searchAddon: SearchAddon | null = null; // *** 添加 searchAddon 变量 ***
|
|
let resizeObserver: ResizeObserver | null = null;
|
|
let debounceTimer: number | null = null; // 用于防抖的计时器 ID
|
|
let selectionListenerDisposable: IDisposable | null = null; // +++ 提升声明并添加类型 +++
|
|
// const fontSize = ref(14); // 移除本地字体大小状态，将由 store 管理
|
|
|
|
// --- Appearance Store ---
|
|
const appearanceStore = useAppearanceStore();
|
|
const { currentTerminalTheme, currentTerminalFontFamily, terminalBackgroundImage, currentTerminalFontSize } = storeToRefs(appearanceStore); // <-- 添加 currentTerminalFontSize
|
|
|
|
// --- Settings Store ---
|
|
const settingsStore = useSettingsStore(); // +++ 实例化设置 store +++
|
|
const { autoCopyOnSelectBoolean } = storeToRefs(settingsStore); // +++ 获取选中即复制状态 +++
|
|
|
|
// 防抖函数
|
|
const debounce = (func: Function, delay: number) => {
|
|
let timeoutId: number | null = null; // Use a local variable for the timeout ID
|
|
return (...args: any[]) => {
|
|
if (timeoutId !== null) {
|
|
clearTimeout(timeoutId);
|
|
}
|
|
timeoutId = window.setTimeout(() => {
|
|
func(...args);
|
|
timeoutId = null;
|
|
}, delay);
|
|
};
|
|
};
|
|
|
|
// 防抖处理由 ResizeObserver 触发的 resize 事件
|
|
const debouncedEmitResize = debounce((term: Terminal) => {
|
|
if (term && props.isActive) { // 仅当标签仍处于活动状态时才发送防抖后的 resize
|
|
const dimensions = { cols: term.cols, rows: term.rows };
|
|
console.log(`[Terminal ${props.sessionId}] Debounced resize emit (from ResizeObserver):`, dimensions);
|
|
emit('resize', dimensions);
|
|
// *** 新增：尝试在发送 resize 后强制刷新终端显示 ***
|
|
try {
|
|
term.refresh(0, term.rows - 1); // Refresh entire viewport
|
|
console.log(`[Terminal ${props.sessionId}] Terminal refreshed after debounced resize.`);
|
|
} catch (e) {
|
|
console.warn(`[Terminal ${props.sessionId}] Terminal refresh failed:`, e);
|
|
}
|
|
} else {
|
|
console.log(`[Terminal ${props.sessionId}] Debounced resize skipped (inactive).`);
|
|
}
|
|
}, 150); // 150ms 防抖延迟
|
|
|
|
// 立即执行 Fit 并发送 Resize 的函数
|
|
const fitAndEmitResizeNow = (term: Terminal) => {
|
|
if (!term) return;
|
|
try {
|
|
fitAddon?.fit();
|
|
const dimensions = { cols: term.cols, rows: term.rows };
|
|
console.log(`[Terminal ${props.sessionId}] Immediate resize emit:`, dimensions);
|
|
emit('resize', dimensions);
|
|
} catch (e) {
|
|
console.warn("Immediate fit/resize failed:", e);
|
|
}
|
|
};
|
|
|
|
// 创建防抖版的字体大小保存函数
|
|
const debouncedSetTerminalFontSize = debounce(async (size: number) => {
|
|
try {
|
|
await appearanceStore.setTerminalFontSize(size);
|
|
console.log(`[Terminal ${props.sessionId}] Debounced font size saved: ${size}`);
|
|
} catch (error) {
|
|
console.error(`[Terminal ${props.sessionId}] Debounced font size save failed:`, error);
|
|
// Optionally show an error to the user
|
|
}
|
|
}, 500); // 500ms 防抖延迟，可以调整
|
|
|
|
// 初始化终端
|
|
onMounted(() => {
|
|
if (terminalRef.value) {
|
|
terminal = new Terminal({
|
|
cursorBlink: true,
|
|
fontSize: currentTerminalFontSize.value, // <-- 使用 store 中的字体大小
|
|
fontFamily: currentTerminalFontFamily.value, // 使用 store 中的字体设置
|
|
theme: currentTerminalTheme.value, // 使用 store 中的当前 xterm 主题
|
|
rows: 24, // 初始行数
|
|
cols: 80, // 初始列数
|
|
allowTransparency: true,
|
|
disableStdin: false,
|
|
convertEol: true,
|
|
scrollback: 1000, // 减少可滚动历史行数
|
|
scrollOnUserInput: true, // 输入时滚动到底部
|
|
...props.options, // 合并外部传入的选项
|
|
});
|
|
|
|
// 注意: 终端数据的解码已在useSshTerminal.ts中进行处理
|
|
|
|
// 加载插件
|
|
fitAddon = new FitAddon();
|
|
searchAddon = new SearchAddon(); // *** 创建 SearchAddon 实例 ***
|
|
terminal.loadAddon(fitAddon);
|
|
terminal.loadAddon(new WebLinksAddon());
|
|
terminal.loadAddon(searchAddon); // *** 加载 SearchAddon ***
|
|
|
|
// 将终端附加到 DOM
|
|
terminal.open(terminalRef.value);
|
|
|
|
// 适应容器大小
|
|
fitAddon.fit();
|
|
emit('resize', { cols: terminal.cols, rows: terminal.rows }); // 触发初始 resize 事件
|
|
|
|
// 监听用户输入
|
|
terminal.onData((data) => {
|
|
emit('data', data);
|
|
});
|
|
|
|
// 监听终端大小变化 (通过 ResizeObserver) - 主要处理浏览器窗口大小变化等
|
|
if (terminalRef.value) {
|
|
const container = terminalRef.value; // 捕获引用
|
|
resizeObserver = new ResizeObserver((entries) => {
|
|
const entry = entries[0];
|
|
const { height, width } = entry.contentRect; // 获取宽度和高度
|
|
// console.log(`[Terminal ${props.sessionId}] ResizeObserver triggered. Size: ${width}x${height}, isActive: ${props.isActive}`);
|
|
if (height > 0 && width > 0 && terminal) { // 确保宽度和高度都有效，并且终端实例存在
|
|
try {
|
|
// *** 恢复：立即调用 fit() 来适应前端容器 ***
|
|
fitAddon?.fit();
|
|
// 触发防抖的 resize 发送，通知后端潜在的尺寸变化
|
|
debouncedEmitResize(terminal);
|
|
} catch (e) {
|
|
console.warn("Fit addon resize failed (observer):", e);
|
|
}
|
|
}
|
|
});
|
|
resizeObserver.observe(container);
|
|
}
|
|
|
|
// 监听 isActive prop 的变化，当标签变为活动时立即 fit 并发送 resize
|
|
watch(() => props.isActive, (newValue) => {
|
|
if (newValue && terminal && terminalRef.value) {
|
|
// 当标签变为活动时，等待 DOM 更新和短暂延时后执行 fit
|
|
console.log(`[Terminal ${props.sessionId}] 标签变为活动状态，准备调整尺寸。`); // 日志改为中文
|
|
nextTick(() => {
|
|
// 添加短暂延时，确保元素完全可见且渲染稳定
|
|
setTimeout(() => {
|
|
// 再次检查终端实例是否存在且容器可见
|
|
if (terminal && terminalRef.value && terminalRef.value.offsetHeight > 0) {
|
|
console.log(`[Terminal ${props.sessionId}] 执行延时后的 fit 和 resize。`); // 日志改为中文
|
|
fitAndEmitResizeNow(terminal);
|
|
} else {
|
|
console.log(`[Terminal ${props.sessionId}] 延时后检查：终端不可见或已销毁，跳过 fit。`); // 日志改为中文
|
|
}
|
|
}, 50); // 50ms 延时，可以根据需要调整
|
|
});
|
|
}
|
|
});
|
|
|
|
// // 监听 fitAddon 的 resize 事件，获取新的尺寸并触发 emit
|
|
// // 注意：fitAddon 本身不直接触发 resize 事件，我们需要在 fit() 后手动获取
|
|
// const originalFit = fitAddon.fit.bind(fitAddon);
|
|
// fitAddon.fit = () => {
|
|
// originalFit();
|
|
// if (terminal) {
|
|
// emit('resize', { cols: terminal.cols, rows: terminal.rows });
|
|
// }
|
|
// };
|
|
|
|
|
|
// 处理传入的数据流 (如果提供了 stream prop)
|
|
watch(() => props.stream, async (newStream) => {
|
|
if (newStream) {
|
|
const reader = newStream.getReader();
|
|
try {
|
|
while (true) {
|
|
const { done, value } = await reader.read();
|
|
if (done) break;
|
|
if (terminal && value) {
|
|
terminal.write(value); // 将流数据写入终端
|
|
// 移除此处不必要的 fit() 调用
|
|
}
|
|
}
|
|
} catch (error) {
|
|
console.error('读取终端流时出错:', error);
|
|
} finally {
|
|
reader.releaseLock();
|
|
}
|
|
}
|
|
}, { immediate: true }); // 立即执行一次 watch
|
|
|
|
// 触发 ready 事件，传递 sessionId, terminal 和 searchAddon 实例
|
|
if (terminal) {
|
|
emit('ready', { sessionId: props.sessionId, terminal: terminal, searchAddon: searchAddon });
|
|
}
|
|
|
|
// --- 监听并处理选中即复制 ---
|
|
let currentSelection = ''; // 存储当前选区内容，避免重复复制空内容
|
|
const handleSelectionChange = () => {
|
|
if (terminal && autoCopyOnSelectBoolean.value) {
|
|
const newSelection = terminal.getSelection();
|
|
// 仅在选区内容发生变化且不为空时执行复制
|
|
if (newSelection && newSelection !== currentSelection) {
|
|
currentSelection = newSelection;
|
|
navigator.clipboard.writeText(newSelection).then(() => {
|
|
// console.log('[Terminal] 文本已自动复制到剪贴板:', newSelection); // 可选：成功日志
|
|
}).catch(err => {
|
|
console.error('[Terminal] 自动复制到剪贴板失败:', err);
|
|
// 可以在这里向用户显示一个短暂的错误提示
|
|
});
|
|
} else if (!newSelection) {
|
|
// 如果新选区为空，重置 currentSelection
|
|
currentSelection = '';
|
|
}
|
|
} else {
|
|
// 如果设置关闭，也重置 currentSelection
|
|
currentSelection = '';
|
|
}
|
|
};
|
|
|
|
// 添加防抖以避免过于频繁地触发 handleSelectionChange
|
|
const debouncedSelectionChange = debounce(handleSelectionChange, 50); // 50ms 防抖
|
|
|
|
// 监听 xterm 的 selectionChange 事件
|
|
selectionListenerDisposable = terminal.onSelectionChange(debouncedSelectionChange); // Assign to outer variable
|
|
|
|
// 监听设置变化，如果关闭了自动复制，确保清除可能存在的旧选区状态
|
|
watch(autoCopyOnSelectBoolean, (newValue) => {
|
|
if (!newValue) {
|
|
currentSelection = '';
|
|
}
|
|
});
|
|
|
|
// --- 监听外观变化 ---
|
|
watch(currentTerminalTheme, (newTheme) => {
|
|
if (terminal) {
|
|
console.log(`[Terminal ${props.sessionId}] 应用新终端主题。`);
|
|
// 直接修改 options 对象
|
|
terminal.options.theme = newTheme;
|
|
// 修改选项后需要刷新终端才能生效
|
|
try {
|
|
// 刷新整个视口
|
|
terminal.refresh(0, terminal.rows - 1);
|
|
console.log(`[Terminal ${props.sessionId}] 终端已刷新以应用新主题。`);
|
|
} catch (e) {
|
|
console.warn(`[Terminal ${props.sessionId}] 刷新终端以应用主题时出错:`, e);
|
|
}
|
|
}
|
|
}, { deep: true });
|
|
|
|
watch(currentTerminalFontFamily, (newFontFamily) => {
|
|
if (terminal) {
|
|
console.log(`[Terminal ${props.sessionId}] 应用新终端字体: ${newFontFamily}`);
|
|
terminal.options.fontFamily = newFontFamily;
|
|
// 字体变化可能影响尺寸，重新 fit
|
|
fitAndEmitResizeNow(terminal);
|
|
}
|
|
});
|
|
|
|
// 监听字体大小变化
|
|
watch(currentTerminalFontSize, (newSize) => {
|
|
if (terminal) {
|
|
console.log(`[Terminal ${props.sessionId}] 应用新终端字体大小: ${newSize}`);
|
|
terminal.options.fontSize = newSize;
|
|
// 字体大小变化需要重新 fit
|
|
fitAndEmitResizeNow(terminal);
|
|
}
|
|
});
|
|
|
|
// 监听背景图片变化
|
|
watch(terminalBackgroundImage, () => { // 只监听图片
|
|
console.log(`[Terminal Watcher] terminalBackgroundImage changed. New image: ${terminalBackgroundImage.value}`); // 添加日志确认 watcher 触发
|
|
applyTerminalBackground();
|
|
}, { immediate: true }); // 添加 immediate: true，强制立即执行一次
|
|
// 移除 onMounted 中的 applyTerminalBackground 调用，完全依赖 watch
|
|
// applyTerminalBackground(); // 初始应用一次
|
|
|
|
// 聚焦终端 (添加 null check)
|
|
if (terminal) {
|
|
terminal.focus();
|
|
}
|
|
// 重新添加鼠标滚轮缩放功能
|
|
if (terminalRef.value) {
|
|
terminalRef.value.addEventListener('wheel', (event: WheelEvent) => {
|
|
// // 只在按下Ctrl键时才触发缩放
|
|
// if (event.ctrlKey) {
|
|
// event.preventDefault(); // 阻止默认的滚动行为
|
|
|
|
// // 根据滚轮方向调整字体大小
|
|
// if (event.deltaY < 0) {
|
|
// // 向上滚动，增大字体
|
|
// fontSize.value = Math.min(fontSize.value + 1, 40); // 设置最大字体大小为40
|
|
// } else {
|
|
// // 向下滚动，减小字体
|
|
// fontSize.value = Math.max(fontSize.value - 1, 8); // 设置最小字体大小为8
|
|
// }
|
|
|
|
// // 更新终端字体大小
|
|
// if (terminal) {
|
|
// terminal.options.fontSize = fontSize.value;
|
|
// // 调整终端大小以适应新的字体大小
|
|
// fitAddon?.fit();
|
|
// emit('resize', { cols: terminal.cols, rows: terminal.rows });
|
|
// }
|
|
// 只在按下Ctrl键时才触发缩放
|
|
if (event.ctrlKey) {
|
|
event.preventDefault(); // 阻止默认的滚动行为
|
|
|
|
// 根据滚轮方向调整字体大小
|
|
// 直接读取和修改 terminal 实例的字体大小
|
|
if (terminal) {
|
|
let newSize;
|
|
if (event.deltaY < 0) {
|
|
// 向上滚动，增大字体
|
|
newSize = Math.min((terminal.options.fontSize ?? currentTerminalFontSize.value) + 1, 40); // 使用当前实例值或 store 值作为基础
|
|
} else {
|
|
// 向下滚动，减小字体
|
|
newSize = Math.max((terminal.options.fontSize ?? currentTerminalFontSize.value) - 1, 8); // 使用当前实例值或 store 值作为基础
|
|
}
|
|
// 立即更新视觉效果
|
|
terminal.options.fontSize = newSize;
|
|
fitAddon?.fit();
|
|
// 注意：fit() 内部可能不会触发 resize 事件，如果需要精确通知后端，可能需要额外处理，但 fitAndEmitResizeNow 应该足够
|
|
// emit('resize', { cols: terminal.cols, rows: terminal.rows }); // 避免重复发送 resize
|
|
|
|
// 调用防抖函数来保存设置
|
|
debouncedSetTerminalFontSize(newSize);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
}
|
|
});
|
|
|
|
// 组件卸载前清理资源
|
|
onBeforeUnmount(() => {
|
|
if (resizeObserver && terminalRef.value) {
|
|
resizeObserver.unobserve(terminalRef.value);
|
|
}
|
|
if (terminal) {
|
|
terminal.dispose();
|
|
terminal = null;
|
|
}
|
|
|
|
// 在卸载前清理选择监听器
|
|
if (selectionListenerDisposable) {
|
|
selectionListenerDisposable.dispose();
|
|
}
|
|
});
|
|
|
|
// 暴露 write 方法给父组件 (可选)
|
|
const write = (data: string | Uint8Array) => {
|
|
terminal?.write(data);
|
|
};
|
|
|
|
// *** 暴露搜索方法 ***
|
|
const findNext = (term: string, options?: ISearchOptions): boolean => {
|
|
if (searchAddon) {
|
|
return searchAddon.findNext(term, options);
|
|
}
|
|
return false;
|
|
};
|
|
|
|
const findPrevious = (term: string, options?: ISearchOptions): boolean => {
|
|
if (searchAddon) {
|
|
return searchAddon.findPrevious(term, options);
|
|
}
|
|
return false;
|
|
};
|
|
|
|
const clearSearch = () => {
|
|
searchAddon?.clearDecorations();
|
|
};
|
|
|
|
defineExpose({ write, findNext, findPrevious, clearSearch });
|
|
|
|
|
|
// --- 应用终端背景 ---
|
|
const applyTerminalBackground = () => {
|
|
if (terminalRef.value) {
|
|
if (terminalBackgroundImage.value) {
|
|
// --- 修改开始 ---
|
|
// 使用环境变量获取后端基础 URL
|
|
const backendUrl = import.meta.env.VITE_API_BASE_URL || ''; // 提供一个默认空字符串以防万一
|
|
const imagePath = terminalBackgroundImage.value;
|
|
console.log(`[Terminal applyTerminalBackground] backendUrl: "${backendUrl}", imagePath: "${imagePath}"`); // 详细日志
|
|
const fullImageUrl = `${backendUrl}${imagePath}`;
|
|
console.log(`[Terminal applyTerminalBackground] fullImageUrl: "${fullImageUrl}"`); // 打印完整 URL
|
|
// --- 修改结束 ---
|
|
// --- 使用 nextTick 包装样式应用 ---
|
|
nextTick(() => {
|
|
if (terminalRef.value) { // 再次检查 ref 是否存在
|
|
terminalRef.value.style.backgroundImage = `url(${fullImageUrl})`;
|
|
terminalRef.value.style.backgroundSize = 'cover'; // Or 'contain', 'auto', etc.
|
|
terminalRef.value.style.backgroundPosition = 'center';
|
|
terminalRef.value.style.backgroundRepeat = 'no-repeat';
|
|
// 添加 CSS 类
|
|
terminalRef.value.classList.add('has-terminal-background');
|
|
}
|
|
});
|
|
// 应用透明度: 通过设置背景色实现，需要 xterm 的 allowTransparency: true
|
|
// 注意：这会影响整个终端的背景，包括文本后的背景
|
|
// 一个常见的做法是设置一个稍微透明的背景色，让图片透出来
|
|
// 例如，将 xterm 主题的 background 设置为 rgba(r, g, b, opacity)
|
|
// 这里我们简单设置容器的 opacity，但这会影响文本！更好的方法是修改主题。
|
|
// 另一种方法是用伪元素做背景层。
|
|
// 为了简单起见，我们暂时只设置背景图，透明度让用户在主题中调整 background 的 alpha 值。
|
|
// terminalRef.value.style.opacity = terminalBackgroundOpacity.value.toString(); // 不推荐直接设置 opacity
|
|
console.log(`[Terminal ${props.sessionId}] 应用终端背景图片: ${terminalBackgroundImage.value}`);
|
|
} else {
|
|
// --- 使用 nextTick 包装样式移除 ---
|
|
nextTick(() => {
|
|
if (terminalRef.value) { // 再次检查 ref 是否存在
|
|
terminalRef.value.style.backgroundImage = 'none';
|
|
// 移除 CSS 类
|
|
terminalRef.value.classList.remove('has-terminal-background');
|
|
}
|
|
});
|
|
// terminalRef.value.style.opacity = '1'; // 移除背景时恢复不透明
|
|
console.log(`[Terminal ${props.sessionId}] 移除终端背景图片。`);
|
|
}
|
|
}
|
|
};
|
|
|
|
</script>
|
|
|
|
<template>
|
|
<div ref="terminalRef" class="terminal-container"></div>
|
|
</template>
|
|
|
|
<style scoped>
|
|
/* 容器样式，确保填满并隐藏自身滚动条 */
|
|
.terminal-container {
|
|
width: 100%;
|
|
height: 100%; /* 高度需要由父容器控制 */
|
|
overflow: hidden; /* 阻止此容器本身产生滚动条 */
|
|
position: relative; /* 用于可能的伪元素背景 */
|
|
}
|
|
|
|
/* 移除 :deep 样式，让 xterm 内部自然处理滚动 */
|
|
|
|
/* 示例：使用伪元素添加带透明度的背景层 (如果需要独立于主题的透明度) */
|
|
/*
|
|
.terminal-container::before {
|
|
content: '';
|
|
position: absolute;
|
|
top: 0;
|
|
left: 0;
|
|
right: 0;
|
|
bottom: 0;
|
|
background-image: var(--terminal-bg-image);
|
|
background-size: cover;
|
|
background-position: center;
|
|
background-repeat: no-repeat;
|
|
opacity: var(--terminal-bg-opacity);
|
|
z-index: -1; // 确保在 xterm 内容后面
|
|
}
|
|
*/
|
|
|
|
/* 当容器有背景图时，强制内部 xterm 视口和屏幕背景透明 */
|
|
.terminal-container.has-terminal-background :deep(.xterm-viewport),
|
|
.terminal-container.has-terminal-background :deep(.xterm-screen) {
|
|
background-color: transparent !important;
|
|
}
|
|
</style>
|