docs/v2/14-experience-loop.md

# 三模块闭环与数据设计补充

版本：0.2 · 2026-09-29。产品方向已经用户确认；本文件是新增设计候选，不代表兴邦业务签署、工程门禁通过或功能已实现。业务规则唯一编号在 [需求规格](01-requirements.md)，本文件展开 BR-21–44；类型与接口 owner 在 [详细设计](03-detailed-design.md)。

## 1. 目标、事件和第一期范围

核心目标：在最初收集材料时帮助客户经理识别障碍、补件、比较推进方案；在适用范围内，高预测通过概率的项目在公司评审会上确有较高的通过比例。系统提供暂不建议推进的理由和剩余可能路径，由业务人员决定是否放弃，不自动关闭客户项目。

“通过”已经明确为公司评审会通过项目；具体会议结果代码、附条件通过是否计为通过、观察窗口及制度时期仍需兴邦映射。初期预测与后续补件预测是不同材料快照上的结果，不混为一条。没有送审、主动退出、待定不得当作否决标签。

P0：纯模拟数据，完成历史经验加工→卡片装配→预审/沙盘→轨迹与模拟评审对照的演示闭环。暂定演示种子 3,000 个虚构项目，属于可调整的工程演示规模，不是效果样本量承诺。真实数据、正式客户规则和真实概率属于 P1/P2 的独立门禁。

## 2. 三个模块与既有卡片的关系

| 模块 | 输入 | 处理 | 输出 / 人的职责 |
|---|---|---|---|
| 历史经验加工中心 | 历史材料、问询、补件、方案变更、会议记录 | 形成来源和时间线；提炼方法/经验候选；检查反例与适用范围 | Skills / Rules 草稿、来源案例；专家修订和审核发布 |
| AI 预审工作台 | 当前项目数据卡、已发布 Skills/Rules、评审方案 | miniOpenClaw 在授权范围编排核查；程序计算、规则校验、可选专项判断 | 有依据的建议、补件清单、概率状态、独立沙盘；客户经理选择推进动作 |
| 轨迹复盘与改进中心 | 冻结运行、真实会议结果及专家纠正 | 对齐材料版本和时间；归因遗漏/误判；比较改进版本 | 候选知识/编排策略、验证报告；授权人员决定发布和回滚 |

业务配置仍只有数据卡、Skills 卡、Rules 卡及串联它们的评审方案。经验是这些卡片背后的有来源知识对象，不要求用户再配置一套经验卡才能运行。Tools 由后台批准，通过 Skill 的 allowed_tools 和运行权限共同限制，在轨迹里可见，不开放业务 Tools 卡。

Skill 描述“如何核查”：适用条件、必要数据、允许工具、步骤、输出、缺证处理和退出条件。Rule 描述“必须满足什么/何时触发什么”：条件、效果、适用范围、例外与依据。历史常见做法是经验性建议；只有已确认制度或正式授权依据才能成为硬规则。

## 3. 多源材料进入统一证据层

目标链路：用户选择文件集合/授权数据源→导入清单→逐文件解析→提取候选→人工确认与冲突处理→数据卡→冻结项目快照。

- P0 支持选取 PDF、XLSX、CSV 文件集合；浏览器支持时可选目录，否则多文件选择。目录仅表达用户选择的文件集合，不让服务端根据浏览器传来的 F 盘路径扫描电脑。
- ZIP 解包、任意共享盘监听、生产数据库直连不进入 P0。数据库接入保留现有受控连接器边界，P1 先确认表/字段、只读权限和提取时间。
- 每个导入条目保存文件哈希、相对路径、上传者、导入时间、解析版本和状态。保留原始字节，文件名不能成为服务器写入路径。
- PDF 定位页码/片段；表格定位工作表/单元格区域，并保留币种、单位、业务期间。导入时间不冒充材料发生时间。公式缓存值是否可靠要单独标记，不能直接宣称重新计算过。
- 扫描件没有可用 OCR 时显示未解析，可人工补录并保留页码；不伪造 OCR 成功。密码保护、格式损坏、超限文件逐项失败，不隐藏部分导入。
- 跨材料数值冲突并列展示候选值及来源，由有权限人员选择或标为未解决；不默认“最后上传覆盖前值”。未确认/未解决的关键事实不能进入已核实结论。
- 同域、同项目、同哈希可复用原件；不同项目不泄露已有材料存在性。新一次导入保留自己的来源清单，业务期间不同的同名文件不合并。

P0 容量提案：每批最多 100 个文件，每个不超过 10 MiB，总计不超过 100 MiB；与既有上传限制对齐后才能定案。Worker 按文件处理，重试只处理失败项，不能因为一个文件失败重复确认其他事实。上述是待验证工程限制，不是客户 SLA。

## 4. 历史经验加工与人工干预

加工步骤：先划分开发/保留集→在允许的开发案例中恢复时间线→按问题聚合证据与处理动作→生成候选→查适用条件/反例/例外→专家修改→测试→独立审核→发布版本。

历史库只有最终报告时标“过程不完整”，可以提炼有来源的结论，不生成虚构问询顺序、评审员内心推理或完整人工 trajectory。提取出来的 Skill 是可复用核查方法；Rule 初始为 advisory，不能因模型看到频次高就变 hard。

自然语言入口分三种，界面明确显示作用范围：

| 入口 | 例子 | 效果 |
|---|---|---|
| 提炼要求 | “重点整理现金流与利润不一致的核查方法” | 约束本次加工任务，保留提示版本；不生成正式制度 |
| 候选编辑 | “只适用于设备类租赁，并增加关联交易例外” | 创建候选的新修订，显示差异，修改后重新验证/送审 |
| 本次预审补充说明 | “优先核查回款真实性” | 只影响当前运行，不能扩大 Tools 或覆写硬规则；保存为正式卡片需独立提议流程 |

人工新增 Skill/Rule 有独立入口。历史提炼、人工创建共享审核状态机，来源区别不意味着权限不同。业务侧不得通过自然语言提交可执行 Python/SQL/Shell；Rule 条件使用经批准的字段与算子。人工新增也不是默认可立即生效。

来源表示采用两个正交字段：origin=history_derived/manual/policy_import；data_domain=demo/production。历史提炼后经人工修改仍为 history_derived，增加 edited_by、parent_version 和变更说明，不能洗掉来源。

## 5. 评审方案与动态维度

方案固定数据卡引用、Skills/Rules 版本、相关经验版本、关键核查项及维度定义。保存草稿与发布方案分开。发起运行时验证所有依赖在当前项目/域获准，冻结 plan_id/version 和快照；草稿或已撤回组件不能进入新运行。

维度是 Skills/Rules 的元数据，不增加“维度卡”。方案生成时按 dimension_id 合并关联；同 ID 标签/量纲/刻度不同则报冲突并要求修订，不由模型临时猜测合并。重复维度不重复计数。方案发布时固定名称、顺序、标准和关联依据。

雷达用于展示证据核查状态，不是信用分。不同维度只有采用同一可解释刻度时才共用雷达；例如 0 未提供、1 仅有说明、2 材料待核、3 交叉核验、4 人工复核。完整度不等于真实性；该刻度由版本化标准驱动，不由大模型任意打分。模拟达到阶段 3 仍标“假设核验成立”。

- 同刻度 3–8 个维度：雷达加等价文字列表。
- 少于 3 个：状态条/列表；多于 8 个：分组或列表，全部维度仍可查看，不默默丢失关键项。
- 异量纲：分面展示，不强行归一化；硬阻断单列，不被平均数或面积覆盖。
- 原型现有六轴仅为示例。用户更换方案后生成新运行，旧运行的维度布局和依据保持原版本。

## 6. 概率、补件与沙盘

必须分开：核查状态、专项模型对一题的判断指标、项目评审会通过概率。概率模块拥有原始估计与校准结果；主审解释依据、规则和限制，不修改概率。

P0 的真实 probability 仍为 null。演示显示 demo_estimate（来源=synthetic_demo），紧邻“人工设定、未经真实历史校准”，导出也带标识。现有 42/58/51/64 的情景表继续只属于原型，不扩展为假装学到的算法。

每条沙盘动作包含目标问题、前提条件、假设改变的事实、所需证据和互斥动作。区分“补信息”和“改变交易条件”；仅上传一份流水不等于已确认回款。真实核验失败可以使结果变差。

勾选变化创建带 selection_hash 的新情景请求，使用冻结基线和相同组件版本。后端对组合重新核查，不把单项提升相加；前端只接受当前选择对应的结果，旧请求晚到不得覆盖新结果。处理中显示待计算，不先演示乐观增幅。

取消全部动作回到基线；请求失败保留基线、标示该情景未完成。模拟永不直接写入实际项目事实；真正补件按材料确认流程产生新快照与新预审。沙盘输出是条件估计，不宣称动作有经过验证的因果提升。

## 7. 轨迹、会议记录与反向改进

一次完整 Agent 运行是一条 trajectory，多次工具/模型调用是其中的 step/span。最小步骤信息：run_id、step_id、parent_step_id、顺序、时间、动作类型、Skill/Tool/Rule/Profile 版本、输入输出引用、状态、可核对的简短理由、耗时与可得成本。成本未知为 null，不填 0。不采集或伪造模型隐藏思维链。

会议记录单独保存：project_id、meeting_id、会议时间、被审材料快照（可空）、原始结果代码、原文证据、条件、记录人、修订关系。未知快照标 unmatched；修正结果追加新记录并 supersedes_id 指向旧记录，不覆盖历史。

AI 轨迹与人工会议时间线并列展示。匹配只基于可核验的项目、材料版本和时间；最终已通过不能倒填成最初材料也会通过。未送审/撤回/等待另列，既不当否决，也不进入已观察会议通过率的分母。

专项模型可做提炼依据质检、经验适用性检查、轨迹步骤评价；专家确认和真实会议结果仍为参考。不能让同一模型自评高分直接成为训练真值。

改进闭环：标记偏差→区分提取/检索/Skill/Rule/编排/判断模型/概率校准问题→形成 ImprovementCandidate→固定旧版对照→隔离样本回放→人工审核→版本发布→后续效果观察。发布失败保留旧版；已发布版本撤回只影响新运行。P0 先改知识、题库和编排配置，自动训练权重和自动上线不在本期。

## 8. 模拟数据与真实验证隔离

候选演示组成（总数 3,000，配比只为覆盖场景）：直接通过 900、补件后通过 900、会议未通过 600、未送审/退出/待定 600。包括条件通过子类型，但是否计入正式概率目标留给客户映射。生成每个项目的初始事实、可得时间、问询、补件、变更和最终结果；用一致性约束生成，不能只生成 3,000 段“同意通过”。

固定 seed、生成器版本、场景模板、规则版本和清单哈希；演示名称均虚构。先用少量边界 fixture 确认逻辑，再批量生成；默认程序组合结构化场景，不为每条案例进行多轮昂贵模型调用。

开发/校准/测试按客户关联组与项目分组并结合时间分割，之后才允许提炼经验；同客户/项目近重复不得跨集合。保留集标签、最终报告与由其生成的 Skill 都不得进入开发。合成数据的测试只证明设定分布上的逻辑与演示，不能证明真实泛化。

真实试点先锁定事件、观察窗口、预测时点、样本范围、指标与阈值，再揭示结果。核心指标：高预测概率组实际会议通过比例，同时报告该组覆盖率、已观察标签数量、未送审/待定数量、校准误差和重大问题漏检。不能只挑少数简单案例展示高通过率，也不能推断未送审项目如果送审会怎样。

## 9. 状态与事实来源

- 用户已确认：公司评审会通过、初始材料介入、P0 模拟演示、三模块闭环、人工卡片入口、可替换专项判断方向。
- 代码已观察：assistant_model 的 allowed_tools 过滤和只读工具；assistant_experiences 的草稿、评测、发布版本。它们是复用基础，不证明本文件闭环已实现。
- 原型已存在：概率环、六轴示例、四种沙盘组合与依据抽屉；见 [原型](12-prototype.md) 和 [概率设计](13-probability-prototype.md)。
- 候选待定案：扩展契约/DDL、具体路由、数值容量、部署资源、真实身份与规则、Laya 中文业务效果、概率模型。

追溯：产品来源为 2026-09-29 之前用户连续讨论及“按照你的建议来”确认；代码定位见 [架构](02-architecture.md)；任务与门禁见 [开发交接](15-development-handoff.md)。