Nexus/docs/project/AI-HANDOFF-2026-06-09.md

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

新会话请复制下方「复制提示词」整段。
取代 AI-HANDOFF-2026-06-08.md（版本号已过时）。
SSOT：docs/project/nexus-functional-development-guide.md · 门控 bash deploy/pre_deploy_check.sh

---

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

【Nexus 6.0 接续 · Linux · 2026-06-09】

工作区：$NEXUS_ROOT（本机 ~/桌面/Nexus）
仓库：http://66.154.115.8:3000/admin/Nexus.git · 分支 main @ 64c8bd7
生产：https://api.synaglobal.vip · Docker @ /opt/nexus · 端口 8600
  · 运行中前端 ≈ c366ed5（tar/sync_webapp）；主机 git checkout 可能仍 664efb9，下次 upgrade 会 pull
SSH：NEXUS_SSH=azureuser@20.24.218.235 · NEXUS_SSH_KEY="/home/r/下载/Telegram Desktop/nz-admin.pem"
push：bash scripts/git-push.sh
部署：NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/pre_deploy_check.sh && NEXUS_DEPLOY_PATH=/opt/nexus bash deploy/deploy-production.sh
（本机开发路径含中文时，部署必须显式 NEXUS_DEPLOY_PATH=/opt/nexus）

【栈】FastAPI + Async SQLAlchemy + Redis · Vue 3 + Vuetify 4 SPA · Vite → web/app/
【铁律】单 Agent · perfect-implementation.mdc · 改代码必 changelog + audit · 测试 Agent 做、用户终验

【生产已部署】
- 运维时区北京：e3efbd4 / 56139a4 · docs/reports/2026-06-09-operator-timezone-beijing-verification.md
- Wave 0：prod_probe 时区、sync_webapp_to_container、D-01 agent_deploy（863e49e）
- Dashboard 24h 趋势 B-02：664efb9（fleet_metric_samples + v-sparkline）
- 推送页分类全量：c366ed5 · docs/reports/2026-06-09-push-category-full-list-deploy-verification.md
  （机器人 101 台；旧版仅显示 5 台因 per_page=200）

【用户终验待确认】
- 推送页「机器人」0/101；商城等与分类 chip 一致
- Dashboard 24h 资源趋势（采样约 10min/条）
- 调度页北京时间 / next_run；WS 告警时间
- 批量 101 台、WebSSH、Telegram、关 CPU 告警无恢复轰炸

【优先待办 TOP 10】
1. 生产 git pull 对齐 c366ed5（或一次 deploy-production 消歧）
2. API detail 中文化 — 422 ☑ · HTTP 4xx 全局层 ☑ · ValueError 源头 ☑（已部署 64c8bd7）
3. Agent 401 子机 rollout（A-05）
4. 无心跳自动离线 + 告警降噪
5. L4 Playwright 全绿 + L5 清单
6. 资产管理 / Sync 配置 UI（C-01/C-02）
7. B-03 Files 树形侧栏
8. 用户浏览器终验（见 final-acceptance-checklist）
9. 国内 CDN / 双入口（电信 HTTPS RST）
10. POSIX + 文件管理 FM-L* 生产验收

【完整 132 条】AI-HANDOFF-2026-06-08.md §Master Backlog
【对齐计划 31 项】docs/design/plans/2026-06-07-missing-features-alignment-plan.md

【勿提交】deploy/gate_log.jsonl · .cursor/settings.json
【Handoff】docs/project/AI-HANDOFF-2026-06-09.md

---

生产状态

项	值
Git 远程 main	c366ed5
生产 /opt/nexus checkout	664efb9（web/app 已热更至 c366ed5 资源）
前端入口	index-jg6n1uIt.js · PushPage-DukhcoEE.js
生产 URL	https://api.synaglobal.vip
探针	NEXUS_PROBE_MODE=origin bash scripts/prod_health_check.sh
外网	部分线路 HTTPS RST；隧道 ssh -L 18600:127.0.0.1:8600 nexus

---

2026-06-09 主要交付

主题	提交/文档
运维时区北京	e3efbd4
Wave 0 部署对齐	863e49e
Dashboard 24h 趋势 B-02	664efb9
推送分类全量加载	c366ed5 · changelog + verification
生产探针 / sync_webapp / D-01	863e49e 起

---

关键路径

用途	路径
推送全量列表	frontend/src/composables/push/usePushServers.ts
未设路径独立筛选	frontend/src/pages/ServersPage.vue → unsetListQueryParams
Dashboard 趋势	frontend/src/components/dashboard/DashboardFleetTrends.vue
时区工具	server/utils/display_time.py
前端同步	deploy/sync_webapp_to_container.sh
Handoff	本文