24 lines
1.6 KiB
Markdown
24 lines
1.6 KiB
Markdown
# OpsXShell 项目说明
|
||
|
||
请使用中文沟通。项目当前架构为 Tauri 2 + Rust + React + TypeScript，开发规则和命令以 [AGENTS.md](./AGENTS.md) 为准。
|
||
|
||
核心产品范围：SSH、SFTP、HTTP/SOCKS5 代理、端口转发（本地 / 远程 / 动态 SOCKS5）、RDP / VNC 远程桌面、串口、本地终端、多标签、分屏、批量命令，以及可选的终端 AI Agent。界面文案走 `src/i18n`（多语言；key 对齐用 `test/i18n/localeKeys.test.ts`）。
|
||
|
||
## 目录要点
|
||
|
||
- `src/`：React UI；`src-tauri/`：Rust / Tauri 原生后端
|
||
- `shared/`：前后端共享 TypeScript 契约
|
||
- `test/`：Vitest；基础巡检在 `test/patrol/`（优先 `npm run test:patrol`）
|
||
- `scripts/`：启动、验收、构建与发布（`./run.sh` → `scripts/run.sh`；打包用 `./scripts/build.sh`）
|
||
- `docs/`：使用 / 架构 / 验收 / 发布
|
||
- 持续开发任务：根目录 `ROADMAP.md` / `TASKS.md` / `TDD_PLAN.md`
|
||
|
||
数据流：UI → Zustand → `src/platform/*` → Tauri command → Rust 服务。组件不直接 `invoke`，也不直接碰 SSH / 文件系统 / 加密。
|
||
|
||
## 与 AGENTS.md 的关系
|
||
|
||
- **AGENTS.md**：完整开发规则（安全、转发、SFTP、RDP、AI、扩展步骤、命令）。
|
||
- **CLAUDE.md**：本文件，给 Claude/Cursor 的短入口；细节一律以 AGENTS.md 为准，避免双份漂移。
|
||
|
||
不要恢复旧桌面构建链、终端命令历史或堡垒机审计能力。RDP / VNC 是原生 IronRDP / vnc-rs 会话，不是旧 Electron 桌面壳。转发运行态不落盘；未点停止的 Listener 在同窗重连时可 retain / orphan-adopt。
|