lan-reader-chat/docs/deployment-preflight-checklist.md

部署前总验收清单

这份清单用于在把网站正式交给 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