feat(site): 并入 Gin 官网与文档服务，对齐桌面产品形态

- apps/server：Gin embed 官网 + /docs + /health + /download（无操作 API）
- run.sh 重写 web/gui 场景；.gitignore 排除 server 二进制与挂载的安装包
- README/AGENTS/CLAUDE 同步「浏览器只看官网、操作走桌面」的产品形态说明
- 终端视口背景变量与全宽终端边缘 hairline 修正（serial/terminal/i18n 微调）

README.md

@@ -1,22 +1,36 @@
 # OpsXShell
 
-原生运维终端：SSH、SFTP、端口转发、RDP/VNC、串口、本地终端。短路径好用，不做审计/审批/堡垒机。
+原生运维**桌面**终端：SSH、SFTP、端口转发、RDP/VNC、串口、本地终端。短路径好用，不做审计/审批/堡垒机。
 
-需要 Node.js 18+、npm 9+、Rust 1.77+。macOS 打包还要 Xcode Command Line Tools。
+开发规范：[AGENTS.md](./AGENTS.md)（短入口 [CLAUDE.md](./CLAUDE.md)）。授权走 `opsx-licence`。
 
-## 本地调试（GUI）
+产品形态（对齐 opsxdb / opsxapi）：
 
-```bash
-./run.sh
+```text
+浏览器  →  官网 + 文档（Gin :8789）
+操作    →  桌面 Tauri（./run.sh gui）
 ```
 
-会清掉旧的 Vite / 应用进程，缺依赖时自动 `npm install`，再开 Tauri 开发窗。DevTools：`Cmd+Option+I` 或 `F12`。日志：
+官网与用户文档在本仓 `apps/server`（原独立仓 `site-opsxshell` 已并入）。Gin **不做**桌面操作后端。
+
+需要 Node.js 18+、npm 9+、Rust 1.77+、Go 1.22+（跑官网时）。macOS 打包还要 Xcode Command Line Tools。
+
+## 本地调试
+
+```bash
+./run.sh          # = web：官网 + docs → http://127.0.0.1:8789/
+./run.sh web      # 同上
+./run.sh gui      # 桌面操作入口（默认顺带起 Gin）
+./run.sh stop | status
+```
+
+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`）。
+只要前端、不要原生窗：`npm run dev:ui`（默认 `http://127.0.0.1:1420`，**不是**产品入口）。
 
 ## 测试
 
@@ -26,6 +40,10 @@ npm run acceptance:quick
 npm run acceptance:full
 ```
 
+## 开发机卫生
+
+Launchpad / Spotlight 若扫到 `target` 里重复的 Opsx 应用，跑：`~/devops/scripts/clean-opsx-apps.sh`（可选 `--delete-target-apps` / `--reset-launchpad`）。
+
 ## 打包
 
 必须在目标系统上打：macOS 包在 Mac 打，Windows 包在 Windows 打。
@@ -47,9 +65,12 @@ Gitee Release（tag 推上去之后）：
 ./scripts/release.py v2.1.1
 ```
 
+发版安装包也可放到 `apps/server/download/` 供本地 Gin `/download/` 挂载（勿把大 DMG 提交进 Git）。
+
 ## 文档
 
-- [使用指南](docs/user-guide.md)
+- 用户文档站（本地）：`./run.sh web` → http://127.0.0.1:8789/docs
+- [使用指南](docs/user-guide.md)（开发向）
 - [架构](docs/architecture.md) · [验收](docs/testing-acceptance.md) · [发布](docs/release.md)
 - [路线图](ROADMAP.md) · [当前任务](TASKS.md)