opsxshell/CLAUDE.md

OpsXShell 项目说明

请使用中文沟通。项目当前架构为 Tauri 2 + Rust + React + TypeScript，开发规则和命令以 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；macOS 公证用 ./scripts/macos-notarize.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。