# Go Desk 设备调用测试功能设计

> **文档版本**：v0.1.0
> **创建时间**：2026-01-20
> **维护者**：JueChen
> **状态**：设计阶段

## 1. 功能概述

实现系统资源访问和设备调用测试功能，验证 Wails 应用与系统资源的交互能力。

## 2. 功能需求

### 2.1 系统信息获取

- [ ] CPU 信息：核心数、使用率、型号
- [ ] 内存信息：总内存、已用内存、可用内存
- [ ] 磁盘信息：磁盘列表、总容量、已用容量、可用容量
- [ ] 系统信息：操作系统、架构、主机名
- [ ] 网络信息：IP 地址、网络接口列表

### 2.2 文件系统操作

- [ ] 读取文件：读取指定路径的文件内容
- [ ] 写入文件：写入内容到指定文件
- [ ] 列出目录：获取目录下的文件和文件夹列表
- [ ] 创建目录：创建新目录
- [ ] 删除文件/目录：删除指定路径的文件或目录
- [ ] 文件信息：获取文件大小、修改时间、权限等

### 2.3 系统操作

- [ ] 环境变量：读取系统环境变量
- [ ] 执行命令：执行系统命令（可选，需谨慎）
- [ ] 打开文件/目录：使用系统默认程序打开
- [ ] 文件选择对话框：选择文件或目录

### 2.4 进程信息

- [ ] 进程列表：获取当前运行的进程列表
- [ ] 进程详情：获取指定进程的详细信息

## 3. 技术实现

### 3.1 Go 后端实现

#### 3.1.1 系统信息模块

```go
// internal/system/system.go
package system

// GetSystemInfo 获取系统信息
func GetSystemInfo() (map[string]interface{}, error)

// GetCPUInfo 获取 CPU 信息
func GetCPUInfo() (map[string]interface{}, error)

// GetMemoryInfo 获取内存信息
func GetMemoryInfo() (map[string]interface{}, error)

// GetDiskInfo 获取磁盘信息
func GetDiskInfo() ([]map[string]interface{}, error)
```

#### 3.1.2 文件系统模块

```go
// internal/filesystem/fs.go
package filesystem

// ReadFile 读取文件
func ReadFile(path string) (string, error)

// WriteFile 写入文件
func WriteFile(path, content string) error

// ListDir 列出目录
func ListDir(path string) ([]map[string]interface{}, error)

// CreateDir 创建目录
func CreateDir(path string) error

// DeletePath 删除文件或目录
func DeletePath(path string) error

// GetFileInfo 获取文件信息
func GetFileInfo(path string) (map[string]interface{}, error)
```

#### 3.1.3 App 方法暴露

```go
// app.go 中添加方法

// GetSystemInfo 获取系统信息
func (a *App) GetSystemInfo() (map[string]interface{}, error)

// GetCPUInfo 获取 CPU 信息
func (a *App) GetCPUInfo() (map[string]interface{}, error)

// GetMemoryInfo 获取内存信息
func (a *App) GetMemoryInfo() (map[string]interface{}, error)

// GetDiskInfo 获取磁盘信息
func (a *App) GetDiskInfo() ([]map[string]interface{}, error)

// ReadFile 读取文件
func (a *App) ReadFile(path string) (string, error)

// WriteFile 写入文件
func (a *App) WriteFile(path, content string) error

// ListDir 列出目录
func (a *App) ListDir(path string) ([]map[string]interface{}, error)

// CreateDir 创建目录
func (a *App) CreateDir(path string) error

// DeletePath 删除文件或目录
func (a *App) DeletePath(path string) error

// GetFileInfo 获取文件信息
func (a *App) GetFileInfo(path string) (map[string]interface{}, error)

// GetEnvVars 获取环境变量
func (a *App) GetEnvVars() (map[string]string, error)

// OpenPath 打开文件或目录
func (a *App) OpenPath(path string) error
```

### 3.2 前端实现

#### 3.2.1 系统信息展示

- 系统信息卡片（Arco Card）
- 实时刷新按钮
- 信息表格展示

#### 3.2.2 文件系统操作界面

- 文件浏览器组件
- 路径输入框
- 操作按钮（读取、写入、删除等）
- 文件内容编辑器（文本区域）

#### 3.2.3 测试页面布局

```
┌─────────────────────────────────────┐
│  系统信息测试                        │
├─────────────────────────────────────┤
│  [刷新]                              │
│  ┌─────────┬─────────┬─────────┐   │
│  │ CPU     │ 内存    │ 磁盘    │   │
│  └─────────┴─────────┴─────────┘   │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│  文件系统测试                        │
├─────────────────────────────────────┤
│  路径: [________________] [浏览]     │
│  ┌───────────────────────────────┐ │
│  │  文件列表                      │ │
│  │  - file1.txt                  │ │
│  │  - folder1/                   │ │
│  └───────────────────────────────┘ │
│  [读取] [写入] [删除] [创建目录]    │
└─────────────────────────────────────┘
```

## 4. 依赖库

### 4.1 Go 依赖

```go
// 系统信息
github.com/shirou/gopsutil/v3/cpu
github.com/shirou/gopsutil/v3/mem
github.com/shirou/gopsutil/v3/disk
github.com/shirou/gopsutil/v3/host

// 文件操作
os
path/filepath
io/ioutil

// 系统操作
os/exec
runtime
```

### 4.2 安装命令

```bash
go get github.com/shirou/gopsutil/v3/cpu
go get github.com/shirou/gopsutil/v3/mem
go get github.com/shirou/gopsutil/v3/disk
go get github.com/shirou/gopsutil/v3/host
```

## 5. 实现细节

### 5.1 系统信息获取

**CPU 信息**：
- 使用 `gopsutil/cpu` 获取 CPU 核心数、使用率
- 使用 `runtime.NumCPU()` 获取逻辑核心数

**内存信息**：
- 使用 `gopsutil/mem` 获取内存统计
- 转换为 MB/GB 单位显示

**磁盘信息**：
- 使用 `gopsutil/disk` 获取磁盘分区和使用情况
- 过滤系统盘和可访问盘

**系统信息**：
- 使用 `gopsutil/host` 获取主机信息
- 使用 `runtime.GOOS` 和 `runtime.GOARCH` 获取平台信息

### 5.2 文件系统操作

**路径安全**：
- 验证路径合法性
- 防止路径遍历攻击
- 限制操作范围（可选）

**错误处理**：
- 文件不存在
- 权限不足
- 路径无效

**文件编码**：
- 文本文件使用 UTF-8
- 二进制文件提示用户

### 5.3 跨平台兼容

- Windows：使用 `os/exec` 执行系统命令
- Linux/Mac：使用相应的系统调用
- 路径分隔符：使用 `filepath.Join` 处理

## 6. 文件结构

```
go-desk/
├── internal/
│   ├── system/
│   │   └── system.go      # 系统信息获取
│   └── filesystem/
│       └── fs.go          # 文件系统操作
├── app.go                 # 添加系统调用方法
└── frontend/src/
    └── components/
        ├── SystemInfo.vue  # 系统信息组件
        └── FileSystem.vue # 文件系统组件
```

## 7. 安全考虑

1. **路径验证**：防止路径遍历攻击
2. **权限检查**：确保有足够的权限执行操作
3. **操作限制**：限制危险操作（如删除系统文件）
4. **输入验证**：验证所有用户输入
5. **错误信息**：不暴露敏感系统信息

## 8. 测试用例

### 8.1 系统信息测试

- [ ] 获取 CPU 信息成功
- [ ] 获取内存信息成功
- [ ] 获取磁盘信息成功
- [ ] 信息格式正确

### 8.2 文件系统测试

- [ ] 读取文件成功
- [ ] 写入文件成功
- [ ] 列出目录成功
- [ ] 创建目录成功
- [ ] 删除文件成功
- [ ] 路径验证有效
- [ ] 错误处理正确

## 9. 开发优先级

### 阶段一：基础系统信息
- [ ] CPU 信息获取
- [ ] 内存信息获取
- [ ] 系统基本信息

### 阶段二：文件系统基础操作
- [ ] 读取文件
- [ ] 列出目录
- [ ] 文件信息获取

### 阶段三：文件系统完整操作
- [ ] 写入文件
- [ ] 创建目录
- [ ] 删除文件/目录

### 阶段四：高级功能
- [ ] 磁盘信息
- [ ] 网络信息
- [ ] 环境变量
- [ ] 打开文件/目录

## 10. 注意事项

1. **性能**：系统信息获取可能较慢，考虑异步调用
2. **权限**：某些操作需要管理员权限
3. **跨平台**：不同平台的行为可能不同
4. **错误处理**：完善的错误提示和日志记录

---

**下一步**：根据此设计文档开始实现设备调用测试功能。