release: BUG fixes batch 1-6, full bug scan docs, Ubuntu/Linux dev

- Backend: auth refresh reuse, schedule/retry/sync/agent/files fixes - Frontend: push WS, files ETag browse, vite build assets - Docs: audit/changelog, production deploy gate, bug scan registry B7-77 - Deploy: deploy-production.sh, prune assets, gate logs
2026-06-04 14:01:14 +08:00
parent 9ac6a2d27f
commit a2ae74d582
367 changed files with 77336 additions and 751 deletions
@@ -0,0 +1,43 @@
+# Linux 开发路径约定（SSOT）
+
+> **生效日期**: 2026-06-04  
+> 取代各 handoff 文档中的 `C:\Users\...` / `/mnt/c/...` 示例。
+
+## 工作区
+
+| 变量 | 示例 |
+|------|------|
+| `NEXUS_ROOT` | `~/Nexus` 或 `/home/you/Nexus` |
+| Git 克隆 | `git clone http://66.154.115.8:3000/admin/Nexus.git "$NEXUS_ROOT"` |
+
+## SSH / 部署
+
+| 用途 | Linux |
+|------|--------|
+| SSH 配置 | `~/.ssh/config` 中 `Host nexus` |
+| 私钥 | `~/.ssh/id_rsa_nexus` |
+| 生产目录 | `/www/wwwroot/api.synaglobal.vip/` |
+
+```bash
+ssh nexus "cd /www/wwwroot/api.synaglobal.vip && git pull && supervisorctl restart nexus"
+```
+
+## Cursor MCP
+
+- MySQL：`scripts/linux_mcp_mysql.sh`（见 `docs/project/mysql-mcp-setup.md` §4）
+- **勿**在 `mcp.json` 使用 `wsl` + Windows 路径（仅 WSL-on-Windows 主机适用）
+
+## 历史文档
+
+`docs/handoff-2026-05-31.md`、`AI-HANDOFF-2026-05-23.md` 等保留 Windows 示例作归档；**以本文 + `AI-HANDOFF-2026-06-03.md` 为准**。
+
+## 本地验收账号
+
+```bash
+# .env（不入 git）
+NEXUS_TEST_ADMIN_USER=admin
+NEXUS_TEST_ADMIN_PASSWORD='你的本地密码'
+
+python3 scripts/seed_local_admin.py   # 仅空库 + 127.0.0.1
+cd frontend && NEXUS_E2E_BASE=http://127.0.0.1:8600 npm run test:e2e
+```