OpsXShell Dev
caba5f4c0d
任务1: 全局快捷键管理器 — useKeyboardShortcuts hook Ctrl+Tab/Shift+Tab标签切换, Ctrl+1~9跳转, F11全屏, Ctrl+Shift+N新建标签 任务2: 标签拖拽排序 — tabStore.moveTab + TabBar HTML5 DnD 不可变更新, 拖拽视觉反馈(opacity+指示线), 活跃标签底部accent-blue指示线 任务3: SFTP拖拽上传 + useSFTP调试清理 FileListPanel拖拽覆盖层(Upload图标+虚线边框), 5个调试函数→createLogger, disconnect()正确调用IPC, 删除mock data 任务4: SFTP右键菜单完善 — 重命名/复制路径/属性/权限 FilePropertiesDialog+ChmodDialog, sftpStat/sftpChmod IPC全栈实现 任务5-6: 侧边栏分组折叠动画 + 宽度可拖拽调整 Grid 0fr→1fr折叠动画, ChevronRight旋转, resize handle 180~400px, settings记忆 任务7: 响应式布局 + 视觉优化V1~V5 useMediaQuery hook, <800px侧边栏overlay模式, SFTP垂直堆叠, WelcomeView响应式grid 任务8: Loading/Skeleton骨架屏 Skeleton/SkeletonLine/SkeletonCircle/SkeletonBlock + FileListSkeleton/SessionTreeSkeleton/TabContentSkeleton 任务9: 空状态设计 EmptyState通用组件, SessionTree/FileListPanel/WelcomeView/SFTPView空状态引导 任务10: TerminalView组件拆分重构 711行→285行 useTerminalConnection(300行) + useTerminalSearch(123行) + TerminalOverlay(98行) + TerminalSearchBar(74行) 33 files changed, 2682 insertions(+), 872 deletions(-)
7.4 KiB
7.4 KiB
ROADMAP.md - OpsXShell 开发路线图
版本规划总览
v1.1.0 基础可用 ─── 2 周 ──→ UI/UX 48→65, 代码 58→68
v1.2.0 体验升级 ─── 2 周 ──→ UI/UX 65→78, 代码 68→75
v1.3.0 测试覆盖 ─── 2 周 ──→ 测试 15→50%, 代码 75→80
v1.4.0 专业功能 ─── 2 周 ──→ UI/UX 78→88, 功能完成度 90+
v1.5.0 安全升级 ─── 1 周 ──→ 安全 55→85, 代码 80→85
v1.1.0 基础可用 (2 周) — ✅ 已完成
目标: 解决所有 Critical UI/UX 问题，建立基础反馈系统，产品具备日常使用价值
✅ 全部完成 (提交: 53274e2 + d344900)
| # | 任务 | 状态 | 提交 |
|---|---|---|---|
| 1 | Toast 通知系统 | ✅ | d344900 |
| 2 | 替换所有 alert/prompt/confirm | ✅ | d344900 |
| 3 | SFTP 上传/删除真实实现 | ✅ | d344900 |
| 4 | 终端搜索 (SearchAddon) | ✅ | d344900 |
| 5 | 会话恢复 (标签持久化) | ✅ | d344900 |
| 6 | 修复私钥浏览按钮 | ✅ | 53274e2 |
| 7 | 清理生产调试日志 | ✅ | 53274e2 |
| 8 | 设计系统统一颜色 | ✅ | 53274e2 |
| 9 | StatusBar 接入实际状态 | ✅ | 53274e2 |
| 10 | WelcomeView 真实最近连接 | ✅ | 53274e2 |
| 11 | better-sqlite3 → sql.js 迁移 | ✅ | 53274e2 |
里程碑
- SFTP 功能可用 (上传+删除+右键菜单)
- Toast 系统上线 (零 alert)
- 终端搜索可用
- 会话恢复可用
v1.2.0 体验升级 (2 周) — 🚧 进行中
目标: 快捷键补全、视觉打磨、交互优化，接近 Termius 体验水平
🟡 P1 — 重要
| # | 任务 | 类型 | 预计 | 验收标准 |
|---|---|---|---|---|
| 1 | Ctrl+Tab / Ctrl+1~9 标签切换 | 新增 | 1天 | Ctrl+Tab 前后切换，Ctrl+1~9 跳转指定标签 |
| 2 | 标签拖拽排序 | 新增 | 2天 | 拖拽标签头重排序，拖出标签栏可弹出新窗口（可选） |
| 3 | SFTP 拖拽上传 | 新增 | 2天 | 从系统文件管理器拖拽文件到远程面板触发上传 |
| 4 | SFTP 右键菜单完善 | 完善 | 1天 | 新增：权限编辑、属性查看、重命名、复制路径 |
| 5 | 侧边栏会话分组折叠 | 完善 | 1天 | 点击分组头折叠/展开，带动画 |
| 6 | Sidebar 宽度可拖拽调整 | 新增 | 1天 | 拖拽分隔条调整宽度，记忆到 settings |
| 7 | 响应式布局基础 | 新增 | 2天 | 窄窗口（<800px）自动折叠侧边栏，SFTP 垂直堆叠 |
| 8 | Loading/Skeleton 加载态 | 新增 | 1天 | FileListPanel 加载时显示骨架屏，SessionTree 同理 |
| 9 | 空状态设计 | 新增 | 1天 | 每个组件空状态有引导文案+操作按钮 |
| 10 | TerminalView 组件拆分 | 重构 | 3天 | 645行拆为 TerminalCore + TerminalOverlay + TerminalSearch |
视觉优化清单
| # | 文件 | 改进 |
|---|---|---|
| V-1 | StatusBar.tsx | bg-accent-blue → bg-dark-800 border-t |
| V-2 | SFTPView.tsx | emoji 图标 → Lucide 组件 |
| V-3 | TabBar.tsx | 添加活跃标签底部指示线 |
| V-4 | App.tsx | Sidebar 折叠/展开过渡动画 |
| V-5 | WelcomeView.tsx | 响应式 grid-cols-1 sm:grid-cols-2 |
v1.3.0 测试覆盖 (2 周)
目标: 核心模块测试覆盖率从 10% 提升到 50%
详细计划见 TDD_PLAN.md
| # | 模块 | 当前覆盖 | 目标覆盖 | 预计 |
|---|---|---|---|---|
| 1 | stores (tab/connection/settings/session) | 0% | 70% | 3天 |
| 2 | hooks (useTerminal/useSFTP/useConnection) | 0% | 50% | 3天 |
| 3 | electron services (ssh/sftp/database/crypto) | 0% | 60% | 4天 |
| 4 | 组件渲染测试 (WelcomeView/TabBar/SFTPView) | 5% | 40% | 3天 |
v1.4.0 专业功能 (2 周)
目标: 快捷键自定义、终端分屏、i18n，达到专业级水平
| # | 任务 | 类型 | 预计 | 验收标准 |
|---|---|---|---|---|
| 1 | 快捷键自定义系统 | 新增 | 3天 | 设置页快捷键 Tab，可重映射所有快捷键，冲突检测 |
| 2 | 终端分屏 | 新增 | 5天 | 水平/垂直分割标签页，可拖拽调整分割比例 |
| 3 | i18n 国际化 | 新增 | 5天 | zh-CN + en-US，所有 UI 文字抽离到 locale 文件 |
| 4 | Light 主题 | 新增 | 3天 | 完整 light 色板，自动跟随系统 |
| 5 | Snippets 命令片段库 | 新增 | 3天 | 创建/管理/搜索命令片段，快捷键插入到终端 |
| 6 | 代理设置 | 新增 | 2天 | HTTP/SOCKS5 代理配置，按会话独立设置 |
| 7 | 多窗口支持 | 新增 | 5天 | 右键标签"在新窗口打开"，窗口位置记忆 |
v1.5.0 安全升级 (1 周)
目标: 安全评分从 55 提升到 85
| # | 任务 | 类型 | 预计 |
|---|---|---|---|
| 1 | IPC 传输加密 (密码不明文) | 修复 | 2天 |
| 2 | Electron 升级 v28→v33+ | 升级 | 2天 |
| 3 | CSP 策略强化 | 新增 | 1天 |
| 4 | 依赖安全审计 + 更新 | 修复 | 1天 |
长期愿景 (v2.0+)
| 功能 | 描述 |
|---|---|
| 云同步 | 会话/设置跨设备同步 |
| AI 助手 | 终端命令建议、错误诊断 |
| 团队协作 | 共享会话、权限管理 |
| 插件系统 | 第三方扩展支持 |
| 脚本录制 | 操作录制+回放 |
技术栈
| 类别 | 技术 | 版本 |
|---|---|---|
| 框架 | Electron | 28+ (升级至 33+) |
| UI | React | 18 |
| 语言 | TypeScript | 5 |
| 构建 | Vite | 5 |
| 状态管理 | Zustand | 4 |
| 终端 | XTerm.js | 5 |
| SSH | ssh2 | 1.15 |
| 样式 | Tailwind CSS | 3 |
| 图标 | Lucide React | — |
| 数据库 | better-sqlite3 | 11 |
| 加密 | AES-256-GCM (Node crypto) | — |
架构设计
┌──────────────────────────────────────────────┐
│ Electron Main │
│ ┌─────────┐ ┌──────────┐ ┌───────────────┐ │
│ │ Window │ │ IPC │ │ Services │ │
│ │ Manager │ │ Handlers │ │ SSH/SFTP/DB │ │
│ └─────────┘ └──────────┘ └───────────────┘ │
├──────────────────────────────────────────────┤
│ React Renderer │
│ ┌─────────┐ ┌──────────┐ ┌───────────────┐ │
│ │ Views │ │ Stores │ │ Hooks │ │
│ │Term/SFTP│ │Zustand x5│ │useTerm/useSFTP│ │
│ └─────────┘ └──────────┘ └───────────────┘ │
│ ┌─────────────────────────────────────────┐ │
│ │ Components (Button/Modal/...) │ │
│ └─────────────────────────────────────────┘ │
├──────────────────────────────────────────────┤
│ Shared (types/constants) │
└──────────────────────────────────────────────┘