60 lines
5.6 KiB
Markdown
60 lines
5.6 KiB
Markdown
# 兴邦 v2 实施与迁移计划
|
||
|
||
状态：计划，未执行 v2 代码迁移。当前用户要求补齐文档以便使用Claude Code/DeepSeek开发；本轮不开始业务实现。
|
||
|
||
## 1. 迁移边界
|
||
|
||
拟目标目录 F:/mini-OpenClaw-v2，当前尚不存在。先保护旧版，再从已备份提交白名单迁移，禁止把整个工作区连同数据/密钥/依赖一起复制。新仓库远程和独立部署资源见 OQ-06。
|
||
|
||
| 候选迁移内容 | 依赖理由 | 验证 |
|
||
|---|---|---|
|
||
| src/ 当前页面、组件、代理与 lib | workbench 和鉴权相互依赖，先保留可运行闭环 | 生产构建及既有 UI 脚本 |
|
||
| backend/api、services、contracts、graph、tools、data_layer | app.py 注册路由与服务调用链 | unittest + 导入/启动冒烟 |
|
||
| backend/skills、fixtures、requirements.txt | 固定方法和演示种子是运行/测试依赖 | fixtures 标为 demo，运行不读取旧数据目录 |
|
||
| backend/app.py、config.py 与必要无密钥默认配置 | 真正入口是 app.py，不照抄旧文档的 backend.backend.main | 独立进程和健康检查 |
|
||
| package*.json、Next/TS/CSS 配置、Dockerfile、入口脚本 | 构建完整性 | npm ci/build、Compose config |
|
||
| backend/test_*.py、相关 scripts 测试与 verify.py | 保留既有回归能力 | 同一验证入口在 v2 运行 |
|
||
| docs/project-process、docs/v2、根 AGENTS.md | 新流程与设计基线 | 链接/规则覆盖检查 |
|
||
|
||
排除：.env、server-deploy.conf、.docker-codex、node_modules、venv、.next*、日志、sessions/storage/raw_logs、实际 xingbang_data、原始客户材料、_backup*、office 临时文件。旧 DELIVERY.md 含凭据，不能原样进入新仓库；部署文档采用重写后的不含密钥说明。代码内默认演示数据需标注来源，不把默认频次当成客户经验。
|
||
|
||
抽取前按 import 与路由调用图确认必要依赖。先建立可运行基座，再根据测试逐项裁剪，不能按文件名猜核心。原版始终保留，禁止恢复用户此前主动合并删除的旧页。
|
||
|
||
## 2. 分批交付
|
||
|
||
| 里程碑 | 产出 | 进入条件 / 完成证据 |
|
||
|---|---|---|
|
||
| M0 文档与恢复点（本轮） | Gitea 快照、流程适配、URD/规格草案 | 远程 SHA 一致；文档检查；不是新版功能交付 |
|
||
| M1 独立基座 | v2 源码、环境模板、契约生成与追加迁移骨架 | 阶段①–③相应门禁通过；独立路径、完整构建、回归通过 |
|
||
| M2 历史过程与经验 | 时间线、原文定位、审核发布和检索 | AC-01/02/03/04/08/13，模拟与真实域隔离 |
|
||
| M3 主审与专项判断 | 有界 Agent Loop、统一 JudgmentProvider、本地开源模型适配、可选 Jev 适配、证据和硬规则约束 | AC-05/06/07/09/10/12/14/16/17/18/19/20/21；先契约 mock，再验证本地路径；有 Key 后单独启用 Jev 实测，缺 Key 不阻塞 local 交付 |
|
||
| M4 沙盘与展示 | UI 状态、假设动作、正式/模拟对照 | UI门禁通过，AC-11；源快照哈希不变 |
|
||
| M5 脱敏试点 | 数据授权清单、保留集盲测和复盘 | AC-15/16，专家评审、指标事先锁定 |
|
||
| M6 概率校准（后续） | 事件口径、训练/校准/测试、漂移监测 | OQ-05 关闭且样本支持；审批概率与违约风险分开 |
|
||
|
||
一次只交付一个可验证业务切片。新增文件按流程 ≤500 行；既有巨大 service 只接薄入口，不继续堆独立领域逻辑。新依赖先评估必要性和大小。
|
||
|
||
## 3. 每批标准动作
|
||
|
||
读 AGENTS 和对应流程 → 检查 status/log/调用方 → 更新需求规则与接口 → 增加行为测试 → 最小实现 → 相关测试 → 项目 verify.py → diff 自查 → 文档同步 → 独立提交和评审。
|
||
|
||
行为涉及权限、证据、模拟、外发时必须有反例；不以静态页面或模型的一句解释替代行为断言。失败先定位，不能反复重跑直到偶然通过。
|
||
|
||
## 4. 配置、迁移与回滚
|
||
|
||
代码通过可回滚提交/镜像标签恢复。数据迁移追加并有幂等守卫；旧库先快照，升级/回退边界经测试后才部署。回退代码不等于撤销已写入数据。v2 使用独立工作目录、Compose 项目、容器名、数据卷及端口，具体值在 OQ-06 定案。
|
||
|
||
本轮不实施剪裁、不改业务行为、不创建远程 v2 仓库、不部署。任务执行细分见 [开发交接](15-development-handoff.md)，T00可立即文档核对，后续按切片过门禁。先把评审文档写清，避免规范到位后返工。
|
||
|
||
## 5. M3 专项模块实施顺序
|
||
|
||
按 [专项判断设计](11-judgment-providers.md) 先落统一题库/请求/答案契约与配置冻结，再接本地推理服务并完成真实本地集成测试。Jev 适配独立实现；无 Key 时只验证厂商响应 fixture，live 用例标 skipped，不宣称原版已接通。mock 仅用于测试，不能冒充业务推理结果。
|
||
|
||
两条路径都读取同一版历史经验和证据，主审不写提供方分支。上线某个配置之前，该提供方/模型/提示/题库组合必须独立完成相同业务验收；合同测试通过不能证明模型效果合格。
|
||
|
||
## 6. 三模块闭环与任务包映射
|
||
|
||
M0包含本次0.2规格更新；M1对应T00–T02；M2对应T03–T06；M3对应T07/T08；M4对应T09/T10/T11的模拟闭环；M5/M6对应T13真实试点/概率。T12是可选Jev及实时专项准入。原里程碑编号保留，不能把P0模拟会议回放推迟到真实数据才能演示。
|
||
|
||
核心复用是卡片/方案、材料来源、受限Agent Loop、运行存储和经验治理；代码抽取仍需依赖白名单，不全盘复制旧四Agent所有领域。本期不自动微调主审、不建Tools业务卡、不把前端演示数据充当后端能力。
|