# OpsXShell 项目说明

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

## 是什么

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

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

```text
浏览器  →  Gin 官网 + docs（./run.sh web → :8789）
操作    →  仅桌面（./run.sh gui）
```

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

## 和谁分工

| 仓 / 服务                      | 职责                                               |
| ------------------------------ | -------------------------------------------------- |
| **本仓** `src/` + `src-tauri/` | 桌面客户端（唯一操作入口）                         |
| **本仓** `apps/server`         | 官网落地页 + 用户文档（已并入原 `site-opsxshell`） |
| `opsx-licence`                 | 结账与授权（桌面只验 LIC / LICOFF）                |
| `opsxdb` / `opsxapi`           | 同族；同样「浏览器=官网/docs，操作=桌面」          |

## 目录

- `src/`：React UI（进 Tauri WebView）
- `src-tauri/`：Rust 原生能力
- `apps/server/`：Gin site/docs/health（薄服务，无操作面）
- `shared/`：契约；`src/platform/`：唯一 IPC 适配
- `test/patrol/`：改功能优先 `npm run test:patrol`
- `./run.sh web|gui` / `./scripts/build.sh`：开发与打包

暂不强制迁到 `apps/web` / `apps/desktop`；见 AGENTS.md「目录对齐说明」。

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

## 硬边界（摘要）

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