Rebuild guidance wiki as a unified SaaS workspace
This commit is contained in:
@@ -1,33 +1,38 @@
|
||||
# 交付验收清单
|
||||
# 交付验收记录
|
||||
|
||||
这是要求与证据的对照表,不能用提交、PR 或测试意图代替实际验收。所有 PR 由用户手动合并。构建只使用 ces-control,网页只在指定服务器验收。
|
||||
所有 PR 由用户手动合并,只有 main 更新触发 ces-control CI/CD。用户后续明确允许在当前项目目录内本地开发和测试;本次 SaaS 重构使用独立工作区,结束后清理自建临时依赖、预览和构建产物。
|
||||
|
||||
| 用户要求 | 应验证的行为 | 当前证据 / 待办 |
|
||||
| --- | --- | --- |
|
||||
| 研究 LLM Wiki | 能指出原始提案与本项目新增设计的边界 | protocol.md 引用 Karpathy 原始 gist;XML、条件链接和版本规则为本项目提案 |
|
||||
| SkillHub 逐页截图与设计分析 | 首页、目录、详情各标签、作者、登录、发布入口具备截图和观察记录 | 主 chat 已截取首页首屏与下半屏、目录、概述、文件、版本、评论、评测、登录、作者及发布限制;另补插件、SkillPay、大赛、使用指南、专家包列表/详情与企业专区首屏;截图目前在 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/#11/#12/#13/#14/#15/#16 已由用户合并;#10 待最终证据完善;所有 merge 由用户完成 |
|
||||
## 已部署功能的实际证据
|
||||
|
||||
## SMTP 验收边界
|
||||
2026-10-29,main run 508 / job 556 成功:类型检查、51 项单元测试、生产构建、smoke、真实 PostgreSQL/S3/Chromium 集成、认证检查与生产部署全部通过。验收入口为 http://8.211.154.134:18131/ ,健康检查返回应用版本 `9a603cf87e9b726a566ae68f4f479030e0d02629`。随后 #18 仅修改工作流与说明,没有应用代码变更。
|
||||
|
||||
配置已写入服务器 root 所有、0600 权限的 /etc/prompt.env。密码不在仓库、PR 或 CI 日志中。SMTP_SSL 证书验证、连接与认证已通过。2026-10-29 10:23 UTC 发送诊断邮件 LG-SMTP-20261029-01,SMTP 接受;随后通过 Gmail 定向检索确认该编号邮件位于指定测试收件箱的 INBOX、UNREAD、CATEGORY_PERSONAL,非垃圾邮件。诊断邮件不含验证链接;这不证明注册流程已经完成。生产服务尚未因配置而手动重启,等待正常 CI/CD 部署。
|
||||
| 用户要求 | 已有证据 |
|
||||
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| 研究 LLM Wiki 与新语法 | protocol.md 引用 Karpathy 原始 gist;独立 XML、条件链接、关系、预算与版本规则是本项目提出的实验协议,不声称 Agent 已原生支持 |
|
||||
| SkillHub 截图与设计分析 | chat 中已截取首页、目录、详情概述/文件/版本/评论/评测、登录、作者、发布限制;补充插件、SkillPay、大赛、使用指南、专家包与企业专区首屏。受限发布编辑器未完整验收 |
|
||||
| 单篇可独立采用 | 公开入口 GET/HEAD、Agent 索引、样例与持久文档读取均已验证;不要求安装整个集合 |
|
||||
| 条件链接与固定版本 | 实际预览解析 source-trust 固定版本;缺失版本返回 404;XML 条件和标签往返已验证 |
|
||||
| 邮箱、密码、邮箱验证 | 指定真实收件箱收到注册邮件并确认位于 INBOX;未验证登录 401,验证一次 200、重复消费 400,验证后登录 200 |
|
||||
| 普通账户权限隔离 | 普通邮箱会话调用旧管理员写 API 返回 401;匿名预览 401,跨来源写入 403 |
|
||||
| 真实发布与版本 | 实际发布 v1/v2,旧版本正文保持不变,旧版本号重复发布返回 409;目录返回最新版本 |
|
||||
| 撤下与退出 | 验收文档已撤下,最新入口 404、固定历史版本 200、公开目录不再列出;注销后会话为空 |
|
||||
| 保留旧界面 | src/legacy/WaterfallHome.tsx 与旧 Shell/ExploreFeed 保留,新入口不再使用旧首页;旧内容路由仍在集成测试覆盖范围内 |
|
||||
| 独立分支、人工合并 | #6–#18 由用户合并;当前 SaaS 重构使用 codex/wiki-saas,交付 PR 等待用户手动合并 |
|
||||
|
||||
## 当前未完成工作
|
||||
## 邮件与敏感信息
|
||||
|
||||
补齐窄屏参考及验收截图;完成当前 main 的远程 CI(仅 main 更新触发,PR/手动不触发);其余 PR 由用户手动合并;等待正常部署;在服务器上测试邮箱注册验证与文档发布、编辑、精确版本及关联阅读;记录桌面与窄屏效果。只有运行时证据齐全后才认定完整交付。
|
||||
SMTP 运行时配置位于服务器 root 所有、0600 权限的 /etc/prompt.env。密码、注册验证令牌与测试账户密码不进入仓库、PR、截图或报告。早期 SMTP 诊断邮件只证明投递;上述后续真实注册验证才证明完整账户流程。验收文档已撤下;固定历史版本按产品约定保留。
|
||||
|
||||
## Agent 发现入口
|
||||
## 本次 SaaS 视觉重构
|
||||
|
||||
PR #12 将 llms.txt 与 /agent/index.md、/index.md 导向独立指导文档,索引同时包含持久化用户文档与示例,并只公开 GET/HEAD。测试覆盖发现入口、预算与固定版本链接;已由用户合并;远程 CI 和部署验收尚未完成。
|
||||
详细设计参考与页面规范见 ../wiki-saas/DESIGN.md。重构范围为公共外壳、目录、社区/我的文档、阅读、账户、编辑与协议页。
|
||||
|
||||
## 最近的 main CI 证据
|
||||
本地独立预览中的 UI 回归使用明确的 API 测试夹具,覆盖 URL 筛选恢复、清除、键盘标签导航、阅读/XML/版本、账户模式与密码可见性、发布登录门槛、表单错误保留输入、校验预览、发布输入规范化、现有文档编辑、XML 往返、移动端导航关闭及无横向溢出。该测试不代替上述真实数据库、SMTP 和权限验证;已接入 main 集成测试流程。
|
||||
|
||||
run 504(main 1925d15)类型检查、50 项单元测试与生产构建通过,随后 smoke 因缺管理员配置返回 503 而失败;不代表完整 CI 通过。PR #16 仅给绑定回环地址的 smoke 子进程设置显式测试模式,已由用户合并。main 254ac62 的后续检查仍待完成;未在本机编译,未手动触发构建。
|
||||
类型检查、51 项单元测试、生产构建与 standalone smoke 已通过。生产构建保留 preview.ts 动态文件跟踪的既有警告。
|
||||
|
||||
实际检查了 1440px 桌面目录/阅读/账户/编辑器,以及 390px 手机目录/阅读/XML 编辑器/协议截图。原生桌面浏览器当时因 Mac 锁定不可操作,截图由项目隔离的无头 Chromium 回归测试生成,未将其表述为线上部署验收。
|
||||
|
||||
## 剩余交付边界
|
||||
|
||||
SaaS 改版尚未合并和部署。PR 就绪后等待用户手动合并,届时由正常 main CI/CD 运行真实存储集成与部署,再在指定服务器复核新页面。不得把旧版本的成功 CI 或本地夹具截图称为新版线上验证。
|
||||
|
||||
Reference in New Issue
Block a user