docs(v2): 将专项判断设计为Jev与本地模型可切换

2026-09-28 17:24:03 +08:00
parent 9d2399feed
commit e1b5ee0f7c
13 changed files with 203 additions and 39 deletions
@@ -38,15 +38,15 @@ flowchart LR
 | history_cases / backend/services/history_cases.py | 提炼历史事件、来源及未知项 | 依赖材料与存储；不直接批准经验 |
 | experience_catalog / backend/services/experience_catalog.py | 关联案例与经验版本、先授权过滤再相关性比较 | 复用既有经验生命周期，不建立平行发布路径 |
 | prescreen / backend/services/prescreen.py | 主审制定核查、调用专业能力、综合意见 | 只访问冻结授权上下文；不直接操作通用 terminal/SQL |
-| judgment_provider / backend/services/judgment_provider.py | Jev 窄问题、schema 校验、预算、失败状态 | 通过出口策略；不写审批或综合结论 |
+| judgment_provider / backend/services/judgment_provider.py | 统一窄问题契约、Jev/本地适配、schema 校验、预算、失败状态 | 通过出口策略；不写审批或综合结论 |
 | prescreen_policy / backend/services/prescreen_policy.py | 硬规则、证据、缺证及概率输出约束 | 不依赖页面，不以模型高分绕过硬约束 |
 | scenario_service / backend/services/prescreen_scenarios.py | 保存独立情景与差异 | 引用不可变基线；不覆盖真实事实 |
 | prescreen_evaluation / backend/services/prescreen_evaluation.py | 冻结样本、版本、预测及专家对照 | 标签与推理侧隔离 |
 | prescreen contracts / backend/contracts/prescreen.py | 新对象与错误契约 | 后端单一定义，前端由 OpenAPI 生成；生成器待建设 |

-拟议数据流：材料/授权数据 → 标准事实和来源 → 冻结快照 → 硬规则和计算 → 检索有效经验 → 主审提出具体核查问题 → 专业 Skills/Jev → 验证证据与规则 → 主审综合预审 → 独立复核/正式审批入口。
+拟议数据流：材料/授权数据 → 标准事实和来源 → 冻结快照 → 硬规则和计算 → 检索有效经验 → 主审提出具体核查问题 → 专业 Skills/可切换专项判断 → 验证证据与规则 → 主审综合预审 → 独立复核/正式审批入口。

-历史经验用于选择核查动作和比较适用条件，不能用“相似案例通过”直接推出当前项目通过。Jev 的判断置信与主审解释都不是独立的真实性认证。
+历史经验用于选择核查动作和比较适用条件，不能用“相似案例通过”直接推出当前项目通过。专项模型的判断置信与主审解释都不是独立的真实性认证。

 ## 3. 数据模型与持久化

@@ -62,16 +62,16 @@ P0 候选使用现有 SQLite 事务存储承载新增对象类型。历史事件

 - 历史导入失败：保留原件和失败事件，允许补充/重新提炼，不伪造缺失过程。
 - 主审识别矛盾：记录待核查事项，使用授权证据工具验证，达到预算停止为 partial/awaiting_input。
- Jev 不可用：缺失项进入 degradations；主审只能依据已完成检查给出有限意见。
+- 所选专项模型不可用或关闭：缺失项进入 degradations；主审只能依据已完成检查给出有限意见。
 - 硬规则冲突：结果校验阻断建议推进，保留模型原始结构化提案供审计。
 - 新证据进入：产生新快照、新运行，旧结果保留；模拟不进入这条正式更新路径。
 - Worker 恢复：复用持久任务机制；幂等范围包含 actor/project/operation/key，禁止重复生成运行。

 ## 5. 接口与集成

-内部 API 以 /api/prescreen 为候选命名空间；沿用当前项目鉴权和同源代理。前端不能直接访问模型厂商。现有 assistant_model 的受信端点规则不自动适用于 Jev，后者需独立出口与域策略。
+内部 API 以 /api/prescreen 为候选命名空间；沿用当前项目鉴权和同源代理。前端不能直接访问模型厂商。现有 assistant_model 的受信端点规则不自动适用于 Jev，专项模块需独立出口与域策略；local 也只能使用管理员批准的端点，不能从浏览器传入任意 URL。

-Jev 接口概念参考 TypeSafe 官方文档：https://docs.typesafe.ai/introduction 、https://docs.typesafe.ai/confidence 。当前没有 SDK 安装、Key、版本或延迟实测；实施前重核版本与中文金租样本效果。
+Jev 接口概念参考 TypeSafe 官方文档：https://docs.typesafe.ai/introduction 、https://docs.typesafe.ai/confidence 。当前没有 SDK 安装、Key、版本或延迟实测；实施前重核版本与中文金租样本效果。Jev 是可选提供方，本地开源模型通过独立适配器执行同一业务任务；拿不到 Jev Key 不阻塞本地路径。统一契约和差异处理见 [专项判断模型切换](11-judgment-providers.md)。

 概率预测为后续独立模型，输入仅使用预测时可得事实和判断特征。主审解释模型输出但不能改写原始概率；审批阶段、样本偏差和校准结果未明确前 probability=null。

@@ -84,7 +84,7 @@ Jev 接口概念参考 TypeSafe 官方文档：https://docs.typesafe.ai/introduc
 ## 7. ADR

 ADR-01 保留现有技术基线，按模块增量扩展，否决全面换框架。
-ADR-02 主审综合判断+确定性约束+Jev 专项复核，否决单模型 yes/no 审批。
+ADR-02 主审综合判断+确定性约束+可切换专项复核，否决单模型 yes/no 审批。
 ADR-03 经验以过程和来源为核心，否决只按最终结果记忆。
 ADR-04 经验发布复用现有治理，否决自动从反馈直接生效。
 ADR-05 先做验证和数据合作，再建设概率校准，否决专家分数转百分比。
@@ -94,6 +94,6 @@ ADR-06 v2 独立目录与资源，旧版保留；本轮先文档后迁移，目

 ## 8. 拟建立的架构验证

-业务 service 不导入 src；预审工具集合不含 terminal/任意 SQL；跨域经验不可检索；引用必须属于授权快照；模拟不修改真实快照；无校准时概率为 null；经验发布只能经过一个治理入口。映射 AC-04/06/08/10/11/12/16。
+业务 service 不导入 src；预审工具集合不含 terminal/任意 SQL；跨域经验不可检索；引用必须属于授权快照；模拟不修改真实快照；无校准时概率为 null；经验发布只能经过一个治理入口。专项模型只能通过统一接口接入；local 不依赖 Jev 凭据；配置冻结且故障不自动切换。映射 AC-04/06/08/10/11/12/16/17/18/19/20/21。

 这些是待实施的机器检查；现有测试覆盖另列，不能标成 v2 已通过。