# PR 草稿正文 — P0-a:条带 hint 按 actor 分档+actor 判别子推导(close+reopen) - **分支**:`149-p0a-actor-hint`(自 5F main `9902b2ce4` 开出,独立 worktree) - **Commit**:`3ec163e4f588b8da31000221d23ddc3079f6f459`(5 文件,+188/−9) - **状态**:本地已提交,未 push、未开 PR(按工单纪律,合并动作由 Twin 侧执行) ## 一、现象 隔离实例 N5 实测(修前段收口件八例全表):chair 持 bearer token 走 RPC close(`/rpc/group-task/close`),任务正确翻转 done、交付物 pending→accepted、状态事件如实落库 `actor_kind='chair'`(actor_globalmetaid 空串)——**账本是诚实的**。但组件条带对这行 accepted 交付物渲染的 hint 是「已通过 owner 验收」;Route-1 对照(`window.electron.groupTask.close`)落库 `actor_kind='owner'`,渲染同一句。即:**两种 actor 在账本上分家,在呈现层被合并成同一句 owner 验收——界面替账本撒谎**。同一 handler 家族的 `groupTask:reopen` 有一模一样的硬编码(「Owner-only UI action」注释旁的 `actor: { kind: 'owner' }`),是同族隐患。 ## 二、根因 根因链四级(N6a 件静态锚逐级可回): 1. **事件参数被弃用**:`registerIpcHandler('groupTask:close', async (_event, input) => …)` 把事件判别子丢成 `_event`,调用方身份在 handler 内失去来源; 2. **actor 写死兜底**:失去来源后硬编码 `actor: { kind: 'owner' }`,注释「The UI close action is the owner's」把「UI 动作=owner」的假设固化进代码;reopen 同型; 3. **假设可被远程穿透**:按 REQ-A-12/13,网关 invoke 与渲染端 invoke 走**同一** handlers map(`ipc/registry.ts` 注册与 `invokeRegisteredHandler` 读取同源),且 allowlist 把全部 16 条 `groupTask:*` 通道暴露为 P2——网关侧 chair 调用会落进这个「owner 假设」; 4. **呈现层只读 status 位**:i18n key `groupTasksDeliverableStatusAcceptedHint`(「已通过 owner 验收」)的分支只看 `deliverable.status === 'accepted'`,不读落库 actor——于是「谁验收的」这一维度在渲染层无处安放,两种 actor 合流成一句。 ## 三、修法 - `src/main/ipc/registry.ts`:新增 `isGatewayInvokeEvent()` 判别守卫——按 REQ-A-13 冻结形态判别(合成事件带 `gateway.clientId` 且 sender/senderFrame 为 null;渲染端 invoke 有真实 senderFrame 无 `gateway`); - `src/main/main.ts`:close 与 reopen 两处 `_event` 改回 `event` 并被实际读取,actor 改为 `isGatewayInvokeEvent(event) ? { kind: 'chair' } : { kind: 'owner' }` 从判别子推导——**零硬编码**(全文件 `actor: { kind:` 字面量清零,推导式是唯一来源); - `src/renderer/components/groupTasks/GroupTaskDetailView.tsx`:新增 `acceptedActorKind` memo,从 `detail.statusEvents`(落库、newest first)取**末次 close-to-done 事件**的 `actor_kind` 分档——chair 走新 chair 档 key,其余(owner/system/无事件旧行)保持 owner 档;不读 session 状态、不做 UI 现场推断; - `src/renderer/services/i18n.ts`:新增 `groupTasksDeliverableStatusAcceptedHintByChair`(zh「已由主席代为关闭——最终验收待定」/en「Closed by the chair (proxy close) — final acceptance pending」)——chair 档文案**不含**「owner 验收」/「Accepted by the owner」字样(不得出现式判定,测试断言固化); - `tests/ncase-presentation.test.tsx`:承袭修前三例(N1/N2/N5),N5 由「chair 代闭仍渲染 owner 文案」红复现翻绿为修后判据:chair 代闭渲染 chair 文案、整页不得出现 owner 验收文案、落库 status event 的 actor 进状态史渲染。4/4 全绿。 **范围声明(P0-b 边界)**:本 PR 不改 chair close 写什么 status(仍 accepted,枚举语义归 P0-b 单列);chair 档文案「最终验收待定」在现行(P0-b 之前)账本语义下即为诚实表述。修后回归 N5b 由修复方跑、AI_Sunny 复验,不构成本 PR 的合入门。 ## 四、证据锚(审计链件,可点回) | 件 | 角色 | pin | |---|---|---| | 修前证据包裹(含勘误链) | #149 修前段主证 | pin://232899edfbeb0bca9dd2b2f7af6d75d353db40223d65778f75a331521de9e5e5i0 | | N6a 静态锚件(两处硬编码定位+网关同源) | 根因链 1–3 级锚 | pin://9328c9944365174dd2f17230707e1f66bdb154f9e6908a66130d9188bdf4c72di0 | | 修前段收口件(八例全表+N5/Route-1 对照) | 现象段数据源 | pin://503ab7c6e24dc97fdce7d9dd9eb17551c5f37b6121d19440d663c2b821b43bf0i0 | | 收口件联署(AI_Sunny) | 收口件独立核读 | pin://9cd7859324ce3f6ba1d66777f16e914e3c1a30577b2044dea10f4a9386cf69a4i0 | | 验收契约判据件(PR done 定义) | 本 PR 判据基准 | pin://0ba8a0db6130247a2f1bdb3b97925122552dadbc4b8da7404ec72f6a09bdf26ei0 | | 判据件联署 | 契约双签第二签 | pin://b0eaf6f3bf8d9bd1353bc2ceee04c6059f581fc5c5edb32b5475fdc82ca7dcaei0 | | 校验器基准 v0.1.4 生效引用(correction) | N5b 随件自检基准 | pin://ffa65a3627dbdfc784150c77c27711ab440e9c888a4849d1cf7ed7e1e6745f1ai0 | | correction 联署 | 生效引用双签 | pin://9f6055a6232310e1cf4b0030dd639340939722a368cf35c65244d4ba58f983b0i0 | | ncase 测试原文(链上件) | 测试承袭源头 | pin://16b63f23cec3e2aa65b7ac390dd60b9e3fb5dd0c3d5c1467f9042e649d60e834i0 | | 静态终判 v2(佐证链) | 修前静态判 | pin://82b45decbe96361a6fa7619788d6faa4ac1726edfe6a0b84a0f2c27fe722b202i0 | | 组件级证明(佐证链) | 修前组件级判 | pin://848fefa8e8f496dadc3baa980ed32bd6dc53709d670dcfbd2fd3601b0e8cb2ffi0 | | AI_Sunny 联署件(佐证链) | 修前段复验 | pin://d539624e6a9974b592f3f54bffdf160546aa705414ba452eaf0366b530e3b2f9i0 | 链上指纹注记:测试承袭源的工作文件 sha256 = `fc115127da7609cf6641b1571b3a64a76a20d0fd4e13a0da21523906139c60fa`(105 行),与链上件内声明指纹一致;此前「链上提取字节九形态未复算」的差异出在围栏提取形态,仓库入库后以 git blob sha 为准锚。