61 lines
5.7 KiB
Markdown
61 lines
5.7 KiB
Markdown
# 本次交付记录：流程接入、版本备份和新版文档
|
||
|
||
日期：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，当前未宣称完成。
|
||
|
||
## 6. 追加：专项模型可选设计（2026-09-28）
|
||
|
||
用户补充可能无法取得 Jev Key，要求官方服务与本地开源模型可选且承担相同任务。新增 [专项判断设计](11-judgment-providers.md)，同步 URD、规格、架构、详细接口、UI约束、实施/验证计划、部署、数据试点和 ADR-08。原有需求编号保留，追加 BR-17–20 / E-13–15 / AC-17–21。
|
||
|
||
统一题库和答案契约，提供 jev/local/disabled；local 不读取 Jev 凭据，故障不自动改用外部服务。主审形成综合意见，专项模型不能决定整体通过；模型原生指标分别验证，不将本地自报置信度转为审批概率。先实现本地路径，Jev live 缺 Key 可明确跳过。
|
||
|
||
检查：26份Markdown、94个本地链接、20条BR/15条E/21条AC的编号和覆盖、GWT、表格连续性、URD验收引用、文档范围与git diff格式均通过。命令/计划/文件哈希见 test-evidence/20260928-judgment-providers/。仅修改docs/v2，按纯文档轻量路径验证，本次未重跑旧版全量测试。新适配代码、真实模型调用和业务效果均未验证；未更改部署或旧版业务代码。
|
||
|
||
沿用 codex/xingbang-v2-docs-20260928 独立提交并备份；最终提交/远程SHA以该证据目录中的 delivery.json 为准。不修改原始备份分支或 main；独立评审及实现阶段仍待完成。
|