4.3 KiB
本次交付记录：流程接入、版本备份和新版文档
日期：2026-09-28。业务实现未启动；文档仍为评审草案。
1. 用户授权与边界
用户要求：把 docs/project-process 接入 agent 开发规则；确保当前版本在 Gitea 备份；随后编写兴邦新版开发文档。沿用仓库唯一入口 AGENTS.md，不再建平行的 agent.md。
实际副作用：本地文档写入、创建Git分支/提交、向已配置origin推送独立分支。未部署、未调用真实模型、未更改数据库、未推送github-backup、未修改main。
2. 原版备份
- 原分支：codex/deploy-stable-20260909；上游origin/main。
- 原HEAD：b10093f9d8a949c6a6f8f8ed6d5b9c1bb044b569。
- 备份分支：codex/backup-before-ai-prescreen-v2-20260928。
- 备份SHA：4d5a420671cb073a56335bd617e7d0812b8179a9。
- 远程：ssh://git@192.168.10.111:2222/qiaoqichao/mini-openclaw.git。
- 证据：git push成功后，git ls-remote返回完全相同SHA。
- 内容：37个变更文件，包含用户已有未提交代码、测试、部署配置、脚本、resetdata页面、业务文档及新流程原文。
- 排除：.docker-codex、本地Office锁文件、重复的project-process.zip；本来忽略的.env、server-deploy.conf、运行数据等均未加入。
备份扫描检查了新变更的常见凭据模式，包括docx XML，未发现匹配项；这不是完整历史密钥审计。已有旧文档凭据问题未扩散到新文档。
原始新增文档有11处行尾空格（部分为Markdown换行），备份原样保留并记录在baseline-whitespace.log；恢复快照不声称达到发布门禁。本轮新写文档另做diff检查。
3. 本次文档范围
根AGENTS流程入口、项目流程兴邦适配、docs/v2目录中的URD、七段规格、架构、详细设计、UI、视觉约束、迁移、验证、部署/Gitea、数据试点、决策和本记录。
按用户后续要求，project-process的README、01–08及两份URD模板已直接适配兴邦；保留八阶段与原规则编号，原始内容可从4d5a420恢复。根AGENTS同时修正为真实后端app.py和项目工作目录。
文档分支：codex/xingbang-v2-docs-20260928。最终提交与远程状态使用git rev-parse HEAD及git ls-remote核验；不把文档提交等同正式需求评审或新版发布。
4. 本轮验证
状态：旧版代码全量验证通过；规范和新版文档的机械检查通过。证据目录：test-evidence/20260928-v2-planning/。
2026-09-28 执行 backend/venv/Scripts/python.exe scripts/verify.py，工作目录为仓库根；报告在 test-evidence/20260928-164935-4d5a420/REPORT.md。124个后端测试、4项UI源码守卫、Next生产构建、本地与云端Compose配置及diff检查全部通过（9项检查）。未执行--docker，未启动/发布容器。后续仅修改规范文档，业务源码保持备份哈希不变；最终文档检查单独绑定最终文件摘要。
测试环境使用占位模型Key和测试开关，不复制真实密钥。Gitea CI、真实浏览器E2E和云端实时健康均未在本次验证。
本轮文档检查：25份Markdown、87个本地链接、16条BR/12条E/16条AC的唯一性与覆盖通过；原流程各R-*编号集合保持一致，来源项目无效命令/路径残留清除。26个非流程备份文件的字节哈希未变，确认未修改既有业务代码。新增文档摘要保存在final-document-hashes.json；git diff格式检查通过。HTML模板仅调整项目说明和例子，未变更脚本/样式，未做浏览器视觉验收。
审阅：已检查正确性（当前入口/路径）、一致性（前后端及草案状态）、安全（密钥与数据范围）、测试（检查覆盖与未完成项）。这是本轮作者自查；独立业务/技术评审尚未发生，不宣称需求阶段获批。旧版通过也不代表v2功能通过。
5. 回滚与剩余工作
源码恢复可从已核验分支克隆到新目录，不重置当前工作区。文档修改保留独立提交，可通过后续revert撤销，不删除原始规范。远程资源仅新增分支，无main改写；无需进行破坏性恢复演练。
剩余：需求与方案评审、独立v2代码抽取、真实权限/模型出口确认、历史过程提炼、Jev适配、沙盘实现、脱敏盲测与后续概率校准。全部列入实施计划和OQ，当前未宣称完成。