57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
# OpsXShell
|
||
|
||
原生运维终端：SSH、SFTP、端口转发、RDP/VNC、串口、本地终端。短路径好用，不做审计/审批/堡垒机。
|
||
|
||
需要 Node.js 18+、npm 9+、Rust 1.77+。macOS 打包还要 Xcode Command Line Tools。
|
||
|
||
## 本地调试（GUI）
|
||
|
||
```bash
|
||
./run.sh
|
||
```
|
||
|
||
会清掉旧的 Vite / 应用进程，缺依赖时自动 `npm install`，再开 Tauri 开发窗。DevTools：`Cmd+Option+I` 或 `F12`。日志：
|
||
|
||
```bash
|
||
tail -f "$HOME/Library/Application Support/opsxshell/logs/opsxshell.log"
|
||
```
|
||
|
||
只要前端、不要原生窗：`npm run dev:ui`（默认 `http://127.0.0.1:1420`）。
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
npm run test:patrol # 改功能后优先跑
|
||
npm run acceptance:quick
|
||
npm run acceptance:full
|
||
```
|
||
|
||
## 打包
|
||
|
||
必须在目标系统上打：macOS 包在 Mac 打，Windows 包在 Windows 打。
|
||
|
||
```bash
|
||
./scripts/build.sh # 当前平台；产物在 release/v<版本>/
|
||
./scripts/build.sh mac-arm64 --quick # 本机重复打包
|
||
./scripts/macos-notarize.sh # 新 DMG：Apple 公证 + staple
|
||
```
|
||
|
||
Windows：`scripts\build.bat win-x64`
|
||
|
||
本机有 gitignore 的 `src-tauri/tauri.signing.conf.json` 时，`build.sh` 会签 Developer ID。没这份配置就是 ad-hoc，别人电脑会 Gatekeeper 拦截。新打的 DMG **必须再公证**。申请证书、导入钥匙串的步骤见 [download/Apple开发者签名.md](./download/Apple开发者签名.md)；发版细节见 [docs/release.md](./docs/release.md)。
|
||
|
||
Gitee Release（tag 推上去之后）：
|
||
|
||
```bash
|
||
./scripts/release.py v2.1.1 --dry-run
|
||
./scripts/release.py v2.1.1
|
||
```
|
||
|
||
## 文档
|
||
|
||
- [使用指南](docs/user-guide.md)
|
||
- [架构](docs/architecture.md) · [验收](docs/testing-acceptance.md) · [发布](docs/release.md)
|
||
- [路线图](ROADMAP.md) · [当前任务](TASKS.md)
|
||
|
||
MIT，见 [LICENSE](./LICENSE)。
|