# 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`