M5 收官:六个活动包 + 统一报价全图 + 任务推进器

活动包(按 MVP示例工作流归一化): - quote-intake A1 受理归一(flow):LLM 抽取 → 条件跳步补全 → 查历史价 → DMN 打标 → 验收 - quote-pricing A4 成本定价(flow):DMN 利润模型 P-01 + 底价门禁 P-02;超限条目调人决策 - quote-negotiate A6 报价议价(flow):写类动作登记意向、放行即落地;建 D+3 跟进监听; 议价结果建模为选择组三口(成交/有异议/拒绝)—— 业务分支走输出口,不用异常终态编码 - quote-archive A7 情报归档(flow):写共享域(历史价格情报/客户资料库/落地率统计) - quote-sourcing A3 渠道寻源(loop):CMMN 四阶段 + 里程碑 + 裁量项 + 两个时间监听; DMN 采用策略判定;案例说明书与 XML 同版本 - quote-alternative A2 替代选型(loop):CMMN 三阶段 + userEventListener(客户改需求); DMN 替代等级判定;禁区「差异没核清的不放行」有机检形态流程包全图:7 节点 + 3 网关 + 1 审批点 - 已裁定①:A5 = 审批点,G3 并入驳回走向(驳回 → 回 A4 重开新实例) - 已裁定②:G2 = 并行网关,A3/A2 失败走向 = 容忍 - 已裁定④:议价回环 = 流程层回边(reopen) 闭合校验在此拦下一个真实建模错误(A4 有两条并发入边映射同名字段), 按规范改拓扑:TYPE-A 直通也走汇合;同时把「回边不是并发汇合」写进判定 —— reopen 边不参与隐式合并检查。 app:task-advancer worker —— 过程在后端,运行中的任务一拍一拍推,不依赖浏览器在线; 进入等待或终结即停手,不空转。第一方工具补齐 P-01/P-02/画像/落地率/出站发送。已验证(真机): - 六个活动包经安装通道装入,静态审各 0 条提示 - 流程包闭合校验通过并发布 - 台账自生长:11 张表由活动声明物化(含 shared 三张共享域表) - 邮件入站 → 触发器 → 工作流 → A1 落到冯兵工位 → 推进器推 2 拍: 装载 5 步声明 → 执行 LLM 步 → 按声明重试 2 次 → 转人兜底 → awaiting-event (LLM 端点是占位 key,失败路径因此走通了 —— 正是声明给定的兜底) 358 个测试通过,门禁五道全绿 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-27 02:37:04 +08:00
parent 78dc03bb58
commit 2f01eda3fb
24 changed files with 1862 additions and 25 deletions
@@ -0,0 +1 @@
+{ "name": "@activities/quote-alternative", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }
@@ -0,0 +1,111 @@
+/**
+ * A2 替代选型的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
+ */
+
+export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
+<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
+  <case id="alternative">
+    <caseFileModel>
+      <caseFileItem id="request" name="替代评估请求"/>
+      <caseFileItem id="shortlist" name="初筛清单"/>
+      <caseFileItem id="benchmark" name="替代对标表"/>
+      <caseFileItem id="datasheet" name="芯片规格书"/>
+    </caseFileModel>
+    <casePlanModel id="plan" name="替代选型" autoComplete="true">
+      <sentry id="s_request">
+        <onPart id="op_req" caseFileItemRef="request"><standardEvent>create</standardEvent></onPart>
+      </sentry>
+      <sentry id="s_need_alt">
+        <onPart id="op_alt" caseFileItemRef="request"><standardEvent>update</standardEvent></onPart>
+        <ifPart id="if_alt"><condition>needAlternative = true</condition></ifPart>
+      </sentry>
+      <sentry id="s_shortlist">
+        <onPart id="op_sl" caseFileItemRef="shortlist"><standardEvent>create</standardEvent></onPart>
+      </sentry>
+      <sentry id="s_confirmed">
+        <onPart id="op_cf" caseFileItemRef="shortlist"><standardEvent>update</standardEvent></onPart>
+        <ifPart id="if_cf"><condition>candidatesConfirmed &gt;= 2</condition></ifPart>
+      </sentry>
+
+      <stage id="S1" name="初选核险" autoComplete="true">
+        <entryCriterion id="ec_s1" sentryRef="s_request"/>
+        <humanTask id="T_spec_risk" name="人工查规格核险">
+          <itemControl><manualActivationRule id="m_sr"/></itemControl>
+        </humanTask>
+        <humanTask id="T_brand" name="人工判主推品牌">
+          <itemControl><manualActivationRule id="m_br"/></itemControl>
+        </humanTask>
+        <planningTable id="pt_s1">
+          <humanTask id="T_known_issues" name="人工查沉淀避坑"/>
+        </planningTable>
+      </stage>
+      <milestone id="M_initial" name="初选定性"/>
+
+      <stage id="S2" name="圈选替代" autoComplete="true">
+        <entryCriterion id="ec_s2" sentryRef="s_need_alt"/>
+        <humanTask id="T_shortlist" name="人工撒网拉初筛">
+          <itemControl><manualActivationRule id="m_sl"/><repetitionRule id="r_sl"/></itemControl>
+        </humanTask>
+        <humanTask id="T_grade" name="人工逐条核验分级">
+          <entryCriterion id="ec_grade" sentryRef="s_shortlist"/>
+          <itemControl><manualActivationRule id="m_gr"/><repetitionRule id="r_gr"/></itemControl>
+        </humanTask>
+        <humanTask id="T_confirm" name="人工确认主推型号">
+          <itemControl><manualActivationRule id="m_cf"/></itemControl>
+        </humanTask>
+      </stage>
+      <milestone id="M_candidates" name="候选圈定"/>
+
+      <stage id="S3" name="对比评估交付" autoComplete="true">
+        <entryCriterion id="ec_s3" sentryRef="s_confirmed"/>
+        <humanTask id="T_collect" name="人工收集规格书">
+          <itemControl><manualActivationRule id="m_co"/></itemControl>
+        </humanTask>
+        <humanTask id="T_compare" name="人工参数对比表">
+          <itemControl><manualActivationRule id="m_cp"/></itemControl>
+        </humanTask>
+        <humanTask id="T_risk" name="人工替代风险评估">
+          <itemControl><manualActivationRule id="m_rk"/></itemControl>
+        </humanTask>
+        <humanTask id="T_sign" name="人工签字交出">
+          <itemControl><manualActivationRule id="m_sg"/></itemControl>
+        </humanTask>
+      </stage>
+      <milestone id="M_signed" name="签字放行"/>
+
+      <humanTask id="T_knowledge" name="人工知识入库">
+        <itemControl><manualActivationRule id="m_kb"/></itemControl>
+      </humanTask>
+
+      <timerEventListener id="TL_half" name="时限过半">
+        <timerExpression>P2D</timerExpression>
+      </timerEventListener>
+      <userEventListener id="UL_change" name="客户改需求"/>
+    </casePlanModel>
+  </case>
+</definitions>`;
+
+export const NARRATIVE = `§0 开案:替代选型一事一议 —— 收到替代评估请求即开案。客户/PM 给出初选物料,或芯片类型与大致参数。
+先核初选(EOL 等风险提示 + 是否我司主推品牌),无风险且主推直接采信初选办结;
+需要替代的,先撒网(AI 检索/聚合平台拉初筛清单)后逐条人工核验,常要两三轮,
+存活候选按替代等级分级(P2P/功能兼容/其他)圈 2~3 颗,做参数对比与风险评估成报告交回。
+**任何替代必须把差异与风险写清 —— 差异没核清的不放行。**
+
+S1 初选核险:一手资料以原厂官网为准(产品页/规格书/PCN·EOL 公告);
+查芯片规格书确认初选料有无 EOL/停产风险,生命周期对照 PN物料主库;
+对品牌原厂字典判是否我司主推 —— 无风险且主推,直接采信初选、免替代办结。
+顺手查替代料库与技术问题案例库(裁量项),有沉淀方案或已知坑先亮出来。
+
+S2 圈选替代:先撒网后核验,常要两三轮。逐条人工核验做全面参数对比 ——
+先明确每项数据的来源(一律以原厂官网规格书为准),再逐项对标(Pin-to-Pin);
+存活者按替代等级分级;候选过客户技术画像禁用清单;不足 2~3 颗就放宽参数或换角度重新撒网。
+
+S3 对比评估交付:收齐候选规格书,关键参数逐项对比写进替代对标表,标出差异项与替代等级,
+写明差异带来的风险;按等级定评估深度 —— P2P 核确免改动,功能兼容/其他逐项评软件开发、
+外围电路与 layout 改动。FAE 签字后交回发起方。
+
+全程随时可做:知识入库 —— 规格书入库、替代关系回填替代料库与 PN物料主库、踩到的坑记案例库。
+
+§Z 结案:必做的事都办完、没有进行中的事,自动算结案(CMMN AutoComplete)。
+无需替代的,确认初选可用即结案;需要替代的,推荐报告(已签字)交回发起方即结案 ——
+每办一案,知识库厚一层。`;
@@ -0,0 +1,63 @@
+/**
+ * 统一报价 A2 · 替代选型 —— 活动包代码入口(ADR-004)。
+ * loop 活动:调度权归 AI;本文件只做视图流控与「差异没核清不放行」的把关呈现。
+ */
+import { defineActivity } from '@sdk';
+import type { ActivityBase, ActivityOutcome } from '@sdk';
+
+const SHORTLIST = 'quote_alternative.shortlist';
+const BENCHMARK = 'quote_alternative.benchmark';
+
+export default defineActivity({
+  name: 'quote-alternative',
+  paradigm: 'loop',
+
+  async run(base: ActivityBase): Promise<ActivityOutcome> {
+    const shortlist = await base.ledger.read(SHORTLIST);
+    const benchmark = await base.ledger.read(BENCHMARK);
+    // 差异没核清的不放行 —— 禁区的机检形态
+    const unclear = benchmark.filter((r) => String(r['risk'] ?? '').trim() === '');
+
+    await base.interaction.pushView([
+      {
+        t: 'kv',
+        title: '选型进展',
+        items: [
+          { k: '原型号', v: String(base.contract.data['originalPn'] ?? '') },
+          { k: '初筛候选', v: `${shortlist.length} 颗` },
+          { k: '已对标', v: `${benchmark.length} 颗` },
+          { k: '差异未核清', v: `${unclear.length} 颗` },
+        ],
+      },
+      {
+        t: 'cards',
+        title: '候选替代',
+        items: benchmark.map((r) => ({
+          tag: String(r['grade'] ?? '待定级'),
+          title: String(r['candidate_pn'] ?? ''),
+          swap: { from: String(r['original_pn'] ?? ''), to: String(r['candidate_pn'] ?? '') },
+          big: String(r['grade'] ?? '—'),
+          bigLabel: '替代等级',
+          note: String(r['risk'] ?? '差异风险未写'),
+          tone: String(r['risk'] ?? '').trim() === '' ? 'danger' : 'ok',
+        })),
+      },
+    ]);
+
+    if (benchmark.length < 2) {
+      await base.interaction.say(
+        shortlist.length === 0 ? '尚未撒网,先拉初筛清单。' : `已初筛 ${shortlist.length} 颗,继续逐条核验分级。`,
+        'conclusion',
+      );
+      return { kind: 'await', reason: '候选不足 2 颗' };
+    }
+
+    if (unclear.length > 0) {
+      await base.interaction.say(`${unclear.length} 颗候选的差异风险未写清 —— 差异没核清的不放行。`, 'criterion');
+      return { kind: 'await', reason: '差异风险未核清' };
+    }
+
+    await base.interaction.say('候选已分级、差异与风险已写清,可签字交回发起方。', 'criterion');
+    return { kind: 'submit', deliverable: 'benchmark-table', rationale: '2 颗以上分级候选,差异与风险齐备' };
+  },
+});
@@ -0,0 +1,185 @@
+/**
+ * 活动包清单 —— 统一报价 A2 · 替代选型(**案例活动 · loop**)。
+ *
+ * 业务素材:docs/MVP示例工作流.html §1.6。
+ * `▶需拍板`(签字交出)→ manualActivation + 放行;`✋客户改需求` → userEventListener;
+ * `⏱时限过半` → 时间监听(**时限必配**)。
+ */
+import type { ActivityManifest, DmnModel } from '@contracts';
+import { activityIdSchema } from '@contracts';
+import { CMMN_XML, NARRATIVE } from './case-model.ts';
+
+const DOMAIN = 'quote_alternative';
+const ACTIVITY_ID = activityIdSchema.parse('quote-alternative');
+
+/** 替代等级 —— 把「装得下的判断」从 LLM 手里拿走 */
+export const GRADE_DMN: DmnModel = {
+  drd: [{ decision: 'alt-grade', requires: [], inputs: ['pinCompatible', 'packageSame', 'paramDelta'] }],
+  tables: [
+    {
+      id: 'alt-grade',
+      label: '替代等级判定',
+      hitPolicy: 'FIRST',
+      inputs: [
+        { name: 'pinCompatible', expression: 'pinCompatible' },
+        { name: 'packageSame', expression: 'packageSame' },
+        { name: 'paramDelta', expression: 'paramDelta' },
+      ],
+      outputs: [{ name: 'grade' }, { name: 'effort' }],
+      rules: [
+        { id: 'g-p2p', when: ['true', 'true', '<= 0.05'], then: ['P2P', '核确免改动'] },
+        { id: 'g-func', when: ['-', '-', '<= 0.20'], then: ['功能兼容', '评外围电路与 layout'] },
+        { id: 'g-other', when: ['-', '-', '-'], then: ['其他', '须验证'] },
+      ],
+    },
+  ],
+};
+
+export const manifest: ActivityManifest = {
+  identity: {
+    activityId: ACTIVITY_ID,
+    name: 'A2 · 替代选型',
+    packageVersion: '0.1.0',
+    category: '统一报价',
+    paradigm: 'loop',
+    sdkVersion: '0.1.0-m5',
+    checksum: 'dev-checksum-quote-alternative',
+  },
+
+  contract: {
+    activityId: ACTIVITY_ID,
+    version: '0.1.0',
+    input: {
+      data: {
+        type: 'object',
+        required: ['originalPn'],
+        properties: {
+          originalPn: { type: 'string' },
+          chipType: { type: 'string' },
+          params: { type: 'object' },
+          scenario: { type: 'string' },
+        },
+      },
+      messageAllowed: true,
+    },
+    output: {
+      mandatory: [
+        {
+          name: 'benchmark',
+          payload: { type: 'object', required: ['rows'], properties: { rows: { type: 'array' } } },
+          description: '替代对标表(已签字)',
+        },
+      ],
+      selective: [],
+    },
+    requiredDeliverables: [{ key: 'benchmark-table', label: '替代对标表(FAE 签字)' }],
+    acceptanceCriteria: [
+      { key: 'candidates', label: '2~3 颗分级候选经确认', level: 'L2', predicate: 'candidatesConfirmed >= 2' },
+      { key: 'diff-clear', label: '差异项与风险逐项写清', level: 'L2', predicate: 'undocumentedDiff = 0' },
+      { key: 'source-traceable', label: '每项数据来源可溯(以原厂官网规格书为准)', level: 'L3' },
+      { key: 'fae-sign', label: 'FAE 签字放行', level: 'L5' },
+    ],
+    prohibitions: [
+      { key: 'no-unclear-diff', statement: '差异没核清的不放行' },
+      { key: 'no-banned', statement: '客户技术画像禁用清单里的型号不得作候选' },
+    ],
+    authorization: {
+      discretion: [{ key: 'widen-search', statement: '候选不足 2~3 颗时可放宽参数或换角度重新撒网' }],
+      preauthorizedActions: [],
+      humanCallBudget: 6,
+    },
+    resources: {
+      tools: [{ name: 'crm.history-price-read' }],
+      skills: [],
+      models: ['quote-extractor'],
+      roles: ['FAE'],
+      budget: { steps: 100, tokens: 260_000, activeMinutes: 360, humanCalls: 6 },
+    },
+  },
+
+  declarations: {
+    models: ['quote-extractor'],
+    tools: [{ name: 'crm.history-price-read' }],
+    ledger: [
+      {
+        domain: DOMAIN,
+        object: 'shortlist',
+        label: '初筛清单',
+        fields: [
+          { name: 'original_pn', type: 'text', primaryKey: true, masked: false, label: '原型号' },
+          { name: 'candidate_pn', type: 'text', primaryKey: true, masked: false, label: '候选型号' },
+          { name: 'brand', type: 'text', primaryKey: false, masked: false, label: '品牌' },
+          { name: 'lifecycle', type: 'text', primaryKey: false, masked: false, label: '生命周期' },
+        ],
+      },
+      {
+        domain: DOMAIN,
+        object: 'benchmark',
+        label: '替代对标表',
+        fields: [
+          { name: 'original_pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'candidate_pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'grade', type: 'text', primaryKey: false, masked: false, label: '替代等级' },
+          { name: 'param_diff', type: 'text', primaryKey: false, masked: false, label: '参数差异项' },
+          { name: 'risk', type: 'text', primaryKey: false, masked: false, label: '差异风险' },
+          { name: 'verify_advice', type: 'text', primaryKey: false, masked: false, label: '验证建议' },
+          { name: 'signed_by', type: 'text', primaryKey: false, masked: false, label: 'FAE 签字' },
+        ],
+      },
+    ],
+    listeners: [
+      {
+        // ⏱ 时限过半:向 BD 与 PM 同步进度与风险
+        origin: 'static',
+        eventType: 'time',
+        keyFilter: { kind: 'half-deadline' },
+        semantic: 'observe',
+        deadline: 'P2D',
+        escalation: ['nudge'],
+      },
+      {
+        // ✋ 客户改需求:应用条件/参数变更 → 回初选核险与圈选复核
+        origin: 'static',
+        eventType: 'human',
+        keyFilter: { kind: 'requirement-change' },
+        semantic: 'observe',
+        deadline: 'P5D',
+        escalation: ['nudge', 'reroute'],
+      },
+    ],
+    harness: {
+      memoryWindow: 30,
+      stallAfter: 'P1D',
+      nudge: [{ after: 'PT12H', action: 'nudge' }],
+      retry: { times: 2, backoff: 'PT5M' },
+    },
+  },
+
+  assets: {
+    businessModel: {
+      paradigm: 'loop',
+      cmmnXml: CMMN_XML,
+      narrative: NARRATIVE,
+      dmn: GRADE_DMN,
+    },
+    skills: [],
+    viewTemplates: [
+      { name: 'alt-board', html: '<div class="jc-card"><h3>替代选型</h3><p data-slot="stage"></p></div>' },
+    ],
+    cardSchemas: {},
+    distillHooks: [
+      { on: 'milestone', milestone: 'M_candidates', prompt: '归纳本轮撒网的有效角度与无效角度。' },
+      { on: 'terminal', prompt: '归纳替代经验:哪些参数差异实际造成了问题、哪些品牌的替代关系可复用。' },
+    ],
+  },
+
+  samples: [
+    {
+      name: 'EOL 料替代',
+      input: { originalPn: 'TL072CDR', chipType: '运放', scenario: '车规' },
+      expect: { ports: ['benchmark'] },
+    },
+  ],
+
+  entry: { file: 'index.js', checksum: 'dev-entry-quote-alternative' },
+};
@@ -0,0 +1 @@
+{ "name": "@activities/quote-archive", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }
@@ -0,0 +1,37 @@
+/**
+ * 统一报价 A7 · 情报归档 —— 活动包代码入口(ADR-004)。
+ * 「不成交也留资产」:把归档结果摆给人看,确认无空档再提交放行。
+ */
+import { defineActivity } from '@sdk';
+import type { ActivityBase, ActivityOutcome } from '@sdk';
+
+export default defineActivity({
+  name: 'quote-archive',
+  paradigm: 'flow',
+
+  async run(base: ActivityBase): Promise<ActivityOutcome> {
+    const history = await base.ledger.read('shared.history_price');
+    const stats = await base.ledger.read('shared.landing_stats');
+
+    await base.interaction.pushView([
+      {
+        t: 'kv',
+        title: '归档闭环',
+        items: [
+          { k: '情报回写', v: `${history.length} 条` },
+          { k: '落地率', v: stats.length > 0 ? String(stats[0]?.['landing_rate'] ?? '—') : '—' },
+          { k: '客户', v: String(base.contract.data['customerCode'] ?? '') },
+        ],
+      },
+    ]);
+
+    // 不得空归档 —— 每一单不成交的报价也是情报资产
+    if (history.length === 0) {
+      await base.interaction.say('情报尚未回写,继续登记结果。', 'conclusion');
+      return { kind: 'await', reason: '等待结果登记步完成' };
+    }
+
+    await base.interaction.say('拒绝原因与竞对价位已回写,画像与落地率已落账。', 'criterion');
+    return { kind: 'submit', deliverable: 'history-archive', rationale: '情报、画像、落地率三样齐备' };
+  },
+});
@@ -0,0 +1,180 @@
+/**
+ * 活动包清单 —— 统一报价 A7 · 情报归档。
+ *
+ * 业务素材:docs/MVP示例工作流.html §1.7(S1 结果登记 → S2 画像更新 → S3 落地率统计)。
+ * 「不成交也留资产:情报、客户画像、落地率」—— 写的是**共享域**,跨活动的沉淀事实。
+ */
+import type { ActivityManifest } from '@contracts';
+import { activityIdSchema } from '@contracts';
+
+const ACTIVITY_ID = activityIdSchema.parse('quote-archive');
+
+export const manifest: ActivityManifest = {
+  identity: {
+    activityId: ACTIVITY_ID,
+    name: 'A7 · 情报归档',
+    packageVersion: '0.1.0',
+    category: '统一报价',
+    paradigm: 'flow',
+    sdkVersion: '0.1.0-m5',
+    checksum: 'dev-checksum-quote-archive',
+  },
+
+  contract: {
+    activityId: ACTIVITY_ID,
+    version: '0.1.0',
+    input: {
+      data: {
+        type: 'object',
+        required: ['customerCode', 'quoteNo'],
+        properties: {
+          customerCode: { type: 'string' },
+          quoteNo: { type: 'string' },
+          reason: { type: 'string' },
+          competitorPrice: { type: 'number' },
+        },
+      },
+      messageAllowed: true,
+    },
+    output: {
+      mandatory: [
+        {
+          name: 'archived',
+          payload: { type: 'object', properties: { landingRate: { type: 'number' } } },
+          description: '归档闭环:情报回写 + 落地率落账',
+        },
+      ],
+      selective: [],
+    },
+    requiredDeliverables: [
+      { key: 'history-archive', label: '历史价格情报(归档)' },
+      { key: 'landing-stats', label: '报价落地率统计' },
+    ],
+    acceptanceCriteria: [
+      { key: 'reason-logged', label: '拒绝原因 / 竞对价位已回写', level: 'L1', predicate: 'reasonLogged = true' },
+      { key: 'profile-updated', label: '客户画像标签已更新', level: 'L2', predicate: 'profileUpdated = true' },
+      { key: 'bd-release', label: 'BD 放行', level: 'L5' },
+    ],
+    prohibitions: [{ key: 'no-blank-archive', statement: '不得空归档 —— 每一单不成交的报价也是情报资产' }],
+    authorization: { discretion: [], preauthorizedActions: [], humanCallBudget: 1 },
+    resources: {
+      tools: [],
+      skills: [],
+      models: ['quote-extractor'],
+      roles: ['BD'],
+      budget: { steps: 30, tokens: 60_000, activeMinutes: 60, humanCalls: 1 },
+    },
+  },
+
+  declarations: {
+    models: ['quote-extractor'],
+    tools: [],
+    ledger: [
+      {
+        // 共享域:跨活动的沉淀事实(AM 11.3 暗耦合禁令的两条合法路径之一)
+        domain: 'shared',
+        object: 'history_price',
+        label: '历史价格情报',
+        fields: [
+          { name: 'pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'quoted_at', type: 'date', primaryKey: true, masked: false },
+          { name: 'lost_reason', type: 'text', primaryKey: false, masked: false, label: '拒绝原因' },
+          { name: 'competitor_price', type: 'number', primaryKey: false, masked: false, label: '竞对价位' },
+        ],
+      },
+      {
+        domain: 'shared',
+        object: 'customer',
+        label: '客户资料库',
+        fields: [
+          { name: 'customer_code', type: 'text', primaryKey: true, masked: false, label: '客户码' },
+          { name: 'grade', type: 'text', primaryKey: false, masked: false, label: '客户等级' },
+          { name: 'profile_tags', type: 'text', primaryKey: false, masked: false, label: '画像标签' },
+        ],
+      },
+      {
+        domain: 'shared',
+        object: 'landing_stats',
+        label: '报价落地率统计',
+        fields: [
+          { name: 'period', type: 'text', primaryKey: true, masked: false, label: '月份' },
+          { name: 'landing_rate', type: 'number', primaryKey: false, masked: false, label: '落地率' },
+          { name: 'type_a_hit', type: 'number', primaryKey: false, masked: false, label: 'TypeA命中' },
+          { name: 'reply_rate_d3', type: 'number', primaryKey: false, masked: false, label: 'D+3回复率' },
+        ],
+      },
+    ],
+    listeners: [],
+    // 7 天闭环(MVP示例 §1.7)
+    harness: { memoryWindow: 15, stallAfter: 'P1D', nudge: [], retry: { times: 2, backoff: 'PT30S' } },
+  },
+
+  assets: {
+    businessModel: {
+      paradigm: 'flow',
+      steps: [
+        {
+          kind: 'llm',
+          name: 'S1_log_result',
+          label: 'S1 结果登记(拒绝原因 / 竞对价位)',
+          input: { reason: 'reason', quoteNo: 'quoteNo' },
+          output: { domain: 'shared', object: 'history_price', fields: { lost_reason: 'lostReason' } },
+          model: 'quote-extractor',
+          template: '从跟进反馈里抽出拒绝原因与竞对价位。只输出 JSON。反馈:{{reason}}',
+          outputSchema: {
+            type: 'object',
+            properties: { lostReason: { type: 'string' }, competitorPrice: { type: 'number' } },
+          },
+          failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
+        },
+        {
+          kind: 'pure-tool',
+          name: 'S2_profile',
+          label: 'S2 画像更新(供 P-01 的客户等级因子取用)',
+          input: { customerCode: 'customerCode', reason: 'reason' },
+          output: { domain: 'shared', object: 'customer', fields: { profile_tags: 'tags' } },
+          tool: 'quote-archive.profile',
+          failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
+        },
+        {
+          kind: 'pure-tool',
+          name: 'S3_landing_rate',
+          label: 'S3 落地率统计',
+          input: {},
+          output: { domain: 'shared', object: 'landing_stats', fields: { landing_rate: 'landingRate' } },
+          tool: 'quote-archive.landing-rate',
+          failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
+        },
+        {
+          kind: 'human',
+          name: 'S4_release',
+          label: 'S4 归档闭环验收放行',
+          input: {},
+          workOrder: 'acceptance',
+          card: { title: '情报归档请验收', deliverable: 'history-archive' },
+          deadline: 'P1D',
+          failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
+        },
+      ],
+      parallelGroups: [],
+    },
+    skills: [],
+    viewTemplates: [
+      { name: 'archive-summary', html: '<div class="jc-card"><h3>归档闭环</h3><p data-slot="stats"></p></div>' },
+    ],
+    cardSchemas: {},
+    distillHooks: [
+      { on: 'terminal', prompt: '归纳丢单的共性:价格、交期、竞对、客户类型 —— 供下一单更快更准。' },
+    ],
+  },
+
+  samples: [
+    {
+      name: '客户拒绝',
+      input: { customerCode: 'C001', quoteNo: 'Q202601', reason: '竞对报价更低' },
+      expect: { ports: ['archived'] },
+    },
+  ],
+
+  entry: { file: 'index.js', checksum: 'dev-entry-quote-archive' },
+};
@@ -0,0 +1 @@
+{ "name": "@activities/quote-negotiate", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }
@@ -0,0 +1,50 @@
+/**
+ * 统一报价 A6 · 报价议价 —— 活动包代码入口(ADR-004)。
+ *
+ * 「发出的同时必须建立 D+3/D+7 跟进 —— 没有跟进的报价等于没报。」
+ * 这里把跟进监听立起来:AI 对世界只有触达(动作,落在放行)与等待(监听)两种姿势。
+ */
+import { defineActivity } from '@sdk';
+import type { ActivityBase, ActivityOutcome } from '@sdk';
+
+const QUOTE = 'quote_negotiate.formal_quote';
+
+export default defineActivity({
+  name: 'quote-negotiate',
+  paradigm: 'flow',
+
+  async run(base: ActivityBase): Promise<ActivityOutcome> {
+    const lines = await base.ledger.read(QUOTE);
+
+    await base.interaction.pushView([
+      {
+        t: 'table',
+        title: '正式报价单',
+        cols: ['PN', '单价CNY', '交期', 'MOQ', '有效期'],
+        rows: lines.map((r) => [
+          String(r['pn'] ?? ''),
+          String(r['unit_price'] ?? '—'),
+          String(r['lead_time'] ?? '—'),
+          String(r['moq'] ?? '—'),
+          String(r['valid_until'] ?? '—'),
+        ]),
+      },
+    ]);
+
+    const incomplete = lines.filter((r) => r['unit_price'] === undefined || r['valid_until'] === undefined);
+    if (lines.length === 0 || incomplete.length > 0) {
+      await base.interaction.say('报价单条目尚未齐备,继续排版。', 'conclusion');
+      return { kind: 'await', reason: '等待报价单生成步完成' };
+    }
+
+    // 建 D+3 跟进:等客户回音 —— 时限必配,无死等
+    await base.tools.listen({
+      eventType: 'data',
+      keyFilter: { kind: 'customer-reply', customerCode: String(base.contract.data['customerCode'] ?? '') },
+      deadline: 'P3D',
+    });
+    await base.interaction.say('已建 D+3 跟进监听 —— 没有跟进的报价等于没报。', 'guidance');
+
+    return { kind: 'submit', deliverable: 'formal-quote', rationale: '报价单齐备且已建跟进,提交放行即发出' };
+  },
+});
@@ -0,0 +1,188 @@
+/**
+ * 活动包清单 —— 统一报价 A6 · 报价议价。
+ *
+ * 业务素材:docs/MVP示例工作流.html §1.4(S1 生成发出 → S2 CRM 留档 → S3 建立跟进)。
+ * 关键机制:生成正式报价单是**写类动作** → 登记为动作意向 → 落地预检 →
+ * 放行通过即落地(台账回写 + 出站发送)→ 输出口发射;并建 D+3 跟进监听。
+ */
+import type { ActivityManifest } from '@contracts';
+import { activityIdSchema } from '@contracts';
+
+const DOMAIN = 'quote_negotiate';
+const ACTIVITY_ID = activityIdSchema.parse('quote-negotiate');
+
+export const manifest: ActivityManifest = {
+  identity: {
+    activityId: ACTIVITY_ID,
+    name: 'A6 · 报价议价',
+    packageVersion: '0.1.0',
+    category: '统一报价',
+    paradigm: 'flow',
+    sdkVersion: '0.1.0-m5',
+    checksum: 'dev-checksum-quote-negotiate',
+  },
+
+  contract: {
+    activityId: ACTIVITY_ID,
+    version: '0.1.0',
+    input: {
+      data: {
+        type: 'object',
+        required: ['customerCode', 'items'],
+        properties: { customerCode: { type: 'string' }, items: { type: 'array' } },
+      },
+      messageAllowed: true,
+    },
+    output: {
+      mandatory: [],
+      // 议价结果是**业务分支**:必须建模为选择组的一口,随放行发射 —— 不得用异常终态编码
+      selective: [
+        {
+          group: 'negotiation',
+          ports: [
+            { name: 'won', payload: { type: 'object' }, description: '成交 → 转订单履约(ORM)' },
+            { name: 'revise', payload: { type: 'object' }, description: '有异议 → 返回调整 A4' },
+            { name: 'lost', payload: { type: 'object' }, description: '拒绝/超时 → 转 A7 情报归档' },
+          ],
+        },
+      ],
+    },
+    requiredDeliverables: [
+      { key: 'formal-quote', label: '正式报价单(PDF · 中英双语)' },
+      { key: 'followup', label: 'D+3/D+7 跟进提醒' },
+    ],
+    acceptanceCriteria: [
+      { key: 'quote-complete', label: '单价/交期/SPQ/MOQ/贸易条款/有效期齐备', level: 'L1', predicate: 'missingQuoteFields = 0' },
+      { key: 'validity', label: '按报价有效期 P-04 注明有效期', level: 'L2', predicate: 'validityDays > 0' },
+      { key: 'followup-set', label: '已建 D+3/D+7 跟进 —— 没有跟进的报价等于没报', level: 'L2', predicate: 'followupSet = true' },
+      { key: 'bd-release', label: 'BD 放行', level: 'L5' },
+    ],
+    prohibitions: [
+      { key: 'no-break-line', statement: '客户议价超出授权范围的,回 A5 重批,不私自破线' },
+      { key: 'no-send-before-release', statement: '报价单在放行前不得发出 —— 写类动作集中在放行时落地' },
+    ],
+    authorization: {
+      discretion: [{ key: 'haggle-band', statement: '在已批准的价格区间内回旋;出区间必须回审批' }],
+      // 预授权必须逐项列举:催办模板可即时发,报价单不行
+      preauthorizedActions: [{ tool: 'mail.send', operation: 'nudge', limit: '仅催办模板' }],
+      humanCallBudget: 3,
+    },
+    resources: {
+      tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
+      skills: [],
+      models: ['quote-extractor'],
+      roles: ['BD'],
+      budget: { steps: 50, tokens: 120_000, activeMinutes: 60, humanCalls: 3 },
+    },
+  },
+
+  declarations: {
+    models: ['quote-extractor'],
+    tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
+    ledger: [
+      {
+        domain: DOMAIN,
+        object: 'formal_quote',
+        label: '正式报价单',
+        fields: [
+          { name: 'quote_no', type: 'text', primaryKey: true, masked: false, label: '报价单号' },
+          { name: 'pn', type: 'text', primaryKey: true, masked: false, label: 'PN' },
+          { name: 'unit_price', type: 'number', primaryKey: false, masked: false, label: '单价CNY' },
+          { name: 'lead_time', type: 'text', primaryKey: false, masked: false, label: '交期' },
+          { name: 'spq', type: 'integer', primaryKey: false, masked: false, label: 'SPQ' },
+          { name: 'moq', type: 'integer', primaryKey: false, masked: false, label: 'MOQ' },
+          { name: 'trade_terms', type: 'text', primaryKey: false, masked: false, label: '贸易条款' },
+          { name: 'valid_until', type: 'date', primaryKey: false, masked: false, label: '有效期' },
+        ],
+      },
+      {
+        domain: 'shared',
+        object: 'history_price',
+        label: '历史价格情报(共享域)',
+        fields: [
+          { name: 'pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'quoted_at', type: 'date', primaryKey: true, masked: false, label: '报价日期' },
+          { name: 'unit_price', type: 'number', primaryKey: false, masked: false },
+          { name: 'lead_time', type: 'text', primaryKey: false, masked: false },
+        ],
+      },
+    ],
+    listeners: [
+      {
+        origin: 'static',
+        eventType: 'data',
+        keyFilter: { kind: 'customer-reply' },
+        semantic: 'complete-step',
+        // 建 D+3 跟进监听:等客户回音,时限必配 —— 无死等
+        deadline: 'P3D',
+        escalation: ['nudge', 'escalate'],
+      },
+    ],
+    harness: {
+      memoryWindow: 20,
+      stallAfter: 'PT15M',
+      nudge: [{ after: 'PT10M', action: 'nudge' }],
+      retry: { times: 2, backoff: 'PT30S' },
+    },
+  },
+
+  assets: {
+    businessModel: {
+      paradigm: 'flow',
+      steps: [
+        {
+          kind: 'llm',
+          name: 'S1_compose',
+          label: 'S1 生成正式报价单',
+          input: { items: 'items', customerCode: 'customerCode' },
+          output: { domain: DOMAIN, object: 'formal_quote', fields: { unit_price: 'unitPrice', lead_time: 'leadTime' } },
+          model: 'quote-extractor',
+          template:
+            '把已批准的报价草案排版为正式报价单条目(单价CNY/交期/SPQ/MOQ/贸易条款),' +
+            '按报价有效期 P-04 注明 7 日历天有效。只输出 JSON。条目:{{items}}',
+          outputSchema: {
+            type: 'object',
+            required: ['lines'],
+            properties: { lines: { type: 'array' }, validityDays: { type: 'integer' } },
+          },
+          failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
+        },
+        {
+          kind: 'tool',
+          name: 'S2_send',
+          label: 'S2 发出报价单(写类 → 登记动作意向,放行时落地)',
+          input: { customerCode: 'customerCode' },
+          tool: 'mail.send',
+          failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
+        },
+        {
+          kind: 'human',
+          name: 'S3_release',
+          label: 'S3 正式报价单验收放行(放行即落地:台账回写 + 出站发送)',
+          input: {},
+          workOrder: 'acceptance',
+          card: { title: '正式报价单请验收 —— 放行即发出', deliverable: 'formal-quote' },
+          deadline: 'P1D',
+          failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
+        },
+      ],
+      parallelGroups: [],
+    },
+    skills: [],
+    viewTemplates: [
+      { name: 'quote-preview', html: '<div class="jc-card"><h3>正式报价单</h3><p data-slot="lines"></p></div>' },
+    ],
+    cardSchemas: {},
+    distillHooks: [{ on: 'terminal', prompt: '归纳本单议价的经验:客户的还价幅度、成交与否的关键因素。' }],
+  },
+
+  samples: [
+    {
+      name: '车规 Analog 报价',
+      input: { customerCode: 'C001', items: [{ pn: 'LM358DR', quotedPrice: 1.95 }] },
+      expect: { ports: ['won'] },
+    },
+  ],
+
+  entry: { file: 'index.js', checksum: 'dev-entry-quote-negotiate' },
+};
@@ -0,0 +1 @@
+{ "name": "@activities/quote-pricing", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }
@@ -0,0 +1,80 @@
+/**
+ * 统一报价 A4 · 成本定价 —— 活动包代码入口(ADR-004)。
+ *
+ * flow 活动:下一步由步序声明给定。本文件只做声明装不下的两件事 ——
+ * 视图流控,与「结论不可静默覆写」的呈现:P-02 拦下的条目必须显式呈现给人。
+ */
+import { defineActivity } from '@sdk';
+import type { ActivityBase, ActivityOutcome } from '@sdk';
+
+const DRAFT = 'quote_pricing.draft';
+
+export default defineActivity({
+  name: 'quote-pricing',
+  paradigm: 'flow',
+
+  async run(base: ActivityBase): Promise<ActivityOutcome> {
+    const items = await base.ledger.read(DRAFT);
+    const priced = items.filter((r) => typeof r['quoted_price'] === 'number');
+    // 底价门禁 P-02 拦下的条目 —— DMN 结论是**约束性输入**,不得静默覆写
+    const blocked = items.filter((r) => String(r['disposition'] ?? '').includes('拦截'));
+
+    await base.interaction.pushView([
+      {
+        t: 'kv',
+        title: '定价概览',
+        items: [
+          { k: '条目', v: `${items.length} 条` },
+          { k: '已定价', v: `${priced.length} 条` },
+          { k: '底价门禁拦下', v: `${blocked.length} 条` },
+        ],
+      },
+      {
+        t: 'table',
+        title: '报价草案',
+        cols: ['PN', '拟报单价', '毛利率', '偏离度', '门禁处置'],
+        rows: items.map((r) => [
+          String(r['pn'] ?? ''),
+          fmt(r['quoted_price']),
+          pct(r['margin']),
+          pct(r['deviation']),
+          String(r['disposition'] ?? '待判'),
+        ]),
+        linkDonut: {
+          col: 4,
+          title: '门禁分布',
+          map: [
+            { match: '直接放行', label: '直接放行', tone: 'ok' },
+            { match: 'PM', label: 'PM 附理由', tone: 'warn' },
+            { match: '拦截', label: '拦截', tone: 'danger' },
+          ],
+        },
+      },
+    ]);
+
+    if (priced.length < items.length) {
+      await base.interaction.say(`还有 ${items.length - priced.length} 条未定价,继续按利润模型 P-01 求值。`, 'conclusion');
+      return { kind: 'await', reason: '等待定价步完成' };
+    }
+
+    if (blocked.length > 0) {
+      // 超出授权边界 → 走「人 · 决策」,不自行破线
+      await base.interaction.say(
+        `${blocked.length} 条低于底价 20% 以上,已被底价门禁 P-02 拦下 —— 需要人裁决回调还是注明理由。`,
+        'criterion',
+      );
+      return { kind: 'await', reason: '等待超限条目的人裁决' };
+    }
+
+    await base.interaction.say(`${items.length} 条已全部定价且过底价门禁,可提交审批。`, 'criterion');
+    return { kind: 'submit', deliverable: 'quote-draft', rationale: '全条目带偏离度,底价门禁全过' };
+  },
+});
+
+function fmt(value: unknown): string {
+  return typeof value === 'number' ? value.toFixed(2) : '—';
+}
+
+function pct(value: unknown): string {
+  return typeof value === 'number' ? `${(value * 100).toFixed(1)}%` : '—';
+}
@@ -0,0 +1,242 @@
+/**
+ * 活动包清单 —— 统一报价 A4 · 成本定价。
+ *
+ * 业务素材:docs/MVP示例工作流.html §1.2(S1 取价基准 → S2 逐条定价 → S3 底价自检)。
+ * README《已裁定的落地决策》③:**A4 = flow** —— 取价、查表定价、自检的判断
+ * **全部装进 DMN 决策表确定性求值**;一旦出现「由 AI 决定怎么办」,按 AM 2.1 上升。
+ */
+import type { ActivityManifest, DmnModel } from '@contracts';
+import { activityIdSchema } from '@contracts';
+
+const DOMAIN = 'quote_pricing';
+const ACTIVITY_ID = activityIdSchema.parse('quote-pricing');
+
+/**
+ * 利润模型 P-01 —— 品牌 × 类型 × 客户等级 × 数量档 → 目标毛利。
+ * 「经验」段落不入决策表(那是技能 / 活动记忆种子:载方法不载权力)。
+ */
+export const P01_DMN: DmnModel = {
+  drd: [
+    { decision: 'p01-margin', requires: [], inputs: ['customerGrade', 'materialType', 'volumeTier'] },
+    { decision: 'p02-floor', requires: ['p01-margin'], inputs: ['quotedPrice', 'floorPrice'] },
+  ],
+  tables: [
+    {
+      id: 'p01-margin',
+      label: '利润模型 P-01',
+      hitPolicy: 'FIRST',
+      inputs: [
+        { name: 'customerGrade', expression: 'customerGrade' },
+        { name: 'materialType', expression: 'materialType' },
+        { name: 'volumeTier', expression: 'volumeTier' },
+      ],
+      outputs: [{ name: 'marginLow' }, { name: 'marginHigh' }],
+      rules: [
+        { id: 'p01-1', when: ['"战略客户"', '"A"', '"大批量"'], then: [0.08, 0.1], annotation: '战略客户 A 类标准件大批量 8%–10%' },
+        { id: 'p01-2', when: ['"普通客户"', '"A"', '-'], then: [0.12, 0.15], annotation: '普通客户 A 类标准件 12%–15%' },
+        { id: 'p01-3', when: ['-', '"B"', '-'], then: [0.15, 0.2], annotation: 'B 类波动件 15%–20%' },
+        { id: 'p01-4', when: ['-', '"C"', '-'], then: [0.2, 0.5], annotation: 'C 类替代/EOL ≥20% 或一事一议' },
+        { id: 'p01-default', when: ['-', '-', '-'], then: [0.12, 0.15], annotation: '兜底按普通客户标准件' },
+      ],
+    },
+    {
+      /** 底价门禁 P-02 —— 偏离底价 ±20% 即止 */
+      id: 'p02-floor',
+      label: '底价门禁 P-02',
+      hitPolicy: 'FIRST',
+      inputs: [{ name: 'deviation', expression: 'deviation' }],
+      outputs: [{ name: 'disposition' }, { name: 'passable' }],
+      rules: [
+        { id: 'p02-1', when: ['>= 0'], then: ['直接放行', true], annotation: '≥底价 → 直接放行' },
+        { id: 'p02-2', when: ['[-0.20..0)'], then: ['PM 附理由放行', true], annotation: '低于底价 ≤20% → PM 附理由' },
+        { id: 'p02-3', when: ['< -0.20'], then: ['拦截 · BOSS 拍板', false], annotation: '低于底价 >20% → 拦截' },
+      ],
+    },
+  ],
+};
+
+export const manifest: ActivityManifest = {
+  identity: {
+    activityId: ACTIVITY_ID,
+    name: 'A4 · 成本定价',
+    packageVersion: '0.1.0',
+    category: '统一报价',
+    paradigm: 'flow',
+    sdkVersion: '0.1.0-m5',
+    checksum: 'dev-checksum-quote-pricing',
+  },
+
+  contract: {
+    activityId: ACTIVITY_ID,
+    version: '0.1.0',
+    input: {
+      data: {
+        type: 'object',
+        required: ['customerCode', 'records'],
+        properties: {
+          customerCode: { type: 'string' },
+          records: { type: 'array' },
+          // B/C 类由 A3/A2 交回的底价与替代方案;A 类直通时为空
+          floorPrices: { type: 'array' },
+        },
+      },
+      messageAllowed: true,
+    },
+    output: {
+      mandatory: [
+        {
+          name: 'draft',
+          payload: {
+            type: 'object',
+            required: ['items'],
+            properties: { items: { type: 'array' } },
+          },
+          description: '报价草案(逐条带偏离度)',
+        },
+      ],
+      selective: [],
+    },
+    requiredDeliverables: [{ key: 'quote-draft', label: '报价草案(全条目带偏离度)' }],
+    acceptanceCriteria: [
+      { key: 'all-priced', label: '每条都有拟报单价与毛利率', level: 'L1', predicate: 'unpriced = 0' },
+      // 底价门禁沉为 L2 机检 —— 「约束力收缩」的终点
+      { key: 'floor-gate', label: '偏离底价 ≤±20%,超限者已回调或注明理由', level: 'L2', modelRef: 'p02-floor' },
+      { key: 'pm-release', label: 'BD 放行', level: 'L5' },
+    ],
+    prohibitions: [
+      { key: 'no-silent-override', statement: '不得静默绕开 P-02 的结论;要破线只能走「人 · 决策」' },
+      { key: 'no-stale-floor', statement: '底价超一周未更新的,先刷底价再判' },
+    ],
+    authorization: {
+      discretion: [{ key: 'margin-band', statement: '在 P-01 给出的毛利区间内自决;出区间必须调人决策' }],
+      preauthorizedActions: [],
+      humanCallBudget: 2,
+    },
+    resources: {
+      tools: [{ name: 'crm.history-price-read' }],
+      skills: [],
+      models: ['quote-extractor'],
+      roles: ['BD'],
+      budget: { steps: 60, tokens: 150_000, activeMinutes: 120, humanCalls: 2 },
+    },
+  },
+
+  declarations: {
+    models: ['quote-extractor'],
+    tools: [{ name: 'crm.history-price-read' }],
+    ledger: [
+      {
+        domain: DOMAIN,
+        object: 'draft',
+        label: '报价草案',
+        fields: [
+          { name: 'pn', type: 'text', primaryKey: true, masked: false, label: 'PN' },
+          { name: 'quoted_price', type: 'number', primaryKey: false, masked: false, label: '拟报单价' },
+          { name: 'margin', type: 'number', primaryKey: false, masked: false, label: '毛利率' },
+          { name: 'deviation', type: 'number', primaryKey: false, masked: false, label: '偏离度' },
+          { name: 'disposition', type: 'text', primaryKey: false, masked: false, label: '门禁处置' },
+        ],
+      },
+    ],
+    listeners: [
+      {
+        origin: 'static',
+        eventType: 'human',
+        keyFilter: { kind: 'decision' },
+        semantic: 'complete-step',
+        deadline: 'PT4H',
+        escalation: ['nudge', 'escalate'],
+      },
+    ],
+    // SLA <2h(MVP示例 §1.2 留痕 · SLA)
+    harness: {
+      memoryWindow: 20,
+      stallAfter: 'PT2H',
+      nudge: [{ after: 'PT1H', action: 'nudge' }],
+      retry: { times: 2, backoff: 'PT30S' },
+    },
+  },
+
+  assets: {
+    businessModel: {
+      paradigm: 'flow',
+      steps: [
+        {
+          kind: 'tool',
+          name: 'S1_basis',
+          label: 'S1 取价基准',
+          // Type A 取历史价近期价;B/C 取供应商底价表(C 类参考替代对标表)
+          input: { pn: 'pn' },
+          output: { domain: DOMAIN, object: 'draft', fields: { deviation: 'deviation' } },
+          tool: 'crm.history-price-read',
+          failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
+        },
+        {
+          kind: 'pure-tool',
+          name: 'S2_price',
+          label: 'S2 逐条定价(DMN · 利润模型 P-01)',
+          input: { customerGrade: 'customerGrade', materialType: 'materialType', volumeTier: 'volumeTier' },
+          output: { domain: DOMAIN, object: 'draft', fields: { margin: 'marginLow', quoted_price: 'quotedPrice' } },
+          tool: 'quote-pricing.margin',
+          failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
+        },
+        {
+          kind: 'pure-tool',
+          name: 'S3_floor_gate',
+          label: 'S3 底价自检(DMN · 底价门禁 P-02)',
+          input: { deviation: 'deviation' },
+          output: { domain: DOMAIN, object: 'draft', fields: { disposition: 'disposition' } },
+          tool: 'quote-pricing.floor-gate',
+          failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
+        },
+        {
+          kind: 'human',
+          name: 'S4_decide_breach',
+          label: '超限条目:调人决策(回调还是注明理由)',
+          // 只有门禁不过才调人 —— 条件必谓词,零 LLM
+          when: 'breached > 0',
+          input: {},
+          workOrder: 'execution',
+          card: { title: '有条目低于底价 20% 以上,请裁决', fields: ['disposition', 'reason'] },
+          deadline: 'PT4H',
+          failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
+        },
+        {
+          kind: 'human',
+          name: 'S5_release',
+          label: 'S5 报价草案验收放行',
+          input: {},
+          workOrder: 'acceptance',
+          card: { title: '报价草案(全条目带偏离度)请验收', deliverable: 'quote-draft' },
+          deadline: 'P1D',
+          failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
+        },
+      ],
+      parallelGroups: [],
+    },
+    skills: [],
+    viewTemplates: [
+      {
+        name: 'pricing-summary',
+        html: '<div class="jc-card"><h3>报价草案</h3><p>已定价 <b data-slot="count"></b> 条</p></div>',
+      },
+    ],
+    cardSchemas: {},
+    distillHooks: [
+      {
+        on: 'terminal',
+        prompt: '归纳本单定价的经验:哪些组合的毛利档被人回调过、底价门禁拦下的形态、破线的理由。',
+      },
+    ],
+  },
+
+  samples: [
+    {
+      name: '战略客户 A 类大批量',
+      input: { customerCode: 'C001', records: [{ pn: 'LM358DR', type: 'A' }] },
+      expect: { ports: ['draft'] },
+    },
+  ],
+
+  entry: { file: 'index.js', checksum: 'dev-entry-quote-pricing' },
+};
@@ -0,0 +1 @@
+{ "name": "@activities/quote-sourcing", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }
@@ -0,0 +1,120 @@
+/**
+ * A3 渠道寻源的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
+ * 「说明书是 XML 的叙事投影,迭代时一起放行」(AM 3.1)。
+ */
+
+export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
+<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
+  <case id="sourcing">
+    <caseFileModel>
+      <caseFileItem id="inquiry" name="询价请求"/>
+      <caseFileItem id="supplier_quote" name="供应商回价单"/>
+      <caseFileItem id="compare_table" name="寻源比价表"/>
+    </caseFileModel>
+    <casePlanModel id="plan" name="渠道寻源" autoComplete="true">
+      <sentry id="s_inquiry">
+        <onPart id="op_inquiry" caseFileItemRef="inquiry"><standardEvent>create</standardEvent></onPart>
+      </sentry>
+      <sentry id="s_need_quote">
+        <onPart id="op_need" caseFileItemRef="inquiry"><standardEvent>update</standardEvent></onPart>
+        <ifPart id="if_need"><condition>needNewQuote = true</condition></ifPart>
+      </sentry>
+      <sentry id="s_channels">
+        <onPart id="op_ch" caseFileItemRef="inquiry"><standardEvent>update</standardEvent></onPart>
+        <ifPart id="if_ch"><condition>channelsPicked &gt;= 2</condition></ifPart>
+      </sentry>
+      <sentry id="s_quotes_in">
+        <onPart id="op_q" caseFileItemRef="supplier_quote"><standardEvent>create</standardEvent></onPart>
+      </sentry>
+      <sentry id="s_ready">
+        <onPart id="op_r" caseFileItemRef="compare_table"><standardEvent>create</standardEvent></onPart>
+      </sentry>
+
+      <stage id="S1" name="接需核史" autoComplete="true">
+        <entryCriterion id="ec_s1" sentryRef="s_inquiry"/>
+        <humanTask id="T_history" name="人工查历史报价">
+          <itemControl><manualActivationRule id="m_hist"/></itemControl>
+        </humanTask>
+        <decisionTask id="D_strategy" name="判定采用策略" decisionRef="sourcing-strategy">
+          <itemControl><manualActivationRule id="m_str"/></itemControl>
+        </decisionTask>
+      </stage>
+      <milestone id="M_strategy" name="策略已定"/>
+
+      <stage id="S2" name="选渠定策" autoComplete="true">
+        <entryCriterion id="ec_s2" sentryRef="s_need_quote"/>
+        <humanTask id="T_pick" name="人工按场景圈渠道">
+          <itemControl><manualActivationRule id="m_pick"/></itemControl>
+        </humanTask>
+        <planningTable id="pt_s2">
+          <humanTask id="T_verify_channel" name="人工渠道资质核实"/>
+        </planningTable>
+      </stage>
+      <milestone id="M_channels" name="渠道圈定"/>
+
+      <stage id="S3" name="发询比价" autoComplete="true">
+        <entryCriterion id="ec_s3" sentryRef="s_channels"/>
+        <humanTask id="T_send" name="人工批量发询">
+          <itemControl><manualActivationRule id="m_send"/><repetitionRule id="r_send"/></itemControl>
+        </humanTask>
+        <humanTask id="T_log_quote" name="人工登记回价">
+          <entryCriterion id="ec_log" sentryRef="s_quotes_in"/>
+          <itemControl><manualActivationRule id="m_log"/><repetitionRule id="r_log"/></itemControl>
+        </humanTask>
+        <humanTask id="T_verify_price" name="人工价格验证">
+          <itemControl><manualActivationRule id="m_vp"/><repetitionRule id="r_vp"/></itemControl>
+        </humanTask>
+        <planningTable id="pt_s3">
+          <humanTask id="T_chase" name="人工追价补询"/>
+        </planningTable>
+      </stage>
+      <milestone id="M_quotes" name="报价确认"/>
+
+      <stage id="S4" name="反馈交付" autoComplete="true">
+        <entryCriterion id="ec_s4" sentryRef="s_ready"/>
+        <humanTask id="T_fill_table" name="人工填寻源比价表">
+          <itemControl><manualActivationRule id="m_fill"/></itemControl>
+        </humanTask>
+        <planningTable id="pt_s4">
+          <humanTask id="T_order" name="人工下单与跟踪"/>
+        </planningTable>
+      </stage>
+      <milestone id="M_delivered" name="交付完成"/>
+
+      <humanTask id="T_knowledge" name="人工知识入库">
+        <itemControl><manualActivationRule id="m_kb"/></itemControl>
+      </humanTask>
+
+      <timerEventListener id="TL_deadline" name="时限预警">
+        <timerExpression>P4D</timerExpression>
+      </timerEventListener>
+      <timerEventListener id="TL_quote_expiry" name="回价到期">
+        <timerExpression>P7D</timerExpression>
+      </timerEventListener>
+    </casePlanModel>
+  </case>
+</definitions>`;
+
+export const NARRATIVE = `§0 开案:本案例覆盖四种询价场景 —— BOM早期、BOM后期、现货询价、样品询价。
+场景不同,供应商选择尺度与价格验证规则各异,但都遵循同一主线:
+PM 提交询价请求 → 查历史报价判定可否直采 →(须询价时)按场景圈渠道 → 发询验证 → 填入寻源比价表反馈。
+
+S1 接需核史:系统带出在供供应商与历史报价。先核历史,按场景规则逐 PN 判定是否可直接采用 ——
+可直采则跳过询价直接进入反馈交付;须新询价则进入选渠阶段。
+  · 查历史报价:未达 3 次询价但有效期已过的,标记须重询。
+  · 判定采用策略:BOM早期有效期内直采、过期浮动≤10%直采、10-20%取均价、>20%重询;
+    BOM后期历史最低(≥3次)直采,否则降 20% 谈;现货/样品一律重询。
+
+S2 选渠定策:BOM早期/样品渠道可放宽;BOM后期按主→备选→贸易商顺序圈 2~3 家,贸易商尽量不用;
+现货仅选有库存且可提供仓库实拍的供应商。渠道资质核实是「看情况」的裁量项。
+
+S3 发询比价:同一料所有渠道一次发齐;PN/数量/目标价/回价时限写死在询价里。
+回价逐单登记,一一对应不可缺项。价格验证因场景而异。回价异常或未应答则追价补询(裁量项)。
+
+S4 反馈交付:确认报价/LT/SPQ/有效期逐项填入寻源比价表,供 PM 直接查阅。
+现货/样品场景多一步下单与跟踪(裁量项)。
+
+全程随时可做:知识入库 —— 回价与成交沉淀历史价格情报,渠道表现回写供应商渠道目录。
+
+§Z 结案:必做的事都办完、没有进行中的事,自动算结案(CMMN AutoComplete)。
+寻源比价表交付 PM 即结案 —— 每询一轮,行情底账厚一层。`;
@@ -0,0 +1,59 @@
+/**
+ * 统一报价 A3 · 渠道寻源 —— 活动包代码入口(ADR-004)。
+ *
+ * **loop 活动**:下一步由 Agent 在案例模型的结构上临场决断,引擎只推进到 Enabled 为止。
+ * 本文件只做视图流控 —— 把阶段、里程碑与比价进展摆给人看。
+ */
+import { defineActivity } from '@sdk';
+import type { ActivityBase, ActivityOutcome } from '@sdk';
+
+const QUOTES = 'quote_sourcing.supplier_quote';
+const COMPARE = 'quote_sourcing.compare_table';
+
+export default defineActivity({
+  name: 'quote-sourcing',
+  paradigm: 'loop',
+
+  async run(base: ActivityBase): Promise<ActivityOutcome> {
+    const quotes = await base.ledger.read(QUOTES);
+    const compare = await base.ledger.read(COMPARE);
+    const suppliers = new Set(quotes.map((q) => String(q['supplier'] ?? '')));
+
+    await base.interaction.pushView([
+      {
+        t: 'kv',
+        title: '寻源进展',
+        items: [
+          { k: '场景', v: String(base.contract.data['scenario'] ?? '') },
+          { k: '已圈渠道', v: `${suppliers.size} 家` },
+          { k: '已收回价', v: `${quotes.length} 单` },
+          { k: '比价表', v: compare.length > 0 ? '已填' : '未填' },
+        ],
+      },
+      {
+        t: 'table',
+        title: '供应商回价',
+        cols: ['供应商', '回价', 'MOQ', '交期', '渠道等级'],
+        rows: quotes.map((q) => [
+          String(q['supplier'] ?? ''),
+          String(q['price'] ?? '—'),
+          String(q['moq'] ?? '—'),
+          String(q['lead_time'] ?? '—'),
+          String(q['grade'] ?? '—'),
+        ]),
+      },
+    ]);
+
+    if (compare.length === 0) {
+      // 交集为空即断点 —— 由引擎判定、Agent 定夺调人还是立监听,这里不代它决定
+      await base.interaction.say(
+        suppliers.size === 0 ? '尚未圈定渠道,先按场景定策。' : `已收 ${quotes.length} 单回价,待填寻源比价表。`,
+        'conclusion',
+      );
+      return { kind: 'await', reason: '寻源比价表未交付' };
+    }
+
+    await base.interaction.say('寻源比价表已填齐,可交回 PM。', 'criterion');
+    return { kind: 'submit', deliverable: 'compare-table', rationale: '每料有有效报价或明确无货' };
+  },
+});
@@ -0,0 +1,187 @@
+/**
+ * 活动包清单 —— 统一报价 A3 · 渠道寻源(**案例活动 · loop**)。
+ *
+ * 业务素材:docs/MVP示例工作流.html §1.5。按 README《归一化对照表》映射:
+ *   案例图 → CMMN XML;案例说明书 → 同版本叙事面;
+ *   `!必做` → entryCriterion 常项;`看情况` → discretionary(planningTable);
+ *   `#可反复` → repetitionRule;`▶需拍板` → manualActivation + 放行;
+ *   `⏱时限/回价到期` → 时间监听(**时限必配**)。
+ */
+import type { ActivityManifest, DmnModel } from '@contracts';
+import { activityIdSchema } from '@contracts';
+import { CMMN_XML, NARRATIVE } from './case-model.ts';
+
+const DOMAIN = 'quote_sourcing';
+const ACTIVITY_ID = activityIdSchema.parse('quote-sourcing');
+
+/** 采用策略 —— 「能算的不问 LLM」:场景 × 历史情形 → 直采 / 重询 */
+export const STRATEGY_DMN: DmnModel = {
+  drd: [{ decision: 'sourcing-strategy', requires: [], inputs: ['scenario', 'priceDrift', 'quoteCount'] }],
+  tables: [
+    {
+      id: 'sourcing-strategy',
+      label: '采用策略判定',
+      hitPolicy: 'FIRST',
+      inputs: [
+        { name: 'scenario', expression: 'scenario' },
+        { name: 'priceDrift', expression: 'priceDrift' },
+        { name: 'quoteCount', expression: 'quoteCount' },
+      ],
+      outputs: [{ name: 'strategy' }, { name: 'needNewQuote' }],
+      rules: [
+        { id: 'st-spot', when: ['"现货","样品"', '-', '-'], then: ['一律重询', true] },
+        { id: 'st-early-direct', when: ['"BOM早期"', '<= 0.10', '-'], then: ['直采', false] },
+        { id: 'st-early-avg', when: ['"BOM早期"', '[0.10..0.20]', '-'], then: ['取均价', false] },
+        { id: 'st-late-direct', when: ['"BOM后期"', '-', '>= 3'], then: ['历史最低直采', false] },
+        { id: 'st-default', when: ['-', '-', '-'], then: ['重询', true] },
+      ],
+    },
+  ],
+};
+
+export const manifest: ActivityManifest = {
+  identity: {
+    activityId: ACTIVITY_ID,
+    name: 'A3 · 渠道寻源',
+    packageVersion: '0.1.0',
+    category: '统一报价',
+    paradigm: 'loop',
+    sdkVersion: '0.1.0-m5',
+    checksum: 'dev-checksum-quote-sourcing',
+  },
+
+  contract: {
+    activityId: ACTIVITY_ID,
+    version: '0.1.0',
+    input: {
+      data: {
+        type: 'object',
+        required: ['pn', 'scenario'],
+        properties: {
+          pn: { type: 'string' },
+          scenario: { type: 'string' },
+          quantity: { type: 'integer' },
+          targetPrice: { type: 'number' },
+        },
+      },
+      messageAllowed: true,
+      messageHint: '急料、客户特殊要求写这里',
+    },
+    output: {
+      mandatory: [
+        {
+          name: 'compare',
+          payload: { type: 'object', required: ['rows'], properties: { rows: { type: 'array' } } },
+          description: '寻源比价表(多渠道横比定底)',
+        },
+      ],
+      selective: [],
+    },
+    requiredDeliverables: [{ key: 'compare-table', label: '寻源比价表' }],
+    acceptanceCriteria: [
+      { key: 'each-has-quote', label: '每料有有效报价或明确无货', level: 'L2', predicate: 'unquoted = 0' },
+      { key: 'channels-enough', label: 'BOM后期每料 2~3 家渠道', level: 'L2', predicate: 'channelsPicked >= 2' },
+      { key: 'cross-check', label: '价格验证按场景规则做过', level: 'L3' },
+      { key: 'prm-release', label: '采购放行', level: 'L5' },
+    ],
+    prohibitions: [
+      { key: 'no-stockless-trader', statement: '现货场景不得选无库存转单商' },
+      { key: 'no-unverified', statement: '不实回价或远低行情的,必须换渠道补询,不得直接采用' },
+    ],
+    authorization: {
+      discretion: [{ key: 'channel-band', statement: '按场景放宽或收紧渠道尺度;贸易商尽量不用' }],
+      preauthorizedActions: [{ tool: 'mail.send', operation: 'inquiry', limit: '询价模板' }],
+      humanCallBudget: 8,
+    },
+    resources: {
+      tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
+      skills: [],
+      models: ['quote-extractor'],
+      roles: ['PRM'],
+      budget: { steps: 120, tokens: 300_000, activeMinutes: 480, humanCalls: 8 },
+    },
+  },
+
+  declarations: {
+    models: ['quote-extractor'],
+    tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
+    ledger: [
+      {
+        domain: DOMAIN,
+        object: 'supplier_quote',
+        label: '供应商回价单',
+        fields: [
+          { name: 'pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'supplier', type: 'text', primaryKey: true, masked: false, label: '供应商' },
+          { name: 'price', type: 'number', primaryKey: false, masked: false, label: '回价' },
+          { name: 'moq', type: 'integer', primaryKey: false, masked: false, label: 'MOQ' },
+          { name: 'lead_time', type: 'text', primaryKey: false, masked: false, label: '交期' },
+          { name: 'valid_until', type: 'date', primaryKey: false, masked: false, label: '有效期' },
+          { name: 'grade', type: 'text', primaryKey: false, masked: false, label: '渠道等级' },
+        ],
+      },
+      {
+        domain: DOMAIN,
+        object: 'compare_table',
+        label: '寻源比价表',
+        fields: [
+          { name: 'pn', type: 'text', primaryKey: true, masked: false },
+          { name: 'supplier', type: 'text', primaryKey: false, masked: false },
+          { name: 'price', type: 'number', primaryKey: false, masked: false },
+          { name: 'conclusion', type: 'text', primaryKey: false, masked: false, label: '结论' },
+        ],
+      },
+    ],
+    listeners: [
+      {
+        // 回价到期:临过期提醒复核确认,过期触发重询 —— 时限必配
+        origin: 'static',
+        eventType: 'data',
+        keyFilter: { kind: 'supplier-quote' },
+        semantic: 'observe',
+        deadline: 'P4D',
+        escalation: ['nudge', 'escalate'],
+      },
+      {
+        origin: 'static',
+        eventType: 'time',
+        keyFilter: { kind: 'quote-expiry' },
+        semantic: 'observe',
+        deadline: 'P7D',
+        escalation: ['nudge', 'reroute'],
+      },
+    ],
+    // 按场景时限:BOM早期/现货 1~4 日、样品 1~3 日、BOM后期 3~9 日 —— 取最宽做停滞阈值
+    harness: {
+      memoryWindow: 30,
+      stallAfter: 'P2D',
+      nudge: [{ after: 'P1D', action: 'nudge' }],
+      retry: { times: 2, backoff: 'PT5M' },
+    },
+  },
+
+  assets: {
+    businessModel: {
+      paradigm: 'loop',
+      cmmnXml: CMMN_XML,
+      // 双表示同版本:XML 是机器面,说明书是叙事面 —— 不允许分叉
+      narrative: NARRATIVE,
+      dmn: STRATEGY_DMN,
+    },
+    skills: [],
+    viewTemplates: [
+      { name: 'sourcing-board', html: '<div class="jc-card"><h3>寻源看板</h3><p data-slot="stage"></p></div>' },
+    ],
+    cardSchemas: {},
+    distillHooks: [
+      { on: 'milestone', milestone: 'M_quotes', prompt: '归纳各渠道的回价节奏与配合度。' },
+      { on: 'terminal', prompt: '归纳本单寻源:哪些渠道靠谱、哪些场景的价格验证规则该收紧。' },
+    ],
+  },
+
+  samples: [
+    { name: 'BOM后期询价', input: { pn: 'LM358DR', scenario: 'BOM后期', quantity: 5000 }, expect: { ports: ['compare'] } },
+  ],
+
+  entry: { file: 'index.js', checksum: 'dev-entry-quote-sourcing' },
+};
				`@@ -0,0 +1 @@`
				`{ "name": "@activities/quote-alternative", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }`
				`@@ -0,0 +1 @@`
				`{ "name": "@activities/quote-archive", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }`
				`@@ -0,0 +1 @@`
				`{ "name": "@activities/quote-negotiate", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }`
				`@@ -0,0 +1 @@`
				`{ "name": "@activities/quote-pricing", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }`
				`@@ -0,0 +1 @@`
				`{ "name": "@activities/quote-sourcing", "version": "0.1.0", "private": true, "type": "module", "exports": { ".": "./src/index.ts" } }`