chore: 官网拆分 homepage + 关于页瘦身 + 端口 5175(当前可用状态基线)

This commit is contained in:
Logan.Li committed 2026-10-14 20:31:51 +08:00
1 parent 5eb11826db
commit be151cb68f
85 files changed
+4420 -1530

No files matched your search

+15 -7
View File
@@ -11,9 +11,9 @@
操作 → 桌面 Tauri(./run.sh gui)
```
官网与用户文档在本仓 `apps/server`(原独立仓 `site-opsxshell` 已并入)。Gin **不做**桌面操作后端。
官网与用户文档为独立静态站(`homepage/` 源 → `tools/homepage-build` 生成 dist,可部署自有域名;本地 `:8789` 预览)。Gin **不做**桌面操作后端。
需要 Node.js 18+、npm 9+、Rust 1.77+、Go 1.22+(跑官网时)。macOS 打包还要 Xcode Command Line Tools。
需要 Node.js 22 LTS(建议 22.12+)、npm 9+、Rust 1.89+、Go 1.22+(跑官网时)。macOS 打包还要 Xcode Command Line Tools。
## 本地调试
@@ -30,7 +30,7 @@ DevTools:`Cmd+Option+I` 或 `F12`。桌面应用日志:
tail -f "$HOME/Library/Application Support/opsxshell/logs/opsxshell.log"
```
只要前端、不要原生窗:`npm run dev:ui`(默认 `http://127.0.0.1:1420`,**不是**产品入口)。
只要前端、不要原生窗:`npm run dev:ui`(默认 `http://127.0.0.1:5175`,**不是**产品入口)。
## 测试
@@ -42,21 +42,29 @@ npm run acceptance:full
## 开发机卫生
Launchpad / Spotlight 若扫到 `target` 里重复的 Opsx 应用,跑:`~/devops/scripts/clean-opsx-apps.sh`(可选 `--delete-target-apps` / `--reset-launchpad`)。
`./run.sh gui` 启动前会自动做**轻量清**(推出残留 Opsx/OpsX DMG 卷、注销非 `/Applications` 且非本次启动路径的幽灵登记;不删 `target`、不重置 Launchpad)。
若 Launchpad / Spotlight 仍堆出重复图标,手动跑全量:
```bash
~/devops/scripts/clean-opsx-apps.sh
# 或:./run.sh clean-apps
# 可选:--delete-target-apps --reset-launchpad
```
## 打包
必须在目标系统上打:macOS 包在 Mac 打,Windows 包在 Windows 打。
```bash
./scripts/build.sh # 当前平台;产物在 release/v<版本>/
./scripts/build.sh # 当前平台;产物在 src-tauri/target/<triple>/release/bundle/
./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)。
本机有 gitignore 的 `src-tauri/tauri.signing.conf.json` 时,`build.sh` 会签 Developer ID。没这份配置就是 ad-hoc,别人电脑会 Gatekeeper 拦截。新打的 DMG **必须再公证**。签名配置、公证与发版细节见 [发布文档](./docs/release.md#签名公证和自动更新)。
Gitee Release(tag 推上去之后):
@@ -65,7 +73,7 @@ Gitee Release(tag 推上去之后):
./scripts/release.py v2.1.1
```
发版安装包也可放到 `apps/server/download/` 供本地 Gin `/download/` 挂载(勿把大 DMG 提交进 Git)。
发版安装包也可放到 `server/download/` 供本地 Gin `/download/` 挂载(勿把大 DMG 提交进 Git)。
## 文档