资料文件真产出来了;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

packages/contracts/src/api/governance.ts

@@ -524,6 +524,12 @@ export const listActivitiesRoute = {
               label: z.string().optional(),
               /** `file` = 这一格收**真文件**(界面给文件选择器);缺席 = 普通文本格 */
               format: z.string().optional(),
+              /** 声明了枚举 → 界面给下拉选,不给自由文本框猜合法值 */
+              options: z.array(z.object({ value: z.string(), label: z.string() })).optional(),
+              /** 示例值(JSON Schema `examples` 第一项)—— 占位提示用,比裸类型名能抄 */
+              example: z.string().optional(),
+              /** 声明了 → 只在另一格(`field`)等于 `equals` 时才出现(级联下拉那类场景) */
+              showWhen: z.object({ field: z.string(), equals: z.string() }).optional(),
             }),
           ),
           /**

packages/contracts/src/api/workbench.ts

@@ -157,6 +157,40 @@ export const taskDetailSchema = z.object({
     )
     .default([]),
   workOrders: z.array(workOrderSchema),
+  /**
+   * **答过的决策卡,答完那一刻的报告快照**(2026-08-21)。
+   *
+   * `decide` 是唯一能循环的中间验收机制(`issueAcceptance` 一个任务只能发一次),
+   * 它答完不产生工单行 —— 工作成果那一屏要看见这些报告,得走这条**单独的**口:
+   * 混进 `workOrders` 会连累别处「`mode==='acceptance'` 恒是终局放行卡」的假设
+   * (如 `signed` 那处「字签下了正在落地」的判断)。呈现时前端把两份列表并显即可。
+   */
+  decidedDeliverables: z.array(workOrderSchema).default([]),
+  /**
+   * **这一单产出的资料文件** —— 工作成果里与定稿报告并列的一摞(2026-08-23)。
+   *
+   * 它不是工单快照:工单是「叫了人办的一件事」,资料是**办出来的东西本身**
+   * (白皮书 / 对照表 / 落地页)。两者混进一摞会让「几份成果」这个数说不清。
+   * 在办期间来自台账现造,放行之后来自存档 —— 两处都按 `address + key` 认,
+   * 点开走的是同一条路(`openAssetFileRoute`)。
+   */
+  assetFiles: z
+    .array(
+      z.object({
+        /** 台账地址 `域.对象` */
+        address: z.string(),
+        /** 主键(多列主键用 `列=值` 以 `,` 连)—— 与 `data-file` 里那一串同一形状 */
+        key: z.string(),
+        title: z.string(),
+        /** md | html | docx | xlsx */
+        format: z.string(),
+        name: z.string(),
+        /** 已存档的带上时刻;在办中的没有 */
+        at: z.string().optional(),
+        archived: z.boolean(),
+      }),
+    )
+    .default([]),
   chat: z.array(chatMessageSchema),
   view: z.array(viewBlockSchema),
   /** 活动推送的视图 HTML —— 容器沙箱渲染,无脚本执行权(AM 07) */
@@ -286,6 +320,29 @@ export const saveTableRoute = {
   output: z.object({ ok: z.boolean(), rows: z.number().int().min(0) }),
 } as const satisfies RouteContract;
 
+/**
+ * **点开一份资料文件** —— 件上的资料名指向哪一行,这里就把那一行现造成文件交出去。
+ *
+ * 为什么按「台账地址 + 主键」取,而不是给文件发一个 id:资料的正身是台账里那一行
+ * (标题、正文、要哪种格式都在上头),文件是它的投影。发 id 就等于另存一份,
+ * 同一份事实两处各存一份 —— 台账改了,那个 id 指的还是旧的。
+ *
+ * `raw=1` 交原字节(下载,真 .docx / .xlsx);不带就交 `FileDoc`,前端照它渲。
+ */
+export const openAssetFileRoute = {
+  method: 'GET',
+  path: '/api/desk/tasks/:taskId/file',
+  params: z.object({ taskId: taskIdSchema }),
+  query: z.object({
+    /** `域.对象` —— 必须是活动清单里声明过 `file` 段的那张表(授权面) */
+    address: z.string().min(3),
+    /** 主键值(多列主键用 `列=值` 以 `,` 连;单列主键直接给值) */
+    key: z.string().min(1),
+    raw: z.string().optional(),
+  }),
+  output: z.object({ file: fileDocSchema, fileName: z.string(), format: z.string() }),
+} as const satisfies RouteContract;
+
 /** 负责人的自由输入 —— 人事件的第二形态 */
 export const sayRoute = {
   method: 'POST',

packages/contracts/src/card.ts

@@ -86,7 +86,15 @@ const fileDocSchema = z.discriminatedUnion('kind', [
    * 渲染一律经 `@ui` 的 `ViewContainer` 沙箱,无脚本执行权(AM 07)。
    */
   z.object({ kind: z.literal('html'), name: z.string(), html: z.string() }),
-  z.object({ kind: z.literal('markdown'), name: z.string(), md: z.string() }),
+  /**
+   * Markdown —— `md` 是**原文**(下载得到的就是它),`html` 是基座渲好的那一份。
+   *
+   * 为什么渲染要在基座做:HTML 一律经沙箱呈现,而 Markdown 若在前端拼 DOM 就得
+   * `dangerouslySetInnerHTML`,那是把模型写的字直接注进父文档。基座渲的这一份
+   * 全程转义、只吐固定几种标签,再经同一个沙箱摆出来,与别的 HTML 件同一条路。
+   * `html` 缺席不是错误,是「这一份还没渲」—— 查看面照旧摆原文,不假装渲染过。
+   */
+  z.object({ kind: z.literal('markdown'), name: z.string(), md: z.string(), html: z.string().optional() }),
   z.object({
     kind: z.literal('excel'),
     name: z.string(),
@@ -514,6 +522,16 @@ export const decisionCardSchema = z.object({
       note: z.string().optional(),
     })
     .optional(),
+  /**
+   * **答完那一刻的件快照**(与 `workOrderBase.finalHtml` 同一条道理)。
+   *
+   * `decide` 是唯一能循环的验收机制(`issueAcceptance` 一个任务只能发一次,
+   * 中间验收点只能靠决策卡),但决策卡本身不是工单 —— 没有这个字段的话,
+   * 人在这张卡上通过的那份报告(如 E04 的经营计划)永远进不了工作成果:
+   * 那一屏只认 `sys.work_order`,而这一签根本没有工单行。
+   * 回传那一刻基座把当时渲好的件原样存这里,工作成果拼装时并进同一份列表。
+   */
+  finalHtml: z.string().optional(),
 });
 export type DecisionCard = z.infer<typeof decisionCardSchema>;
 

packages/contracts/src/ledger.ts

@@ -195,6 +195,28 @@ export const objectDeclarationSchema = z.object({
    * 安装期就能核:它在不在 fields 里、是不是主键的一部分。
    */
   caseKey: identifier.optional(),
+  /**
+   * **这张表的每一行还是一份资料文件** —— 哪几列合起来是那份文件(2026-08-23 加)。
+   *
+   * 起因:I01 要「真实产出资料文件」(word/excel/md/html,人点开就能看)。文件的
+   * 正身是**内容**,而内容本来就该落在台账里 —— 再单独存一份文件字节,同一份事实
+   * 两处各存一份,改一处就分叉。所以这里只声明「这一行的哪一列是标题、哪一列是正文、
+   * 哪一列说要出哪种格式」,字节由基座按声明**现造**(`composeFile`):
+   * 下载拿到的是真 .docx/.xlsx(能用 Word/Excel 打开),而它与台账永远一致。
+   *
+   * 它同时是**授权面**:没声明这一段的表,谁也点不出文件来 —— 与「写的授权面是
+   * 台账声明」「立监听的授权面是清单声明」同款。
+   */
+  file: z
+    .object({
+      /** 文件名取哪一列(空了退主键) */
+      titleColumn: identifier,
+      /** 正文取哪一列 —— 一律 Markdown 原文,四种格式都由它现造 */
+      bodyColumn: identifier,
+      /** 出哪种格式取哪一列(值:md / html / docx / xlsx) */
+      formatColumn: identifier,
+    })
+    .optional(),
   fields: z.array(fieldDeclarationSchema).min(1),
 });
 export type ObjectDeclaration = z.infer<typeof objectDeclarationSchema>;