feat: precipitate grid presentation (row/column/region) into skill contract

Release v1.0.110: 沉淀壳子页与页面调用契约
docs: document JobStopped and lease cleanup contract for interrupt
2026-09-20 21:08:23 +08:00 · 2026-09-19 16:23:23 +08:00 · 2026-09-17 13:26:28 +08:00 · 2026-09-12 14:08:33 +08:00
33 changed files with 663 additions and 116 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,28 @@
 - 小节正文写用户能看懂的变化（新能力、修复、注意事项），避免堆砌内部实现细节
 - 打 tag 前**必须**为即将发布的版本新增一节；找不到匹配小节时，本次发布不会更新 changelog 字段

+## 1.0.111
+
+- 沉淀数据管理呈现加法：同一 `cellPresentation.enabled` 支持单元格、整行、整列、行列交叉区域（闭集 tone）
+- 新增 `_jiangchang_grid_presentation` 契约 / Schema / 示例；v1 `cells[]` 保持不变；禁止整表 `all`×`all`；整行色只涂表格、不铺到详情字段
+- 内部隐藏表补上两张呈现旁路表；模板默认仍不启用着色
+
+## 1.0.110
+
+- 数据管理侧栏除了生成出来的 HTML 快照，也会直接显示安装包里 `assets/html/pages/` 的页面，装完就有，不用点生成
+- 这些页面可以调用本技能已经声明的命令：宿主代为执行 Python，把 JSON 交回页面
+
+## 1.0.109
+
+- 沉淀任务中断与账号租约契约：禁止用裸 `except Exception` 吞掉 `JobStopped`；`finally` 先释租约再关浏览器；宿主只通知不代收租约
+- 补充 CHECKLIST A5-13（中断后租约须释放）及 ACCOUNT_MANAGER / LOGGING / ADAPTER / 样例 README
+
+## 1.0.108
+
+- 沉淀数据管理「用户可见文案」契约：弹窗 description / 确认黄条 / 参数说明 / 任务失败 message 须全中文产品用语
+- 明确禁止把字段名、CLI 子命令、async/pending、Agent 禁令写进用户可见文案；Agent 路由仍放 SKILL.md
+- 修正 `selection-mode-optional` 示例为口语文案；更新 ACTIONS / RUNTIME / CHECKLIST A4-10
+
 ## 1.0.107

 - 沉淀数据管理 `bind.selectionMode` 契约（`required` / `none` / `optional`）：同一按钮可「有勾选走 ids、无勾选走 pickCount」
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: 技能开发模板（通用业务版）
 description: "OpenClaw 通用业务技能开发模板，供复制后定制新业务 skill。定制步骤见 development/DEVELOPMENT.md。"
-version: 1.0.107
+version: 1.0.111
 author: 深圳匠厂科技有限公司
 metadata:
  openclaw:
@@ -39,11 +39,12 @@ allowed-tools:
 - **`placements`**：只决定 Action **出现在哪里**（toolbar / row / batch / cron / agent / skill-detail）。其中 `row` 表示**行级入口**（宿主可呈现为操作列、行右键、行内「⋯」等；技能配什么就显示什么，无独立菜单 DSL）。数据管理技能按钮顺序见 `actions` **数组相对顺序**（详见 `references/ACTIONS.md`），无独立 sortOrder。
 - **`bind.tables`**：只决定数据管理出现在哪些表；含 `toolbar` 时**必须**显式非空绑定。
 - **`bind.selectionMode`（可选）**：表勾选如何驱动 Action（`required` / `none` / `optional`）；省略由宿主推断。同一能力勿拆两个同义顶栏按钮，见 `references/ACTIONS.md`。
+- **用户可见文案**：数据管理弹窗 / 任务中心文案须全中文产品用语；勿把 `pickCount`、`async`、`pending`、CLI 子命令写进弹窗（见 `references/ACTIONS.md`「用户可见文案」）。
 - **`executionProfile`**：只决定执行方式——`sync` 当场返回结果，`async` 进**任务中心**。与 placements / 入口**无关**。心智上多数为 sync，仅长任务 / RPA 标 async；宿主省略该字段时按 sync。每个 Action **仍必须**显式写 `sync` 或 `async`。
 - **`policy`（可选）**：需要按用户/角色控制数据管理按钮或行列时，在 `actions.json` 顶层启用 Data Policy，由技能 `policy` CLI 输出 Snapshot；**未启用 = 与今日一致（L0）**。详见 `references/POLICY.md`。用户/角色数据源（飞书/库/API）属技能内部，宿主不托管。
- **`cellPresentation`（可选）**：需要数据管理「某格特殊标色/强调」时启用；技能按当前数据写入呈现（语义 tone），宿主映射主题样式；**未启用 = P0 无标色**。用途不限（超时、预警、驳回等）。详见 `references/CELL_PRESENTATION.md`。
+- **`cellPresentation`（可选）**：需要数据管理「某格 / 整行 / 整列 / 区域」特殊标色时启用；技能按当前数据写入呈现（语义 tone），宿主映射主题样式；**未启用 = P0 无标色**。用途不限（超时、预警、驳回等）。详见 `references/CELL_PRESENTATION.md`。
 - **业务行生命周期（有处理队列时）**：对某一行做生成/触达/私信等处理时，默认只操作「可操作」角色状态；开始抢占「进行中」；结束回写成功或失败（失败带原因）；重做靠人工改回可操作。状态名由本技能自定。详见 `references/WORK_ITEM_STATUS.md`。
- **同步数据**写技能本地库、不生成导出文件；**导出当前表**由宿主数据管理负责；文件型特殊报告才另做 `export-*`（落 `output/`）；**HTML 整页报告**写 `html/` 并用固定 Action id `render-html`（见 `references/ACTIONS.md`）。
+- **同步数据**写技能本地库、不生成导出文件；**导出当前表**由宿主数据管理负责；文件型特殊报告才另做 `export-*`（落 `output/`）；**HTML**：壳子页放 `assets/html/pages/`，快照写 `html/` 并用固定 Action id `render-html`；页面用 `jiangchang.call` 调已声明命令（见 `references/ACTIONS.md`）。
 - **准备 vs 执行（适用则拆）**：若技能存在「先写入/准备本地数据」与「再对外产生副作用」两段，Agent 必须能分开触发；禁止默认绑成不可拆的一步。一键无准备态的技能可跳过本条。

 ### 如何触发（能力类型）
--- a/assets/README.md
+++ b/assets/README.md
@@ -2,11 +2,12 @@

 - `actions.json`：Skill Action manifest 最小示例（按入口定位表决定是否保留/扩展；见 `development/PRODUCT_SURFACES.md`）。每个 action **必须**显式声明 `executionProfile`（`sync` \| `async`）。默认仅 `health` / `version` / `config-path`，不放 toolbar，故无 `bind` 示例。
 - **业务技能注意：** 若主路径在数据管理，准备/载入/导入类 Action 应挂 `toolbar` + `bind.tables`（用户看得见），**不要**只挂 `skill-detail` 却在教程里写成「技能详情点按钮」。见 `development/TUTORIAL_SURFACES.md` §5、`references/ACTIONS.md`「用户可见性」。
- `html/example-report.html`：HTML 报告页最小壳（`{{TITLE}}` / `{{GENERATED_AT}}` / `{{BODY}}`）；含数据管理 iframe 预览布局基线（流体铺满、禁横向滚动）；渲染后须写入数据目录 `html/`，见 `references/ACTIONS.md`「HTML 页面报告」。
+- `html/example-report.html`：HTML 快照页最小壳（`{{TITLE}}` / `{{GENERATED_AT}}` / `{{BODY}}`）；含数据管理 iframe 预览布局基线（流体铺满、禁横向滚动）；渲染后须写入数据目录 `html/`。不要放进 `pages/`。
+- `html/pages/*.html`：装完就出现在侧栏的壳子页（宿主直接读安装包，不经生成）。页面用 `jiangchang.call` 调本技能已声明的命令。见 `references/ACTIONS.md`「HTML 页面报告」。模板仓库不要在这里放示例页。
 - `examples/`：CLI 成功输出形状示例、Action 形状参考（含 `path-root-file-action.example.json`、`selection-label-column.action.example.json`、`selection-mode-optional.action.example.json`、`render-html.action.example.json` 等；虚构路径与数据）。
 - `schemas/`：轻量 JSON Schema（`skill-actions.schema.json` 为**新技能严格规范**）。

-`skill-actions.schema.json` 使用 `additionalProperties: false`。正式支持 `bind.tables`（toolbar Action 必填）与可选 `bind.inputMapping` / `columnMapping` / **`labelColumn`**（选择摘要标签列）/ **`selectionMode`**（`required` \| `none` \| `optional`：表勾选如何驱动 Action；省略则宿主兼容推断）。placements 含 `toolbar` / `row` / `batch` / `cron` / `agent` / `skill-detail`（对齐匠厂宿主）。数据管理 confirm/form 弹层在会应用勾选时展示「已选择」摘要；**form + 有摘要时映射 `readOnly` 默认不占参数区（仍提交）**，可选 **`revealInForm`** 强制显示。可选 `hoverHint` 为数据管理工具栏悬停（省略不显示，不回退）。`concurrency`/`locks` 仍为预留。`placements` 与 `executionProfile` 正交——进任务中心只看 `async`，与入口无关。表级 Action 与 Agent 契约见 [`references/ACTIONS.md`](../references/ACTIONS.md)；开发深度规范见 [`development/SKILL_ACTION_RUNTIME.md`](../development/SKILL_ACTION_RUNTIME.md)。
+`skill-actions.schema.json` 使用 `additionalProperties: false`。正式支持 `bind.tables`（toolbar Action 必填）与可选 `bind.inputMapping` / `columnMapping` / **`labelColumn`**（选择摘要标签列）/ **`selectionMode`**（`required` \| `none` \| `optional`：表勾选如何驱动 Action；省略则宿主兼容推断）。placements 含 `toolbar` / `row` / `batch` / `cron` / `agent` / `skill-detail`（对齐匠厂宿主）。数据管理 confirm/form 弹层在会应用勾选时展示「已选择」摘要；**form + 有摘要时映射 `readOnly` 默认不占参数区（仍提交）**，可选 **`revealInForm`** 强制显示。弹窗 `description` / 确认黄条 / 参数说明须**用户可见中文**（勿写 `pickCount`/`async`/`pending`/CLI 子命令；见 ACTIONS.md「用户可见文案」）。可选 `hoverHint` 为数据管理工具栏悬停（省略不显示，不回退）。`concurrency`/`locks` 仍为预留。`placements` 与 `executionProfile` 正交——进任务中心只看 `async`，与入口无关。表级 Action 与 Agent 契约见 [`references/ACTIONS.md`](../references/ACTIONS.md)；开发深度规范见 [`development/SKILL_ACTION_RUNTIME.md`](../development/SKILL_ACTION_RUNTIME.md)。

 - 用户市场四 Tab 见根目录 [`README.md`](../README.md) / [`TUTORIAL.md`](../TUTORIAL.md) / [`DEMO.md`](../DEMO.md) / [`CHANGELOG.md`](../CHANGELOG.md)；写法契约见 [`development/TUTORIAL_SURFACES.md`](../development/TUTORIAL_SURFACES.md)
 - Agent 调用/编排参考见 [`references/`](../references/)（含 [`ACTIONS.md`](../references/ACTIONS.md)）
--- a/assets/examples/README.md
+++ b/assets/examples/README.md
@@ -3,9 +3,10 @@
 - `version-response.json`：`python main.py version` 成功时 stdout 单行对象的形状参考。
 - `skill-policy-snapshot.*.example.json`：Data Policy Snapshot 形状参考（见 `references/POLICY.md`）。
 - `skill-cell-presentation.example.json`：数据管理单元格呈现文档形状参考（见 `references/CELL_PRESENTATION.md`）。
+- `skill-grid-presentation.example.json`：数据管理整行 / 整列 / 区域呈现文档形状参考（见 `references/CELL_PRESENTATION.md`）。
 - `render-html.action.example.json`：HTML 报告「重新生成」Action 形状参考（固定 id `render-html`；见 `references/ACTIONS.md`）。
 - `lookup-action.example.json`：Action 内联 Lookup 形状参考（单选 + `multiple: true` 多选并列；跨表引用勿填编号；见 `references/ACTIONS.md`「跨表引用：Lookup」）。
 - `visible-when-action.example.json`：Action 参数字段条件显隐 `visibleWhen` 形状参考（互斥模式联动；见 `references/ACTIONS.md`「字段条件显隐」；≠ Policy L3）。
 - `selection-label-column.action.example.json`：选择摘要 `bind.labelColumn` 形状参考（见 `references/ACTIONS.md`「选择摘要」）。
- `selection-mode-optional.action.example.json`：`bind.selectionMode: "optional"` 智能勾选/按数量合并形状参考（见 `references/ACTIONS.md`「勾选驱动模式」）。
+- `selection-mode-optional.action.example.json`：`bind.selectionMode: "optional"` 智能勾选/按数量合并形状参考；用户可见文案为口语中文（见 `references/ACTIONS.md`「勾选驱动模式」「用户可见文案」）。
 - `replaces-create.action.example.json` / `replaces-update.action.example.json` / `replaces-delete.action.example.json` / `replaces-import.action.example.json`：数据管理默认按钮接管（`replaces`）形状参考；**import 时 UI 仍用宿主「导入数据」面板**，确认后调技能写库（见 `references/ACTIONS.md`「`replaces`」）。
--- a/assets/examples/selection-mode-optional.action.example.json
+++ b/assets/examples/selection-mode-optional.action.example.json
@@ -1,12 +1,12 @@
 {
  "id": "process-queue",
  "label": "处理队列",
-  "description": "有勾选则按编号处理；无勾选则按 pickCount 从可操作队列领取。示例：bind.selectionMode=optional，避免拆成两个同义顶栏按钮。",
+  "description": "从业务队列处理待处理记录。有勾选则处理勾选的；没有勾选则按下方数量从队列领取。已成功或失败的会自动跳过。进度可在任务中心查看。",
  "placements": ["toolbar", "batch", "cron", "agent"],
  "executionProfile": "async",
  "interaction": "form",
  "confirmation": {
-    "message": "将按技能业务规则处理记录（有勾选则处理勾选；未勾选则按数量从队列领取）。"
+    "message": "将按规则处理记录（有勾选则处理勾选的；未勾选则按数量从队列领取），是否继续？"
  },
  "bind": {
    "tables": ["business_items"],
@@ -23,13 +23,13 @@
      "itemIds": {
        "type": "string",
        "title": "编号列表",
-        "description": "勾选时由宿主预填；无勾选时不要传",
+        "description": "有勾选时自动填入，一般无需修改",
        "readOnly": true
      },
      "pickCount": {
        "type": "number",
        "title": "处理数量",
-        "description": "未勾选时：从队列领取可操作状态记录的条数",
+        "description": "没有勾选时：从待处理队列里领取的条数",
        "default": 1,
        "minimum": 1
      }
--- a/assets/examples/skill-grid-presentation.example.json
+++ b/assets/examples/skill-grid-presentation.example.json
@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 1,
+  "skill": "your-skill-slug",
+  "table": "business_records",
+  "rowKey": "id",
+  "generatedAt": "2026-08-10T06:00:00Z",
+  "rules": [
+    {
+      "ruleKey": "qty-low-rows",
+      "rows": ["42", "99"],
+      "columns": "all",
+      "tone": "danger",
+      "message": "库存低于安全线",
+      "alert": true
+    },
+    {
+      "ruleKey": "status-column",
+      "rows": "all",
+      "columns": ["status"],
+      "tone": "warning",
+      "message": "待审核"
+    },
+    {
+      "ruleKey": "overdue-print-region",
+      "rows": ["7", "8"],
+      "columns": ["print_done_at", "ship_done_at"],
+      "tone": "danger",
+      "message": "环节到期未填",
+      "alert": true
+    }
+  ]
+}
--- a/assets/naming/platforms.txt
+++ b/assets/naming/platforms.txt
@@ -11,3 +11,4 @@ lianlian
 single-window
 export-rebate
 etax
+colipu
--- a/assets/schemas/skill-actions.schema.json
+++ b/assets/schemas/skill-actions.schema.json
@@ -28,7 +28,7 @@
    },
    "cellPresentation": {
      "$ref": "#/$defs/cellPresentationDeclaration",
-      "description": "可选。启用数据管理单元格呈现（P1）。缺省或不 enabled = P0，宿主不读标色。详见 references/CELL_PRESENTATION.md。"
+      "description": "可选。启用数据管理呈现（P1：格子/行/列/区域）。缺省或不 enabled = P0，宿主不读标色。详见 references/CELL_PRESENTATION.md。"
    }
  },
  "$defs": {
--- a/assets/schemas/skill-cell-presentation.schema.json
+++ b/assets/schemas/skill-cell-presentation.schema.json
@@ -2,7 +2,7 @@
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://openclaw.local/skill-template/skill-cell-presentation.schema.json",
  "title": "SkillCellPresentationDocument",
-  "description": "匠厂数据管理「单元格呈现」文档（schemaVersion 1）。技能按业务规则为「某表某行某列」声明语义 tone（非任意 CSS）；宿主映射主题样式。用途不限（时效超时、库存预警、状态异常、必填缺失等）。详见 references/CELL_PRESENTATION.md。",
+  "description": "匠厂数据管理「单元格呈现」文档（schemaVersion 1）。技能按业务规则为「某表某行某列」声明语义 tone（非任意 CSS）；宿主映射主题样式。整行/整列/区域见 skill-grid-presentation.schema.json，同一 cellPresentation.enabled。用途不限（时效超时、库存预警、状态异常、必填缺失等）。详见 references/CELL_PRESENTATION.md。",
  "type": "object",
  "required": ["schemaVersion", "skill", "table", "rowKey", "cells"],
  "additionalProperties": false,
--- a/assets/schemas/skill-grid-presentation.schema.json
+++ b/assets/schemas/skill-grid-presentation.schema.json
@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openclaw.local/skill-template/skill-grid-presentation.schema.json",
+  "title": "SkillGridPresentationDocument",
+  "description": "匠厂数据管理「Grid Presentation」文档（schemaVersion 1）。技能按业务规则为 rows×columns 声明语义 tone（整行、整列、区域或单格）；禁止 all×all。非任意 CSS。与 skill-cell-presentation.schema.json（v1 cells[]）并存，同一 cellPresentation.enabled。详见 references/CELL_PRESENTATION.md。",
+  "type": "object",
+  "required": ["schemaVersion", "skill", "table", "rowKey", "rules"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "skill": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "minLength": 1,
+      "description": "与 SKILL.md metadata.openclaw.slug / actions.json skill 一致"
+    },
+    "table": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "业务表物理名（snake_case）"
+    },
+    "rowKey": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "用于匹配行的业务表列名（如 id）；rules[].rows 的 id 取自该列"
+    },
+    "generatedAt": {
+      "type": "string",
+      "minLength": 1,
+      "description": "可选。ISO-8601 或技能约定的生成时间，便于排障"
+    },
+    "rules": {
+      "type": "array",
+      "description": "当前应对该表生效的 grid 规则；空数组 = 该表无 grid 呈现（清除旧行/列/区域样式）。同 ruleKey 由 UNIQUE 约束覆盖。",
+      "items": { "$ref": "#/$defs/ruleItem" }
+    }
+  },
+  "$defs": {
+    "tone": {
+      "type": "string",
+      "enum": ["danger", "warning", "info", "success", "muted"],
+      "description": "语义色板（闭集）。宿主映射到底色/字色/左边线等；禁止技能下发原始 CSS 或任意 hex。"
+    },
+    "axisTarget": {
+      "description": "\"all\" = 该轴全部；非空字符串数组 = 有限集合（行 id 或列名）",
+      "oneOf": [
+        { "type": "string", "const": "all" },
+        {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      ]
+    },
+    "ruleItem": {
+      "type": "object",
+      "required": ["ruleKey", "rows", "columns", "tone"],
+      "additionalProperties": false,
+      "not": {
+        "properties": {
+          "rows": { "const": "all" },
+          "columns": { "const": "all" }
+        },
+        "required": ["rows", "columns"]
+      },
+      "properties": {
+        "ruleKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200,
+          "description": "本表内唯一。建议稳定业务键（重算时覆盖同一条）"
+        },
+        "rows": { "$ref": "#/$defs/axisTarget" },
+        "columns": { "$ref": "#/$defs/axisTarget" },
+        "tone": { "$ref": "#/$defs/tone" },
+        "message": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "可选。悬停/无障碍说明（短文案）；不要塞长报告"
+        },
+        "alert": {
+          "type": "boolean",
+          "description": "可选，默认 false。true = 按本条规则计入进页/同步提醒（不按命中格子数）"
+        }
+      }
+    }
+  }
+}
--- a/development/ACCOUNT_MANAGER.md
+++ b/development/ACCOUNT_MANAGER.md
@@ -173,7 +173,9 @@ python scripts/main.py account open <account_id>
 - 租约持有者应使用技能 slug 或可追踪任务标识，`purpose` 写明用途。
 - 租约 TTL 应覆盖正常任务时长；长任务需要平台支持的续租策略，不能依赖永不过期。
 - `finally release_lease(...)` 是最低要求，浏览器关闭失败也不能跳过释放尝试。
- 进程被强制结束后可能留下租约；先用 `lease list --active` 核对，确认没有真实任务仍在使用后再释放或清理。
+- **清理顺序**：`finally` 内**先 `release_lease`，再关浏览器**。关浏览器（含 CDP / 强杀 Profile 进程）可能耗时或卡住；先释租约可避免「窗还没关完、账号已被下一任务抢走失败」的空窗拉长。
+- **任务中心中断**：宿主只下发 `stop` 并等待技能退出；技能须在闸门抛出 `JobStopped` 后进入 `finally` 自清。禁止用 `except Exception` 吞掉 `JobStopped`（详见 [`LOGGING.md`](LOGGING.md) §2.5）。不要指望宿主代收租约。
+- 进程被强制结束后可能留下租约；先用 `lease list --active` 核对，确认没有真实任务仍在使用后再释放或清理；亦可等待 TTL 过期。
 - 禁止看到租约冲突就直接删数据库记录、删 Profile、换账号或新建重复账号。

 ## 9. 工业级测试
@@ -184,6 +186,7 @@ python scripts/main.py account open <account_id>
 - 账号不存在、平台不匹配、Profile 缺失、返回格式异常；
 - 同一账号并发抢占和 `LEASE_CONFLICT`；
 - 业务成功、业务失败、用户取消、浏览器崩溃后的租约释放；
+- **NEED_MANUAL** 任务中心运行中点「中断」：租约变为 `released`（或无 active），马上再采不因残留租约 `LEASE_CONFLICT`；
 - 登录过期、验证码 / 二次验证、账号风险和权限不足；
 - 两个以上账号轮换且 Profile、登录态、结果互不污染；
 - 关闭重开后登录保持；
--- a/development/ADAPTER.md
+++ b/development/ADAPTER.md
@@ -102,7 +102,7 @@ def get_adapter():
 2. **普通兄弟技能调用**，优先走统一 **`service.sibling_bridge`**（`call_sibling_json`），**不要**在 `task_service.py`、`task_rpa.py` 等业务流程文件中到处散落 `subprocess.run`。
 3. **account-manager 账号/租约能力**是例外：可参考 `examples/real_browser_rpa/scripts/service/account_client.py` 与 `examples/simulator_browser_rpa/scripts/service/account_client.py`，封装为**单一** `account_client.py`；允许在该文件内部集中通过 subprocess 调 account-manager CLI。**禁止** import `rpa_helpers` 等 account-manager 内部模块；`simulator_rpa` 与 `real_rpa` 均走同一 `pick_web_account` / `release_lease` 模式。
 4. **不允许**直接 `import account-manager` 的内部 Python 模块（如 `service/`、`util/`、`db/`）。
-5. **所有选择路径都必须取得 lease**：包括纯数字 `DEFAULT_ACCOUNT_ID`。`account get <id>` 只能读取账号，不能单独作为运行结果；必须再通过可定位该账号的 pick 流程取得非空 `lease_token`。随后必须 `finally release lease`；进程被 kill 后可能残留 lease，需按 [`ACCOUNT_MANAGER.md`](ACCOUNT_MANAGER.md) 排查。
+5. **所有选择路径都必须取得 lease**：包括纯数字 `DEFAULT_ACCOUNT_ID`。`account get <id>` 只能读取账号，不能单独作为运行结果；必须再通过可定位该账号的 pick 流程取得非空 `lease_token`。随后必须 `finally` **先 `release_lease`、再关浏览器**；进程被 kill 后可能残留 lease，需按 [`ACCOUNT_MANAGER.md`](ACCOUNT_MANAGER.md) 排查。宿主中断只通知技能，**不**代收租约；禁止 `except Exception` 吞掉 `JobStopped`（见 [`LOGGING.md`](LOGGING.md) §2.5）。
 6. **网页 RPA 硬规则**（详见 [`RPA.md`](RPA.md) §0.2）：必须先经 `pick_web_account`（底层 **`ensure-web` / `pick-web --ensure`**）拿到 `profile_dir` 再开浏览器；拿不到则失败退出；生产有头；**是否站点登录**按平台约定，但**不等于**可以跳过 account-manager。登记账号 ≠ 站点已登录。
 7. **账号选择优先级**：纯数字 `DEFAULT_ACCOUNT_ID` → 校验指定账号后带租约 pick；`DEFAULT_LOGIN_ID` / 非数字标识 → `ensure-web --login-id --lease`；皆空 → 按平台 `ensure-web --lease`。人读展示优先 `login_id` / `account_label`，不要只用数字 id。多条匹配或无法确保拿到指定 ID → `ERROR:AMBIGUOUS_ACCOUNT`。
 8. **运行前校验**：`profile_dir` 和 `lease_token` 均须非空；账号平台必须匹配；缺任一字段立即失败，不打开浏览器。
@@ -119,10 +119,12 @@ result = call_sibling_json("account-manager", ["list", "--limit", "10"])
 from service.account_client import pick_web_account, release_lease

 account = pick_web_account(platform="target_platform", login_id=None)
+lease_token = account.get("lease_token")
 try:
    ...
 finally:
-    release_lease(account.get("lease_token"))
+    release_lease(lease_token)  # 先释租约
+    # 再关浏览器 / Playwright
 ```

 ## 相关文档
--- a/development/CHECKLIST.md
+++ b/development/CHECKLIST.md
@@ -60,7 +60,7 @@ checklist_version: 1.0
 - [ ] S0-9 **入口定位表**（见 `PRODUCT_SURFACES.md` / `REQUIREMENTS` §0.1）：已填写 / 未填写
 - [ ] S0-10 本技能宣称的主用户路径涉及：对话 / 数据管理（执行或仅展示） / 定时（可多选；与定位表一致）
 - [ ] S0-11 **业务行生命周期**（见 `references/WORK_ITEM_STATUS.md` / `REQUIREMENTS` §0.3）：有处理队列且已声明状态→角色映射 / 不适用
- [ ] S0-12 **HTML 页面报告**（见 `references/ACTIONS.md`「HTML 页面报告」）：有侧栏可预览的 `html/*.html` + `render-html` / 不适用
+- [ ] S0-12 **HTML 页面报告**（见 `references/ACTIONS.md`「HTML 页面报告」）：壳子页 `assets/html/pages/*.html` / 快照 `html/*.html` + `render-html` / 不适用

 ---

@@ -112,6 +112,7 @@ checklist_version: 1.0
 - [ ] A4-7 **P1** 若 Action 有互斥采集/操作模式（如「按关键词 / 按主页」）：用 `inputSchema` 字段级 **`visibleWhen`** 联动显隐，勿只靠 `description` 灰字说明「仅某某时填写」（见 `references/ACTIONS.md`；勿与 Policy L3 行态 `visibleWhen` 混淆）
 - [ ] A4-8 **P1** 行内/勾选打开的 `form`：有「已选择」时参数区不应再重复映射主键（`inputMapping` + `readOnly`）；需要强制露出时用 `revealInForm`，**禁止**用 `visibleWhen` 藏主键（会不提交）
 - [ ] A4-9 **P1** 若同一能力既支持「勾选处理」又支持「按数量从队列领取」：用一个 Action + `bind.selectionMode: "optional"`（勿拆两个同义顶栏按钮）；无勾选可点、有勾选显示「已选择」、空选数量字段用 `pickCount` 等约定名（见 `references/ACTIONS.md`）
+- [ ] A4-10 **P0** 数据管理弹窗与任务失败文案：全中文产品用语；禁止在 `description` / `confirmation.message` / 参数 `description` / 用户向 `message` 写英文字段名、CLI 子命令、`async`/`pending`/`status=` 等（Agent 路由放 `SKILL.md`；见 `references/ACTIONS.md`「用户可见文案」）
 ---

 ## 5. 账号与浏览器会话（网页 RPA 适用；其他形态标 N/A 或改测等价项）
@@ -124,10 +125,11 @@ checklist_version: 1.0
 - [ ] A5-6 **P0** **NEED_MANUAL** 真实站或约定仿真站主路径至少完整跑通 1 次；仅模拟数据通过不算交活
 - [ ] A5-7 **P0** 账号创建后可在宿主数据管理和 `account list/get` 查到，返回的 `profile_dir` 在当前用户数据目录真实存在
 - [ ] A5-8 **P0** 每个账号使用独立且稳定的 Profile；不同账号不共用，本机日常浏览器目录不参与运行
- [ ] A5-9 **P0** 指定账号 ID、指定登录标识和自动选择均取得非空租约；成功、失败、取消和异常路径最终释放
+- [ ] A5-9 **P0** 指定账号 ID、指定登录标识和自动选择均取得非空租约；成功、失败、取消和异常路径最终释放；`finally` 先释租约再关浏览器
 - [ ] A5-10 **P0** **NEED_MANUAL** 登录后关闭浏览器并释放租约，再取同一账号重开，登录状态仍有效；失效时明确提示重新登录
 - [ ] A5-11 **P1** 至少两个账号连续或轮换测试通过，Profile、登录态、结果和失败互不污染
 - [ ] A5-12 **P1** 租约冲突、残留租约和账号登录失效能按文档自助定位，不通过删库、删 Profile 或自动换号处理
+- [ ] A5-13 **P0** **NEED_MANUAL** 任务中心运行中点「中断」：技能响应 `JobStopped` 并释放租约（数据管理「账号租约」为 `released` / 无 active）；立即再跑不因残留租约失败；进度 `emit` 不得用裸 `except Exception` 吞掉停止

 ---

@@ -147,6 +149,7 @@ checklist_version: 1.0
 - [ ] A6-12 **P2** `display_type: boolean` 的展示列推荐同时配置 `options_json` 中文 label（如 停用/启用），避免仅靠宿主默认「是/否」；无 boolean 列 → **N/A**
 - [ ] A6-13 **P0** 新技能**不得**创建 `task_logs`；过程/进度/业务结果走运行日志、任务中心、业务表（见 `LOGGING.md`、`SCHEMA.md`）
 - [ ] A6-14 **P0** 废弃用户可见表时：`drop_deprecated_user_table` 物理删表 + 清元数据；**禁止**只删元数据留物理表；有迁移时须提供旧库回归测试（见 `SCHEMA.md`、`tests/samples/test_table_deprecation_migration.py.sample`）
+- [ ] A6-15 **P1** 若启用 `cellPresentation`：旁路表不得出现在数据管理侧栏；整行着色不得铺到详情每个字段；禁止 `all`×`all`；tone 闭集。未启用 → **N/A**（见 `references/CELL_PRESENTATION.md`）

 ---

@@ -157,7 +160,7 @@ checklist_version: 1.0
 - [ ] A7-3 **P0** 故意失败一条时，文件日志先有 `task_failed`/`warning`，再有 `ERROR:CODE` 或任务中心失败态
 - [ ] A7-4 **P1** 关键步骤有据可查（能对应到开始/关键节点/结束；RPA 宜有多个 `stage=`）
 - [ ] A7-5 **P1** 若宣称支持录屏或截图存证：打开开关后关键步骤或失败能留下可查看产物；宣称支持却完全无产物 → **FAIL**
- [ ] A7-6 **P2** 用户可见文案偏业务语言，而非大段开发黑话
+- [ ] A7-6 **P2** 用户可见文案偏业务语言，而非大段开发黑话（数据管理弹窗 / 任务失败见 **A4-10**，更高优先级）
 - [ ] A7-7 **P2** 数据管理技能按钮（toolbar / row / batch）中文名对照 `references/ACTIONS.md`「Action 按钮中文名」；不与宿主「查看 / 编辑 / 删除」抢名；打开类成功不弹成功条。行业专有按钮名可自创

 ---
--- a/development/DATA_PATHS.md
+++ b/development/DATA_PATHS.md
@@ -70,7 +70,7 @@ D:\jiangchang-data\12500\download-video-baidu-haokan\
 - 工具栏「导入」**UI 一律**打开宿主「导入数据」面板（默认从本技能 `input/` 选文件）；「导出」默认写到 `output/`
 - **Action 表单**里 `display_type`/`format` 为 `file` 或 `directory` 时：宿主原生对话框默认打开**当前技能** `{skill_data}/input`；若字段声明可选 **`pathRoot`**（相对技能数据根，如 `input/库存数据`），则打开该子目录。禁止在技能里写用户 ID 或绝对盘符。契约见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「本地路径选择与 pathRoot」
 - 若表声明了 `replaces: import`，确认导入后由技能 CLI 写库（见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「`replaces`」）；仅有 `replaces: create` 时宿主可按行调 create（兼容）
- 数据管理扫描 `{skill_data}/html/*.html`（一层、非递归）；`<title>` → 侧栏显示名；「重新生成」调用 Action id **`render-html`**（见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「HTML 页面报告」）
+- 数据管理扫描两处 HTML（都只扫一层）：安装包 `assets/html/pages/*.html` 是装完就有的壳子页；`{skill_data}/html/*.html` 是快照，「重新生成」调用 Action id **`render-html`**。页面里用 `jiangchang.call` 调本技能已声明的命令。详见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「HTML 页面报告」

 ---

--- a/development/DEVELOPMENT.md
+++ b/development/DEVELOPMENT.md
@@ -635,7 +635,7 @@ cmd_stats()                 # 只读 sync：JSON，无 job_context
 - 批量数量用 **`pickCount` / `--pick N` 参数**（任意正整数），不写死条数。
 - **顺序执行、不并发**同一浏览器 Profile / account lease。
 - **同步数据**与**宿主表导出**职责分离：同步不写 CSV/Excel；表导出交给数据管理。
- **HTML 页面报告**（可选）：需要侧栏预览整页时，写入 `html/` + Action `render-html`；契约见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「HTML 页面报告」（含**宿主预览布局**底线）、[`DATA_PATHS.md`](DATA_PATHS.md)；薄写入 helper 见 `scripts/service/html_page_service.py`。建议从 `assets/html/example-report.html` 复制壳；`{{BODY}}` 内数据须转义；样式升级后提醒用户重新生成。
+- **HTML 页面报告**（可选）：壳子页放 `assets/html/pages/*.html`，装完即进侧栏；快照才写入 `html/` + Action `render-html`。页面用 `jiangchang.call` 调已声明命令。契约见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「HTML 页面报告」（含**宿主预览布局**底线）、[`DATA_PATHS.md`](DATA_PATHS.md)。快照可从 `assets/html/example-report.html` 复制壳，不要把该文件放进 `pages/`。
 - 详情见 [`SKILL_ACTION_RUNTIME.md`](SKILL_ACTION_RUNTIME.md)；契约样例见 `tests/samples/test_sync_contract.py.sample`、`tests/samples/test_action_core_contract.py.sample`。

 ### 队列 + pick（可选）
@@ -894,7 +894,7 @@ uses: client-jiangchang/jiangchang-platform-kit/.github/workflows/reusable-relea
 |-------------------------|----------------|--------------|
 | **新建任务**（对话 Agent） | `placements` 含 `agent`；或短查询走共享 Python CLI | 自然语言能触发主流程；长任务 / RPA 须走 `run_skill_action`，禁止 bash 干等 |
 | **数据管理 · 表顶栏** | `placements` 含 `toolbar`（须合法非空 `bind.tables`） | 左侧能看到本技能库表；表顶栏出现按钮；点按行为符合预期 |
-| **数据管理 · HTML 报告** | 写出 `html/*.html`；提供 Action id `render-html` | 侧栏出现报告项；预览正常；右键「重新生成」成功且时间/内容更新 |
+| **数据管理 · HTML 报告** | 壳子页放 `assets/html/pages/*.html`；快照写出 `html/*.html` 并提供 `render-html` | 壳子装完即现、右键无「重新生成」；快照可重新生成；页面 `jiangchang.call` 能拿到 JSON |
 | **数据管理 · 行级** | `placements` 含 `row`（建议 `bind.tables` + `bind.inputMapping` 预填主键） | 操作列和/或行右键（及可选「⋯」）出现本技能行级 Action（需有主键列）；点按后入参/行为与壳无关、均正确 |
 | **数据管理 · 批量** | `placements` 含 `batch` | 勾选行后批量按钮可用；无勾选时禁用；批量行为正确 |
 | **定时任务** | `placements` 含 `cron`（创建时选「技能直调」） | 能选到本技能 Action、保存并触发；到点或「立即运行」行为正确 |
--- a/development/LOGGING.md
+++ b/development/LOGGING.md
@@ -122,6 +122,26 @@ RPA 等待用 `interruptible_sleep`，**不要**裸 `asyncio.sleep`（否则暂

 Journal 会写入 `type: lifecycle` 事件（`paused` / `resumed` / `stopping`），供宿主任务中心显示状态。

+**宿主中断（`stop`）与 `JobStopped`（必读）：**
+
+- 用户在任务中心点「中断」时，宿主写入 `control.json` `command=stop`，并**等待技能进程协作退出**（超时后才可能强杀）。
+- 技能在 `emit` / `checkpoint` / `interruptible_sleep` / `rpa_step` 等闸门处会抛出 `JobStopped`；业务代码须让其冒泡到 `job_context` / 外层 `finally`，由技能**自己**释放租约、关闭浏览器等资源。
+- **禁止**用裸 `except Exception:` 包住上述闸门调用。`JobStopped` 是 `Exception` 子类，会被吞掉，导致 UI 已停、进程仍占账号租约，下次采集必 `LEASE_CONFLICT`。
+- 若必须兜底「emit 写 Journal 失败」，正确写法：
+
+```python
+from jiangchang_skill_core.activity import JobStopped, emit
+
+try:
+    emit("正在处理…", skill=SKILL_SLUG, stage="fetch")
+except JobStopped:
+    raise
+except Exception:
+    log.debug("emit_failed", exc_info=True)
+```
+
+- 宿主**不会**按技能类型统一代收 account-manager 租约（许多技能根本不用账号管理）。强杀后的残留靠租约 TTL / 数据管理手工 force-release；主路径必须是技能自清。
+
 ### 2.3 可观测性三分法（禁止 task_logs）

 | 信息类型 | 去哪里 | 技能怎么做 |
--- a/development/SKILL_ACTION_RUNTIME.md
+++ b/development/SKILL_ACTION_RUNTIME.md
@@ -9,7 +9,7 @@
 | 文档 | 职责 |
 |------|------|
 | 本文 | sync/async、任务中心、Agent 禁令、单内核编排、队列 pick、同步 vs 导出 |
-| [`../references/ACTIONS.md`](../references/ACTIONS.md) | `actions.json` 字段、placements、`bind.tables`、`bind.selectionMode`、inputSchema、跨表 Lookup、字段条件显隐 `visibleWhen`、本地路径 `file`/`directory` + 可选 **`pathRoot`**、选择摘要「已选择」与映射 **`readOnly` / `revealInForm`**、**按钮中文名 `label` 参考** |
+| [`../references/ACTIONS.md`](../references/ACTIONS.md) | `actions.json` 字段、placements、`bind.tables`、`bind.selectionMode`、**用户可见文案**、inputSchema、跨表 Lookup、字段条件显隐 `visibleWhen`、本地路径 `file`/`directory` + 可选 **`pathRoot`**、选择摘要「已选择」与映射 **`readOnly` / `revealInForm`**、**按钮中文名 `label` 参考** |
 | [`LOGGING.md`](LOGGING.md) | `job_context` / `emit` / `finish` / Run Journal |
 | [`DATA_PATHS.md`](DATA_PATHS.md) | 下载/导入等落盘路径 |

@@ -21,7 +21,7 @@

 1. **宿主管调度，技能管业务** — 不自行实现任务中心 / Job 轮询 / 后台守护进程。
 2. **单业务内核、多入口** — 数据管理、定时任务、Agent、技能详情与直接 CLI 复用同一 domain service；禁止按入口复制业务逻辑。
-3. **五职责正交** — `placements` / `bind.tables` / `executionProfile` / `entrypoint` / domain service 各管一事（见 ACTIONS.md）。可选第六轴 **policy**（见 `references/POLICY.md`）：未启用 = L0 与今日一致。可选 **`hostEffects` / `steps`**（见 ACTIONS.md）：数据管理交互前后的 UI/级联编排；省略 = 不额外改 UI（匠厂宿主 ≥2.8.5）。可选 **`hoverHint`**（见 ACTIONS.md）：数据管理工具栏悬停；省略 = 不显示，不回退说明或确认黄条。可选 **`visibleWhen`**（见 ACTIONS.md）：Action 参数表单字段条件显隐；省略 = 字段始终平铺；**勿与** Policy L3 行态 `visibleWhen` 混淆；**勿**用其藏映射主键。可选 **`pathRoot`**（见 ACTIONS.md）：`file`/`directory` 原生选路对话框起始目录（相对技能数据根；省略默认 `{skill_data}/input`）。可选 **`bind.labelColumn`**（见 ACTIONS.md）：选择摘要可读标签列；省略 = 宿主常见列名启发。可选 **`bind.selectionMode`**（见 ACTIONS.md）：表勾选如何驱动 Action（`required` / `none` / `optional`）；省略 = 宿主按 `$selection.ids` / `batch` 推断。可选 **`revealInForm`**（见 ACTIONS.md）：有「已选择」时仍强制显示某 `readOnly` 字段；省略 = 映射只读默认不占 form 参数区（仍提交）。可选 **`cellPresentation`**（见 `references/CELL_PRESENTATION.md`）：单元格语义标色；省略 = P0。
+3. **五职责正交** — `placements` / `bind.tables` / `executionProfile` / `entrypoint` / domain service 各管一事（见 ACTIONS.md）。可选第六轴 **policy**（见 `references/POLICY.md`）：未启用 = L0 与今日一致。可选 **`hostEffects` / `steps`**（见 ACTIONS.md）：数据管理交互前后的 UI/级联编排；省略 = 不额外改 UI（匠厂宿主 ≥2.8.5）。可选 **`hoverHint`**（见 ACTIONS.md）：数据管理工具栏悬停；省略 = 不显示，不回退说明或确认黄条。可选 **`visibleWhen`**（见 ACTIONS.md）：Action 参数表单字段条件显隐；省略 = 字段始终平铺；**勿与** Policy L3 行态 `visibleWhen` 混淆；**勿**用其藏映射主键。可选 **`pathRoot`**（见 ACTIONS.md）：`file`/`directory` 原生选路对话框起始目录（相对技能数据根；省略默认 `{skill_data}/input`）。可选 **`bind.labelColumn`**（见 ACTIONS.md）：选择摘要可读标签列；省略 = 宿主常见列名启发。可选 **`bind.selectionMode`**（见 ACTIONS.md）：表勾选如何驱动 Action（`required` / `none` / `optional`）；省略 = 宿主按 `$selection.ids` / `batch` 推断。可选 **`revealInForm`**（见 ACTIONS.md）：有「已选择」时仍强制显示某 `readOnly` 字段；省略 = 映射只读默认不占 form 参数区（仍提交）。可选 **`cellPresentation`**（见 `references/CELL_PRESENTATION.md`）：单元格/整行/整列/区域语义标色；省略 = P0。**用户可见文案**（见 ACTIONS.md「用户可见文案」）：弹窗 `description` / 确认黄条 / 参数说明 / 任务失败 `message` 须全中文产品用语；Agent 路由勿塞进弹窗。
 4. **长耗时建议 async** — 开浏览器、RPA、HTTP 大文件下载等建议 `executionProfile: "async"`，进**任务中心**；这是对**方法**的选择，**不**限制可以出现在哪些 placement / 入口。
 5. **Agent：短 CLI / 长 Action** — 短查询可用共享 Python bash CLI；长任务 / RPA **禁止** `exec` + `process poll`，必须 `run_skill_action`。
 6. **进度走 Journal** — `emit` / `video.add_step` → Run Journal；UI / Skill Run Card / 任务中心展示；**不靠 stdout 流**。
@@ -167,7 +167,7 @@ cmd_stats()                 # 只读 sync：JSON stdout，无 job_context
 | 同步 / refresh / collect | 外部来源 → 技能本地 SQLite | 技能 domain service |
 | 导出当前数据表 | 本地库 → CSV/Excel | **宿主**数据管理统一导出 |
 | 特殊业务报告（文件） | 多表合并 / 特殊格式 → `output/` | 仅系统导出不足时提供 `export-*` |
-| HTML 页面报告 | 写入 `{skill_data}/html/*.html` | 技能生成；宿主扫描预览；重新生成 Action id 固定为 **`render-html`** |
+| HTML 页面报告 | 壳子页 `assets/html/pages/*.html`；快照写入 `{skill_data}/html/*.html` | 壳子装完即现；快照由技能生成，重新生成 Action id 固定为 **`render-html`**。页面用 `jiangchang.call` 调已声明命令 |

 同步 Action 默认写库、不写导出文件。HTML 报告契约见 [`../references/ACTIONS.md`](../references/ACTIONS.md)「HTML 页面报告」与 [`DATA_PATHS.md`](DATA_PATHS.md)。通用幂等 / 事务 / 空结果保护见 [`../references/SCHEMA.md`](../references/SCHEMA.md)。

--- a/development/TESTING.md
+++ b/development/TESTING.md
@@ -35,7 +35,7 @@
 - **发布打包守护**：[`tests/test_release_packaging_constraints.py`](../tests/test_release_packaging_constraints.py) ——`scripts/**/*.py` 单文件 < 1000 行、文本文件 UTF-8 without BOM。
 - **开发规范守护（hard policy）**：[`tests/test_development_policy_guard.py`](../tests/test_development_policy_guard.py) ——规则索引见 [`development/POLICY_MATRIX.md`](POLICY_MATRIX.md)，只执行可机器检测的 hard 规则。
 - **slug 语义**：[`tests/test_slug_naming.py`](../tests/test_slug_naming.py) ——verb-noun-platform 命名规范校验。
- **HTML 报告壳**：[`tests/test_html_page_service.py`](../tests/test_html_page_service.py) 守护 `assets/html/example-report.html` 的数据管理 iframe 预览布局基线；业务技能若有自定义 `assets/html/*.html`，建议在自有仓库加同类静态断言（见 `references/ACTIONS.md`「宿主预览布局」）。
+- **HTML 报告壳**：[`tests/test_html_page_service.py`](../tests/test_html_page_service.py) 守护 `assets/html/example-report.html` 的数据管理 iframe 预览布局基线，并守护 ACTIONS.md 里的壳子页目录 `assets/html/pages` 与 `jiangchang.call`。业务技能若有自定义 `assets/html/*.html` 或 `pages/*.html`，建议在自有仓库加同类静态断言（见 `references/ACTIONS.md`「宿主预览布局」）。不要把 `example-report.html` 放进 `pages/`。

 **原则：`tests/test_*.py` 不允许隐形访问外网、不允许拉起真实浏览器、不允许读写开发者机器的真实数据根**。如果需要仿真服务器，也应仅在 integration（并由档位变量放行）。

--- a/examples/real_browser_rpa/README.md
+++ b/examples/real_browser_rpa/README.md
@@ -52,7 +52,7 @@ real_browser_rpa/
 8. **等待结果容器** — `#search-result-container`（示例 selector）
 9. **滚动采集循环** — 采集可见条目 → 判断 stop_reason → 滚动加载
 10. **返回结果** — `ScrapeRunResult` + `format_stop_reason_for_user()`
-11. **释放租约** — `finally` 中 `release_lease()`
+11. **释放租约** — `finally` 中**先** `release_lease()`，**再**关浏览器；进度 `emit` 不得用裸 `except Exception` 吞掉 `JobStopped`

 ## 开发新 skill 时如何复制

@@ -150,7 +150,7 @@ real_browser_rpa/
 - **不自动破解验证码** — 滑块/短信只检测 + 等待人工完成
 - **不对抗平台风控** — 频控、账号风险、封禁或权限不足时停止并交由人工处理
 - **日志脱敏** — 不输出完整手机号/账号
- **租约释放** — `ensure-web` / `pick-web --lease` 后必须在 `finally` 释放
+- **租约释放** — `ensure-web` / `pick-web --lease` 后必须在 `finally` **先**释放租约再关浏览器；任务中心中断靠 `JobStopped` 进 `finally`，禁止吞掉停止信号
 - **失败留痕** — 真实 skill 应在关键失败点截图（示例中已留注释位）

 ## 常见坑
--- a/examples/simulator_browser_rpa/README.md
+++ b/examples/simulator_browser_rpa/README.md
@@ -55,7 +55,7 @@ simulator_browser_rpa/
 | `browser_session.py` | async 系统 Chrome/Edge + launch args；**不在此 goto** |
 | `account_client.py` | **唯一** account-manager subprocess 封装（`pick_web_account`→ensure-web / `release_lease`） |
 | `simulator_playwright.py` | 门户轮询、登录、批量表单、PIN、解析 `batch_id`、截图 |
-| `adapter/simulator_rpa.py` | **薄** adapter：pick 账号、lease、委托 RPA、`finally release_lease` |
+| `adapter/simulator_rpa.py` | **薄** adapter：pick 账号、lease、委托 RPA、`finally` 先 `release_lease` 再关浏览器 |
 | `adapter/mock.py` | 不启浏览器，供 unit/mock/CI |
 | `task_service.py` | async 校验输入 → 选 adapter → `await submit_batch` |
 | `sandbox/demo_app.html` | 可控 DOM；含可选门户门闩 + 原批量提交流程 |
--- a/references/ACTIONS.md
+++ b/references/ACTIONS.md
@@ -77,7 +77,7 @@ Action 是否提供、挂哪些 `placements`，由本技能 **入口定位表**
 | `skill` | 是 | 必须与 `SKILL.md` 的 `metadata.openclaw.slug` 一致 |
 | `actions` | 是 | Action 数组，每项 `id` 唯一；**数组相对顺序**决定数据管理 toolbar / row / batch 技能按钮的展示顺序（见下节） |

-模板最小示例见 [`assets/actions.json`](../assets/actions.json)；JSON Schema 见 [`assets/schemas/skill-actions.schema.json`](../assets/schemas/skill-actions.schema.json)。可选 Data Policy 见 [`POLICY.md`](POLICY.md) 与 [`assets/schemas/skill-policy-snapshot.schema.json`](../assets/schemas/skill-policy-snapshot.schema.json)。可选单元格呈现见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md) 与 [`assets/schemas/skill-cell-presentation.schema.json`](../assets/schemas/skill-cell-presentation.schema.json)。
+模板最小示例见 [`assets/actions.json`](../assets/actions.json)；JSON Schema 见 [`assets/schemas/skill-actions.schema.json`](../assets/schemas/skill-actions.schema.json)。可选 Data Policy 见 [`POLICY.md`](POLICY.md) 与 [`assets/schemas/skill-policy-snapshot.schema.json`](../assets/schemas/skill-policy-snapshot.schema.json)。可选单元格/整行/整列呈现见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)、[`assets/schemas/skill-cell-presentation.schema.json`](../assets/schemas/skill-cell-presentation.schema.json) 与 [`assets/schemas/skill-grid-presentation.schema.json`](../assets/schemas/skill-grid-presentation.schema.json)。

 ## 六职责正交（必读）

@@ -91,7 +91,7 @@ Action 是否提供、挂哪些 `placements`，由本技能 **入口定位表**
 | **`hoverHint`** | **可选**：数据管理**工具栏悬停**文案 | 不决定短按钮名；不决定点下去弹不弹窗；**不回退** `description` / `confirmation.message`；省略 = 不显示悬停。当前宿主实现为顶栏技能按钮 |
 | **`inputSchema.visibleWhen`** | **可选**：Action **参数表单**字段条件显隐（先选模式再出对应参数） | **不是** Data Policy L3 行态 `visibleWhen`；不决定 placements；旧宿主忽略则字段平铺全显 |
 | **`hostEffects` / `steps`** | **可选**：数据管理交互跑完前后，宿主要不要刷新表 / 清选区 / 级联删等 | 不决定业务写什么；**省略 = 宿主不额外改 UI**（≥2.8.5 起不再硬编码 mutation 后刷新）；cron/agent 忽略 |
-| **`cellPresentation`** | **可选**：某表某行某列的语义标色/强调（tone + 说明） | 不替代业务列；不下发 CSS；用途不限（超时、预警、驳回等）；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md) |
+| **`cellPresentation`** | **可选**：某表某格 / 整行 / 整列 / 区域的语义标色/强调（tone + 说明） | 不替代业务列；不下发 CSS；用途不限（超时、预警、驳回等）；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md) |
 | **`policy` / Snapshot** | **可选**：当前身份在数据管理下允许哪些 Action / 宿主内置能力 / 行列范围 | 不替代 placements；不替代 domain 写路径鉴权；多数技能不配 = L0 全开 |
 | **`entrypoint`** | 实际执行哪个 CLI 命令与参数 | 不写业务逻辑 |
 | **domain service** | **真正完成什么业务** | 不感知 toolbar / cron / agent 来源 |
@@ -102,14 +102,14 @@ Action 是否提供、挂哪些 `placements`，由本技能 **入口定位表**

 | 层级 | 稳定字段 / 能力 |
 |------|----------------|
-| 顶层 | `schemaVersion`、`skill`、`actions`；可选 **`policy`**（Data Policy 启用块）；可选 **`cellPresentation`**（单元格呈现启用块） |
+| 顶层 | `schemaVersion`、`skill`、`actions`；可选 **`policy`**（Data Policy 启用块）；可选 **`cellPresentation`**（格子/行/列/区域呈现启用块） |
 | action | `id`、`label`、`description`、`placements`、`entrypoint`、**`executionProfile`（必填）**；可选 `hoverHint`、`inputSchema`、`confirmation`、**`interaction`**、**`interactionByPlacement`**、**`bind`**、**`replaces`**、**`hostEffects`**、**`steps`**、**`authz`**（仅文档提示） |
 | entrypoint | `type = cli`、`command`、`args`（**必填** JSON 数组，项为 `string` / `number` / `boolean`） |
 | placements | `toolbar`、`row`、`batch`、`skill-detail`、`agent`、`cron`；仅 `replaces` 时可为空数组 |
 | **replaces** | 可选 `"create"` \| `"update"` \| `"delete"` \| `"import"` — 接管默认新增/编辑/删除/导入（须 `bind.tables`） |
 | **bind** | `{ "tables": ["business_table"] }`；可选 `inputMapping`、`columnMapping`、**`labelColumn`**、**`selectionMode`**（行内/批量预填、选择摘要标签、勾选驱动模式，见下节） |
 | **policy** | 可选；`enabled` + `entrypoint`（推荐 `policy` CLI）；见 POLICY.md。未启用 = L0 |
-| **cellPresentation** | 可选；`{ "enabled": true }` 时宿主应加载单元格呈现；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)。未启用 = P0 |
+| **cellPresentation** | 可选；`{ "enabled": true }` 时宿主应加载格子与 grid 呈现；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)。未启用 = P0 |
 | inputSchema | 根 `type: object`；properties 使用 `string` / `number` / `boolean`；支持 `enum`、`default`、`required`、`sensitive`、`readOnly`、可选 **`revealInForm`**；可选 `display_type` / `format`（含 `file` / `directory` 等）；可选 **`pathRoot`**（file/directory 起始目录，相对技能数据根）；可选 **`visibleWhen`**（字段条件显隐，见专节） |
 | confirmation | `{ "message": "..." }` — **风险文案**（confirm/form 弹窗黄条；agent 元数据）；**不是**「要不要弹窗」的开关 |
 | **hoverHint** | 可选字符串。数据管理**工具栏悬停**文案；与 `description` / `confirmation.message` **独立**。省略则不显示悬停，不回退。短名已够懂时不要写。需宿主已支持该字段；当前实现为顶栏技能按钮，不含宿主内置删除/刷新/新增/导入/导出 |
@@ -167,6 +167,47 @@ Action 是否提供、挂哪些 `placements`，由本技能 **入口定位表**

 示例：[`assets/examples/selection-mode-optional.action.example.json`](../assets/examples/selection-mode-optional.action.example.json)。

+弹窗上的 `description` / 参数说明须用**普通用户中文**（见下节「用户可见文案」）；`pickCount` 等只作 **property 名 / CLI 参数名**，不要写进用户可读句子。
+
+### 用户可见文案（双受众，必读）
+
+宿主会把下列字段**原样展示给普通用户**（数据管理弹窗、任务中心时间线、表说明等）：
+
+| 字段 | 出现位置 |
+|------|----------|
+| Action `description` | 弹窗顶部说明 |
+| `confirmation.message` | 确认/表单黄条 |
+| `inputSchema` 各字段 `title` / `description` | 参数区标签与帮助 |
+| CLI / `finish` 返回的用户向 `message` | 任务中心、失败摘要 |
+| 表/列 `display_name`、表 `description` | 数据管理侧栏与表头帮助 |
+
+**总原则：** 以上文案 = **产品用语、全中文**。Agent 路由禁令、实现细节、契约自述放在 **`SKILL.md` / `references/`**，**不要**塞进弹窗 `description`。
+
+**允许写：** 待下载、任务中心、打开浏览器、有勾选 / 没有勾选、下载数量、按钮中文名（如「导入待下载链接」）。
+
+**禁止写进用户文案（常见反例）：**
+
+| 类型 | 反例 |
+|------|------|
+| 字段名 / CLI 子命令 | `pickCount`、`itemIds`、`import-urls`、`enqueue` |
+| 英文状态 / 条件式 | `pending`、`status=pending`、`failed` |
+| 执行剖面黑话 | `async`、`sync`、单独甩 `Job`（可说「任务中心」） |
+| Agent 禁令 | 「不是明确 URL 入口」「不要先 download-enqueue…」 |
+| 契约自述 | 「示例：bind.selectionMode=optional」 |
+
+**对照：**
+
+| 差（开发者备注） | 好（普通用户） |
+|------------------|----------------|
+| 按 `pickCount` 从 `pending` 领取（async） | 没有勾选则按下方数量从待下载队列领取；进度可在任务中心查看 |
+| 请先 import-urls | 请先在数据管理录入链接，或使用「导入待下载链接」 |
+
+**边界：**
+
+- `inputSchema` **属性名**、`entrypoint` 参数、库表状态枚举值可以仍是英文；变的是 **title / description / message**。
+- `label` 仍遵循上文「Action 按钮中文名」；本节约束的是说明与帮助文字。
+- 与 `bind.selectionMode` 正交：行为对了，文案仍须对人说人话。
+
 ### 数据管理：选择摘要（宿主默认能力）

 当用户在数据管理**勾选行**（或行内打开带行上下文的动作）后打开 `confirm` / `form` 弹层时，若当前 Action 的 `selectionMode` 会**应用**表勾选（`required`，或 `optional` 且已勾选），宿主会展示通用 **「已选择 · N 条」** 摘要（`#主键` + 可读标签；超过约 3 条可展开查看全部）。这是**宿主 UX**，对适用技能默认生效：
@@ -760,28 +801,55 @@ HINT: <next step>
 | **同步数据**（sync / refresh / collect） | 外部来源 → 技能本地数据库 | 技能 Action / domain service |
 | **导出当前数据表** | 技能本地数据库 → CSV/Excel 等 | 数据管理页**宿主统一导出** |
 | **生成特殊业务报告（文件）** | 多表合并、特殊排版或附加计算的 **xlsx/csv/json 等文件** | 仅当系统导出无法满足时，才提供独立 `export-*` Action；文件落 `output/` |
-| **HTML 页面报告** | 可在数据管理侧栏预览的整页 HTML | 技能写入 `{skill_data}/html/*.html` + Action id **`render-html`**（见下节） |
+| **HTML 页面报告** | 可在数据管理侧栏预览的整页 HTML | 壳子页放安装包 `assets/html/pages/`；快照写入 `{skill_data}/html/*.html` + Action id **`render-html`**（见下节） |

 同步型 Action 默认：读外部数据、写技能自己的库、**不**生成 CSV/Excel/JSON 文件、不重复实现宿主表导出。兼容旧 export 命令若需要刷新数据，必须调用同一个 sync 业务内核。通用同步语义见 [`SCHEMA.md`](SCHEMA.md) 与 [`../development/SKILL_ACTION_RUNTIME.md`](../development/SKILL_ACTION_RUNTIME.md)。

 ## HTML 页面报告（数据管理预览）

-> 一句话：**技能负责生成并覆盖 `html/*.html`；宿主负责发现、预览、用 `render-html` 触发重新生成。**
+> 一句话：**壳子页跟安装包走，装完就在侧栏；快照由技能写入 `html/*.html`，宿主用 `render-html` 重新生成。** 页面上的按钮通过宿主调用本技能已声明的命令，不自己起 Python。

 ### 何时用

- 需要**可浏览的整页报告**（KPI + 表格 + 自带样式），而不是再导出一张表
- 与 `export-*` / 宿主表导出**并列**：HTML 走 `html/`；文件型特殊报告仍走 `output/` + `export-*`
+- 需要**可浏览的整页**（KPI + 表格 + 自带样式），而不是再导出一张表
+- **壳子页**：样式和脚本随技能安装就有，数字在打开后向宿主要。不要为了让它出现而点「生成 HTML」，也不要在 `init-db` 里拷进数据目录
+- **快照**：把算好的报告烘进文件（往来对账单一类）。与 `export-*` / 宿主表导出**并列**：快照走 `html/`；文件型特殊报告仍走 `output/` + `export-*`

 ### 目录与发现（宿主契约）

 | 项 | 约定 |
 |----|------|
-| 路径 | `{skill_data}/html/*.html`，**只扫一层**（子目录忽略） |
-| helper | `util.runtime_paths.get_html_dir()`；写入用 `service.html_page_service.write_html_page` |
+| 壳子页 | 安装包 `assets/html/pages/*.html`，**只扫一层**（子目录忽略）。装完即进侧栏，不经 `render-html` |
+| 快照 | `{skill_data}/html/*.html`，**只扫一层**。helper：`get_html_dir()` / `write_html_page` |
 | 侧栏名 | 取文件内 `<title>`（缺省则用文件名） |
-| 预览 | 宿主 iframe 预览；右键：重新生成 / 浏览器打开 / 刷新 |
-| 模板资源 | 建议放 `assets/html/*.html`（安装包内），渲染后**写出**到数据目录 `html/` |
+| 预览 | 宿主 iframe 预览。壳子页右键：打开 / 打开目录 / 刷新，**没有**「重新生成」。快照右键另有「重新生成」 |
+| 同名 | 壳子和快照文件名相同则留下快照。两边不要用同一个文件名 |
+| 快照模板 | `assets/html/example-report.html` 是写出快照时用的壳，**不要**放进 `pages/` |
+
+### 壳子页
+
+1. 把自包含 HTML 放到 `assets/html/pages/`（一层，不要子目录）。`<title>` 就是侧栏名字。
+2. 布局底线与下面「宿主预览布局」相同：铺满、禁横向滚动、禁外链 CSS/JS。
+3. 不要在初始化数据库时把这些文件拷进 `{skill_data}/html/`。升级技能后宿主读的是新安装包里的文件。
+
+### 页面调用
+
+宿主在数据管理预览里注入 `jiangchang.call`。页面脚本把它当成普通函数调用；宿主只在**当前技能** `actions.json` 已声明的方法里查找，命中后走和表按钮同一条 Python CLI，把 CLI 打出的 JSON 交回。
+
+```javascript
+const data = await jiangchang.call("方法名", { date: "2026-09-19" });
+```
+
+| 项 | 约定 |
+|----|------|
+| 方法名 | `actions.json` 里该条的 `id`。没声明则调用失败。不能传任意命令，也不能调别的技能 |
+| 参数 | 一个 JSON 对象，字段必须落在该条 `inputSchema` 里 |
+| 入口 | 可以不挂 `toolbar`。页面调用不要求表按钮。`placements` 仍不能为空（例如只挂 `agent`） |
+| 成功 | CLI 退出码 0，并打印**一个** JSON 对象。页面拿到的就是这个对象 |
+| 失败 | 退出码非 0，JSON 里带可读的 `message`（`type` 为 `result`、`status` 为 `failed` 时宿主会把 `message` 交给页面） |
+| 范围 | 只在数据管理预览里有这个函数。用浏览器单独打开该文件时没有，页面应说明「请在数据管理中打开」 |
+
+异步命令当场只返回任务号，不在这一节展开。写入和只读是同一种调用，差在技能声明了哪条命令。

 ### Action：`render-html`（固定 id）

@@ -803,7 +871,7 @@ HINT: <next step>

 ### 宿主预览布局

-数据管理在 **iframe** 内预览 `html/*.html`；宿主 iframe 已占满右侧预览区，**技能页不应再人为收窄正文**（尤其数据管理窗口通常较窄）。
+数据管理在 **iframe** 内预览壳子页和快照；宿主 iframe 已占满右侧预览区，**技能页不应再人为收窄正文**（尤其数据管理窗口通常较窄）。

 | 级别 | 约定 |
 |------|------|
@@ -829,7 +897,9 @@ HINT: <next step>

 ### 验收（复制后自测）

- [ ] `html/` 下出现 `.html`，数据管理侧栏能看到报告项，预览正常
+- [ ] 壳子页：安装后侧栏能看到 `assets/html/pages/` 里的标题，无需点生成；右键没有「重新生成」
+- [ ] 页面调用：`jiangchang.call` 能拿到 CLI 的 JSON；未声明的方法名失败且有可读错误
+- [ ] 快照：`html/` 下出现 `.html`，数据管理侧栏能看到报告项，预览正常
 - [ ] 预览区**横向铺满**、**无横向滚动条**；拖窄侧栏后内容自适应（见上节「宿主预览布局」）
 - [ ] 表顶栏（若声明 toolbar）或报告右键「重新生成」能跑通；成功后预览刷新
 - [ ] 未登录/无权限用户被拒绝，且有可读错误
--- a/references/CELL_PRESENTATION.md
+++ b/references/CELL_PRESENTATION.md
@@ -1,9 +1,9 @@
 # 数据管理单元格呈现（Cell Presentation）契约（v1.0）

-> **状态：正式契约 v1.0（`schemaVersion` 1）。**  
-> **目标：** 冻结「技能声明某表某行某列的语义呈现 → 宿主映射主题样式」的通用能力，供任意业务场景复用。  
+> **状态：正式契约 v1.0（`cells[]` 文档 `schemaVersion` 1）+ 加法 Grid Presentation。**  
+> **目标：** 冻结「技能声明语义呈现 → 宿主映射主题样式」的通用能力：某一格、整行、整列、若干行×若干列，供任意业务场景复用。  
 > **非目标：** 超时/SLA 专用字段；技能下发任意 CSS / 任意色值；宿主实现业务规则引擎。  
-> **配套 Schema：** [`../assets/schemas/skill-cell-presentation.schema.json`](../assets/schemas/skill-cell-presentation.schema.json)。
+> **配套 Schema：** [`../assets/schemas/skill-cell-presentation.schema.json`](../assets/schemas/skill-cell-presentation.schema.json)（格子）、[`../assets/schemas/skill-grid-presentation.schema.json`](../assets/schemas/skill-grid-presentation.schema.json)（行/列/区域）。

 相关正交轴见 [`ACTIONS.md`](ACTIONS.md)、[`POLICY.md`](POLICY.md)、[`SCHEMA.md`](SCHEMA.md)。

@@ -11,9 +11,17 @@

 ## 0. 一句话

-技能可以声明：**哪张业务表、哪一行、哪一列**需要特殊标色/强调（语义 `tone` + 可选说明）。  
+技能可以声明：**哪张业务表**上，**哪些行 × 哪些列**需要特殊标色/强调（语义 `tone` + 可选说明）。
+
+| 想涂什么 | 怎么声明 |
+|----------|----------|
+| 某一格 | 一行 × 一列（v1 `cells[]` 或一条格子规则） |
+| 整行 | 若干行 × 该轴全部列 |
+| 整列 | 该轴全部行 × 若干列 |
+| 区域 | 若干行 × 若干列 |
+
 用途不限：时效超时未填、库存预警、状态异常、必填缺失、审核驳回等。  
-**不是**「再加一列超时文字」；强调落在**真正要关注的业务格子**上。
+**不是**「再加一列超时文字」；强调落在**真正要关注的业务格子或行**上。

 ---

@@ -22,9 +30,20 @@
 | 档位 | 技能行为 | 宿主行为 |
 |------|----------|----------|
 | **P0（默认）** | 不写呈现数据 / 未启用 | 数据管理表格与今日一致，无特殊标色 |
-| **P1** | 按规则写入呈现文档或推荐旁路表 | 渲染对应单元格的语义样式；可选汇总 `alert: true` 做进页提醒 |
+| **P1** | 按规则写入呈现文档或推荐旁路表 | 渲染对应格子 / 行 / 列 / 区域的语义样式；可选汇总 `alert: true` 做进页提醒 |

-多数技能保持 **P0**。需要视觉强调时再启用。
+多数技能保持 **P0**。需要视觉强调时再启用。模板 `actions.json` **默认不启用**。
+
+---
+
+## 0.2 宿主能力
+
+| 能力 | 旁路表 | 宿主 |
+|------|--------|------|
+| 格子着色 | `_jiangchang_cell_presentation` | 既有宿主即可 |
+| 整行 / 整列 / 区域 | `_jiangchang_grid_presentation` | 需已读取该表（匠厂数据管理已支持）。**旧宿主忽略该表**，格子着色仍有效 |
+
+同一开关 `cellPresentation.enabled` 同时打开两张旁路表。未建表 = 该通道为空，宿主忽略。

 ---

@@ -32,17 +51,17 @@

 | 角色 | 负责 | 不负责 |
 |------|------|--------|
-| **技能** | 按**当前业务数据**算出哪些格子要强调；在数据变更后**重算**并覆盖旧结果 | 不写宿主 CSS；不把强调文案污染进业务真值列冒充「变红」 |
-| **宿主** | 读取呈现结果，按闭集 `tone` 映射主题样式；可选 Toast/提醒汇总 | 不理解「提前 3 天交单」等业务规则；不为单个技能写死样式 |
+| **技能** | 按**当前业务数据**算出哪些格子/行/列要强调；在数据变更后**重算**并覆盖旧结果 | 不写宿主 CSS；不把强调文案污染进业务真值列冒充「变红」 |
+| **宿主** | 读取呈现结果，按闭集 `tone` 映射主题样式；按几何涂表格；可选 Toast/提醒汇总 | 不理解「提前 3 天交单」等业务规则；不为单个技能写死样式 |

 **派生状态（重要）：** 呈现是计算结果，不是粘性开关。  
 用户补填数据 / 同步刷新后技能重算 → 该项消失 → **样式与提醒自然关闭**。不要单独维护「已关闭提醒」状态机（除非产品另做「忽略此条」能力，本契约不冻结）。

 ---

-## 2. 文档形状（冻）
+## 2. 格子文档形状（冻，`schemaVersion` 1）

-技能产出一份 **Cell Presentation Document**（可落库、可 CLI 打印，形状相同），须符合 Schema。
+技能产出一份 **Cell Presentation Document**（可落库、可 CLI 打印，形状相同），须符合格子 Schema。v1 **只描述某一格**；整行/整列用 §2.1。

 ```json
 {
@@ -71,14 +90,14 @@

 | 字段 | 必填 | 说明 |
 |------|------|------|
-| `schemaVersion` | 是 | 固定 `1` |
+| `schemaVersion` | 是 | 固定 `1`（本形状不升版本） |
 | `skill` | 是 | 与 slug 一致 |
 | `table` | 是 | 当前文档作用的业务表 |
 | `rowKey` | 是 | 行匹配列（`id` / `feishu_record_id` 等） |
 | `generatedAt` | 否 | 排障用 |
-| `cells` | 是 | 数组；**空数组 = 该表清除全部特殊呈现** |
+| `cells` | 是 | 数组；**空数组 = 该表清除全部格子呈现** |

-### 2.1 `cells[]` 项
+### 2.0 `cells[]` 项

 | 字段 | 必填 | 说明 |
 |------|------|------|
@@ -91,6 +110,74 @@
 同一 `(rowId, column)` 多条：宿主可**后者覆盖前者**。  
 `column` 对用户不可见（policy 打码 / 列隐藏）时：宿主可仍应用样式，或跳过——**推荐跳过不可见列的强调**，避免泄露「有问题」的存在感（技能仍可写，宿主按可见性过滤）。

+### 2.1 Grid 文档形状（加法，独立 Schema）
+
+整行 / 整列 / 区域用 **Grid Presentation Document**（`rules[]`）。与 `cells[]` **并存**，不替代、不升 `cells` 的 `schemaVersion`。
+
+统一几何：**`rows` × `columns`**。某一侧为 `"all"`（或省略，落库时写成 JSON `"all"`）= 该轴全部。禁止两侧都是全部（见 §4.2）。
+
+```json
+{
+  "schemaVersion": 1,
+  "skill": "your-skill-slug",
+  "table": "business_records",
+  "rowKey": "id",
+  "generatedAt": "2026-08-10T06:00:00Z",
+  "rules": [
+    {
+      "ruleKey": "qty-low-rows",
+      "rows": ["42", "99"],
+      "columns": "all",
+      "tone": "danger",
+      "message": "库存低于安全线",
+      "alert": true
+    },
+    {
+      "ruleKey": "status-column",
+      "rows": "all",
+      "columns": ["status"],
+      "tone": "warning",
+      "message": "待审核"
+    },
+    {
+      "ruleKey": "overdue-print-region",
+      "rows": ["7", "8"],
+      "columns": ["print_done_at", "ship_done_at"],
+      "tone": "danger",
+      "message": "环节到期未填",
+      "alert": true
+    }
+  ]
+}
+```
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `schemaVersion` | 是 | 固定 `1` |
+| `skill` / `table` / `rowKey` | 是 | 同格子文档；`rowKey` 用于匹配 `rows` 里的 id |
+| `rules` | 是 | 数组；**空数组 = 该表清除全部 grid 规则** |
+
+#### `rules[]` 项
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `ruleKey` | 是 | 本表内唯一（建议稳定业务键，便于重算覆盖） |
+| `rows` | 是 | `"all"` 或行 id 字符串数组（对应 `rowKey` 列值） |
+| `columns` | 是 | `"all"` 或业务列名数组 |
+| `tone` | 是 | 见 §3 |
+| `message` | 否 | ≤500 |
+| `alert` | 否 | 默认 `false`；按**规则条数**计提醒，不按命中格子数 |
+
+| `rows` × `columns` | 宿主 scope |
+|--------------------|-----------|
+| 1 行 × 1 列 | `cell` |
+| 若干行 × 若干列（非单格） | `region` |
+| 若干行 × `"all"` | `row`（整行） |
+| `"all"` × 若干列 | `column`（整列） |
+| `"all"` × `"all"` | **禁止**，宿主丢弃该规则 |
+
+完整 JSON 例见 [`../assets/examples/skill-grid-presentation.example.json`](../assets/examples/skill-grid-presentation.example.json)。
+
 ---

 ## 3. `tone` 闭集（冻）
@@ -106,13 +193,13 @@
 **禁止：** 技能下发原始 `#RRGGBB`、任意 CSS class、内联 style。  
 以后若扩展色板，只能**追加新 tone token** 并升契约，不能开放任意色值。

-「技能配置什么就显示什么」在本契约中的含义是：技能选择 **哪一格 + 哪个 tone + 什么说明**；**像素级颜色由宿主主题决定**，以保证多技能 UI 一致与安全。
+「技能配置什么就显示什么」在本契约中的含义是：技能选择 **哪一格/行/列 + 哪个 tone + 什么说明**；**像素级颜色由宿主主题决定**，以保证多技能 UI 一致与安全。

 ---

 ## 4. 推荐持久化（给宿主实现）

-v1 **推荐**技能将「当前表」的呈现写入用户库旁路表（与业务表分离，**不是**多余业务超时列）：
+v1 **推荐**技能将「当前表」的**格子**呈现写入用户库旁路表（与业务表分离，**不是**多余业务超时列）：

 ```sql
 CREATE TABLE IF NOT EXISTS _jiangchang_cell_presentation (
@@ -130,19 +217,60 @@ CREATE TABLE IF NOT EXISTS _jiangchang_cell_presentation (
 );
 ```

+### 4.1 整行 / 整列 / 区域（`_jiangchang_grid_presentation`）
+
+```sql
+CREATE TABLE IF NOT EXISTS _jiangchang_grid_presentation (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  table_name TEXT NOT NULL,
+  rule_key TEXT NOT NULL,
+  row_key TEXT NOT NULL DEFAULT '',
+  rows_json TEXT NOT NULL,
+  columns_json TEXT NOT NULL,
+  tone TEXT NOT NULL,
+  message TEXT,
+  alert INTEGER NOT NULL DEFAULT 0,
+  generated_at TEXT,
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  UNIQUE (table_name, rule_key)
+);
+```
+
+`rows_json` / `columns_json` 存 JSON：字符串 `"all"`，或 id / 列名数组（如 `["42","99"]`）。  
+`row_key`：有限行集合时必填（与文档 `rowKey` 相同，如 `id`）；整列（`rows_json = "all"`）可空字符串。
+
+两张表都列入技能 `INTERNAL_METADATA_TABLES`（见 `scripts/db/display_metadata.py`），**不得**作为业务表出现在数据管理侧栏。模板 **不**在 `init_db()` 里默认建这两张表；技能用到时再 `CREATE`。
+
+### 4.2 冲突与特异性
+
+同一格被多条规则命中时，宿主按 **格子 > 区域 > 行 > 列** 取胜。同级后者覆盖前者。
+
+宿主先加载 grid 规则，再加载 v1 `cells[]`（同级时 **v1 格子仍赢**），因此旧技能只写 `cells[]` 的行为不变。
+
+**禁止 `all` × `all`**（会把整张表涂满）。技能不要写；宿主遇到则丢弃该规则。
+
+### 4.3 表格 vs 详情
+
+| 表面 | 整行（scope=`row`） | 格子 / 列 / 区域 |
+|------|-------------------|------------------|
+| 数据管理表格 | 给整行（`<tr>`）上色 | 给对应单元格上色 |
+| 行详情 | **不**把行色铺到每个字段 | 对应字段可保留 tone |
+
+整行强调的是「这一行在表里扎眼」，不是「打开详情后每个值都变色」。
+
 约定：

- 重算某表时：**先删该 `table_name` 全部行，再插入新结果**（或等价事务替换），保证填完后旧 `danger` 不会残留。  
- 宿主打开数据管理某表时：若该技能启用了呈现（见 §5）且存在此表，则按当前页行的 `rowKey` 值匹配并着色。  
+- 重算某表时：**先删该 `table_name` 在两张旁路表中的全部行，再插入新结果**（或等价事务替换），保证填完后旧 `danger` 不会残留。只维护其中一张时，至少清掉自己负责的那张，并删掉已迁走的旧行（例如从格子改成整行后，删掉对应 `_jiangchang_cell_presentation`）。  
+- 宿主打开数据管理某表时：若该技能启用了呈现（见 §5）且存在旁路表，则按当前页行的 `rowKey` 值匹配并着色。  
 - 也允许技能用 CLI 打印整份 Document 供调试；**运行时以库内旁路表为准**（除非后续宿主另定拉取入口）。

-未创建该旁路表 = P0，宿主忽略。
+未创建该旁路表 = 该通道 P0，宿主忽略。

 ---

 ## 5. 在 `actions.json` 中启用（可选，推荐）

-与 `policy` 类似，顶层可选：
+与 `policy` 类似，顶层可选。**一份开关同时启用格子与 grid：**

 ```json
 {
@@ -158,7 +286,7 @@ CREATE TABLE IF NOT EXISTS _jiangchang_cell_presentation (
 | 字段 | 说明 |
 |------|------|
 | `cellPresentation` | 省略 = P0 |
-| `cellPresentation.enabled` | 仅 `true` 表示宿主应尝试加载呈现；`false`/缺省等同 P0 |
+| `cellPresentation.enabled` | 仅 `true` 表示宿主应尝试加载呈现（两张旁路表）；`false`/缺省等同 P0 |

 v1 **不**要求单独 CLI entrypoint（与 policy 不同）；技能在 `sync` / 写路径 / `init-db` 后自行维护旁路表即可。若未来需要「仅刷新呈现」Action，用普通 Skill Action 即可，不必扩展本启用块。

@@ -172,8 +300,8 @@ v1 **不**要求单独 CLI entrypoint（与 policy 不同）；技能在 `sync`
 2. 会改变「是否仍需强调」的写路径成功之后（新建、更新、登记等）  
 3. （可选）用户显式「刷新呈现」类 Action  

-进页 Toast：宿主可在加载表后统计当前页或全表 `alert=1` 的条数；**0 则不打扰**。  
-提醒关闭 = 重算后没有对应 cell，而不是用户点「我知道了」写死关闭（除非另做忽略列表，本契约不冻）。
+进页 Toast：宿主可在加载表后统计当前页或全表 `alert=1` 的**规则条数**（grid 按规则计，不按命中格子数）；**0 则不打扰**。  
+提醒关闭 = 重算后没有对应 cell/rule，而不是用户点「我知道了」写死关闭（除非另做忽略列表，本契约不冻）。

 ---

@@ -181,7 +309,7 @@ v1 **不**要求单独 CLI entrypoint（与 policy 不同）；技能在 `sync`

 | 契约 | 关系 |
 |------|------|
-| **SCHEMA / `_jiangchang_columns`** | 管列是否可见、类型、中文名；**不管**条件标色 |
+| **SCHEMA / `_jiangchang_columns`** | 管列是否可见、类型、中文名；**不管**条件标色。呈现旁路表须进内部隐藏表集合 |
 | **POLICY Snapshot** | 管谁能看哪些 Action/行列；呈现仍建议按可见列过滤 |
 | **hostEffects / steps** | 管 Action 跑完后是否 `reloadTable`；重载后宿主应重新读呈现 |
 | **业务列真值** | 保持干净；不要把 `【超时】` 写进业务字段冒充变色 |
@@ -195,16 +323,21 @@ v1 **不**要求单独 CLI entrypoint（与 policy 不同）；技能在 `sync`
 - 只在首次超时时打标、填完不重算导致红字残留  
 - 宿主写死某个技能 slug 的特殊染色逻辑  
 - 把 Cell Presentation 做成仅服务 SLA 的专用协议  
+- 写 `rows: "all"` 且 `columns: "all"` 企图整表变色  
+- 假定打开行详情后，整行色会铺到每一个字段  
+- 把某一业务技能的检查逻辑（例如「检查列 → 整行」）复制进模板当通用运行时  

 ---

 ## 9. 示例场景（说明用途不限）

-| 场景 | column | tone | message 例 |
-|------|--------|------|------------|
-| 打单超时未填 | `print_done_at` | `danger` | 打单已超 1 天未填 |
-| 库存低于安全线 | `qty` | `warning` | 低于安全库存 |
-| 审核驳回 | `status` | `danger` | 已驳回，请修改 |
-| 选填备注缺失但不紧急 | `notes` | `muted` | 建议补充备注 |
+| 场景 | 几何 | tone | message 例 |
+|------|------|------|------------|
+| 打单超时未填 | 格子 `print_done_at` | `danger` | 打单已超 1 天未填 |
+| 库存低于安全线 | **整行**（该行 × `all`） | `warning` | 低于安全库存 |
+| 审核驳回 | 格子或整列 `status` | `danger` | 已驳回，请修改 |
+| 选填备注缺失但不紧急 | 格子 `notes` | `muted` | 建议补充备注 |
+| 两个日期列同时逾期 | 区域：若干行 × `print_done_at`+`ship_done_at` | `danger` | 环节到期未填 |

-完整 JSON 例见 [`../assets/examples/skill-cell-presentation.example.json`](../assets/examples/skill-cell-presentation.example.json)。
+格子 JSON 例见 [`../assets/examples/skill-cell-presentation.example.json`](../assets/examples/skill-cell-presentation.example.json)。  
+Grid JSON 例见 [`../assets/examples/skill-grid-presentation.example.json`](../assets/examples/skill-grid-presentation.example.json)。
--- a/references/CLI.md
+++ b/references/CLI.md
@@ -27,7 +27,7 @@ python {baseDir}/scripts/main.py <command> …
 | **短 CLI 白名单** | （例）`health` / `version` / `render-html` / `<your-read-or-prep>` | 可用 bash/exec + 共享 `python` |
 | **Action 强制黑名单** | （例）`<your-long-or-rpa-command>` | **禁止** bash + `process poll`；必须 `run_skill_action` |

-细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。若提供 HTML 报告，「重新生成」须有 Action id **`render-html`**（可同时进短 CLI 白名单）；见 ACTIONS.md「HTML 页面报告」。
+细节与 Action 清单见 [`ACTIONS.md`](ACTIONS.md)。快照「重新生成」须有 Action id **`render-html`**；壳子页与页面调用 `jiangchang.call` 见 ACTIONS.md「HTML 页面报告」。

 ## 最小命令

--- a/references/README.md
+++ b/references/README.md
@@ -20,8 +20,8 @@
 | [`ACTIONS.md`](ACTIONS.md) | Skill Action、sync/async、任务中心、多入口、按钮中文名 `label` 参考（按入口定位表挂载；先读 `development/PRODUCT_SURFACES.md`） |
 | [`SCHEMA.md`](SCHEMA.md) | 本地 SQLite 与数据管理展示契约 |
 | [`POLICY.md`](POLICY.md) | Data Policy：可选身份授权、Snapshot、行 scope（多数技能 L0 不配） |
-| [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md) | 数据管理单元格呈现：语义 tone 标色/强调（用途不限；多数技能 P0 不配） |
+| [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md) | 数据管理呈现：格子 / 整行 / 整列 / 区域语义 tone（用途不限；多数技能 P0 不配） |
 | [`WORK_ITEM_STATUS.md`](WORK_ITEM_STATUS.md) | 业务行生命周期：处理队列的可操作/进行中/终态角色与重做规则（有处理行 Action 时适用） |
 | [`../development/`](../development/) | 开发、测试、RPA 深度规范（给人 / 编码助手） |

-按需阅读：短操作优先 `CLI.md`；Action / 任务中心读 `ACTIONS.md`；结构化字段读 `SCHEMA.md`；权限 opt-in 读 `POLICY.md`；格子标色读 `CELL_PRESENTATION.md`；队列处理状态机读 `WORK_ITEM_STATUS.md`。
+按需阅读：短操作优先 `CLI.md`；Action / 任务中心读 `ACTIONS.md`；结构化字段读 `SCHEMA.md`；权限 opt-in 读 `POLICY.md`；格子/行/列标色读 `CELL_PRESENTATION.md`；队列处理状态机读 `WORK_ITEM_STATUS.md`。
--- a/references/SCHEMA.md
+++ b/references/SCHEMA.md
@@ -17,7 +17,7 @@
 - 需要「新增表单预填」时，在物理列上声明 SQLite `DEFAULT`（勿把默认值只写在文案里）
 - 定义哪些字段可见、可搜索、可创建、可编辑
 - 定义字段展示类型和枚举选项
- （可选）按业务规则维护单元格呈现旁路数据（语义 tone；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)）
+- （可选）按业务规则维护单元格 / 整行 / 整列 / 区域呈现旁路数据（语义 tone；见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)）
 - 保证元数据与真实数据库结构一致
 - 保证元数据初始化幂等

@@ -36,7 +36,7 @@
 - 不猜测技能业务含义
 - 不根据具体技能名称写特殊逻辑
 - 可在技能安装/更新成功后静默调用 `python scripts/main.py init-db` 做幂等 ensure（内部即 `init_db()`）；失败不影响安装结果
- 若技能启用了单元格呈现（见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)），读取旁路呈现数据并为单元格映射语义样式（`tone`）；不猜测业务规则
+- 若技能启用了单元格呈现（见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)），读取旁路呈现数据并为格子 / 行 / 列 / 区域映射语义样式（`tone`）；不猜测业务规则；整行色只涂表格行，不铺到详情字段

 ## 初始化入口

@@ -45,7 +45,8 @@
 SQLite **没有**可靠的 `COMMENT ON TABLE/COLUMN`；SQL 文件里的 `-- 注释` 也不会成为可查询结构。
 因此中文展示名称必须写入元数据表；字段顺序必须写在 `CREATE TABLE` 的列定义顺序中（`PRAGMA table_info` 的 `cid`）。

-> **禁止**新技能使用宿主的旧版 `_schema_meta` 表。仅 `_jiangchang_tables` / `_jiangchang_columns` 为正式契约。
+> **禁止**新技能使用宿主的旧版 `_schema_meta` 表。仅 `_jiangchang_tables` / `_jiangchang_columns` 为正式契约。  
+> 可选呈现旁路表 `_jiangchang_cell_presentation` / `_jiangchang_grid_presentation` **不是**展示元数据，但须列入 `INTERNAL_METADATA_TABLES`（侧栏不可见）。见 [`CELL_PRESENTATION.md`](CELL_PRESENTATION.md)。

 ## 技能名称（SKILL.md）

@@ -143,7 +144,7 @@ metadata:
 | **同步数据** | 外部来源 → 技能本地数据库 | 技能 Action / domain service |
 | **导出当前数据表** | 本地库 → CSV/Excel 等 | 数据管理页**宿主统一导出** |
 | **生成特殊业务报告（文件）** | 多表合并、特殊排版或附加计算的文件 | 仅当系统导出无法满足时，才提供独立 `export-*`；落 `output/` |
-| **HTML 页面报告** | 侧栏可预览的整页 HTML | 写入 `html/` + Action id **`render-html`**（见 [`ACTIONS.md`](ACTIONS.md)） |
+| **HTML 页面报告** | 侧栏可预览的整页 HTML | 壳子页 `assets/html/pages/`；快照写入 `html/` + Action id **`render-html`**（见 [`ACTIONS.md`](ACTIONS.md)） |

 同步型 Action 默认只写库、不生成导出文件。兼容旧 export 命令需要刷新时，必须调用同一 sync 内核。可复用测试范式见 `tests/samples/test_sync_contract.py.sample`。

--- a/scripts/db/display_metadata.py
+++ b/scripts/db/display_metadata.py
@@ -9,7 +9,15 @@ from __future__ import annotations
 from typing import Iterable

 # 宿主会隐藏这些表，不作为业务表展示（见 jiangchang electron/data-management/types.ts）
-INTERNAL_METADATA_TABLES = frozenset({"_jiangchang_tables", "_jiangchang_columns"})
+# 呈现旁路表由技能按需 CREATE，见 references/CELL_PRESENTATION.md；未建表不影响 P0。
+INTERNAL_METADATA_TABLES = frozenset(
+    {
+        "_jiangchang_tables",
+        "_jiangchang_columns",
+        "_jiangchang_cell_presentation",
+        "_jiangchang_grid_presentation",
+    }
+)
 LEGACY_METADATA_TABLES = frozenset({"_schema_meta"})
 METADATA_TABLES = INTERNAL_METADATA_TABLES | LEGACY_METADATA_TABLES

--- a/scripts/service/html_page_service.py
+++ b/scripts/service/html_page_service.py
@@ -1,9 +1,10 @@
-"""技能 HTML 报告页：写入 `{skill_data}/html/*.html`（宿主扫描预览）。
+"""技能 HTML 快照：写入 `{skill_data}/html/*.html`（宿主扫描预览）。

 契约要点（权威说明见 `references/ACTIONS.md`「HTML 页面报告」）：

- 目录：仅一层 `html/*.html`（非递归）
- 重新生成 Action id 必须为 `render-html`（宿主硬编码）
+- 本模块只写快照。装完就有的壳子页放安装包 `assets/html/pages/*.html`，不要从这里拷过去
+- 快照目录：仅一层 `html/*.html`（非递归）
+- 重新生成 Action id 必须为 `render-html`（宿主硬编码；只针对快照）
 - 页面布局底线见 `references/ACTIONS.md`「宿主预览布局」；模板壳 `assets/html/example-report.html`
 - 成功后建议 `steps: refreshCatalog` 以重扫侧栏
 - 本模块只提供路径/模板/原子写；业务 KPI/表格由各技能自行填充
--- a/scripts/util/constants.py
+++ b/scripts/util/constants.py
@@ -1,6 +1,6 @@
 """技能标识、版本与平台公共库约束（复制后请修改 slug/version/logger）。"""

 SKILL_SLUG = "your-skill-slug"
-SKILL_VERSION = "1.0.107"
+SKILL_VERSION = "1.0.111"
 LOG_LOGGER_NAME = "openclaw.skill.your_skill_slug"
 PLATFORM_KIT_MIN_VERSION = "1.2.11"
--- a/scripts/util/runtime_paths.py
+++ b/scripts/util/runtime_paths.py
@@ -134,7 +134,7 @@ def get_videos_dir(*, create: bool = True) -> str:


 def get_html_dir(*, create: bool = True) -> str:
-    """HTML 报告页目录：宿主扫描 `{skill_data}/html/*.html`（一层、非递归）。"""
+    """HTML 快照目录：宿主扫描 `{skill_data}/html/*.html`（一层、非递归）。壳子页不在这里。"""
    path = os.path.join(get_skill_data_dir(), STANDARD_SUBDIR_HTML)
    if create:
        os.makedirs(path, exist_ok=True)
--- a/tests/test_actions_manifest.py
+++ b/tests/test_actions_manifest.py
@@ -522,6 +522,59 @@ class TestActionsManifest(unittest.TestCase):
        }
        jsonschema.validate(instance=manifest, schema=schema)

+    def test_action_examples_user_facing_copy_avoids_jargon(self) -> None:
+        """示例 Action 的用户可见字符串不得含常见开发黑话（属性名本身除外）。"""
+        examples_dir = os.path.join(get_skill_root(), "assets", "examples")
+        # 故意拆开，避免本测试源码触发自身扫描。
+        forbidden = (
+            "pickCount",
+            "itemIds",
+            "status=",
+            "import-urls",
+            "download-enqueue",
+            "bind.selectionMode",
+            "selectionMode=",
+        )
+        # async/pending 作为整词出现在 description 才禁止；executionProfile 值除外。
+        word_forbidden = re.compile(r"\b(async|pending|sync)\b", re.I)
+
+        for name in os.listdir(examples_dir):
+            if not name.endswith(".action.example.json"):
+                continue
+            path = os.path.join(examples_dir, name)
+            with open(path, encoding="utf-8") as f:
+                data = json.load(f)
+            actions = data["actions"] if isinstance(data, dict) and "actions" in data else [data]
+            for action in actions:
+                if not isinstance(action, dict):
+                    continue
+                texts: list[str] = []
+                for key in ("description",):
+                    if action.get(key):
+                        texts.append(str(action[key]))
+                conf = action.get("confirmation") or {}
+                if isinstance(conf, dict) and conf.get("message"):
+                    texts.append(str(conf["message"]))
+                props = ((action.get("inputSchema") or {}).get("properties")) or {}
+                for prop in props.values():
+                    if not isinstance(prop, dict):
+                        continue
+                    for key in ("title", "description"):
+                        if prop.get(key):
+                            texts.append(str(prop[key]))
+                blob = "\n".join(texts)
+                for token in forbidden:
+                    self.assertNotIn(
+                        token,
+                        blob,
+                        msg=f"{name} user-facing copy must not contain {token!r}",
+                    )
+                match = word_forbidden.search(blob)
+                if match is not None:
+                    self.fail(
+                        f"{name} user-facing copy must not contain {match.group(0)!r}"
+                    )
+
    def test_no_execution_profile_placement_coupling_in_tests(self) -> None:
        """守护：本文件不得引入入口位置与 sync/async 的错误硬耦合断言。"""
        path = os.path.join(get_skill_root(), "tests", "test_actions_manifest.py")
@@ -683,9 +736,12 @@ class TestActionsManifest(unittest.TestCase):
            "afterFailure",
            "cellPresentation",
            "CELL_PRESENTATION.md",
+            "整行",
            "labelColumn",
            "selectionMode",
            "勾选驱动",
+            "用户可见文案",
+            "双受众",
            "已选择",
            "revealInForm",
            "映射只读",
--- a/tests/test_cell_presentation_contract.py
+++ b/tests/test_cell_presentation_contract.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-"""Cell Presentation 契约：schema + 文档 + 示例。"""
+"""Cell / Grid Presentation 契约：schema + 文档 + 示例。"""
 from __future__ import annotations

 import json
@@ -9,31 +9,34 @@ import unittest
 from util.runtime_paths import get_skill_root


-def _load_schema() -> dict:
-    path = os.path.join(
-        get_skill_root(),
-        "assets",
-        "schemas",
-        "skill-cell-presentation.schema.json",
-    )
-    with open(path, encoding="utf-8") as f:
+def _skill_path(*parts: str) -> str:
+    return os.path.join(get_skill_root(), *parts)
+
+
+def _load_json(*parts: str) -> dict:
+    with open(_skill_path(*parts), encoding="utf-8") as f:
        return json.load(f)


-def _load_example() -> dict:
-    path = os.path.join(
-        get_skill_root(),
-        "assets",
-        "examples",
-        "skill-cell-presentation.example.json",
-    )
-    with open(path, encoding="utf-8") as f:
-        return json.load(f)
+def _load_cell_schema() -> dict:
+    return _load_json("assets", "schemas", "skill-cell-presentation.schema.json")
+
+
+def _load_cell_example() -> dict:
+    return _load_json("assets", "examples", "skill-cell-presentation.example.json")
+
+
+def _load_grid_schema() -> dict:
+    return _load_json("assets", "schemas", "skill-grid-presentation.schema.json")
+
+
+def _load_grid_example() -> dict:
+    return _load_json("assets", "examples", "skill-grid-presentation.example.json")


 class TestCellPresentationContract(unittest.TestCase):
    def test_schema_file_exists_and_parses(self) -> None:
-        schema = _load_schema()
+        schema = _load_cell_schema()
        self.assertEqual(schema.get("title"), "SkillCellPresentationDocument")
        self.assertIs(schema.get("additionalProperties"), False)
        self.assertEqual(schema["properties"]["schemaVersion"].get("const"), 1)
@@ -45,33 +48,38 @@ class TestCellPresentationContract(unittest.TestCase):
            import jsonschema
        except ImportError:
            self.skipTest("jsonschema not installed")
-        jsonschema.validate(instance=_load_example(), schema=_load_schema())
+        jsonschema.validate(instance=_load_cell_example(), schema=_load_cell_schema())

    def test_actions_schema_defines_cell_presentation_enable_block(self) -> None:
-        path = os.path.join(
-            get_skill_root(), "assets", "schemas", "skill-actions.schema.json"
-        )
-        with open(path, encoding="utf-8") as f:
-            actions_schema = json.load(f)
+        actions_schema = _load_json("assets", "schemas", "skill-actions.schema.json")
        self.assertIn("cellPresentation", actions_schema["properties"])
        self.assertIn("cellPresentationDeclaration", actions_schema["$defs"])

    def test_docs_and_example_exist(self) -> None:
-        root = get_skill_root()
-        self.assertTrue(os.path.isfile(os.path.join(root, "references", "CELL_PRESENTATION.md")))
+        self.assertTrue(os.path.isfile(_skill_path("references", "CELL_PRESENTATION.md")))
        self.assertTrue(
            os.path.isfile(
-                os.path.join(root, "assets", "schemas", "skill-cell-presentation.schema.json")
+                _skill_path("assets", "schemas", "skill-cell-presentation.schema.json")
            )
        )
        self.assertTrue(
            os.path.isfile(
-                os.path.join(root, "assets", "examples", "skill-cell-presentation.example.json")
+                _skill_path("assets", "examples", "skill-cell-presentation.example.json")
+            )
+        )
+        self.assertTrue(
+            os.path.isfile(
+                _skill_path("assets", "schemas", "skill-grid-presentation.schema.json")
+            )
+        )
+        self.assertTrue(
+            os.path.isfile(
+                _skill_path("assets", "examples", "skill-grid-presentation.example.json")
            )
        )

    def test_cell_presentation_md_covers_contract(self) -> None:
-        path = os.path.join(get_skill_root(), "references", "CELL_PRESENTATION.md")
+        path = _skill_path("references", "CELL_PRESENTATION.md")
        with open(path, encoding="utf-8") as f:
            text = f.read()
        for marker in (
@@ -80,14 +88,77 @@ class TestCellPresentationContract(unittest.TestCase):
            "warning",
            "alert",
            "_jiangchang_cell_presentation",
+            "_jiangchang_grid_presentation",
            "cellPresentation",
            "派生",
            "任意 CSS",
            "用途不限",
            "schemaVersion",
+            "整行",
+            "整列",
+            "all",
+            "格子 > 区域 > 行 > 列",
+            "详情",
        ):
            self.assertIn(marker, text, msg=f"CELL_PRESENTATION.md missing {marker!r}")

+    def test_grid_schema_file_exists_and_parses(self) -> None:
+        schema = _load_grid_schema()
+        self.assertEqual(schema.get("title"), "SkillGridPresentationDocument")
+        self.assertIs(schema.get("additionalProperties"), False)
+        self.assertEqual(schema["properties"]["schemaVersion"].get("const"), 1)
+        tones = set(schema["$defs"]["tone"].get("enum") or [])
+        self.assertEqual(tones, {"danger", "warning", "info", "success", "muted"})
+        self.assertIn("not", schema["$defs"]["ruleItem"])
+
+    def test_grid_example_validates_against_schema(self) -> None:
+        try:
+            import jsonschema
+        except ImportError:
+            self.skipTest("jsonschema not installed")
+        jsonschema.validate(instance=_load_grid_example(), schema=_load_grid_schema())
+
+    def test_grid_schema_rejects_all_by_all(self) -> None:
+        try:
+            import jsonschema
+        except ImportError:
+            self.skipTest("jsonschema not installed")
+        payload = {
+            "schemaVersion": 1,
+            "skill": "your-skill-slug",
+            "table": "business_records",
+            "rowKey": "id",
+            "rules": [
+                {
+                    "ruleKey": "paint-everything",
+                    "rows": "all",
+                    "columns": "all",
+                    "tone": "danger",
+                }
+            ],
+        }
+        with self.assertRaises(jsonschema.ValidationError):
+            jsonschema.validate(instance=payload, schema=_load_grid_schema())
+
+    def test_internal_metadata_hides_presentation_tables(self) -> None:
+        from db.display_metadata import INTERNAL_METADATA_TABLES, METADATA_TABLES
+
+        self.assertIn("_jiangchang_cell_presentation", INTERNAL_METADATA_TABLES)
+        self.assertIn("_jiangchang_grid_presentation", INTERNAL_METADATA_TABLES)
+        self.assertTrue(INTERNAL_METADATA_TABLES <= METADATA_TABLES)
+
+    def test_template_actions_do_not_enable_presentation_by_default(self) -> None:
+        manifest = _load_json("assets", "actions.json")
+        self.assertNotEqual(manifest.get("cellPresentation", {}).get("enabled"), True)
+
+    def test_checklist_covers_grid_presentation(self) -> None:
+        path = _skill_path("development", "CHECKLIST.md")
+        with open(path, encoding="utf-8") as f:
+            text = f.read()
+        self.assertIn("A6-15", text)
+        self.assertIn("cellPresentation", text)
+        self.assertIn("CELL_PRESENTATION.md", text)
+

 if __name__ == "__main__":
    unittest.main()
--- a/tests/test_docs_standards.py
+++ b/tests/test_docs_standards.py
@@ -327,6 +327,11 @@ class TestDocsStandards(unittest.TestCase):
                os.path.join(root, "assets", "schemas", "skill-cell-presentation.schema.json")
            )
        )
+        self.assertTrue(
+            os.path.isfile(
+                os.path.join(root, "assets", "schemas", "skill-grid-presentation.schema.json")
+            )
+        )
        self.assertTrue(os.path.isfile(os.path.join(root, "tests", "test_actions_manifest.py")))
        self.assertTrue(os.path.isfile(os.path.join(root, "tests", "test_data_management_contract.py")))

@@ -375,6 +380,7 @@ class TestDocsStandards(unittest.TestCase):
            "表增删改与退役",
            "drop_deprecated_user_table",
            "孤儿物理表",
+            "_jiangchang_grid_presentation",
        ):
            self.assertIn(marker, text, msg=f"SCHEMA.md missing {marker!r}")

@@ -416,6 +422,8 @@ class TestDocsStandards(unittest.TestCase):
        text = self._read("assets/examples/README.md")
        self.assertIn("visible-when-action.example.json", text)
        self.assertIn("selection-mode-optional.action.example.json", text)
+        self.assertIn("skill-cell-presentation.example.json", text)
+        self.assertIn("skill-grid-presentation.example.json", text)
        checklist = self._read("development/CHECKLIST.md")
        self.assertIn("A4-7", checklist)
        self.assertIn("visibleWhen", checklist)
@@ -423,10 +431,16 @@ class TestDocsStandards(unittest.TestCase):
        self.assertIn("revealInForm", checklist)
        self.assertIn("A4-9", checklist)
        self.assertIn("selectionMode", checklist)
+        self.assertIn("A4-10", checklist)
+        self.assertIn("用户可见文案", checklist)
        runtime = self._read("development/SKILL_ACTION_RUNTIME.md")
        self.assertIn("visibleWhen", runtime)
        self.assertIn("revealInForm", runtime)
        self.assertIn("selectionMode", runtime)
+        self.assertIn("用户可见文案", runtime)
+        actions = self._read("references/ACTIONS.md")
+        self.assertIn("用户可见文案", actions)
+        self.assertIn("双受众", actions)

    def test_guarded_docs_do_not_reference_amazon_implementation(self) -> None:
        forbidden = (
--- a/tests/test_html_page_service.py
+++ b/tests/test_html_page_service.py
@@ -70,6 +70,20 @@ class TestHtmlPageService(unittest.TestCase):
        self.assertIn("overflow-wrap: anywhere", template)
        self.assertNotIn("max-width:", template)

+    def test_actions_contract_keeps_shell_pages_and_call(self) -> None:
+        from util.runtime_paths import get_skill_root
+
+        root = get_skill_root()
+        actions_path = os.path.join(root, "references", "ACTIONS.md")
+        with open(actions_path, encoding="utf-8") as f:
+            actions = f.read()
+        self.assertIn("assets/html/pages", actions)
+        self.assertIn("jiangchang.call", actions)
+        self.assertTrue(os.path.isfile(os.path.join(root, "assets", "html", "example-report.html")))
+        self.assertFalse(
+            os.path.isfile(os.path.join(root, "assets", "html", "pages", "example-report.html"))
+        )
+

 if __name__ == "__main__":
    unittest.main()
Author	SHA1	Message	Date
chendelian	a70da6a076	feat: precipitate grid presentation (row/column/region) into skill contract All checks were successful 技能自动化发布 / release (push) Successful in 9s Details	2026-09-20 21:08:23 +08:00
chendelian	a125b00285	Release v1.0.110: 沉淀壳子页与页面调用契约 All checks were successful 技能自动化发布 / release (push) Successful in 9s Details	2026-09-19 16:23:23 +08:00
chendelian	2a3e971c76	docs: document JobStopped and lease cleanup contract for interrupt All checks were successful 技能自动化发布 / release (push) Successful in 7s Details	2026-09-17 13:26:28 +08:00
chendelian	db2ed089a3	Release v1.0.108: precipitate user-facing copy contract All checks were successful 技能自动化发布 / release (push) Successful in 8s Details	2026-09-12 14:08:33 +08:00