MVP底座④:统一报价 1:1 流程包单实例 —— 四域物化,种子整体切换

14 语义节点/16 边:A5 是内置审批点(驳回走 reject 声明 reopen A4), G2 的两条互斥分支显式汇合于 G2J —— 隐式合并过不了闭合校验(实测)。顺手修 graph-to-pkg:卡点带 to 时还原成语义边,否则回边画成卡点一存盘就没了。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-28 01:49:49 +08:00
parent 90ca92aa0e
commit 0fe5222f79
7 changed files with 662 additions and 356 deletions
@@ -0,0 +1,118 @@
+/**
+ * MVP 底座的治理台配置 —— 四件事一次做完(README《MVP 完成判据》第 1 条的机器形态):
+ *
+ *   ① 绑定 LLM 实例(四元绑定;活动只见逻辑名)
+ *   ② 注册功能工具并逐活动给白名单(授权在白名单与契约,不在活动代码)
+ *   ③ **经安装通道**装入六个活动槽位 —— 声明顺带把四域十八对象物化出来
+ *   ④ 编排「统一报价」流程包 v1 并发布 + 触发器与邮件通道
+ *
+ * 活动与工具的解耦就在②③之间:槽位只声明工具**名**,注册、连接值、白名单全在这里。
+ */
+import type { Container } from './container.ts';
+import { installSlots } from './seed-mvp-slots.ts';
+import { seedMvpFlow } from './seed-mvp-flow.ts';
+
+/** 第一方功能工具:查历史价 —— MVP 用录制回放替身代真 CRM(README:mock 只在外界) */
+const HISTORY_TOOL = {
+  name: 'crm.history-price-read',
+  version: '1.0.0',
+  description: '读取历史价格情报:某 PN 最近一次报价距今天数、行情是否平稳、生命周期状态',
+  input: { type: 'object', required: ['pn'], properties: { pn: { type: 'string' } } },
+  output: {
+    type: 'object',
+    properties: {
+      historyDays: { type: 'integer' },
+      marketStable: { type: 'boolean' },
+      lifecycle: { type: 'string' },
+      hit: { type: 'boolean' },
+    },
+  },
+  effect: 'read' as const,
+  errors: [{ code: 'not-found', retryable: false, message: '无历史价' }],
+  idempotent: true,
+  timeoutMs: 10_000,
+  retries: 2,
+  connectionKeys: ['endpoint'],
+};
+
+/** 出站邮件 —— **写类**:过程中登记为动作意向,放行后由系统执行落地 */
+const MAIL_TOOL = {
+  ...HISTORY_TOOL,
+  name: 'mail.send',
+  description: '发出邮件(报价单 / 询价函 / 催办):写类动作,放行时才真正触达世界',
+  input: {
+    type: 'object',
+    required: ['to', 'subject'],
+    properties: { to: { type: 'string' }, subject: { type: 'string' }, body: { type: 'string' } },
+  },
+  output: { type: 'object', properties: { queued: { type: 'boolean' } } },
+  effect: 'write' as const,
+  idempotent: true,
+  connectionKeys: ['endpoint'],
+};
+
+/** 白名单:逐槽位授权 —— 谁能调什么,治理台说了算,活动代码里看不到这张表 */
+const ALLOWLIST: Readonly<Record<string, readonly string[]>> = {
+  'rfq-intake': [HISTORY_TOOL.name],
+  'alt-selection': [HISTORY_TOOL.name],
+  'sourcing-inquiry': [HISTORY_TOOL.name, MAIL_TOOL.name],
+  'cost-pricing': [HISTORY_TOOL.name],
+  'quote-negotiation': [HISTORY_TOOL.name, MAIL_TOOL.name],
+  'intel-archive': [],
+};
+
+export async function seedMvp(container: Container): Promise<void> {
+  const log = (line: string) => process.stdout.write(line + '\n');
+
+  /*
+   * ① LLM 实例:四元绑定(Provider / URL / Key / Model),活动只见自定义模型名。
+   * 密钥**只从环境读**,不入源码、不入包、不入留痕(OS 7.3 凭证隔离 / ADR-009)。
+   */
+  const apiKey = process.env['JCAI_DEEPSEEK_API_KEY'] ?? process.env['JCAI_LLM_API_KEY'] ?? 'sk-placeholder';
+  for (const [name, model, systemUse] of [
+    ['deepseek-v4-flash', 'deepseek-v4-flash', false],
+    ['deepseek-v4-pro', 'deepseek-v4-pro', false],
+  ] as const) {
+    await container.llm.upsert({ name, provider: 'deepseek', baseUrl: '', model, apiKey, systemUse, enabled: true });
+  }
+  // 用途名,不是型号名:换档只改这一处绑定,活动一行不动。系统用途(小结/汇报/蒸馏)也走它
+  await container.llm.upsert({
+    name: 'quote-extractor',
+    provider: 'deepseek',
+    baseUrl: process.env['JCAI_LLM_BASE_URL'] ?? '',
+    model: process.env['JCAI_LLM_MODEL'] ?? 'deepseek-v4-flash',
+    apiKey,
+    systemUse: true,
+    enabled: true,
+  });
+  log('① LLM 实例已绑定:deepseek-v4-flash · deepseek-v4-pro · quote-extractor(→ flash,系统用途)');
+
+  /* ② 功能工具注册两审 + 逐槽位白名单 */
+  for (const contract of [HISTORY_TOOL, MAIL_TOOL]) {
+    const verdict = await container.toolbox.register({
+      contract,
+      samples: [
+        {
+          // 样例集一份喂两件工具:并集覆盖各家必填
+          input: { pn: 'LM358DR', to: 'x@y.com', subject: '询价' },
+          expectShape: { type: 'object' },
+        },
+      ],
+      connectionValues: { endpoint: 'replay://crm' },
+    });
+    if (!verdict.accepted) {
+      log('   工具 ' + contract.name + ' 未过两审:' + verdict.staticFindings.map((f) => f.message).join('; '));
+    }
+  }
+  for (const [activityId, tools] of Object.entries(ALLOWLIST)) {
+    await container.toolbox.setAllowlist(activityId, tools);
+  }
+  log('② 功能工具已注册并入白名单(读类 1 · 写类 1,逐槽位授权)');
+
+  /* ③ 六个活动槽位经安装通道装入 —— 声明物化把四域十八对象建出来 */
+  await installSlots(container);
+  log('③ 六个活动槽位已装入(契约就绪,实现留白)');
+
+  /* ④ 流程包 1:1 + 触发器 + 通道 */
+  await seedMvpFlow(container);
+}