资料文件真产出来了;E04/I01 补到验收线,顺手填了几个「墙拦住却不给路」的坑

**资料文件全链**(用户:审核资料这一步要真产出 word/excel/md/html,前端能渲、点资料名能开)
接手时这一步一个文件都产不出来 —— S3 剧本白纸黑字写着「file_ref 本 MVP 阶段可留空」。
文件是台账那一行的投影,不另存一份:
· 声明 `file:{titleColumn,bodyColumn,formatColumn}`,它同时是授权面(没声明就点不开)
· 现造真字节 —— docx/xlsx 是自己打的 OOXML 包(zip-write:store+CRC32,零依赖)
· 读回来渲 —— 解的就是造出来那份字节,渲得出来才证明文件是真的
· 件上 `data-file-of` → 工作区二级界面(Word 纸面/Excel 网格/渲好的 md/沙箱 html)+ 下载原件
放行落地前把每一份冻进 `sys.task_asset_file`(迁移 0029):归档件点开的必须是签字那一刻
那一份,而资料落在主数据上、试跑单不落正式表 —— 不存这一份,收工后一个都点不开。
工作成果里「产出的资料」自成一摞。Markdown 富文本渲染顺带销账(仍零依赖)。

**Harness**
· 画面按「这一拍办完之后」在办的那一步挑 —— 从前拿拍首的局面决定拍尾的事:
  收掉 S4、发出 S5 的卡,而屏上还摆着 S4 的只读件,人无处可填(墙要配路第四次现形)
· 验收「重做」真能退回重做,且打回后台账没动就不许再提交(软硬两段,不锁死单子)
· 立监听的授权面是清单声明;发卡的授权面是调人预算,不是计划项
· 读工具同参重调有兜底;空转写身后还有行动就不废串;finish 的 doneWhen 按写完后的草稿算

**界面**
· 翻件与翻页各归各位(从前二选一,多卡多页时页翻不动);没得翻写「—」不写 0/0
· 工作成果详情能翻份;表宽超出能横滑(E04/I01 抄版式时把 overflow-x 抄丢了)
· 查看面灰底滚过一屏变白 —— 两条独立的路都治了(沙箱内不同色 / 弹性子项不长个)
· 测试台「取不到」不再当成「还活着」

**活动**
E04 关系覆盖、I01 品牌内容各自补到验收线:判据全读基座数、判据指向的东西摆上卡面、
样例满载且名字 ≤14 字;提交前要裁的判据搬进说明书(模型会压拍,压过之后只有说明书还在)。

验收:e2e i01 4/4、e04 3/3 全部 released,资料在办中渲得出、放行后存了档点得开;
门禁 typecheck/lint/depcruise/1628 测全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX
This commit is contained in:
xcs
2026-08-24 10:26:45 +08:00
co-authored by Claude Opus 5
parent 70e83d0b09
commit 0aa2fc11b0
92 changed files with 13984 additions and 370 deletions
+68 -1
View File
@@ -37,6 +37,7 @@ import type { TriggerService } from '@modules/trigger';
import { evaluate as evalSfeel, evaluateCondition, evaluateUnaryTest } from '@sfeel';
import type { StaffId, TaskId } from '@contracts';
import { cardIdSchema, staffIdSchema } from '@contracts';
import { archiveAssetFiles } from '../asset-archive.ts';
import { createAgentRunner } from '../agent-runner.ts';
import { createMastraAgentRunner } from '../mastra-agent-runner.ts';
import type { Clock, IdGenerator } from '../runtime.ts';
@@ -673,6 +674,12 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
const owner = task === undefined ? undefined : await deps.org.getStaff(task.ownerId).catch(() => undefined);
const ownerLabel = owner === undefined ? '' : `${owner.name} · ${owner.position.name}`;
const origin = task?.origin === 'testbed' ? '试跑起单' : '通道入站';
/*
* **这一单的任务号** —— 工单模版卡头「关联任务」那一格(E04 目标件 §6.2 点名的
* 共用动态位)。与归属签同理:任务号是基座的事实,活动写不出也不该写;
* 全长 UUID 如实给,摆多长由模版自己的样式定(截断是排版,不是数据)。
*/
const taskRef = task === undefined ? '' : String(taskId);
/*
* **这一单算出来要走哪一口** —— 报告上那张分支判定表要标出命中的是哪一行。
*
@@ -703,6 +710,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
'case:openedAt': openedAt,
'case:origin': origin,
'case:owner': ownerLabel,
'case:taskId': taskRef,
...route,
...own,
}),
@@ -797,7 +805,22 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
const declared = manifest.declarations.ledger;
// 工具调用是**留痕里的事实**:判据要说「亲查过行情」,得有一边不是活动自报的
const trail = await deps.memory.window(taskId, 400);
return {
/*
* **开案时刻要真的在 Agent 的作用域里**(2026-08-22,E04 实测逼出来的):
* 说明书写着「round_ref = case:openedAt 按 YYYYMMDDHHmmss 格式化(引擎注入的
* 开案时刻)」,而这个键从前只注进**视图渲染**那一侧,Agent 的任务视图里没有 ——
* 模型只能自己编;正式表里一旦有别单的案号,它就照抄(A2 治过的「从台账借号」
* 同款),测试台里所有单于是共用同一个号,跨单主键相撞、上一单的正式行渗进
* 下一单的读面。给全到秒(视图那份只到分,是给人看的;这份是给铸主键用的)。
*/
const two = (n: number): string => String(n).padStart(2, '0');
const opened = new Date(task.startedAt);
const openedAt = Number.isNaN(opened.getTime())
? ''
: `${opened.getFullYear()}-${two(opened.getMonth() + 1)}-${two(opened.getDate())} ` +
`${two(opened.getHours())}:${two(opened.getMinutes())}:${two(opened.getSeconds())}`;
const enriched: Record<string, unknown> = {
'case:openedAt': openedAt,
...scope,
...rowReadings(mine, declared),
...rowKeyList(mine, declared),
@@ -806,6 +829,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
...toolCallReadings(trail, manifest.declarations.tools),
...mine,
};
return enriched;
},
/**
* 本活动声明过的台账对象 —— 清单 `declarations.ledger` 就是这份名单。
@@ -955,6 +979,12 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
});
return { id: listener.id };
},
/** 立监听的授权面 —— 活动清单声明过的那几种(见 port.ts 的注释) */
async declared(taskId: TaskId) {
const { activityId } = await taskContext.of(taskId);
const manifest = await deps.registry.manifestOf(activityId);
return manifest.declarations.listeners.map((l) => ({ eventType: l.eventType, keyFilter: l.keyFilter }));
},
};
/**
@@ -2094,6 +2124,43 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
* 在一张验收单上改几十行是另一件事。
*/
await applyRevisions(input.taskId);
/*
* **产出的资料文件在这儿冻住** —— 修订刚落回草稿层、合并还没发生:
* 存下来的正是他签字那一刻的样子(与工单的 `finalHtml` 快照同一个道理)。
*
* 为什么非存不可,而不是回头照台账现造:资料常落在**主数据**上,
* 而试跑单放行时主数据只留在活动缓存、不落正式表 —— 不存这一份,
* 试跑单一放行,人在工作成果里就什么都点不开了。正式单则是另一头的理由:
* 台账后来被下一单改了,归档件不该跟着改口。
* 存不下来不拦放行(资料是成果的一份,不是放行的前提):记一条痕,人看得见。
*/
try {
const manifest = await deps.registry.manifestOf((await taskContext.of(input.taskId)).activityId);
const saved = await archiveAssetFiles({
db,
taskId: input.taskId,
ids,
declarations: manifest.declarations.ledger,
rowsOfAddress: async (address) =>
(
await deps.ledger.taskView(input.taskId, { address, where: {}, orderBy: [], limit: 500, offset: 0 })
).rows as Array<Record<string, unknown>>,
});
if (saved > 0) {
await memoryRecorder.append({
taskId: input.taskId,
kind: 'ledger-write' as never,
title: `产出的资料已存档:${saved} 份(工作成果里点得开)`,
detail: { assetFiles: saved },
});
}
} catch (error) {
await memoryRecorder.append({
taskId: input.taskId,
kind: 'result',
title: `资料存档没做成:${error instanceof Error ? error.message : String(error)}`,
});
}
const outcome = await deps.release.land({
taskId: input.taskId,
ownerId: input.ownerId,