opsxshell/ROADMAP.md

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 体验水平

✅ 全部完成 (提交: caba5f4)

🟡 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 周) — ✅ 已完成

目标: 主题系统、命令面板、Snippets、UI 打磨，达到专业级体验

✅ 全部完成 (提交: 1f2de03 + 924a02b)

|| # | 任务 | 状态 | 提交 | |---|------|------|------| | 1 | 主题系统 Dark/Light/System | ✅ | 1f2de03 | | 2 | Vite 代码分割 | ✅ | 1f2de03 | | 3 | 设置面板视觉重构 | ✅ | 1f2de03 | | 4 | 命令片段库 Snippets | ✅ | 1f2de03 | | 5 | 全局命令面板 | ✅ | 1f2de03 | | 6 | 连接状态面板 | ✅ | 1f2de03 | | 7 | UI 打磨 — 全局细节优化 | ✅ | 924a02b |

---

v1.4.0 专业功能 (2 周) — 🚧 进行中

目标: 快捷键自定义、终端分屏、i18n、代理、多窗口，达到专业级水平

|| # | 任务 | 类型 | 预计 | 验收标准 | 状态 | |---|------|------|------|----------|------| | 1 | 快捷键自定义系统 | 新增 | 3天 | 设置页快捷键 Tab，可重映射所有快捷键，冲突检测 | ✅ | | 2 | 终端分屏 | 新增 | 5天 | 水平/垂直分割标签页，可拖拽调整分割比例 | 🚧 | | 3 | i18n 国际化 | 新增 | 5天 | zh-CN + en-US，所有 UI 文字抽离到 locale 文件 | 🚧 | | 4 | 代理设置 | 新增 | 2天 | HTTP/SOCKS5 代理配置，按会话独立设置 | 🚧 | | 5 | 多窗口支持 | 新增 | 5天 | 右键标签"在新窗口打开"，窗口位置记忆 | 🚧 |

注: Light 主题、Snippets 命令片段库已在 v1.3.0 提前完成

---

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 | — | | 数据库 | sql.js (SQLite WASM) | 1.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)        │
└──────────────────────────────────────────────┘