# NetPilot

**Repository Path**: mfind/net-pilot

## Basic Information

- **Project Name**: NetPilot
- **Description**: 网络排查小工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-17
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NetPilot

NetPilot 是面向网络工程师和系统管理员的跨平台 AI 智能终端工作台。项目使用 Tauri 2 + React，浏览器开发模式提供 Mock 会话，桌面模式通过 Rust 后端建立真实 SSH/Telnet 交互连接。

## 当前状态

- 已完成：三栏深色工作台、设备新增/编辑/删除、SSH/Telnet 设备配置、安全提示、多会话标签、桌面真实 SSH2 交互 Shell、Telnet TCP 会话、终端实时回显、Keychain/Credential Manager 凭据保存、MiniMax HTTP Provider、上下文预览、Mock 演示、敏感信息脱敏、命令风险识别、设置页和自动化测试。
- 说明：浏览器 `npm run dev` 永远是 Mock；必须使用 `npm run tauri dev` 才会加载 Rust 连接器。真实设备连通性仍需使用你的设备参数现场验证。

## 环境准备

安装 Node.js 18+、Rust stable、Tauri 2 系统依赖。当前开发容器未安装 Rust，因此只能验证前端；Windows/macOS 打包请在对应系统执行。

```bash
npm install
npm run dev
```

浏览器打开 <http://localhost:1420>，或安装 Rust 后使用 `npm run tauri dev` 启动桌面窗口。

## 检查与测试

```bash
npm run typecheck
npm test
npm run build
cd src-tauri && cargo test && cargo check
```

## 最短使用路径

1. 点击“新增设备”，填写地址、协议和用户名。Telnet 会显示明文协议风险提示。
2. 在设备卡片点击“连接”。浏览器模式打开 Mock 会话，桌面模式会弹出凭据输入并连接真实设备。
3. 在终端执行 `show interfaces status`、`show ip route` 或 `help`。
4. 在 AI 面板点击“分析当前故障”，先查看本次发送内容，再确认发送。
5. AI 命令只可复制或插入待输入区域，第一阶段不会自动执行。

## 文档

- [架构说明](docs/architecture.md)
- [MiniMax 配置](docs/minimax.md)
- [安全说明](docs/security.md)
- [SSH/Telnet 使用](docs/connections.md)
- [日志格式](docs/logging.md)
- [构建与测试](docs/build.md)

## 真实设备与 AI 测试

安装 Rust、Node.js 和 macOS Command Line Tools 后执行 `npm run tauri dev`。如果 1420 端口被占用，项目会使用配置中的备用端口 1421。新增设备时填写真实地址、端口、用户名和认证方式，点击连接，在密码弹窗中输入密码；密码只用于当前连接，不写入前端状态。设置页输入 MiniMax API Key 并保存，打开真实会话后在 AI 面板确认发送内容再分析。当前仍需继续完善 SSH 主机指纹确认、SQLite 持久化日志分片和 MiniMax 流式响应。

## 已知限制与下一阶段

设备与设置现已使用本地浏览器/Tauri 状态持久化，真实 SSH/Telnet 和 MiniMax 请求已接入；当前仍缺少 SQLite 迁移落地、SSH 主机指纹交互、后端日志分片、流式 AI 事件和 Windows/macOS CI 打包验证。