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 打磨，达到专业级体验

🟡 P1 — 重要

#	任务	类型	预计	验收标准
1	主题系统 Dark/Light/System	新增	3天	CSS 变量驱动，跟随系统自动切换，设置页实时预览
2	Vite 代码分割	优化	1天	manualChunks 拆分 xterm/react/lucide，消除 500KB warning
3	设置面板视觉重构	重构	2天	专业设置页布局 + 快捷键自定义 Tab + 版本号自动读取
4	命令片段库 Snippets	新增	3天	创建/编辑/删除/搜索命令片段，快捷键插入到终端
5	全局命令面板	新增	2天	Ctrl+Shift+P 快速搜索操作/会话/命令片段
6	连接状态面板	新增	2天	实时监控连接、流量统计、延迟显示、重连按钮
7	UI 打磨 — 全局细节优化	完善	2天	过渡动画统一、微交互（hover/active 反馈）、视觉一致性

---

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)        │
└──────────────────────────────────────────────┘