72 lines
1.6 KiB
Markdown
72 lines
1.6 KiB
Markdown
# Gaza
|
||
|
||
Gaza 是一个协议优先、跨平台的多 Teamserver 桌面工作台。当前仓库包含可运行的首个项目骨架，重点验证 Teamserver 工作区和标签页隔离模型。
|
||
|
||
## 技术栈
|
||
|
||
- Tauri 2（桌面容器）
|
||
- React 19 + TypeScript + Vite（界面）
|
||
- Vitest + Testing Library（单元与组件测试）
|
||
|
||
## 快速开始
|
||
|
||
本机安装 Node.js 22 与 Rust stable 后：
|
||
|
||
```bash
|
||
npm ci
|
||
npm run dev # 浏览器开发模式
|
||
npm run tauri dev # 桌面开发模式
|
||
```
|
||
|
||
无需本机 Node.js 的前端验证：
|
||
|
||
```bash
|
||
docker compose run --rm test
|
||
docker compose run --rm build
|
||
```
|
||
|
||
## Docker 启动 Web 测试服务
|
||
|
||
构建镜像并在后台启动：
|
||
|
||
```bash
|
||
docker compose up --build -d
|
||
```
|
||
|
||
浏览器访问 <http://127.0.0.1:1420>。查看状态和日志：
|
||
|
||
```bash
|
||
docker compose ps
|
||
docker compose logs -f web
|
||
```
|
||
|
||
停止服务：
|
||
|
||
```bash
|
||
docker compose down
|
||
```
|
||
|
||
默认只监听本机回环地址。需要让局域网测试设备访问时，显式设置监听地址和端口：
|
||
|
||
```bash
|
||
WEB_BIND_ADDRESS=0.0.0.0 WEB_PORT=1420 docker compose up --build -d
|
||
```
|
||
|
||
开放到局域网前请确认主机防火墙和测试网络范围；Web 预览不包含认证能力。
|
||
|
||
## 当前范围
|
||
|
||
- 展示多 Teamserver 连接状态和独立工作区。
|
||
- 切换 Teamserver 时隔离标签、项目导航和激活状态。
|
||
- 所有演示业务状态仅保存在进程内存，不写入本地存储。
|
||
- 提供 Tauri 最小权限配置；后续连接、协议与加密 SQLite 能力按独立迭代接入。
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
npm run typecheck
|
||
npm test
|
||
npm run build
|
||
npm run tauri build
|
||
```
|