# 交付验收清单

这是要求与证据的对照表，不能用提交、PR 或测试意图代替实际验收。所有 PR 由用户手动合并。构建只使用 ces-control，网页只在指定服务器验收。

| 用户要求 | 应验证的行为 | 当前证据 / 待办 |
| --- | --- | --- |
| 研究 LLM Wiki | 能指出原始提案与本项目新增设计的边界 | protocol.md 引用 Karpathy 原始 gist；XML、条件链接和版本规则为本项目提案 |
| SkillHub 逐页截图与设计分析 | 首页、目录、详情各标签、作者、登录、发布入口具备截图和观察记录 | 主 chat 已截取首页首屏与下半屏、目录、概述、文件、版本、评论、评测、登录、作者及发布限制；截图目前在 chat 中，移动视图待补 |
| 可独立使用的文档 | 单篇内容具有适用条件、正文和步骤，不要求安装包 | catalog.ts 与 /guide 原型；真实文档实现已随 PR #9 合入，待 CI 与运行时验证 |
| 按链接寻找帮助 | 条件、关系、精确版本可读，缺失目标明确，背景不升级权限 | 协议及静态阅读页；真实文档预览与链接解析待 PR #9 验证 |
| 新语法 | XML 可序列化、校验、往返，拒绝未知协议与非法实体 | 原型 XML 输出已合入；严格输入与往返测试已随 PR #9 合入，远程执行待确认 |
| 基于现有 wiki 改造 | 沿用 Pages Router 与现有部署数据 | main 已包含新首页原型，实际服务仍在旧版本，等待 CI 部署 |
| 保留旧小红书 UI | 旧首页和组件仍可在代码库找到，新入口不再使用 | src/legacy/WaterfallHome.tsx 以及原 ExploreFeed/Shell 保留；部署后需检查新首页 |
| 邮箱与密码登录并验证邮箱 | 注册发信、验证一次消费、未验证不能登录、会话可注销 | #6/#8 已由用户合并；SMTP 配置与 TLS 登录已验证；实际注册、投递、验证和登录待部署 |
| 正常用户与管理员隔离 | 普通邮箱 cookie 无法授权旧管理写 API | auth.test.ts 与 account-integration.ts；最终 main CI 结果仍待确认 |
| 真实发布与版本 | 已验证作者能发布和更新，其他人不能覆盖，旧版本不变 | PR #9 的 PostgreSQL 所有权/并发/撤下保留测试，待远程执行与网页验证 |
| 独立开发与人工合并 | 每个方向独立分支和可评审 PR | #6/#7/#8/#9 已由用户合并；#10/#11/#12 等待用户；所有 merge 由用户完成 |

## SMTP 验收边界

配置已写入服务器 root 所有、0600 权限的 /etc/prompt.env。密码不在仓库、PR 或 CI 日志中。SMTP_SSL 证书验证、连接与认证已通过；这只证明邮件服务可连接与认证，不证明注册邮件已发出或用户已收到。生产服务尚未因配置而手动重启，等待正常 CI/CD 部署。

## 当前未完成工作

补齐窄屏参考及验收截图；完成当前 main 和 #11/#12 的远程 CI；PR 由用户手动合并；等待正常部署；在服务器上测试邮箱注册验证与文档发布、编辑、精确版本及关联阅读；记录桌面与窄屏效果。只有运行时证据齐全后才认定完整交付。

## Agent 发现入口

PR #12 将 llms.txt 与 /agent/index.md、/index.md 导向独立指导文档，索引同时包含持久化用户文档与示例，并只公开 GET/HEAD。测试覆盖发现入口、预算与固定版本链接；远程 CI 和部署验收尚未完成。