DeepSeek provider + 判据 ③ 机器路径跑通(零人工兜底)

Provider 侧:
  · 新增 `provider-profile`(纯数据):各家的默认端点 / 结构化出参姿势 / 是否回推理
    集中一处,adapter 只按画像行事 —— 新增 provider 只改画像,不写一族 if-else。
    DeepSeek:`https://api.deepseek.com`,支持 json_object,v4 系列是推理模型。
  · 建实例时 URL 可留空 → 取该 provider 的默认端点(openai-compatible 本就是
    「随便哪个兼容端点」,没有默认,必须自填)。
  · 推理正文归 `reasoning` 单列:那是**过程**不是结论,不进出参、不参与 schema 校验、
    不入录制(录的是语义入参与结论)。
  · 两档实例 deepseek-v4-flash / deepseek-v4-pro 已建;`quote-extractor` 是**用途名**,
    指向 flash 档 —— 换档只改这一处绑定,活动一行不动。密钥只从环境读、落库即密封,
    治理台只回「是否已绑定」(实测:库里是密文,视图无明文字段,三个实例探活全通)。

沿路修掉五处真问题:

① **同一任务被并发推进**:推进器与派发器各推各的,用的不是同一把锁 ——
   实测同一步跑两遍、同一张卡发两张、同一行草稿写出两条互相打架的版本。
   两者改用同一把 advisory lock(键的推导提取共用)。
② **LLM 步出参从不校验**:声明了 outputSchema,解析不出来就静默当 `{}` 写下去,
   毛病要到下游缺字段时才炸、还炸在别处。改为「出参必过 schema」(AM 12.3),
   不过即按声明的失败走向,并把模型原文记进留痕,好让人看见它到底回了什么。
③ **出参路径不认点号**:入参能走 `a.b.0.c`,出参只认扁平键 ——
   模型按 schema 回嵌套结构(最常见的情形)就写出一条空记录。两边共用一份解析。
④ **归一步拿不到原文**:通道载荷只带指针不带正文、start→A1 边也没把主题正文传下去,
   模型只拿到一个单号,于是回空 records。通道载荷带原文,边映射一路带到 A1。
⑤ **出参形状没讲给模型听**:声明了 schema 却只在提示里写「只输出 JSON」,
   模型只能猜键名(实测回 `{"items":[]}` 而声明要 `{"records":[...]}`)。
   改由网关按 outputSchema 统一附上说明 —— 这是系统的事,不该每个活动作者各写一遍。

另修:连接池没有 error 处理器,空闲连接被服务端掐断会让整个进程退出(一次运维操作
就能把 API 带崩)。

结果:一封 RFQ 入站 → 模型从正文抽出 pn/brand/eau/目标价/交期 →
D1 判定跳过补全 → 查历史价 → DMN 三分类 Type A → 验收放行卡,**全程零人工兜底**。

gates: tsc / eslint / depcruise(319 模块)/ api-report / 409 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

api-report/apps/api/src/modules/flow-engine/port.d.ts

@@ -66,9 +66,17 @@ export type LlmStepGateway = {
     }): Promise<{
         ok: boolean;
         object?: unknown;
+        text?: string;
         error?: string;
     }>;
 };
+/** 出参校验 —— app 注入 ajv:LLM 步的出参**必过声明的 schema**(AM 12.3) */
+export type SchemaValidator = {
+    validate(schema: Record<string, unknown>, value: unknown): {
+        ok: boolean;
+        errors: string[];
+    };
+};
 /** 人类工具步 —— app 注入 `human-tool`(L3) */
 export type CardGateway = {
     issue(input: {

api-report/apps/api/src/modules/llm/contract.d.ts

@@ -49,6 +49,12 @@ export type ModelResult = {
     /** outputSchema 给定时的解析结果 */
     readonly object?: unknown;
     readonly usage: ModelUsage;
+    /**
+     * 推理模型的思考正文 —— **过程,不是结论**。
+     * 出参只认 `text` / `object`;这一段单独留着,供任务记忆归档与断点复盘,
+     * 不参与 schema 校验、不进业务字段。
+     */
+    readonly reasoning?: string;
     /** 行为可归因:模型与版本记入留痕(OS 4.1) */
     readonly binding: {
         readonly name: string;
@@ -71,6 +77,7 @@ export type UpsertLlmInstance = {
     readonly id?: string | undefined;
     readonly name: string;
     readonly provider: LlmProvider;
+    /** 留空 = 取该 provider 的默认端点 */
     readonly baseUrl: string;
     readonly model: string;
     /** 只写不读:留空表示保持原值 */

api-report/apps/api/src/modules/llm/port.d.ts

@@ -48,6 +48,7 @@ export type ProviderInvoker = {
     }): Promise<{
         text: string;
         object?: unknown;
+        reasoning?: string;
         usage: ModelUsage;
     }>;
 };

api-report/packages/contracts/src/api/governance.d.ts

@@ -271,7 +271,7 @@ export declare const upsertLlmInstanceRoute: {
             anthropic: "anthropic";
             qwen: "qwen";
         }>;
-        baseUrl: z.ZodString;
+        baseUrl: z.ZodDefault<z.ZodString>;
         model: z.ZodString;
         apiKey: z.ZodOptional<z.ZodString>;
         systemUse: z.ZodDefault<z.ZodBoolean>;