Files
mini-openclaw-v2/docs/v2/09-decisions.md
T
qiaoqichaoandClaude Code d56c699ce6 chore(v2): 从兴邦预审v2白名单抽取独立可运行基座
按 docs/v2/05-implementation-plan.md §1 候选迁移表与 claude_use/T00 白名单,
从 55e2cdb 抽取 224 个文件(2.48 MB)到独立目录 F:/mini-OpenClaw-v2。

- 排除:凭据(.env/server-deploy.conf/旧DELIVERY.md)、运行数据(xingbang_data 等
  4 个 SQLite)、依赖(venv/node_modules 符号链接)、归档(_backup*/test-evidence/
  ori_file)、Office 临时文件
- 目标目录独立 git 仓库,初始恢复点;Gitea 远程与分支待 OQ-06 Q2 定案
- 未部署、未启动服务、未调用模型

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-29 12:58:26 +08:00

65 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 决策、未决项与学习记录
日期:2026-09-29(0.2增量,原记录保留)。状态区分“用户已明确的方向”和“工程候选待评审”。
## 1. ADR
| ID | 决策 / 状态 | 被否方案 / 理由 | 影响 |
|---|---|---|---|
| ADR-01 | 复用 Next.js+FastAPI 与现有组件,工程候选 | 全面换框架;无法复用已验证链路 | 先迁移可运行基座,再逐步拆模块 |
| ADR-02 | 主审综合意见、专项模型局部判断(Jev或本地),用户已明确 | Jev单题直接决定通过;缺乏整体研判 | 证据与硬规则约束最终有效输出 |
| ADR-03 | 历史评审过程是核心资产,用户已明确 | 只存通过/不通过标签;丢失核查和判断变化 | 优先收集问询、补件、修改和批复条件 |
| ADR-04 | 经验经审核、有适用范围,用户确认方向,工程细节待审阅 | 自动把任意反馈变成规则;会固化错误 | 复用现有经验治理,建立历史过程关联 |
| ADR-05 | 无真实校准前不宣称审批概率,已讨论方向 | 分数/Noul直接转通过率;没有业务验证 | P0概率字段为空;先做可追溯预审和试点 |
| ADR-06 | 独立v2代码目录待迁移,当前先备份与文档,用户最新顺序 | 直接覆盖现有部署;难回退 | 旧版Gitea恢复点先核验;v2目录尚未建立 |
| ADR-07 | 按用户最新要求直接适配流程正文,原文保留在Gitea恢复点 | 照搬Electron路径/发布命令;无法执行 | AGENTS统一入口,正文按兴邦事实执行 |
| ADR-08 | 专项判断支持 Jev 官方服务、本地开源模型和关闭;可切换方向用户已明确,契约细节为工程候选 | 把 Jev Key 作为产品依赖或用通用模型自评分伪装等效概率;供应依赖和指标口径不可控 | 统一业务题库/接口,独立适配/验收;本地路径先交付,Jev 接入不阻塞 |
| ADR-09 | 公司评审会通过、初始材料介入、P0纯模拟,用户已确认 | 用违约率代替会议通过、只生成通过案例;偏离目标且没有反例 | 标签映射单列;未送审不当否决 |
| ADR-10 | 三模块闭环与人工Skills/Rules入口,用户已确认 | 自动把反馈写入正式规则;不可控且丢失来源 | 来源/数据域/状态分离,统一审核和版本 |
| ADR-11 | 数据/Skills/Rules装配方案,Tools受后台治理,用户确认方向 | 增加业务Tools卡、六维硬编码;权限负担且无法适配方案 | 维度随方案生成,工具只读追溯 |
| ADR-12 | 按任务可替换专项服务,本地Laya为待测候选,用户接受建议 | 绑定Jev Key或称本地接口兼容即效果等价 | 独立环境、固定权重、各任务准入;缺Key不阻塞 |
| ADR-13 | 轨迹+真实会议结果→改进候选→对照/审核→发布,用户确认方向 | 模型自评分自动训练/上线;循环强化错误 | 专家参考独立,划分先于经验提炼 |
| ADR-14 | 编码模型与产品主审/专项模型独立;小任务交接,用户要求 | 一次让低成本模型重写全系统、双份开发规则 | CLAUDE导入AGENTS,T00–T13逐批验收;本机连接未配置 |
## 2. Open Questions
needed-by 是明确阶段门,不虚构双方尚未约定的日历时间。
| ID | 待定内容 | 当前处理 | owner | needed-by |
|---|---|---|---|---|
| OQ-01 | 首批业务类型、关键核查项、正式硬规则 | 只使用标注演示规则;不宣称兴邦制度 | 项目负责人+兴邦评审专家 | M2真实经验建模前 |
| OQ-02 | 经验发布资格、独立复核、真实身份体系 | 演示角色明确标示;生产数据入口不开启 | 兴邦业务负责人+系统管理员 | M2生产权限实现前 |
| OQ-03 | 专项/主审模型端点、本地模型与硬件、客户数据出口、保留策略 | mock/合成样本;先验证本地路径,缺 Jev Key 不阻塞;不发送真实材料 | 兴邦数据负责人+技术负责人 | 任何真实材料模型调用前 |
| OQ-04 | 验收阈值、时延预算、资源/费用上限 | 文档工程限制仅提案,报告耗时不承诺效果 | 产品+测试+实施负责人 | M3配置定案及M5盲测前 |
| OQ-05 | 已确认“公司评审会通过”和初期材料预审;尚需会议代码、附条件结果、观察窗口、样本量及选择偏差映射 | 方向已关闭;真实标签映射仍open,probability=null | 兴邦审批负责人+建模负责人 | M6概率需求进入架构前 |
| OQ-06 | v2新仓库、云端目录、端口、容器/卷 | 暂用当前独立文档分支;不复用旧生产资源 | 项目负责人+运维 | M1迁移及任何v2部署前 |
以上待定不阻止当前文档交付;阻止相应业务实现/真实数据阶段越过门禁。用户新指令可直接关闭或调整范围,不重复请求已授权事项。
## 3. 当前阶段门检查
| 门 | 状态 / 证据缺口 |
|---|---|
| Term | 0.2已列闭环术语,用户确认产品方向,客户口径待审阅 |
| Contract | 已有候选字段/状态/错误;新增读接口完整清单、DDL、类型生成未定案,见03第9节 |
| Rule | BR-01–44已拆分并标职责,待评审 |
| Exception | E-01–26有错误和文案,契约校验仍待实现 |
| Coverage | 文档AC覆盖机械检查本轮执行;新功能行为测试未实现 |
| Decision | OQ项按里程碑阻断,未宣告需求阶段全过 |
## 4. 学习与持久缺口
- 流程适配:来源文档含项目特例,最小owner是 XINGBANG-ADAPTATION.md 和根AGENTS入口;以后每次新增规范检查失效路径。当前完成文件与链接核验,不等同长期遵守效果。
- 经验数据:默认团队模式和简化案例检索容易被误认为真实学习;owner为架构/产品说明,后续演示必须标来源。
- Gitea CI:仅有GitHub YAML,runner与门禁未核验;owner运维,在首次v2合并前确认。
- 历史文档密钥:旧DELIVERY.md有遗留凭据,当前恢复快照不改历史;新仓库迁移禁止携带;凭据有效性与轮换由凭据owner另行处理,本轮未访问验证。
- 本地工具:沙箱进程初始化失败,已通过受审的升权命令完成工作;不将该环境问题误判为代码故障。
## 5. 0.2已确认与仍待定案
用户已明确业务目标,无须再次确认“三模块是否正确”“是否可以不用Jev”。本轮文档交付走纯文档路径;工程门禁不因为用户认可方向自动通过。
T00需收口:独立代码路径和资源、首个切片字段/全部读写接口/DDL/状态/测试,实际评审记录;T08需验证:本地硬件、checkpoint、中文任务阈值;T09需定案:路由/token/文案文件与可访问性。真实身份/制度/会议标签/出口由兴邦在P1前确认。未决项不阻塞写文档或模拟数据设计,但阻塞对应实现/真实用途。
学习缺口:跨编码代理容易失去上下文,最小owner是15-development-handoff及根CLAUDE导入入口;本次只验证文档结构,尚无Claude/DeepSeek实际接手效果,不能声称已节省成本。后续按任务耗时/返工/费用和验收记录评估。