110 lines
2.7 KiB
Markdown
110 lines
2.7 KiB
Markdown
# INP2P 一页发布手册（P4.5 收官）
|
||
|
||
更新时间：2026-03-08
|
||
当前基线版本：`0.1.0+build.18`
|
||
|
||
---
|
||
|
||
## 0) 适用范围
|
||
|
||
- 项目：`/root/.openclaw/workspace/inp2p`
|
||
- 服务：`inp2ps.service`
|
||
- 目标：每次发布都可复用本手册完成构建、部署、验收与留档
|
||
|
||
---
|
||
|
||
## 1) 标准发布流程（强制）
|
||
|
||
```bash
|
||
cd /root/.openclaw/workspace/inp2p
|
||
make build
|
||
systemctl restart inp2ps.service
|
||
make verify-deploy
|
||
```
|
||
|
||
**判定规则：**
|
||
- 仅当 `make verify-deploy` 全绿，才算发布成功。
|
||
- 仅重启成功不算发布成功。
|
||
|
||
**验收证据：**
|
||
- 报告路径：`run/deploy-check/deploy-check-YYYYmmdd-HHMMSS.txt`
|
||
|
||
---
|
||
|
||
## 2) UI 交互规范（封板基线）
|
||
|
||
### 2.1 按钮层级
|
||
- `btn`：主路径提交（状态变更/写入）
|
||
- `btn2`：次级动作（筛选、导出、切换、重试）
|
||
- `btn-danger`：高风险动作（删除、踢下线、不可逆）
|
||
|
||
### 2.2 文案规范
|
||
- 刷新类统一“重新加载”
|
||
- 空态统一“暂无 xxx 记录 + 下一步引导”
|
||
- 批量反馈统一“成功/失败计数”
|
||
|
||
### 2.3 快捷键规范
|
||
- `/` 聚焦筛选
|
||
- `r` 刷新
|
||
- `g` 打开节点页
|
||
- `?` 打开/关闭帮助
|
||
- 输入法组合态、Ctrl/Alt/Meta 组合键不触发全局热键
|
||
|
||
---
|
||
|
||
## 3) 功能验收清单（最小集）
|
||
|
||
1. 登录/登出正常，停用账号被拒绝
|
||
2. 节点页：搜索、踢下线确认、改昵称/改IP
|
||
3. SDWAN：保存 SDWAN/节点映射/子网代理
|
||
4. 租户/Key/用户/enroll：单条与批量操作可用
|
||
5. 失败池：保留开关、重试、清空行为正确
|
||
6. 审计：预设筛选、清空筛选、CSV 导出、失败事件导出
|
||
7. 最近操作摘要（opSummary）正确回显
|
||
|
||
---
|
||
|
||
## 4) 本轮阶段成果（摘要）
|
||
|
||
### P0（人性化收尾）
|
||
- 危险操作显式标红
|
||
- 输入示例占位补齐
|
||
- 复制快捷操作（Key/enroll）
|
||
|
||
### P1（信息与审计可读性）
|
||
- 常用操作区
|
||
- 审计 action 标签化 + 高风险高亮
|
||
- 审计快速筛选与清空
|
||
- 空态引导、最近操作摘要
|
||
|
||
### P2（效率提升）
|
||
- 审计 CSV 导出 + 失败事件导出
|
||
- 快捷键（/ r g ?）
|
||
- 批量操作 + 二次确认 + 统计回执
|
||
|
||
### P3（稳定性增强）
|
||
- 批量并发执行 + 失败重试
|
||
- 失败池保留/清空策略
|
||
- 审计预设持久化
|
||
- 热键冲突规避（输入法/组合键）
|
||
|
||
### P4（封板）
|
||
- 按钮层级统一
|
||
- 文案词典落地
|
||
- 最终回归清单沉淀
|
||
|
||
---
|
||
|
||
## 5) 发布签字项（可复制）
|
||
|
||
- [ ] 已执行 `make build`
|
||
- [ ] 已执行 `systemctl restart inp2ps.service`
|
||
- [ ] 已执行 `make verify-deploy` 且全绿
|
||
- [ ] 已记录 deploy-check 报告路径
|
||
- [ ] 已完成最小功能回归
|
||
- [ ] 已确认线上版本号与 `VERSION` 一致
|
||
|
||
签字人：__________
|
||
时间：__________
|
||
报告：`run/deploy-check/deploy-check-________________.txt`
|