feat(w05): 差异评估结论审核的收口四格可就地改 —— 判定归规则,话归人

用户:「差异评估结论审核这个界面的收口结论下面这 4 个字段也需要可以编辑」

这四格(推荐理由 / 差异摘要 / 替代风险 / 验证要求)原本是**故意**只读的,理由写在源码里:
「让人直接改这几格,等于让他给自己没做的判断盖章」。用户改了这个口径 —— 审核人对结论
有最终发言权。原理由留在注释里备查。

**光把格子打开等于没开**:`RELATION_PROJECTION` 每跑一次就按规则把这四列重写一遍,
而人在件上按保存会触发 quiet 拍、quiet 恰恰跑 project —— 人刚写下的话当场被规则值冲掉,
那是「让你改、改完被冲掉」,比不给改更糟(基座不记「谁写的」,配方分不清一格是人改的
还是自己写的,所以只能从配方这一侧下手)。

改法:S3 换用新的 `RELATION_RECOMPUTE` —— 与 `DIFFERENCE_ITEM_RECOMPUTE` 同一手法,
**只列主键 + recommendation_level**。patch 是稀疏的、DB 侧是 jsonb 浅合并,没列的列原样
留着,人改过的四格因此保得住。**推荐等级仍然重算且不容手改**:它是规则按四态分布算出来
的判据核心(件② 判据表 / 件③ 落账结论 / 出口谓词都读它),「人改四态 → 等级跟着变」
这条链不能断。分工因此是:**判定归规则,话归人**。

代价说在明处,件上那段说明已改口:改完四态,这四格不会自动跟着改口(否则刚写的话就没了)
——「四态改完,记得回头看看这四格还对不对」。界面不撒谎优先于自动。

件上:三句话走 cell(只读份 + 孪生输入),风险只读态摆徽标、编辑态换 select(枚举列不许
直显 low/medium/high),整块一个宿主一道闸,主键钥匙藏在 .rowkey 里但真挂 data-col。
.summary-box 不是表格 —— setOpen 对非表格容器把 .on 落在 data-edit 元素自身,CSS 按
.summary-box.on 写。

测:件上四格可改 + 一个宿主一道闸 + 钥匙在场;S3 重算笔四列一个都不许出现、判定仍在且
与 S2 共用同一条 when 链。四条变异各红一条(S3 退回用 RELATION_PROJECTION / 混进
difference_summary / 混进 risk_level / 判定不再重算)。pnpm gates 退出码 0(2495 测)。
包版本 2.3.0 -> 2.4.0。

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

activities/part-substitution-assessment/src/case-model.ts

@@ -267,6 +267,37 @@ const RELATION_PROJECTION = {
   },
 } as const;
 
+/**
+ * **S3 专用的关系重算笔** —— 只重算「判定」,**收口四格一个字不碰**
+ * (2026-08-31 用户:「差异评估结论审核这个界面的收口结论下面这 4 个字段也需要可以编辑」)。
+ *
+ * 那四格(推荐理由 / 差异摘要 / 替代风险 / 验证要求)此前只读,件上打开可编辑之后,
+ * **光开格子等于没开**:`RELATION_PROJECTION` 每跑一次就按规则把它们重写一遍,而人在件上
+ * 按保存会触发 quiet 拍、quiet 恰恰跑 `project` —— 人刚写下的话当场被规则值冲掉。
+ * 那是「让你改、改完被冲掉」,比不给改更糟。
+ *
+ * 与 `DIFFERENCE_ITEM_RECOMPUTE` 同一手法:**只列要重算的列,一个都不多写**。
+ * `draftWrite` 的 `patch` 是稀疏的(只含显式给出的列),DB 侧 `patch = patch || excluded.patch`
+ * 是 jsonb **浅合并** —— 没列的列原样留着,人改过的四格因此保得住。
+ *
+ * **`recommendation_level` 仍然重算,而且不容手改**:它是规则按四态分布算出来的判据核心,
+ * 「人改四态 → 等级跟着变」这条链不能断(件② 的判据表、件③ 的落账结论、出口谓词都读它)。
+ * 于是这一步的分工是:**判定归规则,话归人**。
+ *
+ * 代价说在明处:人改完四态,这四格**不会**自动跟着改口(否则他刚写的话就没了)——
+ * 件上那段说明已如实写清「四态改完,记得回头看看这四格还对不对」。界面不撒谎优先于自动。
+ */
+const RELATION_RECOMPUTE = {
+  kind: 'project' as const,
+  into: 'substitution.relation',
+  from: { once: true as const },
+  fields: {
+    /* 主键原样带回,认的是这一行自己 —— 不是新建,是同 PK 覆盖 */
+    substitution_relation_id: { in: 'relationId' },
+    recommendation_level: RELATION_PROJECTION.fields.recommendation_level,
+  },
+} as const;
+
 /* P-06 **一单固定一条**(用户定)。本活动只写「还得去验什么」,状态一律 `not_started`:它不是实测结果,**不许虚构实测**。 */
 const VALIDATION_PROJECTION = {
   kind: 'project' as const,
@@ -742,10 +773,11 @@ export const ASSESSMENT_STEPS = [
     item: 'S3_review' as const,
     intent: '把逐条结论摆给人过目,他就地改四态与影响说明,改到没问题为止',
     guide: '',
-    /* Task 8:人核对结论用的验收工单 —— 对决头(原 PN → 候选 PN)+ 四态分布带 + 推荐等级大徽章
-       只读,逐条明细可就地改(四态 / 影响说明 / 判断依据 / UNKNOWN 去向),收口四格
-       (推荐理由 / 差异摘要 / 风险 / 验证要求)只读——它们是配方按规则算的,人改了上面的四态,
-       这一步的 auto.do 里那两笔投影(RELATION_PROJECTION / VALIDATION_PROJECTION)会重算它们。 */
+    /* Task 8:人核对结论用的验收工单 —— 对决头(原 PN → 候选 PN)+ 四态分布带只读,
+       推荐等级大徽章只读(判据核心,改四态即改它),逐条明细可就地改(四态 / 影响说明 /
+       判断依据 / UNKNOWN 去向);**收口四格(推荐理由 / 差异摘要 / 风险 / 验证要求)
+       2026-08-31 起可就地改**,写下的以人为准 —— 这一步因此用 `RELATION_RECOMPUTE`
+       (只重算判定)而不是 `RELATION_PROJECTION`(会把四格按规则重写、冲掉人写的话)。 */
     view: 'difference-review',
     writes: ['substitution.difference_item', 'substitution.relation', 'validation.record'],
     reads: ['substitution.difference_item', 'substitution.relation'],
@@ -773,7 +805,9 @@ export const ASSESSMENT_STEPS = [
          * 那一笔后面」的又一例 —— 摘要只读,改的是四态。
          */
         DIFFERENCE_ITEM_RECOMPUTE,
-        RELATION_PROJECTION,
+        /* **不是 `RELATION_PROJECTION`** —— 那一笔会把收口四格按规则重写,把人刚改的话冲掉。
+           这一步只重算判定(推荐等级跟着四态走),四格交给人,见 `RELATION_RECOMPUTE` 的头注。 */
+        RELATION_RECOMPUTE,
         VALIDATION_PROJECTION,
         {
           kind: 'card' as const,

activities/part-substitution-assessment/src/manifest.ts

@@ -54,7 +54,7 @@ export const manifest: ActivityManifest = {
     activityId: ACTIVITY_ID,
     name: 'ACT-WORK-05 · 差异评估',
     /* 重写不是改 —— 同版重装是 no-op(静默丢失,踩过) */
-    packageVersion: '2.3.0',
+    packageVersion: '2.4.0',
     category: '需求分析与方案匹配',
     sdkVersion: '0.1.0-m5',
     checksum: 'dev-checksum-part-substitution-assessment',

activities/part-substitution-assessment/src/views/report.ts

@@ -672,6 +672,20 @@ const BIND_ACC1_LAYOUT = `
 .kv span{flex:1 1 auto;color:var(--ink-2);line-height:1.6;overflow-wrap:anywhere}
 .kv span:empty::after{content:"—";color:var(--ink-4)}
 .summary-box{border:1px solid var(--line-soft);border-radius:10px;background:var(--soft);padding:2px 16px;margin-bottom:4px}
+/* **收口四格可就地改**(2026-08-31 用户定):.summary-box 不是表格 —— setOpen 对非表格容器
+   把 .on 落在 data-edit 元素**自身**(A2 对决卡先立此法),所以这几条按 .summary-box.on 写,
+   不是 table.on。注释里不写反引号:这一整段活在 TS 模板字符串里,一个反引号就把串截断
+   (esbuild 当场报在几行之外,本轮踩过一次)。 */
+.summary-box .jc-cell{display:none;width:100%;border:1px solid var(--line);border-radius:6px;padding:6px 8px;font:inherit;font-size:12.5px;color:var(--ink);background:#fff}
+.summary-box .jc-cell:focus{border-color:var(--ledger);box-shadow:0 0 0 3px var(--ledger-soft);outline:none}
+.summary-box.on .kv > .jc-vcell{display:none}
+.summary-box.on .kv > .jc-cell{display:block}
+/* 空值那条「—」占位只属于看的那一份:编辑态里输入框旁边再摆一个破折号是噪音 */
+.summary-box.on .kv .jc-vcell:empty::after{content:none}
+/* 主键钥匙:不给人看,但真挂 data-col(漏了钥匙,这一行凑不出主键) */
+.summary-box .rowkey{display:none}
+/* 行容器 —— data-rows 逐行复制它;不给样式也得有定义(件上每个 class 都要在自己那段 CSS 里找得到) */
+.sumrow{display:block}
 `;
 
 /**
@@ -760,17 +774,34 @@ const DIFF_ITEM_TABLE = `<div class="tbl-wrap"><table>
 </table></div>`;
 
 /**
- * 收口四格 —— **只读**。推荐理由 / 差异摘要 / 验证要求三格是自由文本,裸 `data-slot`;
- * 风险走徽标(`data-class-of`,避免直显 `low`/`medium`/`high` 这类英文枚举原值,
- * 与「陷阱表:枚举列不许 data-slot 直显机器码」同一条纪律)。四格全部读 `substitution.relation`,
- * 但**这一段没有任何 `data-edit`**——它们是配方按 §3.5 规则算出来的,要改就去改上面的四态。
+ * 收口四格 —— **可就地改**(2026-08-31 用户:「差异评估结论审核这个界面的收口结论下面
+ * 这 4 个字段也需要可以编辑」)。
+ *
+ * **原来是只读的,理由写在这儿备查**:它们是配方按 §3.5 规则算出来的,「让人直接改这几格,
+ * 等于让他给自己没做的判断盖章」。用户改了这个口径 —— 审核人对结论有最终发言权。
+ *
+ * **光把格子打开不够,配方那一侧必须一起改**:`RELATION_PROJECTION` 每跑一次就把这四列
+ * 按规则重写一遍,而人在件上按保存会触发 quiet 拍、quiet 恰恰跑 `project` —— 不动配方的话,
+ * 人改完一保存,他写的话当场被规则值冲掉,那是「让你改、改完被冲掉」的另一种撒谎。
+ * 治法见 `case-model.ts` 的 `RELATION_RECOMPUTE`:S3 这一步**只重算判定**
+ * (推荐等级跟着四态走 —— 那是判据的核心,不容人手改),**这四格一个字不碰**。
+ * 代价说在明处:改四态之后这三句话不会自动跟着改口 —— 件上那段说明已如实写清。
+ *
+ * 三格自由文本走 `cell()`(只读那一份 + 自动孪生输入);风险是枚举,只读态走徽标
+ * (`data-class-of`,不裸摆 `low`/`medium`/`high`,「枚举列不许 data-slot 直显机器码」),
+ * 编辑态换 `select` —— 与件① 生命周期那一格同款。
+ * 主键 `substitution_relation_id` 挂在 `.rowkey` 里:不给人看(一串内部编号),但必须
+ * **真挂 `data-col`** —— 漏了钥匙,保存的行凑不出主键(2026-08-02 栽过)。
  */
-const CLOSING_SUMMARY = `<div class="summary-box">
-  <div class="kv"><i>推荐理由</i><span data-slot="recommendation_reason" data-blank></span></div>
-  <div class="kv"><i>差异摘要</i><span data-slot="difference_summary" data-blank></span></div>
-  <div class="kv"><i>替代风险</i><span class="risk-badge" data-class-of="risk_level"></span></div>
-  <div class="kv"><i>验证要求</i><span data-slot="verification_requirement" data-blank></span></div>
-</div>`;
+const CLOSING_SUMMARY =
+  editGate('substitution.relation', '收口四格是 AI 按规则拟的初稿 —— 点「编辑」就地改,改完保存') +
+  `<article class="summary-box" data-rows="mine:substitution.relation" data-edit="substitution.relation"><section class="sumrow">
+  <div class="kv"><i>推荐理由</i>${cell('recommendation_reason')}</div>
+  <div class="kv"><i>差异摘要</i>${cell('difference_summary')}</div>
+  <div class="kv"><i>替代风险</i><span class="jc-vcell"><span class="risk-badge" data-class-of="risk_level"></span></span>${select('risk_level', [['low', '低'], ['medium', '中'], ['high', '高']], true)}</div>
+  <div class="kv"><i>验证要求</i>${cell('verification_requirement')}</div>
+  <span class="rowkey">${cell('substitution_relation_id', 'mono')}</span>
+</section></article>`;
 
 export const DIFFERENCE_REVIEW = doc({
   css: ACC1_CSS,
@@ -785,7 +816,7 @@ export const DIFFERENCE_REVIEW = doc({
     zone('AI 结论说明', '结论是怎么算出来的', ZIC_TASK) +
     note([
       '<span class="done">AI 已完成的判定</span>:按差异规则(锁定版本 <b data-slot="rule_version" data-blank></b>),对两颗料在同一芯片类型下的每一条核心参数逐一比对,给出 MATCH / MISMATCH / UNKNOWN / CONDITIONAL 四态之一 —— 硬约束不满足即 MISMATCH,证据不足即 UNKNOWN,不会被措辞改判成 MATCH。',
-      '<span class="need">系统按规则算出</span>:推荐等级、替代风险、差异摘要、推荐理由、验证要求 —— 这五项不是 AI 编的,是规则按下面四态分布算出来的;你改动下表里任何一条四态,这五项当场重算。',
+      '<span class="need">哪些跟着四态走</span>:<b>推荐等级</b>是规则按下面的四态分布算出来的 —— 你改动下表里任何一条四态,它当场重算,不容手改(那是判据的核心)。<b>收口四格</b>(推荐理由 / 差异摘要 / 替代风险 / 验证要求)是 AI 拟的初稿,<b>可以就地改,写下的以你为准</b> —— 也正因如此,改四态<b>不会</b>把它们自动改写掉(否则你刚写的话会被冲掉);四态改完,记得回头看看这四格还对不对。',
       '<span class="need">就地核对</span>:逐条对过原 PN 与候选 PN 的取值、硬约束是否含糊放过、UNKNOWN 是否有验证去向 —— 要改就在下表里改四态、影响说明、判断依据、UNKNOWN 去向,改完保存即生效,不必重新调用 AI。',
     ]) +
     DUEL +
@@ -794,7 +825,7 @@ export const DIFFERENCE_REVIEW = doc({
     editGate('substitution.difference_item', '逐条核对结论、影响说明、判断依据,点「编辑」开表') +
     gapbar('substitution_difference_item', '必填') +
     DIFF_ITEM_TABLE +
-    zone('收口结论', '系统按规则算出,要改就去改上面的四态 —— 让人直接改这几格,等于让他给自己没做的判断盖章', ZIC_TASK) +
+    zone('收口结论', 'AI 按规则拟的初稿 —— 四格都可就地改,你写下的以你为准(改四态不会把它们冲掉,也就不会自动跟着改口)', ZIC_TASK) +
     CLOSING_SUMMARY +
     flow('<b>审批:</b>本工单只承载内容;逐条核对无误后,请在对话区的【验收卡】中确认通过。通过后进入落账放行(T_release),签字后正式落账并发口。'),
 });