# Phoenix 桌面辅助工具

**Repository Path**: PhoenixWing321/phoenix-desk-tools

## Basic Information

- **Project Name**: Phoenix 桌面辅助工具
- **Description**: Python编写的辅助工具
进行链接修正，
Bom管理等
代码工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-23
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# phoenix-desk-tools

[Gitee](https://gitee.com/PhoenixWing321/phoenix-desk-tools.git) · Apache-2.0

围绕 FreeCAD 工作空间的 **Web 桌面辅助工具**：CAD 索引与检索、BOM、Code 工具等。

## 快速启动

首次运行先安装前端和服务端依赖（仓库使用 pnpm 9.15.9）：

```bash
corepack enable
pnpm install --frozen-lockfile
```

### 浏览器开发模式

```bash
pnpm dev                       # 同时启动 Vite (:5173) 和 Node (:5180)
# 浏览器打开 http://localhost:5173
```

### Tauri 桌面开发模式

桌面模式还需要 Rust 和 Tauri 2 CLI。Tauri 会自行启动前端和本地服务，不需要同时运行 `pnpm dev`。

```bash
cargo install tauri-cli --version "^2.6" --locked  # 仅首次安装
pnpm tauri:dev
```

### 从 VS Code / EXE 打开 CAA 对话框

运行中的 Desk Tools 接受本地 HTTP 请求，并在界面中切换到对应工作空间、打开 `.CATDlg` 编辑 Tab：

```bash
curl -X POST http://127.0.0.1:5180/api/caa/dialog/open \
  -H 'Content-Type: application/json' \
  -d '{"workspaceRoot":"/path/to/workspace","file":"/path/to/workspace/UI/Sample.CATDlg"}'
```

Tauri 可执行文件也接受启动参数；程序已运行时会由单实例桥接转交给现有窗口：

```bash
phoenix-desktop --workspace /path/to/workspace --catdlg /path/to/workspace/UI/Sample.CATDlg
```

也可只传一个 `.CATDlg` 位置；此时文件必须位于当前 Desk Tools 工作空间内。接口还直接接受 `phoenix-desk-tools.caa-dialog.v1` VS Code handoff JSON。

如果启动时提示找不到 `vite/bin/vite.js` 或 `tsx/dist/cli.mjs`，说明本地依赖目录不完整，可强制按锁文件重新安装：

```bash
pnpm install --frozen-lockfile --force
```

### 构建 Rust 模块

```bash
cargo build --manifest-path server/fcstd-query/Cargo.toml --release
cargo build --manifest-path server/cli/Cargo.toml
```

## 架构

```
前端 Vue 3 → Vite :5173
     │
     ▼ proxy /api/*
Node.js Hono :5180
     ├── /api/cad/*  cad-rust (Rust SQLite + 代理)
     ├── /api/caa/*  CAA 对话
     └── /api/*      待迁移（Python 可选）
```

## 测试

```bash
pnpm test                       # 全量：Rust + TS + CAA (161 pass)

# 分类运行
pnpm test:rust                  # Rust 单元测试（fcstd-reader + fcstd-xlink）
pnpm test:ts                    # TypeScript 测试（server/src/lib/）
pnpm test:caa                   # CAA 测试（catdlg-core + web-ui vitest）
```

### 测试报告

`pnpm test:ts` 自动生成 HTML 报告 `test-report/index.html`。
由于 HTML 需加载 JS 资源，用 HTTP 查看：

```bash
python3 -m http.server 4173 --directory test-report
# → 浏览器打开 http://localhost:4173
```

## 目录

| 路径 | 说明 |
|------|------|
| `server/` | Node.js + Rust 后端 |
| `web-ui/` | Vue 3 前端 |
| `phoenix/` | Python 包（逐步退役） |
| `scripts/` | 命令行工具 |
| `doc/` | 文档 |
# Phoenix Desk Tools

## 许可证

Copyright © 2024–2026 上海锟钛。项目使用 [Apache License 2.0](LICENSE) 开源。