产品重命名与后台运行功能实现

第一轮：VaultS3

最初确定 VaultS3 作为产品名：

• 优点：Vault（保险库）体现安全性，S3 体现存储后端
• 缺点：
  • 小写 vaults3 不美观（数字+字母混合）
  • 易联想 HashiCorp Vault（同名产品）
  • 代码中 vaults3 作为标识符视觉效果差

第二轮：探索替代方案

我不喜欢小写+数字的写法，决定重新探索。

约束条件：

1. 不造新单词（如 Vaultix、Vaultr 等）
2. 与 S3/对象存储有一定关联
3. 简短，但不必是单个单词
4. 视觉美观

候选方案：

最终决定：StoreX

• Store：直接体现”存储”核心功能
• X：代表加密（eXtended/eXcrypted 的暗示）
• 6 字母，简短
• 大小写混合 StoreX 美观，纯小写 storex 也可接受

Flutter 端

• client/pubspec.yaml
• client/README.md
• client/android/app/build.gradle.kts
• client/android/app/src/main/kotlin/com/storex/client/MainActivity.kt（新建）
• client/lib/core/services/native_core_service.dart
• client/lib/core/services/video_thumbnail_service.dart
• client/lib/core/database/database.dart
• client/lib/core/state/app_state.dart
• client/lib/ui/s3_config_page.dart

Go 端

• core/go.mod
• core/cmd/server/main.go
• core/mobile/mobile.go
• core/internal/config/config.go
• core/internal/storage/s3.go
• core/internal/crypto/crypto.go
• core/internal/api/server.go
• core/internal/api/utils.go
• core/internal/api/e2e.go
• core/internal/api/files.go
• core/internal/api/folders.go
• core/internal/api/orphan.go
• core/internal/api/send.go
• core/internal/api/thumbnail.go

为什么改 S3 存储路径？

我明确决定开发早期不做数据兼容，直接修改 .vaults3/ 为 .storex/。

受影响的路径：

• .storex/salt - 密钥盐值
• .storex/verify - 密码验证标记
• .storex/meta.enc - 加密元数据
• .storex/send/sessions.enc - 发送会话
• .storex/send/messages/ - 发送消息

为什么改文件魔数？

便携式加密文件的魔数从 VAULTS31 改为 STOREX01：

• 8 字节固定长度
• 用于识别文件格式
• 开发早期无需兼容旧格式

3.2.1 原生端修改

在 MainActivity.kt 的 storex/core MethodChannel 中添加新方法：

"moveToBackground" -> {
    moveTaskToBack(true)
    result.success(null)
}

moveTaskToBack(true) 是 Android Activity 的原生方法，将当前任务移到后台，类似按 Home 键。

3.2.2 Flutter 端修改

NativeCoreService 添加方法：

static Future<void> moveToBackground() async {
  await _channel.invokeMethod<void>('moveToBackground');
}

files_page.dart 修改返回键处理：

if (state.isAtRoot) {
  if (io.Platform.isAndroid) {
    NativeCoreService.moveToBackground();
  } else {
    SystemNavigator.pop();
  }
}

3.3.1 依赖选择

选择 tray_manager + window_manager 组合：

• tray_manager：管理托盘图标、菜单、点击事件
• window_manager：管理窗口显示/隐藏、拦截关闭事件

3.3.2 TrayService 设计

创建 client/lib/core/services/tray_service.dart：

class TrayService with TrayListener, WindowListener {
  // 单例模式
  static final TrayService _instance = TrayService._();
  factory TrayService() => _instance;
  
  Future<void> init() async {
    // 1. 初始化窗口管理器
    await windowManager.ensureInitialized();
    
    // 2. 设置窗口选项
    await windowManager.waitUntilReadyToShow(...);
    
    // 3. 监听窗口事件
    windowManager.addListener(this);
    
    // 4. 拦截关闭事件（关键！）
    await windowManager.setPreventClose(true);
    
    // 5. 设置托盘图标和菜单
    await trayManager.setIcon('windows/runner/resources/app_icon.ico');
    await trayManager.setContextMenu(menu);
    await trayManager.setToolTip('StoreX');
    
    // 6. 监听托盘事件
    trayManager.addListener(this);
  }
  
  // 隐藏到托盘
  Future<void> hideToTray() async {
    await windowManager.hide();
  }
  
  // 从托盘恢复
  Future<void> showFromTray() async {
    await windowManager.show();
    await windowManager.focus();
  }
  
  // 拦截关闭事件
  @override
  void onWindowClose() async {
    final isPreventClose = await windowManager.isPreventClose();
    if (isPreventClose) {
      await hideToTray();  // 隐藏而非退出
    }
  }
  
  // 托盘菜单点击
  @override
  void onTrayMenuItemClick(MenuItem menuItem) {
    switch (menuItem.key) {
      case 'show':
        showFromTray();
      case 'exit':
        windowManager.destroy();  // 真正退出
    }
  }
}

3.3.3 关键技术点

1. setPreventClose(true)：拦截窗口关闭事件，让 onWindowClose 被调用
2. windowManager.hide()：隐藏窗口，但进程保持运行
3. windowManager.destroy()：真正销毁窗口，退出应用
4. 托盘图标：使用现有的 app_icon.ico

3.3.4 main.dart 初始化

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // ... 其他初始化 ...
  
  // Windows: 初始化系统托盘
  if (io.Platform.isWindows) {
    await TrayService().init();
  }
  
  // ... 启动应用 ...
}

Android

1
在文件根目录按返回键
2
    ↓
3
PopScope.onPopInvokedWithResult 触发
4
    ↓
5
检测 Platform.isAndroid
6
    ↓
7
调用 NativeCoreService.moveToBackground()
8
    ↓
9
MethodChannel 调用原生 moveTaskToBack(true)
10
    ↓
11
应用进入后台（进程保持运行）

Windows

1
点击窗口关闭按钮 (X)
2
    ↓
3
WindowListener.onWindowClose 触发
4
    ↓
5
检测 isPreventClose == true
6
    ↓
7
调用 windowManager.hide()
8
    ↓
9
窗口隐藏，托盘图标保留
10
    ↓
11
可点击托盘图标恢复窗口
12
    ↓
13
或点击托盘菜单"退出"真正退出