From d03fed97d25e0592fbc6ac5d8148c5588166994d Mon Sep 17 00:00:00 2001
From: shanqin <45168502@qq.com>
Date: Thu, 27 Aug 2026 10:31:50 +0800
Subject: [PATCH 1/2] =?UTF-8?q?=E8=BF=9B=E5=BA=A6=E6=9A=82=E5=AD=98:L2=20?=
 =?UTF-8?q?=E5=90=AF=E5=8A=A8=E6=B4=BB=E5=8A=A8=E6=8C=89=E9=92=AE=E6=8E=A5?=
 =?UTF-8?q?=E5=8A=9F=E8=83=BD=20=E2=80=94=E2=80=94=20=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E6=8A=BD=E5=B1=89(LaunchDrawer)=E6=8C=89=E8=A7=84=E6=A0=BC?=
 =?UTF-8?q?=E6=B8=B2=E6=9F=93,=E5=8D=A0=E4=BD=8D=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E8=A1=A8=E6=AF=8F=E6=B4=BB=E5=8A=A8=E4=B8=80=E4=BB=BD,?=
 =?UTF-8?q?=E6=8F=90=E4=BA=A4=E8=90=BD=E3=80=8C=E5=BE=85=E6=89=A7=E8=A1=8C?=
 =?UTF-8?q?=E3=80=8D=E6=BC=94=E7=A4=BA=E8=A1=8C;=E9=9C=80=E6=B1=82?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AE=B0=202026-08-27=20=E5=86=B3=E7=AD=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/src/app/styles/console.css           |  15 ++
 .../src/features/gov-task/internal/panel.tsx  | 215 +++++++++++++++++-
 docs/活动模块重构需求-2026-08-25.md           |   1 +
 3 files changed, 227 insertions(+), 4 deletions(-)

diff --git a/apps/web/src/app/styles/console.css b/apps/web/src/app/styles/console.css
index af59d72..0feef15 100644
--- a/apps/web/src/app/styles/console.css
+++ b/apps/web/src/app/styles/console.css
@@ -735,6 +735,21 @@
 @media (prefers-reduced-motion: reduce) {
   .g-actvd .g-popask, .g-actid .g-popask { animation: none; }
 }
+
+/* ══ 启动活动 · 参数抽屉(2026-08-27 用户定)══
+   骨架复用全局 g-drawer;portal 挂在 body 上,作用域类 .g-launch 得自己带着走。
+   这里只补抽屉内表单特有的三件:必填星号、数组参数(list)编辑行、底注 */
+.g-launch .g-fld > span .req { font-style: normal; margin-left: 3px; color: var(--danger-accent); }
+/* 数组参数:一行一条 + 行尾删除,底下虚线「再加一项」—— 可传多个的参数(如候选 PN)的趁手件 */
+.g-lplist { display: grid; gap: 7px; }
+.g-lplist-row { display: flex; align-items: center; gap: 7px; }
+.g-lplist-row .g-input { flex: 1; min-width: 0; }
+.g-lplist-row .x { flex: none; width: 32px; height: 32px; display: grid; place-items: center; border: 1px solid var(--line); border-radius: 8px; background: #fff; color: var(--ink-4); cursor: pointer; transition: color var(--t-fast), border-color var(--t-fast); }
+.g-lplist-row .x:hover:not(:disabled) { color: var(--danger-accent); border-color: var(--danger-accent); }
+.g-lplist-row .x:disabled { opacity: .38; cursor: not-allowed; }
+.g-lplist-add { justify-self: start; display: inline-flex; align-items: center; gap: 6px; height: 30px; padding: 0 12px; border: 1px dashed var(--cline); border-radius: 8px; background: transparent; color: var(--ink-3); font: inherit; font-size: 12px; font-weight: 600; cursor: pointer; transition: color var(--t-fast), border-color var(--t-fast); }
+.g-lplist-add:hover { color: var(--brand); border-color: var(--brand); }
+.g-launch-hint { margin: 13px 0 0; font-size: 11.5px; line-height: 1.6; color: var(--ink-4); }
 .g-fcard .mbtn { flex: none; width: 26px; height: 26px; display: grid; place-items: center; border: 1px solid transparent; border-radius: 7px; background: transparent; color: var(--ink-4); cursor: pointer; }
 .g-fcard .mbtn:hover, .g-fcard .mbtn.on { border-color: var(--cline); background: #f3f6fa; color: var(--ink); }
 .g-fcard .mbtn.bad:hover { border-color: #e6c4c4; background: #fdf2f2; color: var(--danger); }
diff --git a/apps/web/src/features/gov-task/internal/panel.tsx b/apps/web/src/features/gov-task/internal/panel.tsx
index 83981ec..f0030fd 100644
--- a/apps/web/src/features/gov-task/internal/panel.tsx
+++ b/apps/web/src/features/gov-task/internal/panel.tsx
@@ -5,7 +5,8 @@
  * DOM 结构、类名(`g-*` + 色调 `t-*`)与文案原样保留,mock 常量换成服务端投影(README 平移规则 1/2/4)。
  * 区首页只负责导航,治理动作一律落在下钻详情页的**就地确认带**(影响预览三必答)。
  */
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
 import { useMutation, useQueryClient } from '@tanstack/react-query';
 import {
   CONTROL_SEMANTIC_LABEL,
@@ -313,13 +314,193 @@ function PopAsk({ spec, onCancel }: { spec: PopAskSpec; onCancel: () => void })
   );
 }
 
+/* ── 启动活动 · 参数抽屉(2026-08-27 用户定)────────────────────────────
+   点「启动活动」弹抽屉填启动参数:**参数表由服务端按活动下发**(参数名/中文名/控件种类/必填/描述),
+   每个活动要的参数不一样 —— 前端只按规格渲染,不写死字段;
+   接口未落地前用 LAUNCH_PARAMS 占位,提交先在清单头落一条「待执行」看全链路效果 */
+
+/** 启动参数的一项规格 —— 将来就是接口返回的参数表行 */
+type LaunchParam = {
+  /** 提交给接口的字段名 */
+  key: string;
+  /** 表单上的中文名 */
+  label: string;
+  /** 控件种类:text 单行 / textarea 多行 / select 单选 / list 字符串数组(一次可传多个) */
+  type: 'text' | 'textarea' | 'select' | 'list';
+  required?: boolean;
+  /** 参数描述(服务端给),挂在控件下当辅助说明 */
+  desc?: string;
+  placeholder?: string;
+  /** select 的候选项 */
+  options?: readonly string[];
+};
+
+/** 占位参数表 —— 一活动一份,接口定稿后按活动取(2026-08-27 用户定:参数由服务器给,每个活动不一样) */
+const LAUNCH_PARAMS: Readonly<Record<string, readonly LaunchParam[]>> = {
+  /* 极简四参(2026-08-26《一键启动入参说明》口径:客户/需求/原PN/候选PN数组,其余启动后进工单补) */
+  'quote-intake': [
+    { key: 'customer_id', label: '客户', type: 'select', required: true, desc: '决定通知对象与默认负责人线。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
+    { key: 'request_description', label: '客户需求', type: 'textarea', required: true, desc: '保留原始需求语义,据此新建需求主记录(V1)。', placeholder: '如:车身控制器询价 · 3 项物料,期望 9 月交期' },
+    { key: 'original_internal_pn', label: '原内部料号', type: 'select', required: true, desc: '差异评估基准,引用物料台账。', options: ['PN-880101', 'PN-880205', 'PN-880310'] },
+    { key: 'candidate_internal_pn', label: '候选内部料号', type: 'list', required: true, desc: '被评估物料,一次可传多个、逐个评估 —— 至少 1 个。', placeholder: '如 PN-880412' },
+  ],
+  'quote-pricing': [
+    { key: 'quote_id', label: '询价单号', type: 'text', required: true, desc: '针对哪一张询价单做测算。', placeholder: '如 INS-2415' },
+    { key: 'strategy', label: '计价策略', type: 'select', required: true, desc: '测算走哪套成本模型。', options: ['成本加成', '市场竞争', '历史跟随'] },
+    { key: 'target_margin', label: '目标毛利率', type: 'text', desc: '选填,留空按客户线默认。', placeholder: '如 18%' },
+  ],
+  'crm-coverage': [
+    { key: 'customer_id', label: '客户', type: 'select', required: true, desc: '为哪家客户排触达计划。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
+    { key: 'cadence', label: '触达节奏', type: 'select', required: true, desc: '关键人触达的排期密度。', options: ['每周', '双周', '每月'] },
+    { key: 'note', label: '补充说明', type: 'textarea', desc: '选填。' },
+  ],
+  'competitor-watch': [
+    { key: 'rival_pn', label: '竞品型号', type: 'text', required: true, desc: '监测哪个竞品料号的价格动向。', placeholder: '如 Bosch-0261S04' },
+    { key: 'window', label: '监测窗口', type: 'select', required: true, desc: '往回拉多长时间的价格数据。', options: ['7 天', '30 天', '90 天'] },
+  ],
+  'market-weekly': [
+    { key: 'region', label: '覆盖区域', type: 'text', required: true, desc: '周报覆盖的市场区域。', placeholder: '如 东欧 · 商用车' },
+    { key: 'window', label: '数据窗口', type: 'select', required: true, desc: '汇总哪个时间跨度的信号。', options: ['自然周', '自然月'] },
+  ],
+  'supplier-verify': [
+    { key: 'supplier', label: '供应商名称', type: 'text', required: true, desc: '核验哪家供应商的资质。', placeholder: '如 深圳某某电子有限公司' },
+    { key: 'note', label: '资质说明', type: 'textarea', desc: '选填 —— 已有的资质线索先记下来,核验时对照。' },
+  ],
+};
+
+/** 没在表里占位的活动给一份最小通用参数 —— 接口落地后不会有这条路 */
+const LAUNCH_PARAMS_FALLBACK: readonly LaunchParam[] = [
+  { key: 'subject', label: '启动事项', type: 'text', required: true, desc: '这次启动要处理什么,一句话。' },
+  { key: 'note', label: '补充说明', type: 'textarea', desc: '选填。' },
+];
+
+type LaunchValues = Record<string, string | string[]>;
+
+/** 参数值初始形:list 先摆一行空行(至少一行),其余空串 */
+function initLaunchValues(spec: readonly LaunchParam[]): LaunchValues {
+  const v: LaunchValues = {};
+  for (const p of spec) v[p.key] = p.type === 'list' ? [''] : '';
+  return v;
+}
+
+/** 这一项算不算填了 —— list 至少一行非空,其余非空串 */
+function paramFilled(p: LaunchParam, v: string | string[]): boolean {
+  return p.type === 'list' ? (v as string[]).some((s) => s.trim() !== '') : (v as string).trim() !== '';
+}
+
+/**
+ * 启动抽屉 —— 复用全局 `g-drawer` 骨架(与系统区模型抽屉同一副);
+ * 挂 body portal:详情页容器带入场动画 transform,fixed 抽屉不 portal 会被钉进卡片盒子里(2026-07-30 实测);
+ * `gov-root` 类必须跟着挂:设计令牌定义在它上面,出了作用域面板背景会变透明。
+ */
+function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec: readonly LaunchParam[]; onCancel: () => void; onLaunch: (values: LaunchValues) => void }) {
+  const [values, setValues] = useState<LaunchValues>(() => initLaunchValues(spec));
+  /* Esc 关抽屉 —— 抽屉盖住整屏,不给键盘出路是把人关在里面 */
+  useEffect(() => {
+    const onKey = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') onCancel();
+    };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [onCancel]);
+
+  const setVal = (key: string, v: string | string[]) => setValues((cur) => ({ ...cur, [key]: v }));
+  const invalid = spec.some((p) => p.required === true && !paramFilled(p, values[p.key] ?? ''));
+
+  return createPortal(
+    <div className="gov-root g-drawer g-launch" role="dialog" aria-modal="true" aria-label={`启动活动 · ${name}`}>
+      <button className="g-drawer-veil" aria-label="关闭" onClick={onCancel} />
+      <div className="g-drawer-p">
+        <header>
+          <div>
+            <b>启动活动 · {name}</b>
+            <span>参数表由服务端按活动下发 —— 每个活动要的不一样;带 * 必填</span>
+          </div>
+          <button className="x" aria-label="关闭" onClick={onCancel}>
+            <Ico name="x" s={15} />
+          </button>
+        </header>
+
+        <div className="g-drawer-b">
+          <section>
+            <h4>启动参数</h4>
+            {spec.map((p) => (
+              <label key={p.key} className="g-fld">
+                <span>
+                  {p.label}
+                  {p.required === true && <i className="req">*</i>}
+                </span>
+                {p.type === 'text' && (
+                  <input className="g-input" value={values[p.key] as string} placeholder={p.placeholder} onChange={(e) => setVal(p.key, e.target.value)} />
+                )}
+                {p.type === 'textarea' && (
+                  <textarea className="g-ta" value={values[p.key] as string} placeholder={p.placeholder} onChange={(e) => setVal(p.key, e.target.value)} />
+                )}
+                {p.type === 'select' && (
+                  <select className="g-select" value={values[p.key] as string} onChange={(e) => setVal(p.key, e.target.value)}>
+                    <option value="">请选择…</option>
+                    {(p.options ?? []).map((o) => (
+                      <option key={o} value={o}>
+                        {o}
+                      </option>
+                    ))}
+                  </select>
+                )}
+                {p.type === 'list' && (
+                  <span className="g-lplist">
+                    {(values[p.key] as string[]).map((v, i, arr) => (
+                      <span key={i} className="g-lplist-row">
+                        <input
+                          className="g-input mono"
+                          value={v}
+                          placeholder={p.placeholder}
+                          aria-label={`${p.label} 第 ${i + 1} 项`}
+                          onChange={(e) => setVal(p.key, arr.map((x, j) => (j === i ? e.target.value : x)))}
+                        />
+                        <button
+                          type="button"
+                          className="x"
+                          aria-label={`删除第 ${i + 1} 项`}
+                          disabled={arr.length <= 1}
+                          onClick={() => setVal(p.key, arr.filter((_, j) => j !== i))}
+                        >
+                          <Ico name="x" s={13} />
+                        </button>
+                      </span>
+                    ))}
+                    <button type="button" className="g-lplist-add" onClick={() => setVal(p.key, [...(values[p.key] as string[]), ''])}>
+                      <Ico name="plus" s={12} /> 再加一项
+                    </button>
+                  </span>
+                )}
+                {p.desc !== undefined && <small>{p.desc}</small>}
+              </label>
+            ))}
+            <p className="g-launch-hint">本期为占位参数表(接口未接);提交走启动接口 —— 现在先在历史活动清单头落一条「待执行」看效果。</p>
+          </section>
+        </div>
+
+        <footer>
+          <Btn className="g-btn" onClick={onCancel}>
+            取消
+          </Btn>
+          <Btn className="g-btn primary" disabled={invalid} onClick={() => onLaunch(values)}>
+            <Ico name="play" s={12} /> 启动活动
+          </Btn>
+        </footer>
+      </div>
+    </div>,
+    document.body,
+  );
+}
+
 /**
  * L2 · 活动详情 —— 两个问题一屏答:「这个活动是什么」(定义,只读)
  * 与「它跑得怎么样」(小统计 + 实例清单,点行进 L3)。
  *
- * 头部动作三个(2026-08-25 用户定):
+ * 头部动作两个(2026-08-27 更新):
  *   · 激活/禁用 —— 本期做交互,二次确认;**有实例时无法禁用**(规则来自接口,本期前端占位演示);
- *   · 启动活动(即创建实例)/ 版本迭代 —— 只留入口,功能后做(disabled)。
+ *   · 启动活动(即创建实例)—— 弹参数抽屉(LaunchDrawer),参数表按活动下发;已禁用不能启动。
  *
  * 沙箱区:加载服务器返回的活动视图 HTML ——  iframe + sandbox 隔离;
  * v1 静态占位页,src 与内容高度通讯(postMessage)待接口一起定。
@@ -341,6 +522,9 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
   const [fTo, setFTo] = useState('');
   /* 轻量二次确认(2026-08-26 用户定):一句话 + 确认/取消的气泡,不走 AskBand 三必答 */
   const [ask, setAsk] = useState<PopAskSpec | null>(null);
+  /* 启动抽屉(2026-08-27 用户定):launchN 给占位新实例编流水号 */
+  const [launch, setLaunch] = useState(false);
+  const [launchN, setLaunchN] = useState(0);
   if (a === undefined) return <Note tone="warn">活动不存在 —— 它可能已被调整,返回活动清单看看。</Note>;
   const st = status ?? a.status;
   const instances = rows ?? demoInstances(a.owner);
@@ -379,6 +563,27 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
     setFTo('');
     setPage(0);
   };
+  /** 启动提交(2026-08-27):启动接口未接 —— 先在清单头落一条「待执行」演示全链路;
+     输入摘要取第一个填了值的参数,让人认得出这是刚启动的那条 */
+  const launchSpec = LAUNCH_PARAMS[a.id] ?? LAUNCH_PARAMS_FALLBACK;
+  const onLaunch = (values: LaunchValues): void => {
+    const first = launchSpec.map((p) => values[p.key]).flat().find((v): v is string => typeof v === 'string' && v.trim() !== '');
+    setRows((cur) => [
+      {
+        id: `INS-${2418 + launchN}`,
+        input: `${(first ?? '手动启动').trim().slice(0, 24)} · ${launchSpec.length} 项参数`,
+        state: '待执行' as InstanceState,
+        owner: a.owner,
+        startedAt: fmtMinute(Date.now()),
+        output: '—',
+      },
+      ...(cur ?? demoInstances(a.owner)),
+    ]);
+    setLaunchN((n) => n + 1);
+    setLaunch(false);
+    /* 正筛着别的条件时新行可能直接被滤没 —— 启动完清掉检索,让人一眼看到它 */
+    clearFilter();
+  };
   /* 分页(2026-08-25 用户定:单页最多 8 条)—— 检索后按筛出的集合翻页 */
   const pageCount = Math.max(1, Math.ceil(filtered.length / INSTANCE_PAGE_SIZE));
   const cur = Math.min(page, pageCount - 1);
@@ -438,13 +643,15 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
                       },
                     }),
                 },
-            { label: '启动活动', ico: 'plus', disabled: true },
+            /* 启动活动(2026-08-27 接):弹参数抽屉填参启动;已禁用不能启动 —— 先激活,再启动 */
+            { label: '启动活动', ico: 'play', primary: st === 'active', disabled: st !== 'active', onClick: () => setLaunch(true) },
             /* 版本迭代入口先隐藏(2026-08-25 用户定):功能设计回头讨论,要做时把这行加回 acts
             { label: '版本迭代', ico: 'git-branch', disabled: true },
             */
           ]}
         />
         {ask !== null && <PopAsk spec={ask} onCancel={() => setAsk(null)} />}
+        {launch && <LaunchDrawer name={a.name} spec={launchSpec} onCancel={() => setLaunch(false)} onLaunch={onLaunch} />}
       </div>
       {blocked && (
         <Note tone="warn">
diff --git a/docs/活动模块重构需求-2026-08-25.md b/docs/活动模块重构需求-2026-08-25.md
index 13d117e..bd948b1 100644
--- a/docs/活动模块重构需求-2026-08-25.md
+++ b/docs/活动模块重构需求-2026-08-25.md
@@ -92,6 +92,7 @@ L1（模块首页 · 活动清单）需要一个**标签页**切换，因为活
 - 2026-08-26 · **L3 实例详情已落地（静态占位版，用户确认规划后实施）**：路由 `acti`（id = `活动id:实例号`），L2 行内「查看详情」接入。布局 = 主从 2:1（DESIGN-SPEC §9）：左侧「动作过程记录」竖时间线是主角（五步节点流：输入接收 → 要素结构化 → 定价测算 → **负责人验收** → 输出归档 —— 验收永远留给人，对应人机分工），当前步呼吸高亮、未到达空心灰显、连接线成不间断竖轨；右栏输入（键值）/ 输出（文件行，下载随接口开放）。头部 = 状态丸 + 负责人/启动/结束·耗时/专属 LLM；驳回/失败出原因说明块；终止后的过程面与「自己跑挂」区分：当前步记「已终止」而非失败原因。数据仍是静态假数据。
 - 2026-08-26 · **实例不可删除、不可编辑（用户定，推翻 L3 原规划）**：L3 的编辑/删除入口撤掉，唯一动作是进行中的「终止活动」（二次确认）；六功能里实例的「编辑/删除」两项就此划掉，待确认问题里的两条（编辑指什么 / 删除是否放开）同时关闭。
 - 2026-08-26 · **二次确认的规格（用户定）**：活动模块的确认走**轻气泡**（锚在触发钮下方的小泡泡，只问一句 + 确认/取消，点罩即取消）—— 不摆影响三必答；三必答（AskBand）是治理台重度动作的规格，别处的确认带暂不动。
+- 2026-08-27 · **「启动活动」按钮接功能（用户定）**：L2 头部「启动活动」不再占位 —— 点击弹**参数抽屉**（复用全局 `g-drawer` 右抽屉骨架），填启动参数后启动。**参数表由服务端按活动下发**（参数名 / 中文名 / 控件种类 / 必填 / 描述），每个活动要的参数不一样，前端只按规格渲染不写死字段；控件种类已支持单行 / 多行 / 单选 / 字符串数组（可传多个，如候选 PN）。接口未落地前用 `LAUNCH_PARAMS` 占位表（询价接收与结构化 = 入参说明的极简四参），提交先在历史活动清单头落一条「待执行」演示全链路，接口对接后换启动 mutation。**已禁用的活动不能启动**（钮置灰，先激活再启动）。
 
 ## 三、功能表（整理稿）
 

From 723d379dbd659b64355e959d4b92dacc84f80b92 Mon Sep 17 00:00:00 2001
From: shanqin <45168502@qq.com>
Date: Thu, 27 Aug 2026 11:15:21 +0800
Subject: [PATCH 2/2] =?UTF-8?q?=E8=BF=9B=E5=BA=A6=E6=9A=82=E5=AD=98:?=
 =?UTF-8?q?=E7=A6=81=E7=94=A8=E8=A7=84=E5=88=99=E9=87=8D=E5=AE=9A(?=
 =?UTF-8?q?=E4=BB=BB=E4=BD=95=E6=97=B6=E5=88=BB=E5=8F=AF=E7=A6=81=E7=94=A8?=
 =?UTF-8?q?,=E5=8F=AA=E6=8B=A6=E6=96=B0=E5=90=AF=E5=8A=A8)+=20=E5=90=AF?=
 =?UTF-8?q?=E5=8A=A8=E5=8F=82=E6=95=B0=E5=8A=A0=20combo=20=E6=8E=A7?=
 =?UTF-8?q?=E4=BB=B6(=E9=80=89=E6=8B=A9+=E6=96=B0=E5=A2=9E,=E5=BA=93?=
 =?UTF-8?q?=E9=87=8C=E6=B2=A1=E6=9C=89=E4=B8=8D=E6=8B=A6=E5=90=AF=E5=8A=A8?=
 =?UTF-8?q?=E3=80=81=E5=90=AF=E5=8A=A8=E5=90=8E=E6=B4=BE=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E5=B7=A5=E5=8D=95);=E6=96=B0=E5=A2=9E=E3=80=8AAPI=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3-=E6=B4=BB=E5=8A=A8=E6=A8=A1=E5=9D=97=E3=80=8B(L1/L2/L?=
 =?UTF-8?q?3=20=E4=B9=9D=E6=9D=A1=E8=B7=AF=E7=94=B1,=E4=BE=9B=E5=90=8E?=
 =?UTF-8?q?=E7=AB=AF=E7=BC=96=E5=86=99)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/src/app/styles/console.css           |   5 +
 .../src/features/gov-task/internal/panel.tsx  |  96 +++--
 docs/API文档-活动模块.md                      | 337 ++++++++++++++++++
 docs/活动模块重构需求-2026-08-25.md           |   4 +-
 4 files changed, 413 insertions(+), 29 deletions(-)
 create mode 100644 docs/API文档-活动模块.md

diff --git a/apps/web/src/app/styles/console.css b/apps/web/src/app/styles/console.css
index 0feef15..da7371c 100644
--- a/apps/web/src/app/styles/console.css
+++ b/apps/web/src/app/styles/console.css
@@ -750,6 +750,11 @@
 .g-lplist-add { justify-self: start; display: inline-flex; align-items: center; gap: 6px; height: 30px; padding: 0 12px; border: 1px dashed var(--cline); border-radius: 8px; background: transparent; color: var(--ink-3); font: inherit; font-size: 12px; font-weight: 600; cursor: pointer; transition: color var(--t-fast), border-color var(--t-fast); }
 .g-lplist-add:hover { color: var(--brand); border-color: var(--brand); }
 .g-launch-hint { margin: 13px 0 0; font-size: 11.5px; line-height: 1.6; color: var(--ink-4); }
+/* combo 选择+新增(2026-08-27 用户定):新增态 = 输入框 + 右侧「返回选择」链 */
+.g-launch .g-combo { display: flex; align-items: center; gap: 7px; }
+.g-launch .g-combo .g-input { flex: 1; min-width: 0; }
+.g-launch .g-combo-back { flex: none; padding: 4px 6px; border: 0; border-radius: 6px; background: transparent; color: var(--brand); font: inherit; font-size: 12px; font-weight: 600; cursor: pointer; }
+.g-launch .g-combo-back:hover { text-decoration: underline; }
 .g-fcard .mbtn { flex: none; width: 26px; height: 26px; display: grid; place-items: center; border: 1px solid transparent; border-radius: 7px; background: transparent; color: var(--ink-4); cursor: pointer; }
 .g-fcard .mbtn:hover, .g-fcard .mbtn.on { border-color: var(--cline); background: #f3f6fa; color: var(--ink); }
 .g-fcard .mbtn.bad:hover { border-color: #e6c4c4; background: #fdf2f2; color: var(--danger); }
diff --git a/apps/web/src/features/gov-task/internal/panel.tsx b/apps/web/src/features/gov-task/internal/panel.tsx
index f0030fd..22d77b0 100644
--- a/apps/web/src/features/gov-task/internal/panel.tsx
+++ b/apps/web/src/features/gov-task/internal/panel.tsx
@@ -317,6 +317,8 @@ function PopAsk({ spec, onCancel }: { spec: PopAskSpec; onCancel: () => void })
 /* ── 启动活动 · 参数抽屉(2026-08-27 用户定)────────────────────────────
    点「启动活动」弹抽屉填启动参数:**参数表由服务端按活动下发**(参数名/中文名/控件种类/必填/描述),
    每个活动要的参数不一样 —— 前端只按规格渲染,不写死字段;
+   控件口径(2026-08-27 用户定):大部分是自由输入;客户/料号这类「台账里可能有」的用 combo
+   (选择+新增:先选,候选没有就新增自填)—— **填了库里没有的值不拦启动**,存在性检查在启动后做,缺口派数据工单;
    接口未落地前用 LAUNCH_PARAMS 占位,提交先在清单头落一条「待执行」看全链路效果 */
 
 /** 启动参数的一项规格 —— 将来就是接口返回的参数表行 */
@@ -325,24 +327,25 @@ type LaunchParam = {
   key: string;
   /** 表单上的中文名 */
   label: string;
-  /** 控件种类:text 单行 / textarea 多行 / select 单选 / list 字符串数组(一次可传多个) */
-  type: 'text' | 'textarea' | 'select' | 'list';
+  /** 控件种类:text 单行 / textarea 多行 / select 单选(只能选) / combo 选择+新增(候选没有就自己填) / list 字符串数组(一次可传多个) */
+  type: 'text' | 'textarea' | 'select' | 'combo' | 'list';
   required?: boolean;
   /** 参数描述(服务端给),挂在控件下当辅助说明 */
   desc?: string;
   placeholder?: string;
-  /** select 的候选项 */
+  /** select / combo 的候选项 */
   options?: readonly string[];
 };
 
 /** 占位参数表 —— 一活动一份,接口定稿后按活动取(2026-08-27 用户定:参数由服务器给,每个活动不一样) */
 const LAUNCH_PARAMS: Readonly<Record<string, readonly LaunchParam[]>> = {
-  /* 极简四参(2026-08-26《一键启动入参说明》口径:客户/需求/原PN/候选PN数组,其余启动后进工单补) */
+  /* 极简四参(2026-08-26《一键启动入参说明》口径:客户/需求/原PN/候选PN数组,其余启动后进工单补);
+     客户与料号用 combo(2026-08-27 用户定):台账里有就先选,没有就新增自填 —— 不拦启动,缺口派数据工单 */
   'quote-intake': [
-    { key: 'customer_id', label: '客户', type: 'select', required: true, desc: '决定通知对象与默认负责人线。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
+    { key: 'customer_id', label: '客户', type: 'combo', required: true, desc: '台账里有就直接选;是新客户就自己填,启动后派数据工单补档案。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
     { key: 'request_description', label: '客户需求', type: 'textarea', required: true, desc: '保留原始需求语义,据此新建需求主记录(V1)。', placeholder: '如:车身控制器询价 · 3 项物料,期望 9 月交期' },
-    { key: 'original_internal_pn', label: '原内部料号', type: 'select', required: true, desc: '差异评估基准,引用物料台账。', options: ['PN-880101', 'PN-880205', 'PN-880310'] },
-    { key: 'candidate_internal_pn', label: '候选内部料号', type: 'list', required: true, desc: '被评估物料,一次可传多个、逐个评估 —— 至少 1 个。', placeholder: '如 PN-880412' },
+    { key: 'original_internal_pn', label: '原内部料号', type: 'combo', required: true, desc: '差异评估基准;库里没有该 PN 也可启动,启动后派数据工单补参数。', options: ['PN-880101', 'PN-880205', 'PN-880310'], placeholder: '如 PN-880501' },
+    { key: 'candidate_internal_pn', label: '候选内部料号', type: 'list', required: true, desc: '被评估物料,一次可传多个、逐个评估;库里没有的 PN 照样填,至少 1 个。', placeholder: '如 PN-880412' },
   ],
   'quote-pricing': [
     { key: 'quote_id', label: '询价单号', type: 'text', required: true, desc: '针对哪一张询价单做测算。', placeholder: '如 INS-2415' },
@@ -350,7 +353,7 @@ const LAUNCH_PARAMS: Readonly<Record<string, readonly LaunchParam[]>> = {
     { key: 'target_margin', label: '目标毛利率', type: 'text', desc: '选填,留空按客户线默认。', placeholder: '如 18%' },
   ],
   'crm-coverage': [
-    { key: 'customer_id', label: '客户', type: 'select', required: true, desc: '为哪家客户排触达计划。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
+    { key: 'customer_id', label: '客户', type: 'combo', required: true, desc: '为哪家客户排触达计划;新客户直接填,启动后补档案。', options: ['Itelma', '伏尔加', 'GAZ', 'KAMAZ', 'UAZ', 'Lada'] },
     { key: 'cadence', label: '触达节奏', type: 'select', required: true, desc: '关键人触达的排期密度。', options: ['每周', '双周', '每月'] },
     { key: 'note', label: '补充说明', type: 'textarea', desc: '选填。' },
   ],
@@ -388,6 +391,57 @@ function paramFilled(p: LaunchParam, v: string | string[]): boolean {
   return p.type === 'list' ? (v as string[]).some((s) => s.trim() !== '') : (v as string).trim() !== '';
 }
 
+/** combo 里「新增」这一项的哨兵值 —— 不会与真实候选撞名 */
+const COMBO_CREATE = '__create__';
+
+/**
+ * 选择+新增(2026-08-27 用户定):先摆选择框,候选末项是「新增 …」;
+ * 选了它就换成输入框自己填(库里没有的值也收 —— 不拦启动,缺口由服务端派数据工单),
+ * 旁边留「返回选择」换回去。
+ */
+function ComboInput({ p, value, onChange }: { p: LaunchParam; value: string; onChange: (v: string) => void }) {
+  const [custom, setCustom] = useState(false);
+  if (custom) {
+    return (
+      <span className="g-combo">
+        <input className="g-input" value={value} placeholder={p.placeholder ?? `输入新的${p.label}`} onChange={(e) => onChange(e.target.value)} />
+        <button
+          type="button"
+          className="g-combo-back"
+          onClick={() => {
+            setCustom(false);
+            onChange('');
+          }}
+        >
+          返回选择
+        </button>
+      </span>
+    );
+  }
+  return (
+    <select
+      className="g-select"
+      value={value}
+      onChange={(e) => {
+        if (e.target.value === COMBO_CREATE) {
+          setCustom(true);
+          onChange('');
+        } else {
+          onChange(e.target.value);
+        }
+      }}
+    >
+      <option value="">请选择…</option>
+      {(p.options ?? []).map((o) => (
+        <option key={o} value={o}>
+          {o}
+        </option>
+      ))}
+      <option value={COMBO_CREATE}>＋ 新增{p.label}…</option>
+    </select>
+  );
+}
+
 /**
  * 启动抽屉 —— 复用全局 `g-drawer` 骨架(与系统区模型抽屉同一副);
  * 挂 body portal:详情页容器带入场动画 transform,fixed 抽屉不 portal 会被钉进卡片盒子里(2026-07-30 实测);
@@ -446,6 +500,7 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec:
                     ))}
                   </select>
                 )}
+                {p.type === 'combo' && <ComboInput p={p} value={values[p.key] as string} onChange={(v) => setVal(p.key, v)} />}
                 {p.type === 'list' && (
                   <span className="g-lplist">
                     {(values[p.key] as string[]).map((v, i, arr) => (
@@ -499,7 +554,8 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec:
  * 与「它跑得怎么样」(小统计 + 实例清单,点行进 L3)。
  *
  * 头部动作两个(2026-08-27 更新):
- *   · 激活/禁用 —— 本期做交互,二次确认;**有实例时无法禁用**(规则来自接口,本期前端占位演示);
+ *   · 激活/禁用 —— 本期做交互,二次确认;**任何时刻都可禁用**(2026-08-27 用户重定:
+ *     禁用只拦新启动,不影响已完成与进行中的实例,废除「有实例不能禁用」);
  *   · 启动活动(即创建实例)—— 弹参数抽屉(LaunchDrawer),参数表按活动下发;已禁用不能启动。
  *
  * 沙箱区:加载服务器返回的活动视图 HTML ——  iframe + sandbox 隔离;
@@ -508,7 +564,6 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec:
 export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
   const a = DEMO_ACTIVITIES.find((x) => x.id === id);
   const [status, setStatus] = useState<'active' | 'disabled' | undefined>(undefined);
-  const [blocked, setBlocked] = useState(false);
   const [frameLoaded, setFrameLoaded] = useState(false);
   /* 实例清单入组件状态:操作列的「终止活动」要就地改行(本期前端演示,接口对接后走 mutation) */
   const [rows, setRows] = useState<readonly DemoInstance[] | undefined>(undefined);
@@ -618,15 +673,8 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
                       title: '确认禁用这个活动?',
                       okLabel: '确认禁用',
                       danger: true,
-                      onOk: () => {
-                        /* 规则(2026-08-25 用户定):有实例时接口会提示无法禁用 —— 本期前端先演出这个拦截 */
-                        if (a.instances > 0) {
-                          setBlocked(true);
-                        } else {
-                          setStatus('disabled');
-                          setBlocked(false);
-                        }
-                      },
+                      /* 任何时刻都可禁用(2026-08-27 用户重定):只拦新启动,存量实例不受影响 */
+                      onOk: () => setStatus('disabled'),
                     }),
                 }
               : {
@@ -637,10 +685,7 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
                     setAsk({
                       title: '确认激活这个活动?',
                       okLabel: '确认激活',
-                      onOk: () => {
-                        setStatus('active');
-                        setBlocked(false);
-                      },
+                      onOk: () => setStatus('active'),
                     }),
                 },
             /* 启动活动(2026-08-27 接):弹参数抽屉填参启动;已禁用不能启动 —— 先激活,再启动 */
@@ -653,11 +698,6 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) {
         {ask !== null && <PopAsk spec={ask} onCancel={() => setAsk(null)} />}
         {launch && <LaunchDrawer name={a.name} spec={launchSpec} onCancel={() => setLaunch(false)} onLaunch={onLaunch} />}
       </div>
-      {blocked && (
-        <Note tone="warn">
-          无法禁用:该活动还有 {a.instances} 个实例 —— 这条提示将来由接口返回(有实例时接口拒绝禁用),本期为前端占位演示。
-        </Note>
-      )}
 
       <Sec ico="repeat" title="历史活动" extra={`共 ${instances.length} 个 · 查看详情进 L3`}>
         {/* 统计带 + 检索条同一行(2026-08-26 用户定:检索放右侧)——
diff --git a/docs/API文档-活动模块.md b/docs/API文档-活动模块.md
new file mode 100644
index 0000000..9ae0d51
--- /dev/null
+++ b/docs/API文档-活动模块.md
@@ -0,0 +1,337 @@
+# API 文档 —— 活动模块(L1 清单 / L2 活动详情 / L3 实例详情)
+
+> 本文是活动模块前端(运营中心 · 活动区,2026-08-25 重构模版)与服务端之间的接口约定,
+> 给后端编写接口、前端取数用。鉴权 / 票据 / 错误体 / 端归属通则:`docs/API文档-鉴权与人员.md` §0,本文不重复。
+> 需求出处:`docs/活动模块重构需求-2026-08-25.md`;启动参数口径:`ACT-WORK-05-一键启动入参说明.md`(极简四参)。
+> 契约落地后唯一真相在 `packages/contracts/src/api/*.ts`(zod schema,前后端共用);两者不一致时以契约为准并回来改本文。
+
+## 0. 通则(本文特有)
+
+| 项 | 值 |
+|---|---|
+| 前缀 | `/api/gov/activities/*`;**全部 `access: 'ops'`** —— 活动区落在运营中心,与工作流/任务看板同端 |
+| 时间 | 一律 ISO 8601 UTC 字符串(`2026-08-27T02:25:11.000Z`);**展示格式化是前端的事**(`YYYY-MM-DD HH:mm:ss` 本地时区) |
+| 人员 | 凡出人,都是 `{ "id": "<staffId>", "name": "柴浩" }` 两段 —— 展示用 name,筛选/提交用 id;人员候选名单用既有 `GET /api/gov/staff`,本文不另做 |
+| 广播 | 写路由(启动 / 禁用 / 激活 / 终止)成功后广播 `{kind:'system', id:'gov'}` —— 前端按既有套路失效 `['gov',*]` 重取 |
+| 实例状态 | 五态,英文码:`pending`(待执行)/ `running`(进行中)/ `completed`(已完成)/ `rejected`(驳回)/ `failed`(失败);**没有第六态** —— 手动终止归入 `failed`,用 `reason.kind='terminated'` 区分「自己跑挂」(见 §6) |
+| 禁用语义 | **任何时刻都可禁用**(2026-08-27 用户重定,废除「有实例不能禁用」):禁用只拦「新启动」—— 已完成的实例是历史留痕,进行中的实例**继续跑完不受影响**;激活即恢复启动能力 |
+
+状态码怎么读(通则之外本文特有的):
+
+| 状态 | code | 何时 |
+|---|---|---|
+| 400 | `validation-failed` | 入参不合 schema(`detail` 是 zod issues);启动参数缺必填 / 类型不对(`detail` 指明是哪个 `key`) |
+| 404 | `not-found` | 活动 / 实例不存在;实例不属于这个活动 |
+| 412 | `precondition-failed` | 启动:活动已禁用;终止:实例不在 `running` |
+
+## 1. L1 活动清单
+
+### `GET /api/gov/activities?status=active|disabled` —— access: `ops`
+
+L1 两个页签(激活中 / 已禁用)各取一份;不带 `status` = 全量。量小,**不分页**。
+
+```json
+{
+  "activities": [
+    {
+      "id": "quote-intake",
+      "name": "询价接收与结构化",
+      "biz": "报价业务",
+      "status": "active",
+      "version": "1.3.0",
+      "owner": { "id": "8f3c…", "name": "柴浩" },
+      "llm": "K3 · quote-intake",
+      "instanceCount": 12,
+      "createdAt": "2026-08-12T01:00:00.000Z",
+      "ico": "inbox",
+      "hue": "blue"
+    }
+  ]
+}
+```
+
+- `ico` / `hue`:展示元数据(语义图标名 / 业务色相 `blue|teal|amber|violet`),创建活动时可配;**缺省时前端兜底**(`inbox` / `blue`),后端可以暂时不存。
+- `llm`:这个活动绑定的专属 agent 的人读标签;要链到 LLM 实例时再加 `llmId`,本期没有。
+
+## 2. L2 活动定义
+
+### `GET /api/gov/activities/:activityId` —— access: `ops`
+
+```json
+{
+  "id": "quote-intake",
+  "name": "询价接收与结构化",
+  "biz": "报价业务",
+  "status": "active",
+  "version": "1.3.0",
+  "owner": { "id": "8f3c…", "name": "柴浩" },
+  "llm": "K3 · quote-intake",
+  "createdAt": "2026-08-12T01:00:00.000Z",
+  "ico": "inbox",
+  "hue": "blue",
+  "desc": "活动定义只读 —— 输入与输出在创建时定死,演进走版本迭代;验收在工作台,这里只看状态。",
+  "view": { "url": "/api/gov/activities/quote-intake/view" }
+}
+```
+
+- `desc`:定义说明,创建时填,只读。
+- `view`:沙箱要渲染的活动视图;**为 `null` 时前端藏起整个沙箱区块**(不再摆空 iframe)。
+
+### `GET /api/gov/activities/:activityId/view` —— access: `ops`(支持 `?ticket=`)
+
+→ `content-type: text/html`,服务器托管的活动视图 HTML,前端 `<iframe sandbox="allow-scripts">` 直接渲染。
+iframe 带不了 Authorization 头,走票据(`GET /api/auth/ticket`,ADR-012 §6)—— 前端每次装载前取一张拼 `?ticket=`。
+**内容高度用 postMessage 通讯自适应(视图脚本向父页报高),协议随第一版视图实现一起定。**404:该活动没配视图。
+
+## 3. L2 实例清单(历史活动)
+
+### `GET /api/gov/activities/:activityId/instances` —— access: `ops`
+
+查询参数(可组合,AND;都不带 = 全部):
+
+| 参数 | 形 | 说明 |
+|---|---|---|
+| `id` | 字符串 | 实例号**模糊**搜,如 `INS-24` |
+| `ownerId` | staffId | 精确到人 |
+| `state` | 五态之一 | 精确 |
+| `startedFrom` / `startedTo` | `YYYY-MM-DD` | 启动日期段,**含两端整日**;可只给一端 |
+| `page` | 整数,从 1 | 默认 1 |
+| `size` | 整数 | 默认 8(与前端单页一致),上限 50 |
+
+```json
+{
+  "stats": { "total": 13, "byState": { "pending": 1, "running": 1, "completed": 7, "rejected": 2, "failed": 2 } },
+  "total": 13,
+  "page": 1,
+  "size": 8,
+  "items": [
+    {
+      "id": "INS-2417",
+      "state": "running",
+      "owner": { "id": "8f3c…", "name": "柴浩" },
+      "input": "Itelma 车身控制器询价 · 3 项物料",
+      "output": null,
+      "startedAt": "2026-08-25T02:12:00.000Z"
+    },
+    {
+      "id": "INS-2415",
+      "state": "completed",
+      "owner": { "id": "8f3c…", "name": "柴浩" },
+      "input": "GAZ 底盘线束询价 · 7 项物料",
+      "output": "quote-20260824-07.json",
+      "startedAt": "2026-08-24T09:03:00.000Z"
+    }
+  ]
+}
+```
+
+- **`stats` 是活动整体的五态统计,不随检索条件动**(页头统计带摆的是全局数);`total` 是**筛后**条数,分页器按它走。
+- `input` / `output` 都是**一句话摘要**;`output` 为 `null` 前端摆 `-`。排序:启动时间倒序(新的在前)。
+
+## 4. 启动参数表
+
+### `GET /api/gov/activities/:activityId/launch-params` —— access: `ops`
+
+点「启动活动」开抽屉时取。**一活动一份,前端只按此表渲染表单,不写死字段。**
+
+```json
+{
+  "activityId": "quote-intake",
+  "version": "1.3.0",
+  "params": [
+    {
+      "key": "customer_id",
+      "label": "客户",
+      "type": "combo",
+      "required": true,
+      "desc": "台账里有就直接选;是新客户就自己填,启动后派数据工单补档案。",
+      "options": [
+        { "value": "cust-itelma", "label": "Itelma" },
+        { "value": "cust-gaz", "label": "GAZ" }
+      ]
+    },
+    {
+      "key": "request_description",
+      "label": "客户需求",
+      "type": "textarea",
+      "required": true,
+      "desc": "保留原始需求语义,据此新建需求主记录(V1)。",
+      "placeholder": "如:车身控制器询价 · 3 项物料,期望 9 月交期"
+    },
+    {
+      "key": "original_internal_pn",
+      "label": "原内部料号",
+      "type": "combo",
+      "required": true,
+      "desc": "差异评估基准;库里没有该 PN 也可启动,启动后派数据工单补参数。",
+      "placeholder": "如 PN-880501",
+      "options": [
+        { "value": "PN-880101", "label": "PN-880101" }
+      ]
+    },
+    {
+      "key": "candidate_internal_pn",
+      "label": "候选内部料号",
+      "type": "list",
+      "required": true,
+      "desc": "被评估物料,一次可传多个、逐个评估 —— 至少 1 个。",
+      "placeholder": "如 PN-880412"
+    }
+  ]
+}
+```
+
+| 字段 | 说明 |
+|---|---|
+| `key` | 提交时回传的字段名(接口契约,英文) |
+| `label` | 表单上的中文名 |
+| `type` | 控件种类:`text` 单行 / `textarea` 多行 / `select` 单选(只能选候选) / **`combo` 选择+新增**(候选末项是「新增」,选了换输入框自己填;见下方「combo 语义」) / `list` 字符串数组(一次可传多个,逐行自由填);**新增种类前要前后端一起升级**,前端遇到不认识的 type 摆「暂不支持的控件」 |
+| `required` | 必填;前端在没填完时禁提交,**服务端仍要再验一道**(400) |
+| `desc` | 参数描述,挂在控件下当辅助说明 |
+| `placeholder` | 选填,text / textarea / combo(新增态) / list 用 |
+| `options` | `select` / `combo` 必填;**两段式 `{ value, label }`** —— value 是提交的标识(如客户 ID),label 是显示名;标识即显示名时两段相同 |
+| `default` | 选填;预填值(`list` 给字符串数组,其余给字符串)—— 上游触发预填场景用 |
+
+**combo 语义(2026-08-27 用户定)**:启动表单大部分是自由输入;客户 / 料号这类「台账里可能有」的参数才用 combo —— 先选,候选里没有就新增自填。**提交候选之外的值是合法的,不拦启动**:服务端按 value 在台账里查,查不到照样启动,启动后派**数据工单**到工作台补这条档案(客户进客户台账、PN 补参数,确认即入库,活动从断点续跑)。combo 提交的值统一回字符串:选中候选回它的 `value`,新增回用户填的原样字符串 —— 服务端不靠类型区分新旧,靠台账存在性检查。
+
+候选量大到不宜内联时(如全量物料台账选 PN),后续加 `optionsSource` 引用检索接口,**本期一律内联 `options`**。
+
+## 5. 启动活动(创建实例)
+
+### `POST /api/gov/activities/:activityId/instances` —— access: `ops`
+
+```json
+{
+  "idempotencyKey": "01J9…",
+  "params": {
+    "customer_id": "cust-itelma",
+    "request_description": "车身控制器询价 · 3 项物料,期望 9 月交期",
+    "original_internal_pn": "PN-880101",
+    "candidate_internal_pn": ["PN-880412", "PN-880530"]
+  }
+}
+```
+
+→ 200 一条实例详情(同 §6)。**同一 `idempotencyKey` 重放返回第一次创建的实例,不起第二个**(前端每开一次抽屉生成一枚;重复点提交、网络重试都靠它挡住)。
+`params` 的键值形状由 §4 参数表决定:`list` 回字符串数组,其余回字符串;`select` 回 `options` 里某个 `value`;**`combo` 回候选的 `value` 或新增的原样字符串,两种都合法**。
+412:活动已禁用(先激活再启动)。400:缺必填 / 类型不符 / select 的值不在 options 里(**combo 不适用这条** —— 候选之外的值是合法新增)。
+
+正常落地初始状态 `pending`(排入队列,调度器领到即转 `running`);**存在性检查(客户 / 料号在不在台账)在启动后做,查不到不拦启动** —— 按入参说明口径,缺口派数据工单到工作台逐项补(确认即入库,活动从断点续跑);响应里不单独回这件事,工单出现在工作台那一侧(工单接口不在本文范围)。
+
+## 6. L3 实例详情
+
+### `GET /api/gov/activities/:activityId/instances/:instanceId` —— access: `ops`
+
+```json
+{
+  "id": "INS-2417",
+  "activityId": "quote-intake",
+  "state": "running",
+  "owner": { "id": "8f3c…", "name": "柴浩" },
+  "llm": "K3 · quote-intake",
+  "startedAt": "2026-08-25T02:12:00.000Z",
+  "endedAt": null,
+  "durationMs": null,
+  "reason": null,
+  "input": {
+    "content": "Itelma 车身控制器询价 · 3 项物料",
+    "source": { "kind": "manual", "label": "手动启动 · 柴浩" },
+    "submittedAt": "2026-08-25T02:12:00.000Z",
+    "files": [
+      { "index": 0, "name": "RFQ-2026-081.eml", "contentType": "message/rfc822", "size": 48210 }
+    ]
+  },
+  "output": {
+    "files": [
+      { "index": 0, "name": "quote-20260825-07.json", "contentType": "application/json", "size": 6102 }
+    ]
+  },
+  "steps": [
+    { "seq": 1, "name": "输入接收",   "by": "agent", "byName": "K3 · quote-intake", "at": "2026-08-25T02:12:00.000Z", "durationMs": 60000,  "res": "done",    "note": "询价单已进入,要素识别完成,实例正式起步。" },
+    { "seq": 2, "name": "要素结构化", "by": "agent", "byName": "K3 · quote-intake", "at": "2026-08-25T02:15:00.000Z", "durationMs": 360000, "res": "done",    "note": "抽取客户 / 物料 / 交期等字段,落入结构化模型。" },
+    { "seq": 3, "name": "定价测算",   "by": "agent", "byName": "K3 · quote-intake", "at": "2026-08-25T02:21:00.000Z", "durationMs": null,   "res": "current", "note": "按成本模型逐项给出建议价与毛利测算。" },
+    { "seq": 4, "name": "负责人验收", "by": "human", "byName": "柴浩",              "at": null,                        "durationMs": null,   "res": "pending", "note": "确认测算结果 —— 规划类产出必须由人验收担责。" },
+    { "seq": 5, "name": "输出归档",   "by": "agent", "byName": "K3 · quote-intake", "at": null,                        "durationMs": null,   "res": "pending", "note": "生成报价文件并归档,产出回写台账。" }
+  ]
+}
+```
+
+- `endedAt` / `durationMs`:未结束(null)。`durationMs` 毫秒,前端格式化(`27m`)。
+- **`reason`**:终态的原因说明,`null` = 不需要(进行中 / 待执行 / 正常完成)。
+  `{ "kind": "rejected", "text": "验收驳回:测算毛利低于阈值,退回重新测算 —— 负责人 柴浩。" }`
+  `{ "kind": "failed", "text": "要素结构化失败:询价单附件缺失,已通知发起人补齐后重试。" }`
+  `{ "kind": "terminated", "text": "已于 08-27 10:41 由 柴浩 手动终止。" }` —— **手动终止的实例状态归 `failed`,靠 `reason.kind='terminated'` 与「自己跑挂」区分**(过程面当前步记「已终止」,不摆失败原因)。
+- `input.source.kind`:`manual`(运营端手动启动)/ `upstream`(上游活动触发)/ `mail`(邮件触发)…… 枚举随触发渠道增加;`label` 是人读形式,前端直接摆。
+- `steps[].res`:`done` / `fail` / `current` / `pending`;`fail` 那行的性质由 `reason.kind` 定(驳回 / 失败 / 已终止)。
+- `input.files` / `output.files`:只有元数据;**下载走 §7**。没有产出时 `output.files` 是空数组(前端摆「暂无产出」)。
+
+## 7. 实例文件下载
+
+### `GET /api/gov/activities/:activityId/instances/:instanceId/files/:io/:index` —— access: `ops`(支持 `?ticket=`)
+
+`:io` ∈ `input` | `output`,`:index` 对应 §6 文件行的 `index`。
+→ `{ "name": "…", "contentType": "…", "dataBase64": "…" }`(与 `GET /api/gov/upload/:id` 同形);可带 `?ticket=` 用 `<a href download>`。
+**本期可以只回元数据、这条路先 404** —— 前端下载钮当前就是「随接口开放」的置灰态。
+
+## 8. 禁用 / 激活 / 终止
+
+### `POST /api/gov/activities/:activityId/disable` —— access: `ops`
+
+→ 200 活动视图(§2 同形)。**任何时刻都可禁用,没有前置条件**(2026-08-27 用户重定):
+禁用后这个活动不再允许启动(§5 返回 412);**已完成的实例是历史留痕,进行中的实例继续跑完,都不受影响**。
+已禁用再禁用 = 幂等 200。
+
+### `POST /api/gov/activities/:activityId/activate` —— access: `ops`
+
+→ 200 活动视图。已激活再激活 = 幂等 200。
+
+### `POST /api/gov/activities/:activityId/instances/:instanceId/terminate` —— access: `ops`
+
+body 空(终止理由本期不填,`reason.text` 由服务端生成)。
+→ 200 实例详情(§6 同形,`state='failed'` + `reason.kind='terminated'`)。412:实例不在 `running`(已终态的不能再终止)。
+
+## 9. Schema 附录(落地时进 `packages/contracts`,同名)
+
+```ts
+type ActivityStatus = 'active' | 'disabled';
+type InstanceState = 'pending' | 'running' | 'completed' | 'rejected' | 'failed';
+type StaffRef = { id: string; name: string };
+
+type ActivitySummary = { id: string; name: string; biz: string; status: ActivityStatus; version: string;
+  owner: StaffRef; llm: string; instanceCount: number; createdAt: string; ico?: string; hue?: 'blue' | 'teal' | 'amber' | 'violet' };
+type ActivityDetail = Omit<ActivitySummary, 'instanceCount'> & { desc: string; view: { url: string } | null };
+
+type InstanceSummary = { id: string; state: InstanceState; owner: StaffRef; input: string; output: string | null; startedAt: string };
+type InstanceStats = { total: number; byState: Record<InstanceState, number> };
+type InstanceList = { stats: InstanceStats; total: number; page: number; size: number; items: InstanceSummary[] };
+
+type LaunchParamType = 'text' | 'textarea' | 'select' | 'combo' | 'list';
+type LaunchParam = { key: string; label: string; type: LaunchParamType; required?: boolean; desc?: string;
+  placeholder?: string; options?: { value: string; label: string }[] /* select / combo 必填 */; default?: string | string[] };
+type LaunchParams = { activityId: string; version: string; params: LaunchParam[] };
+type LaunchInput = { idempotencyKey: string; params: Record<string, string | string[]> };
+
+type InstanceFile = { index: number; name: string; contentType: string; size: number };
+type InstanceReason = { kind: 'rejected' | 'failed' | 'terminated'; text: string };
+type InstanceStep = { seq: number; name: string; by: 'agent' | 'human'; byName: string;
+  at: string | null; durationMs: number | null; res: 'done' | 'fail' | 'current' | 'pending'; note: string };
+type InstanceDetail = InstanceSummary & { activityId: string; llm: string; endedAt: string | null; durationMs: number | null;
+  reason: InstanceReason | null;
+  input: { content: string; source: { kind: string; label: string }; submittedAt: string; files: InstanceFile[] };
+  output: { files: InstanceFile[] };
+  steps: InstanceStep[] };
+```
+
+## 10. 前端对接要点(现状 → 接口落地)
+
+| 现状(占位) | 接口落地后 |
+|---|---|
+| `DEMO_ACTIVITIES` 静态数组 | §1;L1 页签切换即换 `status` 重取 |
+| `demoInstances()` 每活动共用一份 | §3;检索四条件与分页全部上移到查询参数,前端删掉本地过滤/分页 |
+| 统计带由前端从全量数组数 | §3 `stats`(服务端给,分页下才数得准) |
+| `LAUNCH_PARAMS` 占位参数表 | §4;`options` 从纯字符串升级为 `{value,label}` 两段(渲染器小改);控件种类已含 `combo`(选择+新增,前端已实现) |
+| `onLaunch` 在清单头落假行 | §5;抽屉每开一次生成 `idempotencyKey`,提交走 mutation,成功失效 `['gov']` |
+| 禁用/激活/终止就地改 state | §8;mutation 成功后由服务端重投影(广播 → 失效 → 重取) |
+| `demoSteps` / `terminatedSteps` 五步占位 | §6 `steps`;终止归态以 `reason.kind='terminated'` 为准,前端不再落「失败」占位 |
+| 沙箱 `src="/sandbox-demo/activity-view.html"` 固定 480 高 | §2 `view.url` + 票据;`view` 为 null 藏起沙箱区;高度 postMessage 随第一版视图定 |
+| 输出下载钮置灰 | §7(本期可继续 404,钮保持置灰) |
diff --git a/docs/活动模块重构需求-2026-08-25.md b/docs/活动模块重构需求-2026-08-25.md
index bd948b1..ad284ff 100644
--- a/docs/活动模块重构需求-2026-08-25.md
+++ b/docs/活动模块重构需求-2026-08-25.md
@@ -30,7 +30,7 @@
 - **创建实例**：先把入口留出来，功能待做；
 - **运营概览小统计**：需要；
 - **验收动作在工作台**，活动模块不管验收 —— L2 只展示状态；
-- **激活/禁用都需要二次确认**；禁用会访问接口，**有实例时接口会提示无法禁用**（本期只做前端，暂不接接口，前端先把这个规则的样子做出来）；
+- **激活/禁用都需要二次确认**；禁用会访问接口，~~有实例时接口会提示无法禁用~~（**2026-08-27 用户重定：任何时刻都可禁用**，禁用只拦新启动，不影响已完成与进行中的实例 —— 见下方记录）；
 - **L2 需要一个沙箱**：用来加载服务器返回的 HTML 页面（活动视图），先做一个版本看效果再改。
 
 ### 2026-08-25 · 版本号与版本迭代入口（用户口述）
@@ -93,6 +93,8 @@ L1（模块首页 · 活动清单）需要一个**标签页**切换，因为活
 - 2026-08-26 · **实例不可删除、不可编辑（用户定，推翻 L3 原规划）**：L3 的编辑/删除入口撤掉，唯一动作是进行中的「终止活动」（二次确认）；六功能里实例的「编辑/删除」两项就此划掉，待确认问题里的两条（编辑指什么 / 删除是否放开）同时关闭。
 - 2026-08-26 · **二次确认的规格（用户定）**：活动模块的确认走**轻气泡**（锚在触发钮下方的小泡泡，只问一句 + 确认/取消，点罩即取消）—— 不摆影响三必答；三必答（AskBand）是治理台重度动作的规格，别处的确认带暂不动。
 - 2026-08-27 · **「启动活动」按钮接功能（用户定）**：L2 头部「启动活动」不再占位 —— 点击弹**参数抽屉**（复用全局 `g-drawer` 右抽屉骨架），填启动参数后启动。**参数表由服务端按活动下发**（参数名 / 中文名 / 控件种类 / 必填 / 描述），每个活动要的参数不一样，前端只按规格渲染不写死字段；控件种类已支持单行 / 多行 / 单选 / 字符串数组（可传多个，如候选 PN）。接口未落地前用 `LAUNCH_PARAMS` 占位表（询价接收与结构化 = 入参说明的极简四参），提交先在历史活动清单头落一条「待执行」演示全链路，接口对接后换启动 mutation。**已禁用的活动不能启动**（钮置灰，先激活再启动）。
+- 2026-08-27 · **禁用规则重定（用户定，废除 08-25 的「有实例不能禁用」）**：**任何时刻都可以禁用活动** —— 禁用后只拦「新启动」（启动接口返回 412）；已完成的实例是历史留痕、进行中的实例继续跑完，都不受影响；激活即恢复。前端占位的拦截逻辑（有实例弹「无法禁用」提示条）已随此删除；接口口径见 `docs/API文档-活动模块.md` §0/§8。
+- 2026-08-27 · **启动参数的控件口径（用户定）**：启动表单**大部分是自由输入框**；客户 / 料号这类「台账里可能有」的参数用 **combo（选择+新增）** —— 先摆选择框，候选末项「新增」选了换输入框自己填。**填了库里没有的值不拦启动**：启动后服务端做存在性检查，查不到就派**数据工单**到工作台补档案（客户进客户台账、PN 补参数，确认即入库，活动从断点续跑）。前端已加 `combo` 控件类型；接口口径见 `docs/API文档-活动模块.md` §4「combo 语义」/§5。
 
 ## 三、功能表（整理稿）