This commit is contained in:
zhongluofeng committed 2026-09-25 18:23:56 +08:00
1 parent 79bded1cd2
commit 9e6d73e191
73 files changed
+6229 -1427

No files matched your search

@@ -0,0 +1,398 @@
<script setup lang="ts">
/**
* 文件管理器:双栏(左 / 右各自选择连接)+ 方向式传输 + 传输进度。
*
* # 为什么是「双栏 + 两栏各自选连接」而不是「终端卡片里的会话面板」
*
* 面板原本长在终端卡片里、绑定当前会话,于是「本地 ↔ 远端」是唯一可能的组合,
* 而每次看文件都得先切到那个会话的标签。改成独立页面后,双栏的语义变成
* 「两台机器之间的关系」:本地 ↔ ssh1、ssh1 ↔ ssh2、ssh1 ↔ ssh1(同机跨目录)——
* 这些都是同一类动作,用同一套 UI 表达。
*
* # 为什么传输由这一层编排(而不是各栏自己传)
*
* 一次传输需要**两栏**的信息:源栏的选中项与 cwd、目标栏的 cwd 与连接。
* 单栏组件只看得到自己,若让它们各自发命令,就得让每一栏都持有一份「对面是什么」
* 的镜像状态 —— 那是两份会漂移的真相。因此:单栏负责「选中了什么」,
* 这一层负责「从谁传到哪里」。
*
* # 传输方向由连接组合决定,文案随之变化
*
* | 源 → 目标 | 命令 | 按钮文案 |
* |---|---|---|
* | 本地 → ssh | `terminal_sftp_upload` | 上传到远端 |
* | ssh → 本地 | `terminal_sftp_download` | 下载到本地 |
* | ssh → ssh | `terminal_sftp_relay`(流式中继,不经本地磁盘) | 中继到远端 |
* | 本地 → 本地 | —— | 禁用(没有传输语义) |
*
* 「本地↔本地」被**禁用而不是隐藏**:两栏都是本地时用户仍可能想复制文件,
* 灰掉的按钮配上说明(`transferBlocked`)比一个消失的按钮更容易理解。
* 同时两栏的选择器互相排他,避免走进这个组合 —— 见 `allowLocal` 的计算。
*/
import { computed, onMounted, ref, watch } from 'vue'
import {
ArrowDownToLine,
ArrowLeftRight,
ArrowUpFromLine,
FolderTree,
SquareArrowOutUpRight,
X
} from '@lucide/vue'
import { toast } from 'vue-sonner'
import { useTerminalStore } from '@/stores/terminalStore'
import { createLogger } from '@/lib/logger'
import { Button } from '@/components/ui/button'
import { Card } from '@/components/ui/card'
import PageToolbar from '@/components/layout/PageToolbar.vue'
import FilePane from './FilePane.vue'
import { baseName, humanSize, joinLocal, joinRemote, transferKind } from '../fileUtils'
import type { ActionOutcome, FileSource, SessionInfo } from '@/types/terminal'
defineProps<{
/**
* 独立窗口模式(`FileWindow` 复用本组件时置真)。
*
* 只有一件事不同:不渲染 `PageToolbar`(窗口自带控制栏,标题已在其中),
* 改为由本组件自带四周留白。两栏与传输逻辑完全共用 —— 与终端页 / 终端独立窗口
* 复用同一套组件的取舍一致。
*/
standalone?: boolean
}>()
const store = useTerminalStore()
const logger = createLogger('terminal')
const leftRef = ref<InstanceType<typeof FilePane> | null>(null)
const rightRef = ref<InstanceType<typeof FilePane> | null>(null)
/** 分栏容器:拖动分界线时按它的实际宽度换算百分比 */
const splitRowRef = ref<HTMLElement | null>(null)
// ===== 拖动分界线调整两栏宽度 =====
/**
* 拖动分界线。
*
* 事件挂在 **document** 而不是分界线自己:鼠标一旦快速划出那条 5px 的命中区,
* 挂在元素上的 `mousemove` 就断了(拖动会「粘住」或半路失效)。
* 同时用 `document.body` 上的 `user-select: none` 防止拖出选区(一份文本被选中后
* 半透明蓝底会盖住整个列表)。
*/
function startResize(e: MouseEvent) {
e.preventDefault()
const row = splitRowRef.value
if (!row) return
const rect = row.getBoundingClientRect()
if (rect.width <= 0) return
const prevSelect = document.body.style.userSelect
document.body.style.userSelect = 'none'
const onMove = (ev: MouseEvent) => {
store.setFilePaneSplit(((ev.clientX - rect.left) / rect.width) * 100)
}
const onUp = () => {
document.body.style.userSelect = prevSelect
document.removeEventListener('mousemove', onMove)
document.removeEventListener('mouseup', onUp)
}
document.addEventListener('mousemove', onMove)
document.addEventListener('mouseup', onUp)
}
const sources = computed(() => store.filePaneSources)
/**
* 可作为一栏来源的 SSH 会话。
*
* 只要**已建立**或**连接不稳定**的:连接中/认证中的会话还没有 SFTP 子系统可开,
* 已断开/失败的会话只会让列目录报错。「看得见但用不了」比「看不见」更让人困惑。
*/
const sessions = computed<SessionInfo[]>(() =>
store.sessions.filter(
s => s.kind === 'ssh' && (s.state === 'established' || s.state === 'degraded')
)
)
/** 本地↔本地没有传输语义,故两栏的「本地」互斥(谁的默认值先占上就留着) */
const allowLocalLeft = computed(() => sources.value.right?.kind !== 'local')
const allowLocalRight = computed(() => sources.value.left?.kind !== 'local')
function setSource(side: 'left' | 'right', v: FileSource | null) {
store.setFilePaneSource(side, v)
}
// ===== 传输 =====
const transferring = ref(false)
function kindOf(from: 'left' | 'right') {
const to = from === 'left' ? sources.value.right : sources.value.left
return transferKind(sources.value[from], to)
}
function labelOf(from: 'left' | 'right'): string {
switch (kindOf(from)) {
case 'upload':
return '上传到远端'
case 'download':
return '下载到本地'
case 'relay':
return '中继到远端'
default:
return '无法传送'
}
}
function blockedOf(from: 'left' | 'right'): string {
if (kindOf(from)) return ''
const self = sources.value[from]
const other = from === 'left' ? sources.value.right : sources.value.left
if (!self) return '本栏还没有选择连接'
if (!other) return '另一栏还没有选择连接(点上方按钮选择)'
if (self.kind === 'local' && other.kind === 'local')
return '两栏都是本地时无法直接传送;把其中一栏切到 SSH 会话即可'
return '当前两栏的组合不支持传送'
}
/** 进行中的传输(不再按会话过滤:一屏内能看到自己发起的全部传输) */
const activeTransfers = computed(() => store.transfers)
async function transfer(from: 'left' | 'right') {
const src = sources.value[from]
const dst = from === 'left' ? sources.value.right : sources.value.left
const kind = kindOf(from)
if (!src || !dst || !kind) {
toast.info(blockedOf(from))
return
}
const paneFrom = from === 'left' ? leftRef.value : rightRef.value
const paneTo = from === 'left' ? rightRef.value : leftRef.value
const files = (paneFrom?.getSelection() ?? []).filter(e => !e.isDir)
if (files.length === 0) {
toast.info('请先选择要传送的文件(目录递归传输属 P2)')
return
}
const toCwd = paneTo?.getCwd() ?? ''
if (!toCwd) {
toast.info('目标栏还没有打开目录')
return
}
// 组合由 `transferKind` 判定,这里把两栏的会话 id 取出来;任一侧缺失说明
// 连接在点击与执行之间变了(会话刚断开),直接提示重试而不是发一条注定失败的命令
const srcSsh = src.kind === 'ssh' ? src.sessionId : ''
const dstSsh = dst.kind === 'ssh' ? dst.sessionId : ''
const missing =
(kind === 'upload' && !dstSsh) ||
(kind === 'download' && !srcSsh) ||
(kind === 'relay' && (!srcSsh || !dstSsh))
if (missing) {
toast.error('连接状态已变化,请重新选择后再试')
return
}
transferring.value = true
let ok = 0
const failed: string[] = []
// 串行:受控并发的闸门(4 路)被占满时,文件名顺序错乱的进度条比
// 「一个一个来」更难读(与旧的单文件上传同一取舍)
for (const f of files) {
try {
let r: ActionOutcome
if (kind === 'upload') {
r = await store.sftpUpload(dstSsh, f.path, joinRemote(toCwd, f.name))
} else if (kind === 'download') {
r = await store.sftpDownload(srcSsh, f.path, joinLocal(toCwd, f.name))
} else {
r = await store.sftpRelay(srcSsh, f.path, dstSsh, joinRemote(toCwd, f.name))
}
if (r.ok) ok += 1
else failed.push(`${f.name}:${r.message}`)
} catch (e) {
failed.push(`${f.name}:${String(e)}`)
}
}
transferring.value = false
// 刷新目标栏:刚传过去的文件要立刻出现在眼前,否则用户会以为没成功
await paneTo?.reload()
const verb = kind === 'upload' ? '上传' : kind === 'download' ? '下载' : '中继'
if (failed.length === 0) toast.success(`已${verb} ${ok} 个文件`)
else if (ok > 0) toast.warning(`${verb}完成 ${ok} 个,失败 ${failed.length} 个:${failed.join(';')}`)
else toast.error(`${verb}失败:${failed.join(';')}`)
}
// ===== 独立窗口 =====
async function openWindow() {
try {
await store.openFileWindow()
} catch (e) {
logger.error(`打开文件窗口失败:${String(e)}`)
toast.error(`打开文件窗口失败:${String(e)}`)
}
}
// ===== 初始化 =====
/**
* 默认分栏。
*
* 左栏固定落本地(「我自己的机器」是绝大多数传输的起点),右栏取**第一个**已连接的
* SSH 会话。取「第一个」而不是「终端页当前激活的那个」:激活会话属于
* `useTerminalStream` 的窗口级局部状态(见 TerminalModule 的说明),这里读不到;
* 而从终端页跳过来的那条路径由 `TerminalWorkspace` 先把激活会话写进
* `filePaneSources.right`,效果等价。
*
* 每次挂载都跑一次:tab 切走会卸载本组件(连接选择存在 store 里,不丢),
* 但期间可能有关掉的会话 —— 失效的连接在这里被收敛掉。
*/
function initSources() {
const s = sources.value
const alive = (v: FileSource | null) =>
v?.kind === 'ssh' && sessions.value.some(x => x.id === v.sessionId)
if (s.left?.kind === 'ssh' && !alive(s.left)) setSource('left', { kind: 'local' })
// 只收敛「指向已消失会话」的右栏:右栏若被用户设成本地(左栏是 ssh),
// 它同样不是 ssh 来源,**不能**当成失效处理
if (s.right?.kind === 'ssh' && !alive(s.right)) setSource('right', null)
// 左栏若是空的(理论上不会:本地永远可用),补成本地
if (!sources.value.left) setSource('left', { kind: 'local' })
if (!sources.value.right) {
const first = sessions.value[0]
// 左栏已是本地时右栏不能也是本地 —— 所以没有 SSH 会话就保持空态
if (first) setSource('right', { kind: 'ssh', sessionId: first.id })
}
}
onMounted(() => {
initSources()
})
// 会话列表变化(连上/断开):失效的连接及时收敛,新连上的会话自动补上右栏
// ——后者只在右栏还是空态时发生,不覆盖用户已有的选择
watch(
() => sessions.value.map(s => s.id).join(','),
() => initSources()
)
</script>
<template>
<!--
独立窗口模式自带四周留白(窗口控制栏之下没有模块级的 p-5);
tab 模式由终端模块根节点的 p-5 提供边距。
-->
<div class="flex flex-col h-full overflow-hidden" :class="standalone ? 'p-3' : ''">
<PageToolbar
v-if="!standalone"
:icon="FolderTree"
title="文件管理器"
:meta="sessions.length > 0 ? `可切换 ${sessions.length} 个 SSH 会话` : '暂无已连接的 SSH 会话'"
>
<Button variant="outline" size="sm" :disabled="transferring" @click="openWindow">
<SquareArrowOutUpRight class="size-3.5" />独立窗口
</Button>
</PageToolbar>
<!--
两栏装在**同一个容器**里,中间一条可拖动的分界线。
分成两张卡片(`gap-3`)会让它读作「两个窗口并排」,而这里要做的是
「一个窗口的两半」—— 分界线可拖,与资源管理器的双栏一致。
-->
<Card class="flex-1 min-h-0 !py-0 !gap-0 overflow-hidden">
<div ref="splitRowRef" class="h-full min-h-0 flex">
<!-- 左栏:宽度用百分比(拖动的结果在窗口缩放后仍然成立) -->
<div class="min-w-0 flex flex-col" :style="{ width: `${store.filePaneSplit}%` }">
<FilePane
ref="leftRef"
side="left"
:connection="sources.left"
:sessions="sessions"
:allow-local="allowLocalLeft"
:transfer-label="labelOf('left')"
:transfer-blocked="blockedOf('left')"
@update:connection="setSource('left', $event)"
@transfer="transfer('left')"
/>
</div>
<!--
分界线:视觉上是 1px 的线,命中区宽 5px(`w-[5px]` 容器 + 居中的线)。
只给 1px 的命中区几乎点不中,而把线画成 5px 又太粗。
-->
<div
class="group w-[5px] shrink-0 cursor-col-resize relative"
title="拖动调整两栏宽度"
@mousedown="startResize"
>
<div
class="absolute inset-y-0 left-1/2 -translate-x-1/2 w-px bg-border
transition-colors group-hover:bg-primary/60"
/>
</div>
<div class="flex-1 min-w-0 flex flex-col">
<FilePane
ref="rightRef"
side="right"
:connection="sources.right"
:sessions="sessions"
:allow-local="allowLocalRight"
:transfer-label="labelOf('right')"
:transfer-blocked="blockedOf('right')"
@update:connection="setSource('right', $event)"
@transfer="transfer('right')"
/>
</div>
</div>
</Card>
<!-- ===== 传输进度 ===== -->
<div v-if="activeTransfers.length > 0" class="shrink-0 mt-3 max-h-28 overflow-auto">
<div
v-for="t in activeTransfers"
:key="t.id"
class="px-2.5 py-1.5 flex items-center gap-2 text-xs border-b border-border/50 last:border-b-0"
>
<component
:is="
t.direction === 'upload'
? ArrowUpFromLine
: t.direction === 'download'
? ArrowDownToLine
: ArrowLeftRight
"
class="size-3.5 shrink-0"
:class="t.state === 'failed' ? 'text-destructive' : 'text-muted-foreground'"
/>
<span class="truncate flex-1" :title="`${t.source} → ${t.target}`">
{{ baseName(t.source) }}
<span class="text-muted-foreground/60">→ {{ baseName(t.target) }}</span>
</span>
<div v-if="t.state === 'running'" class="w-24 h-1 rounded-full bg-muted overflow-hidden shrink-0">
<div
class="h-full bg-primary transition-[width] duration-200"
:style="{ width: t.total > 0 ? `${Math.min(100, (t.transferred / t.total) * 100)}%` : '0%' }"
/>
</div>
<span class="text-muted-foreground tabular-nums shrink-0 w-28 text-right whitespace-nowrap">
<template v-if="t.state === 'running'">
{{ t.total > 0 ? `${humanSize(t.transferred)} / ${humanSize(t.total)}` : humanSize(t.transferred) }}
</template>
<span v-else-if="t.state === 'done'" class="text-success">完成</span>
<span v-else-if="t.state === 'failed'" class="text-destructive" :title="t.error ?? ''">失败</span>
<span v-else>{{ t.state }}</span>
</span>
<button
class="text-muted-foreground hover:text-foreground shrink-0"
title="从列表移除"
@click="store.dismissTransfer(t.id)"
>
<X class="size-3.5" />
</button>
</div>
</div>
</div>
</template>