173 lines
7.9 KiB
Markdown
173 lines
7.9 KiB
Markdown
# 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 |
|
|
|
|
### 里程碑
|
|
- [x] SFTP 功能可用 (上传+删除+右键菜单)
|
|
- [x] Toast 系统上线 (零 alert)
|
|
- [x] 终端搜索可用
|
|
- [x] 会话恢复可用
|
|
|
|
---
|
|
|
|
## 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) │
|
|
└──────────────────────────────────────────────┘
|
|
```
|