内嵌 Go 内核初步集成到客户端

• StartWithParams(...) 用于从 Java 侧传入 S3 参数和端口，然后调用内部的 Start(*CoreConfig)。
• Start 内部基于 config.DefaultConfig() 生成配置，根据传入配置覆盖 S3 endpoint、AK/SK、bucket、UseSSL 以及 server 端口，最后通过 api.NewServer 创建 HTTP 服务器并监听 127.0.0.1:<port>。
• Stop 通过 http.Server.Shutdown 优雅关闭，避免进程残留。

以 core 模块为工作目录（core/go.mod 里 module 名是 e2eepan），使用 Android Studio 自带 JBR 和本机 SDK/NDK：

• 设置环境变量：
  • ANDROID_HOME=D:\Android\Sdk
  • ANDROID_NDK_HOME=D:\Android\Sdk\ndk\28.2.13676358
  • PATH 前缀追加 D:\Android\Android Studio\jbr\bin
• 在 core 下执行：
  • gomobile bind -target=android -androidapi=21 -o ..\client\android\app\libs\e2eepan-mobile.aar e2eepan/mobile

早期踩坑：

• 一开始在仓库根目录执行，gomobile 找不到 go.mod，提示“cannot find main module”，后来改成在 core 目录执行，按模块名 e2eepan/mobile 调用后正常。
• PowerShell 中不能用 && 链接命令，这个也踩过一次，后续都用单条命令 + 显式 cwd 解决。

Android 侧通过 client/android/app/build.gradle.kts 中的：

• implementation(files("libs/e2eepan-mobile.aar")) 将 AAR 引入工程。

• 创建 MethodChannel("e2eepan/core")，接收 Flutter 端调用。
• 支持两个方法：
  • startEmbeddedCore：读取 Flutter 传下来的 S3 endpoint、AK/SK、bucket、UseSSL 和端口，启一个后台线程调用 Mobile.startWithParams(...)。
  • stopEmbeddedCore：同样在后台线程中调用 Mobile.stop()。
• 将 Go 启动/关闭都放到子线程，避免在主线程阻塞导致 ANR。

• 定义 MethodChannel('e2eepan/core')。
• 暴露静态方法：
  • startEmbeddedCore(Map<String, dynamic> config)
  • stopEmbeddedCore()

• 增加 _coreMode 字段，默认：
  • Android 默认 'embedded'。
  • 其他平台默认 'external'。
  • 同步到 SharedPreferences('core_mode')，可调。
• 启动流程 _initCoreAndNetwork()：
  • await _ensureCoreModeLoaded();
  • await _maybeStartEmbeddedCore();
  • await _checkInitialNetworkStatus();
• _maybeStartEmbeddedCore 在 core_mode == 'embedded' 且平台是 Android 时：
  • 组装 S3 配置（来自设置页 / 默认值）和 api.baseUrl。
  • 调用 NativeCoreService.startEmbeddedCore(config)。
  • 提供 suppressError 参数，在正常启动路径中吞掉异常，在调试场景中向外抛出。
• restartEmbeddedCoreIfNeeded 用于 S3 配置变更后优雅重启：
  • 若模式是 embedded：先 stopEmbeddedCore，再 _maybeStartEmbeddedCore()。

• 在 core/internal/api/server.go 的 healthCheck 中，将 S3 失败时的响应扩展为：
  • status: "error"
  • component: "s3"
  • code: "S3_UNAVAILABLE"
  • error: 具体错误
• 正常时仍返回 status: "ok" 和时间戳。

• 核心没起 / 网络不通。
• 核心在，但 S3 掉线或配置错误。

• 保留原来的 healthCheck()，仍然只返回 bool，给老逻辑用。
• 新增 getHealthDetail()：
  • 成功时直接返回 /health 的 JSON。
  • 失败但有 JSON body（例如 503 时）也尝试解析并返回。
  • 无法连接时返回 null。

• 增加 _healthErrorCode 字段，对外提供 healthErrorCode getter。
• 构造函数里的 15 秒心跳逻辑改为：
  • 调用 api.getHealthDetail()。
  • 若返回 status == "ok"：认为在线，_isOffline=false，_healthErrorCode=null。
  • 若返回 status == "error"：认为离线，_isOffline=true，记录 code（如 S3_UNAVAILABLE）。
  • 若返回 null：认为离线但不知道具体原因。
• _checkInitialNetworkStatus() 也切换到 getHealthDetail()，保证一启动就能拿到更细的信息。

• 增加本地判断：
  • s3Failed = state.isOffline && state.healthErrorCode == 'S3_UNAVAILABLE'
• 根据 s3Failed 决定文案：
  • 如果离线且 s3Failed：
    • 标题显示 S3 连接失败
    • 副标题显示 请检查存储服务配置后重试
  • 如果离线但不是 S3 错误：
    • 保持原来的 内核未启动 / 请启动内核后刷新
  • 在线保持原有“这里空空如也 / 点击右下角按钮上传文件”的文案。

• 内核没起来 / 端口不通：我这边看到的是“内核未启动”。
• 内核在但 S3 配置错误或服务挂掉：我这边看到的是“S3 连接失败”，定位更精准。

• “重启内核”：
  • 调用 AppState.debugRestartEmbeddedCore() 停止并强制启动内嵌核心。
  • 再通过 AppState.debugCheckCoreStatus() 组合输出当前核心模式、baseUrl、S3 配置、health 和 bootstrap 状态。
  • 结果通过 SnackBar 弹出，便于快速查看。
• “设置内核地址”：
  • 复用原来隐藏在“关于”里的地址弹窗，读取/写入 core_base_url。
  • 可以恢复默认地址，也可以指向局域网其它核心。

• 调试相关逻辑移除：
  • 删除了隐藏 5 连点“关于”触发核心地址弹窗的彩蛋。
  • 删除了设置页里“重启内核”的直接入口。
• 新增一个轻量入口：
  • 在“调试”分区只保留一个 调试选项 的 ListTile，点击后 Navigator.push 到 DebugPage。
• S3 配置对话框：
  • 仍然在设置页中提供。
  • 修改完配置后调用 appState.restartEmbeddedCoreIfNeeded() 尝试重启内嵌核心，并给出提示。