Files
Nexus/docs/project/AI-HANDOFF-2026-06-03.md
T
2026-07-08 22:31:31 +08:00

82 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 @ 9ac6a2dDocker + 前端构建物进 Git
【已完成】
- 文件编辑器 Ref 修复、Monaco preload、FilesList 操作按钮
- text_io / EOL 门控(check_text_eol.py、check_shell_eol.sh
- web/app 构建产物在 GitDocker Composemysql/redis/nexus
【待办】
1. cd $NEXUS_ROOT && git pull origin main
2. dockerpython3 docker/generate_env.py && docker compose up -d --build
3. 裸机生产:ssh nexus → git pull && supervisorctl restart nexus
4. 前端:cd frontend && npx vite buildnpm 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】批次 13 已本地验证;见 docs/changelog/2026-06-04-code-review-*.md
【风险接受 · 单人运维】docs/project/risk-acceptance-single-operator.mdWS 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 仍走 queryADR-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 脚本)
---
## 已下线 — 远程内置浏览器(2026-06-12
Playwright Worker + canvas 浮动窗 **已整体移除**。服务器页「站点」改为 **新标签打开**`browserUrl.ts`)。
| 用途 | 路径 |
|------|------|
| **经验 SSOT(换方案前必读)** | `docs/design/specs/2026-06-12-remote-browser-retired-lessons.md` |
| 下线 changelog | `docs/changelog/2026-06-12-remove-remote-browser.md` |
| 历史设计(归档) | `docs/design/specs/2026-06-11-server-browser-chromium-design.md` |
**勿**在未新设计前恢复 `browser-worker/``/api/browser/*`