OpsXShell 项目说明

请使用中文沟通。完整规则以 AGENTS.md 为准；本文件只做短入口，避免双份漂移。

是什么

Tauri 2 + Rust + React 运维桌面终端：SSH、SFTP、代理/端口转发、RDP/VNC、串口、本地终端、多标签分屏、批量命令、可选终端 AI。

产品形态（对齐 opsxdb / opsxapi）：

浏览器  →  官网/docs 独立静态站（homepage/dist；本地 :8789 预览）
操作    →  仅桌面（./run.sh gui）

Gin 没有操作 API；不要把 Vite :5175 当浏览器工作台。

仓 / 服务	职责
本仓 `src/` + `src-tauri/`	桌面客户端（唯一操作入口）
本仓 `homepage/`	官网落地页 + 用户文档源（tools/homepage-build 出 dist 纯静态，可独立部署）
`opsx-licence`	结账与授权（桌面只验 LIC / LICOFF）
`opsxdb` / `opsxapi`	同族；同样「浏览器=官网/docs，操作=桌面」

src/：React UI（进 Tauri WebView）；src/features/settings/ 已提取设置模型、Hook 和控件
src-tauri/：Rust 原生能力
server/：Gin health/download + 本地静态托管 homepage/dist 预览（薄服务，无操作面）
homepage/：官网落地页 + 产品文档源 → homepage/dist/ 纯静态（自有域名部署）
shared/：契约；src/platform/：唯一 IPC 适配
test/patrol/：改功能优先 npm run test:patrol
./run.sh web|gui / ./scripts/build.sh：开发与打包；安装包只在 src-tauri/target/{debug,release}/bundle/（Tauri 2 标准，不要仓库根 release/）

桌面布局为根级 src/ + src-tauri/（Tauri 主流，三族统一；Vite :5175 仅桌面源）。不要重建已废弃的 apps/、packages/、仓库根 release/。

数据流：UI / Zustand → platform → Tauri command → Rust services。

现状与剩余工作见架构说明、重构进度；验证方式见测试与验收。不要把局部下沉误写为所有 service 已脱离 Tauri。

不做堡垒机/审计；密钥 Rust 加密；转发运行态不落盘且停止即杀 Listener；不恢复旧 Electron 壳。细则见 AGENTS.md。