# 部署前总验收清单

这份清单用于在把网站正式交给 OpenClaw / ops 部署到局域网 MacBook 之前，做最后一轮上线前确认。

## 1. 代码与构建

1. Git 仓库可访问。
2. `npm install` 可以成功完成。
3. `npm run build` 成功通过。
4. `npm run start -- --hostname 0.0.0.0 --port 3000` 可以正常启动。

## 2. 页面访问

至少确认下面页面都可正常打开：

1. `/`
2. `/chat`
3. `/library`
4. `/reader/lan-archive`
5. `/agents`

## 3. 聊天室

1. 文字消息可以发送。
2. 图片可以上传、发送、查看。
3. 文件可以上传、显示、点击下载 / 打开。
4. 清空聊天记录功能可用，并会写入系统清理消息。
5. 服务重启后，聊天记录仍然保留。
6. 当前在线设备数会根据真实在线状态变化。
7. PC 端消息区可滚动，输入区固定。
8. 手机端消息区可滚动，输入区固定。

## 4. 小说阅读

1. 书架页可以进入阅读页。
2. 目录可打开。
3. 上一章 / 下一章切换正常。
4. 字号 / 主题 / 版心切换正常。
5. 桌面端版心切换时，左右悬浮按钮会跟随正文一起移动。
6. 手机端顶部和底部操作区正常。

## 5. Agent 页面

1. `/agents` 可以返回数据。
2. 没有真实数据时，会回退到 demo 数据。
3. 有真实数据文件时，会优先显示真实数据。
4. PC 端总览页一行显示 4 个 agent 卡片。
5. agent 详情页可打开。

## 6. 本地存储

下面目录 / 文件应存在并可写：

1. `storage/chat.sqlite`
2. `storage/chat-uploads/`
3. `storage/agents/openclaw-agents.json`

## 7. 缓存与局域网访问

1. 页面 HTML 返回 `Cache-Control: no-store, no-cache, must-revalidate, proxy-revalidate`
2. 局域网内其他设备可以通过 `http://MacBook局域网IP:3000` 访问
3. 若出现旧页面 / 无样式页面，先关闭旧标签页，再重新打开新标签页验证

## 8. 开机自启

1. `com.lan-reader-chat.web.plist` 已安装
2. `com.lan-reader-chat.agentfeed.plist` 已安装
3. 开机后服务自动启动
4. OpenClaw agent feed 定时同步可执行

## 9. 运维交接

交给 OpenClaw 时至少附带：

1. Git 仓库地址
2. `docs/macbook-deployment.md`
3. `docs/openclaw-ops-runbook.md`
4. `docs/openclaw-agent-feed.md`
5. `docs/openclaw-agent-feed.example.json`
6. `docs/openclaw-handoff.md`