Files
mini-openclaw-v2/docs/v2/09-decisions.md
T

65 lines
7.0 KiB
Markdown
Raw Normal View History

# 决策、未决项与学习记录
日期: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实际接手效果,不能声称已节省成本。后续按任务耗时/返工/费用和验收记录评估。