Nexus/docs/changelog/2026-06-02-server-form-redesign.md

2026-06-02 服务器添加/编辑表单重设计

摘要

Vuetify 服务器页的添加/编辑对话框与 ServerCreate 及 2026-05 设计文档对齐：认证方式、密码/SSH 密钥预设、目标路径、分类 combobox、平台/节点高级项。

动机

迁移 SPA 后表单仅含名称、错误字段 address、裸密码框，无法使用凭据预设与密钥认证，且缺少必填 target_path，导致与后端及旧版 servers.html 行为不一致。

涉及文件

• frontend/src/composables/servers/useServerFormDialog.ts（新建）
• frontend/src/components/servers/ServerFormDialog.vue（新建）
• frontend/src/pages/ServersPage.vue
• docs/design/specs/2026-06-02-server-form-redesign.md
• docs/design/plans/2026-06-02-server-form-redesign.md

迁移 / 重启

• 仅前端构建产物；需 vite build 后部署 web/app/
• 后端无变更，无需重启（仅前端更新时不必重启 nexus）

验证

1. 服务器页 → 添加：可见「密码 / SSH 密钥」切换、密码预设下拉、目标路径默认 /www/wwwroot
2. 选择密码预设后 SSH 密码框隐藏
3. 保存后 Network 中 POST /api/servers/ 含 auth_method、target_path、preset_id 等
4. 编辑 回填 auth_method、preset_id、target_path、分类

部署记录（2026-06-02）

• 构建：npx vite build（Windows Node 20+）
• 上传：scp → root@47.254.123.106:/tmp/nexus-frontend.tar.gz
• 解压：/www/wwwroot/api.synaglobal.vip/web/app
• 清理：prune_frontend_assets.py（removed=2203, kept=173）
• 重启：supervisorctl restart nexus
• 健康：/health → ok，/app/ → HTTP 200
• 产物：ServersPage-CmUnLCji.js 已含 ServerFormDialog（认证方式/密码预设/目标路径等文案）
• 说明：本机 Cursor 内置浏览器访问 https://api.synaglobal.vip/app/login 为黑屏（环境网络/渲染限制），请在已登录浏览器打开 /app/servers 点「添加」终验