v2.0.0: 主题系统+SSH私钥解析修复+会话持久化+连接池优化+UI打磨

核心修复:
- ssh-service.ts: 新增 resolvePrivateKey(),将私钥文件路径(~/.ssh/id_rsa)解析为内容后传给 ssh2,
  解决 'Cannot parse privateKey: Unsupported key format' 错误
- useTerminalConnection.ts + sessionHelper.ts: 根据 authType 过滤字段,password/agent 认证不再传 privateKey
- sessionStore.ts: addSession() 现在先调用 sessionCreate() 持久化到 SQLite,解决恢复标签'无可用连接信息'问题
- database-service.ts: updateSession() 补充 private_key_path 字段持久化
- SessionDialog.tsx: 默认 username='root'、privateKey='~/.ssh/id_rsa'

UI/UX:
- 语义化主题系统(app-theme.ts),强制深色模式,全局无边框设计
- macOS 标题栏支持双击最大化(window:toggleMaximize IPC)
- macOS 菜单栏('OpsXShell' 应用菜单 + Settings Cmd+,)
- WelcomeView 4卡片布局,移除 Settings 按钮
- TabBar/TabItem 背景色统一(bg-dark-800/900),消除白色边框线

架构优化:
- SFTP 生命周期修复(useSFTP.ts useRef + autoConnectAttempted guard)
- 连接池竞态修复,支持快速多标签连接
- IPC 接口规范化,安全错误处理
- Vite 代码分割优化

质量: lint零错误 | tsc零错误 | build成功 | 49 tests pass
This commit is contained in:
Logan.Li committed 2026-04-22 11:15:41 +08:00
1 parent 37e65be823
commit 514d62644e
77 files changed
+2563 -931

No files matched your search

+61 -63
View File
@@ -1,6 +1,7 @@
/**
* SSH IPC Handlers
* 处理 SSH 连接、Shell、会话、端口转发相关 IPC
* 安全增强:规范化错误处理,不暴露敏感信息
*/
import { ipcMain, IpcMainInvokeEvent } from 'electron'
@@ -10,22 +11,22 @@ import { createLogger } from '../utils/logger'
const logger = createLogger('SSH_IPC')
// ===== 彩色调试日志 =====
const DEBUG = true
function debug(...args: any[]) {
if (DEBUG) console.log('[SSH_IPC]', ...args)
// 生产环境日志:使用结构化日志,不输出敏感信息
const DEBUG = process.env.NODE_ENV === 'development'
function debug(...args: unknown[]) {
if (DEBUG) logger.debug('[SSH_IPC]', ...args)
}
function logHeader(msg: string) {
console.log(`%c${msg}`, 'background: #9b59b6; color: #fff; padding: 4px 8px; border-radius: 4px; font-weight: bold;')
logger.info(`[${msg}]`)
}
function logInfo(label: string, value: any) {
console.log(`%c${label}:%c ${value}`, 'background: #2c3e50; color: #fff; padding: 2px 6px; border-radius: 3px;', 'color: #3498db; font-weight: bold;')
function logInfo(label: string, value: unknown) {
logger.info(`${label}: ${value}`)
}
function logSuccess(msg: string) {
console.log(`%c✓ ${msg}`, 'color: #27ae60; font-weight: bold;')
logger.info(`[OK] ${msg}`)
}
function logError(msg: string) {
console.log(`%c✗ ${msg}`, 'color: #e74c3c; font-weight: bold;')
logger.error(msg)
}
// IPC channel names
@@ -49,15 +50,16 @@ export interface SSHIPCOptions {
}
export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
const { sshService, zmodemService, mainWindowGetter } = options
const { sshService, zmodemService, mainWindowGetter: _mainWindowGetter } = options
// SSH connect
ipcMain.handle(SSH_CHANNELS.CONNECT, async (_event: IpcMainInvokeEvent, config) => {
try {
const connection = await sshService.connect(config)
return { success: true, connectionId: connection.id }
} catch (error: any) {
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
return { success: false, error: message }
}
})
@@ -66,8 +68,9 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
try {
await sshService.disconnect(connectionId)
return { success: true }
} catch (error: any) {
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
return { success: false, error: message }
}
})
@@ -76,59 +79,49 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
try {
const result = await sshService.exec(connectionId, command)
return { success: true, result }
} catch (error: any) {
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
return { success: false, error: message }
}
})
// SSH create shell
ipcMain.handle(SSH_CHANNELS.CREATE_SHELL, async (event: IpcMainInvokeEvent, connectionId: string, options?: { cols?: number; rows?: number }, shellId?: string) => {
console.log('=== SSH_IPC CREATE_SHELL ===')
console.log(' connectionId:', connectionId)
console.log(' options:', options)
console.log(' preferredShellId:', shellId)
debug('CREATE_SHELL connectionId:', connectionId, 'preferredId:', shellId)
try {
const preferredShellId = shellId
logger.info('[SSH_IPC] Creating shell for connection:', connectionId, 'preferredId:', preferredShellId)
debug('>>> Calling sshService.createShell...')
const shell = await sshService.createShell(connectionId, options || {}, (shellId, data) => {
// 检查 sender 是否已被销毁
if (event.sender.isDestroyed()) {
console.log('=== SHELL DATA CALLBACK - SKIPPED (sender destroyed) ===')
debug('SHELL DATA CALLBACK - SKIPPED (sender destroyed)')
return
}
const text = data.toString('utf-8')
console.log('=== SHELL DATA CALLBACK ===')
console.log(' shellId:', shellId)
console.log(' data length:', data.length)
console.log(' data preview:', text.substring(0, 100).replace(/\n/g, '\\n'))
// 打印所有收到的数据前100字符用于调试
if (text.length > 0) {
logger.info(`[SSH_IPC] Shell data from ${shellId}:`, text.substring(0, 100).replace(/\n/g, '\\n'))
}
debug('SHELL DATA CALLBACK shellId:', shellId, 'data length:', data.length)
try {
console.log('>>> Sending SHELL_DATA to renderer...')
debug('>>> Sending SHELL_DATA to renderer...')
event.sender.send(SSH_CHANNELS.SHELL_DATA, connectionId, shellId, data)
console.log('>>> SHELL_DATA sent successfully')
debug('>>> SHELL_DATA sent successfully')
} catch (err) {
console.error('>>> FAILED to send SHELL_DATA:', err)
logger.error('>>> FAILED to send SHELL_DATA:', err)
}
zmodemService.feedShellData(shellId, data)
}, preferredShellId)
logger.info('[SSH_IPC] Shell created:', shell.id)
debug('>>> Shell created successfully:', shell.id)
return { success: true, shellId: shell.id }
} catch (error: any) {
} catch (error) {
logger.error('[SSH_IPC] Shell creation failed:', error)
debug('>>> Shell creation FAILED:', error.message)
return { success: false, error: error.message }
const message = error instanceof Error ? error.message : String(error)
debug('>>> Shell creation FAILED:', message)
return { success: false, error: message }
}
})
@@ -137,8 +130,9 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
try {
sshService.shellWrite(shellId, data)
return { success: true }
} catch (error: any) {
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
return { success: false, error: message }
}
})
@@ -147,8 +141,9 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
try {
sshService.shellResize(shellId, cols, rows)
return { success: true }
} catch (error: any) {
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
return { success: false, error: message }
}
})
@@ -160,19 +155,20 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
remoteHost: string,
remotePort: number
) => {
logHeader('🔀 IPC FORWARD_LOCAL')
logHeader('FORWARD_LOCAL')
logInfo('connectionId', connectionId)
logInfo('localPort', localPort)
logInfo('remoteHost', remoteHost)
logInfo('remotePort', remotePort)
try {
const result = await sshService.forwardLocal(connectionId, localPort, remoteHost, remotePort)
logSuccess(`Local forward bound to port ${result.boundPort}`)
return { success: true, boundPort: result.boundPort }
} catch (error: any) {
logError(`Local forward failed: ${error.message}`)
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
logError(`Local forward failed: ${message}`)
return { success: false, error: message }
}
})
@@ -184,19 +180,20 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
localHost: string,
localPort: number
) => {
logHeader('🔀 IPC FORWARD_REMOTE')
logHeader('FORWARD_REMOTE')
logInfo('connectionId', connectionId)
logInfo('remotePort', remotePort)
logInfo('localHost', localHost)
logInfo('localPort', localPort)
try {
const result = await sshService.forwardRemote(connectionId, remotePort, localHost, localPort)
await sshService.forwardRemote(connectionId, remotePort, localHost, localPort)
logSuccess('Remote forward established')
return { success: true }
} catch (error: any) {
logError(`Remote forward failed: ${error.message}`)
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
logError(`Remote forward failed: ${message}`)
return { success: false, error: message }
}
})
@@ -206,17 +203,18 @@ export function registerSSHIPCHandlers(options: SSHIPCOptions): void {
connectionId: string,
localPort: number
) => {
logHeader('🧦 IPC FORWARD_DYNAMIC (SOCKS5)')
logHeader('FORWARD_DYNAMIC (SOCKS5)')
logInfo('connectionId', connectionId)
logInfo('localPort', localPort)
try {
const result = await sshService.forwardDynamic(connectionId, localPort)
logSuccess(`SOCKS5 proxy started on port ${result.boundPort}`)
return { success: true, boundPort: result.boundPort }
} catch (error: any) {
logError(`Dynamic forward failed: ${error.message}`)
return { success: false, error: error.message }
} catch (error) {
const message = error instanceof Error ? error.message : String(error)
logError(`Dynamic forward failed: ${message}`)
return { success: false, error: message }
}
})
}