# Nexus — AI 接续（2026-06-03 · Linux）

> 工作区请以你本机实际路径为准，例如 `~/Nexus` 或 `/opt/nexus`，勿再用 Windows 路径。

## 复制提示词（整段给新会话）

```
【Nexus 6.0 接续 · Linux · 2026-06-03】

工作区：$NEXUS_ROOT（例：~/Nexus 或 /opt/nexus — 以本机为准）
仓库：git clone http://66.154.115.8:3000/admin/Nexus.git
分支：main @ 9ac6a2d（Docker + 前端构建物进 Git）

【已完成】
- 文件编辑器 Ref 修复、Monaco preload、FilesList 操作按钮
- text_io / EOL 门控（check_text_eol.py、check_shell_eol.sh）
- web/app 构建产物在 Git；Docker Compose（mysql/redis/nexus）

【待办】
1. cd $NEXUS_ROOT && git pull origin main
2. docker：python3 docker/generate_env.py && docker compose up -d --build
3. 裸机生产：ssh nexus → git pull && supervisorctl restart nexus
4. 前端：cd frontend && npx vite build（npm run build 可能 vue-tsc 失败）

【规范】.cursor/rules/perfect-implementation.mdc · 单 Agent · 改代码必 changelog

【文档】docs/README.md（总索引）· nexus-functional-development-guide.md + appendix · archive/README.md
【Code Review】批次 1～3 已本地验证；见 docs/changelog/2026-06-04-code-review-*.md
【风险接受 · 单人运维】docs/project/risk-acceptance-single-operator.md（WS ADR-011 + Agent global 不排期）
【插件】docs/project/cursor-plugins-for-nexus.md · MySQL MCP: scripts/linux_mcp_mysql.sh
【本地验收】bash scripts/local_verify.sh · seed_local_admin.py · frontend npm run test:e2e
```

## 解压离线包后

```bash
export NEXUS_ROOT=~/Nexus
mkdir -p "$NEXUS_ROOT" && tar xzf nexus-handoff-2026-06-03.tar.gz -C "$(dirname "$NEXUS_ROOT")"
cd "$NEXUS_ROOT" && git remote -v   # 若无 .git：重新 clone 后覆盖源码目录
```

---

## Code Review 收尾（2026-06-04）

本地已修复并验证三批（P0/P1 + batch2 + batch3），changelog/audit 见：

| 批次 | Changelog | Audit |
|------|-----------|-------|
| P0/P1 | `docs/changelog/2026-06-04-code-review-p0-p1-fixes.md` | `docs/audit/2026-06-04-code-review-p0-p1-fixes.md` |
| batch2 | `docs/changelog/2026-06-04-code-review-p1-p2-batch2.md` | `docs/audit/2026-06-04-code-review-p1-p2-batch2.md` |
| batch3 | `docs/changelog/2026-06-04-code-review-p1-p2-batch3.md` | `docs/audit/2026-06-04-code-review-p1-p2-batch3.md` |

**未排期（已风险接受）**：Operator 确认后台仅一人自用 → 见 **`docs/project/risk-acceptance-single-operator.md`**

- WebSocket JWT 仍走 query（ADR-011），不改造协议
- Agent global `API_KEY` legacy 回退保留；batch3 已禁 unknown server_id

重评触发：新增管理员、日志外发、等保审计、global key 泄露或 Agent 全量 per-server 迁移完成。

## 本地验证（2026-06-04）

```bash
bash scripts/local_verify.sh   # Docker + API + smoke + test_api + ruff
```

文档：`docs/project/local-integration-test.md`（已取代 WSL 脚本）

---

## 待办 — 服务端远程浏览器（Worker 分离）

**用户确认**：任意公网；Chromium；**独立 Worker 服务器**（用户去购机）。

| 文档 | 路径 |
|------|------|
| 设计 | `docs/design/specs/2026-06-11-server-browser-chromium-design.md` |
| 代码实施 | `docs/design/plans/2026-06-11-server-browser-chromium.md` |
| **购机/装机/联调** | **`docs/design/plans/2026-06-11-browser-worker-server-procurement.md`** |

**进度**：iframe 内置浏览器 **已移除**（changelog `2026-06-11-remove-embedded-browser`）；待购 Worker 后按 W1～W4 重建 canvas 浏览器。

**购机规格速记**：2C4G 起（推荐 4C8G）· Ubuntu 22.04/24.04 · Worker 8443 仅允许 Nexus 主站 `20.24.218.235` 访问。

---

## 待办 — 内置浏览器网站导航（收藏）

**用户原话**：浏览器内置网站导航，我自己可以增加，类似收藏功能。

| 文档 | 路径 |
|------|------|
| 设计 | `docs/design/specs/2026-06-11-browser-nav-bookmarks-design.md` |
| 实施计划 | `docs/design/plans/2026-06-11-browser-nav-bookmarks.md` |

**进度**：随 iframe 浏览器一并移除；Worker 方案上线时重做。