Files
Thing/src/modules/terminal/components/FileManager.vue
T
2026-09-25 18:23:56 +08:00

398 lines
16 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<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>