目录结构

顶层结构

.
├── lib/                  # Flutter 应用代码
├── rust/                 # Rust workspace（7 个 crate）
├── test/                 # Flutter 测试
├── windows/ linux/ macos/  # 平台代码（FFI 动态库与打包配置）
├── .github/workflows/    # CI（build-and-test.yml、package.yml）
├── dist/  build/         # 打包产物，勿修改
├── build_rust.bat        # Windows Rust 构建脚本
├── build_rust.sh         # Linux/macOS Rust 构建脚本
└── pubspec.yaml

lib/：Flutter 应用

lib/
├── main.dart              # 入口
├── models/                # 数据模型（实例、节点、市场、远程）
├── screens/               # 页面（home、nodes、marketplace、frp、database、ai 等）
├── services/              # API 服务与 FFI 封装（*_ffi.dart、*_api_service.dart、*_provider.dart）
├── state/                 # AppState、NodeState
├── utils/                 # 工具（docker_visibility、naming、code_highlight 等）
├── widgets/               # 通用组件（参考 apple_widgets.dart）
└── data/                  # 静态数据（config_descriptions、server_cores）

rust/：Rust workspace

rust/
├── backup/                # ZIP 并行压缩/解压
├── downloader/            # HTTP 流式/分片下载（断点续传）
├── http_client/           # 通用 HTTP 请求（GET/POST/PUT/PATCH/DELETE/HEAD，响应含 base64 体）
├── file_ops/              # 文件扫描、移动、回收站
├── db_client/             # 远程数据库客户端（MySQL/MariaDB/PostgreSQL/Redis，统一 db_request 入口）
├── logger/                # 日志
├── vector_store/          # 向量知识库（rusqlite + sqlite-vec，存取与相似检索）
└── Cargo.toml             # workspace 清单

平台目录

目录	作用
windows/runner/	Windows FFI 动态库（xmc_*.dll）与 CMake 配置
linux/	Linux FFI 动态库（xmc_*.so）与 CMakeLists.txt
macos/	macOS FFI 动态库（xmc_*.dylib）、签名脚本与 Xcode 工程

生成目录

rust/target/、build/、dist/ 为生成目录，勿编辑。