@lark-base-open/base-database-cli 1.1.1 → 1.3.8

package/skills/lark-base-database/references/frontend-design-guide.md

@@ -1,97 +1,183 @@
-# 前端设计风格指导
+# 前端设计指南
 
-首次实现页面、整体视觉改版或视觉评审前完整读取；局部视觉修改读取相关章节并沿用现有设计系统。本文统一适用于一方托管和三方搭建，不依赖宿主身份或构建期注入。只修改数据逻辑时不重做视觉方案。
+用于首次实现页面、视觉改版和设计评审。本文件包含所需设计规则，无需继续读取其他设计文档或组件参考源码。目标是让页面任务清楚、比例协调、控件精致，并通过复用减少搭建工作。
 
-目标是让界面适合具体业务，并以一致的排版、组件、状态反馈和细节保持产品质量。用户已有品牌、设计稿与明确偏好优先；可访问性与安全要求见[工程质量](style-guide.md)。下列数值与选型是默认出发点，不是平台限制。
+## 1. 按任务范围设计
 
-## 设计方案
+用户明确要求、正式品牌及现有应用规范优先；starter 占位页、组件库演示页、本轮刚生成的样式和未处理的库默认外观都不算应用规范。使用主流程已经取得的目标、内容、数据模式和工程约束；设计环节不增加需求问答、风格确认或业务规则。
 
-先在内部规划中确定使用者、主要任务与业务特征，再作以下决策；默认不单独创建设计文档，用户要求时提供：
+- 新建或整体改版：确定页面主次、主题、字体和控件基准，直接落实到共享样式及组件。
+- 新增页面：复用应用规范，只决定新页面的内容组织。局部修改只处理受影响的布局或变体；纯数据逻辑修改不触发设计工作。
+- 只实现当前用到的组件和状态。默认不额外创建设计文档、token 清单或选择报告，不为应用预建完整组件库。
 
-1. **色彩**：定义页面背景、内容表面、主次文本、边框、品牌色和独立的成功/警告/危险色。以命名设计变量维护中性色阶，避免逐组件取色。
-2. **排版**：确定标题、正文、辅助文字的字号、字重、行高与数字格式。
-3. **布局与密度**：高频列表与工作台优先信息效率，表单与登记页优先阅读和输入空间；相同任务采用一致密度。
-4. **业务辨识度**：用业务内容、导航结构、品牌色或关键状态表达建立特征。需要视觉强调时集中在少数位置，不让装饰占用核心操作区域。
-5. **交互与动效**：确定控件状态、焦点、过渡时长和响应式策略，落实为可复用组件与设计变量。
+## 2. 先组织内容，再决定装饰
 
-方案应能解释如何服务当前任务。不要为了与其他应用不同而牺牲已有用户习惯，也不要仅替换 starter 文案就完成视觉交付。
+根据当前页面的主要任务分配注意力和空间，不按行业名称套模板：
 
-## 场景与布局
+| 页面任务 | 优先组织 |
+| --- | --- |
+| 业务操作 | 当前对象、必要输入、列表/表格/日历和下一步；统计与说明作辅助 |
+| 数据分析 | 关键读数、趋势与比较、异常及必要明细；范围与单位清楚 |
+| 内容展示 | 品牌、素材和阅读顺序；按内容形成画廊、目录或连续叙事 |
+| 活动参与 | 活动对象、参与路径和当前资格；次数、库存、结果状态与数据模式一致，不能参与、提交中、未知结果、已到账分别表达 |
+| 成果叙事 | 每段有当前数据支持，示例成果不冒充真实业绩；节奏服务叙事，滚动后内容不消失 |
 
-| 页面任务 | 布局重点 | 默认视觉取向 |
+同一应用可包含不同页面。混合或模糊任务按已知内容组织，保持共用视觉语言，不新增分类问答。不同任务的结构差异来自内容，不靠随机换色或固定“四个 KPI + 两张图”制造设计。
+
+业务系统的美感优先来自对齐、文字层级、合适的信息密度和稳定的操作位置。列表、日历、输入等工作区应占据主要空间；普通统计用紧凑摘要，需要处理的异常才局部突出。避免大摘要卡、多行说明和高工具栏把核心内容挤到首屏之外。
+
+下面是内容顺序的起点，只使用任务实际需要的部分：
+
+| 具体页面 | 建议组织 |
+| --- | --- |
+| 列表、台账 | 页头与新增动作 → 搜索/筛选 → 记录与行操作 → 分页；批量动作在选中后突出 |
+| 编辑、设置 | 标题 → 按含义分组的字段 → 保存/取消；短字段有真实关联时并排，长输入独占一行 |
+| 排班、计划 | 紧凑摘要 → 范围与筛选 → 日历/人员网格；避免两排高指标卡把日历推到首屏之外 |
+| 创作、快速记录 | 必要对象选择与输入 → 提交 → 可辨产物；快捷示例用轻量文字行，不逐条套大卡片 |
+| 看板、报告 | 看板便于扫描和比较；报告按结论与证据连续阅读，不因有数字就补齐筛选器与指标卡 |
+
+### 页面默认直接排版，卡片按用途添加
+
+**普通业务页从“一个页面背景 + 透明布局容器”开始。** 列表、编辑、设置、详情、排班与创作页的页头、筛选、字段组、工具栏直接排在页面上；不包整页卡片，也不把每个区块分别包成卡片。页面可直接用白色或协调的浅色背景，不必先铺灰底再垫白板。
+
+- `main`、`section`、Grid/Flex 容器负责宽度、间距与对齐，默认不带卡片底色、圆角、外框或投影。不要把 `Card` 当通用布局组件。白色圆角底板即使无边框、无阴影，也仍是卡片。
+- 卡片只用于确实需要独立边界的内容单元，例如可整体选择的方案、可预览的作品，或需与相邻内容区分的分析模块。**有标题、属于一个分组、包含按钮或需要留白，都不足以成为加卡片的理由。** Dashboard 也不自动给每个模块套卡片。
+- 加卡片前判断：去掉底板后，对象边界、选择关系或阅读是否真的变得不清楚？留白、对齐、局部分隔已能表达时直接排版。这个判断在实现时完成，不输出额外设计报告。
+- 输入框、表格/日历网格、菜单、弹窗和抽屉保留自身必要表面与边界；它们的存在不要求外面再包一层卡片。确需使用的普通内容卡默认无描边、无投影，避免同一内容重复套壳。
+- 新建时替换 starter 的占位外壳；其中 `max-w-2xl rounded-3xl border bg-card … shadow-sm` 等示例组合不作为页面模板沿用。检查已有页面时，删除多余外壳的表面样式及重复内边距，保留必要布局；仅调淡灰边或去掉阴影不算去掉底板。
+
+例如“一个输入区 + 三条快捷示例”：页面下直接排两列，输入保留自己的边界，示例使用文字行与 hover/focus 反馈。不要形成“灰色页面 → 白色大面板 → 输入区卡片 / 示例卡片”的层级。
+
+页头、工具栏和内容共用对齐线，靠面积、字体和间距突出主任务。同排同级、同结构卡片统一列宽、内边距和高度，并对齐标题、数值及动作；用共享槽位处理长标题，不逐卡补 margin 或空话。间距以 4px 基数、8px 节奏为起点，组内小于组间；窄屏堆叠后释放无用留白。图片保持可辨比例，缺图用紧凑回退，不以巨大色块或 emoji 冒充素材；品牌图片、字体或特效加载失败时页面仍可理解与操作。
+
+### 页面尺寸与组件空间不足时的处理
+
+表格、日历和工作台利用扣除导航与边距后的可用宽度；长文、单列表单和专注输入区可局部限宽。检查根节点和父容器的固定宽度、嵌套 `max-width` 与大 padding，避免全屏只铺背景、内容始终挤在中间。
+
+宽屏增加有效列宽、比较空间或合适列数，不等比放大所有控件。**所有区域按自身可用宽度适配**，包括页头、导航、工具栏、表单、卡片、表格、日历和弹层；扣除侧栏、相邻区域及内边距后放不下，就需要重排。宽屏里的窄面板、长文本、项目增多和文字放大也会触发拥挤，不能只处理手机断点。
+
+常规桌面页边距可从 24–32px、窄屏 16px 起；控件组间距约 8px、字段组 16px、区块 24–32px。沿用工程断点，必要时依据容器宽度调整。侧栏后的主区可用 `flex: 1; min-width: 0`，网格用流式轨道；不要用 `100vw` 绕过侧栏和宿主宽度。
+
+先分清哪些内容可收缩、可换行、必须保留可读尺寸。长标题和说明自然换行；图标与短操作标签不被挤成逐字竖排。`min-width: 0` 用于可收缩内容，`nowrap` / `flex-shrink: 0` 只用于需保持完整的局部元素，并给父容器提供换行或折叠方案，不全局套用。文本换行后容器随内容增高；不用缩小字号、固定高度或 `overflow: hidden` 掩盖溢出。次要长文本需要省略时提供可达的完整查看方式，关键金额、日期和操作保持可读。
+
+| 区域 | 空间不足时 |
+| --- | --- |
+| 页头、导航 | 限制品牌与账号区占宽，去掉无用副标题、装饰徽标；导航独占一行或收进菜单，保留当前页标识与所有入口 |
+| 工具栏、筛选、操作组 | 整组换行或堆叠，输入保留可用宽度；主动作可达，次要动作可收进“更多”，筛选条件折叠后仍有状态提示与展开入口 |
+| 表单、卡片、详情 | 减少列数，空间不足时改单列；长字段标签可换行。并排同结构内容用共享槽位对齐，堆叠后按内容自然增高 |
+| 表格、日历、弹层 | 必须保持二维关系时只在所属区域滚动，不挤扁单元内容；弹层受可用宽高限制，长内容内部滚动，关闭和提交动作始终可达 |
+
+响应式处理后不得出现文字重叠、单字竖排、不可达操作或整页意外横向滚动；折叠的业务内容和操作保留可达入口。
+
+## 3. 共用配色与字体
+
+已有规范可用就直接继承。缺少规范时，自主选定一套实际值，写入现有主题、CSS 类或组件变体并在页面调用；不逐页重新取值。
+
+**配色按角色分工**：业务界面以协调的中性面为主体，选择一个主动作色及其前景；错误、警告、成功使用独立语义色。没有品牌色时按产品内容选色，颜色不与 A/B/C 配方绑定。普通指标不一项一种颜色，状态色只标记相关状态或异常，不顺带染满整张卡片；图表需要分类色时保持映射与图例一致。默认浅色，已有主题或明确需求支持暗色时沿用，不为单主题任务新增切换器。
+
+常规业务控件与摘要使用平面样式，不叠加彩色渐变、彩边、投影、光晕和图标底板。图标默认跟随文字或当前状态，不逐项配彩色方块；渐变只在明确的品牌素材或内容表达中局部使用。主动作、真实异常和普通统计有不同强调程度，避免同屏多个高饱和实底按钮争夺注意力。
+
+主次文字在实际背景上均须清楚，浅色标签配清楚的深色文字，亮色按钮不默认配白字。历史、已完成记录仍保留必要可读性，不给整行或整张日历统一降低 opacity。hover、轻量选中面从现有主题派生；把颜色映射到工程的页面/内容/浮层、文字、`input`、`ring` 等角色，Portal 也继承主题。例如选定紫色主动作色后，菜单和选中日期沿用同一色，不为弹层另配一套颜色。主题变量若保存的是 HSL 片段，先拼成完整颜色再赋给组件；弹层经 Portal 挂到 `body` 时，把同一组变量映射到 Portal 根节点，否则弹层会丢失主题。
+
+**字体**：沿用工程可用字体；无品牌字体时采用系统字体栈。下面是常规中文业务页的起点，选定后统一使用，品牌展示可调整整组比例：
+
+| 角色 | 字号/行高 | 字重 |
 | --- | --- | --- |
-| 工作台 | 待办与关键结论前置，再展示快捷入口和动态 | 清晰、紧凑、可预期 |
-| 列表与台账 | 搜索筛选 → 数据 → 行内或批量动作 | 统一列对齐与行密度 |
-| 表单与登记 | 语义分组或分步，主操作始终可达 | 单列优先，适当留白 |
-| 详情 | 标题、状态、关键属性 → 分区内容 → 关联数据 | 稳定层级与对象定位 |
-| 看板与报表 | 指标结论 → 趋势与对比 → 明细 | 以读数为主，主题按使用环境选择 |
-| 门户与展示 | 品牌和核心内容前置 | 可用较大的标题、留白与非对称布局 |
+| 页面标题 | 24/32px | 600 |
+| 区块标题 | 16/24px | 600 |
+| 正文、列表值 | 14/22px | 400 |
+| 标签、表头 | 14/20px | 500 |
+| 辅助文字 | 12/18px | 400 |
+| 指标数值 | 28/36px | 600 |
 
-工具页不默认使用大幅 hero、装饰插画或营销式首屏。并列内容可用网格，顺序内容用步骤或时间轴，层级内容用分组；结构必须反映真实信息关系，不把所有区块放入同一种白色阴影卡片。
+字重使用字体实际支持的值。正文和必要说明保持对比度，不把所有次要文字降为极浅灰；中文强调不用默认斜体或负字距。数字与单位靠近并对齐，需要比较的数值用 `tabular-nums`，表格数值右对齐。长内容通过换行或布局处理，不逐条缩字。
 
-## 排版与间距
+页面标题与正文同属一套字体，标签和正文可以同字号，通过位置、字重和间距区分。品牌首屏或报告封面可单独扩展较大的标题角色，局部使用，不放大全站导航和控件。长中文标题保留足够行高；数字单位以正文级字号紧邻数值，不靠空格手工对齐。只使用当前可用字体，不为普通工具页增加字体下载步骤。
 
-以下作为默认层级，按用户品牌、中文可读性及目标设备调整：
+## 4. 控件采用一套基准
 
-| 层级 | 字号 | 字重 | 适用 |
+优先复用工程中可靠的组件及主题接口。新建基准时按任务选择下表；目标不明确用 A。应用内保持一个基础配方，必要时增加紧凑/触控尺寸变体，不逐页换配方。
+
+| 规格 | A 常规 | B 密集操作 | C 舒展输入 |
 | --- | --- | --- | --- |
-| Display | 32–56px，使用 clamp | 700–800 | 表达页首屏或关键数字 |
-| Heading | 20–28px | 600–700 | 页面和区块标题 |
-| Card title | 15–17px | 600 | 卡片与表单分组 |
-| Body | 13–15px | 400 | 表格和正文；长正文可增大 |
-| Caption | 12px 起 | 400–500 | 辅助说明，不承载唯一关键信息 |
+| 适用 | 常规表单、列表 | 连续处理记录、多筛选、排班 | 少字段、需要较大输入空间 |
+| 单行最小高度 | 36px | 32px | 40px |
+| 控件字号/行高 | 14/20px | 13/20px | 14/20px |
+| 水平内边距 | 12px | 10px | 14px |
+| 圆角 | 6px | 4px | 10px |
+| 输入常态 | 干净表面、1px 轻描边 | 轻填充、透明边框占位 | 轻填充、透明边框占位 |
+
+表中数值是起点，调整时保持整组比例。按钮字重 500、输入值 400；常规图标从 16px 起，图文间距 6px。B 的 13px 只用于密集控件，不把全站正文同步缩小；触控命中区通常至少 44×44px，可扩展命中范围。
+
+- 一个操作组突出当前主动作：主题实底主按钮、轻填充次按钮、透明文字按钮。多个并列动作按当前任务分主次，不给每个动作分配一种鲜艳实底色；危险色仅表示真实危险，发布、生成等普通动作不借用警告色。清空和取消保持较轻层级。
+- **普通按钮和输入默认无投影**，避免灰底、灰边、阴影叠加。输入表面干净、边界可辨，浮层可用必要轻投影。
+- 同密度按钮、输入和选择触发器等高；图标、前后缀与文字分槽对齐。状态变化不改变几何占位或让相邻内容跳动。
+- 普通输入聚焦在原位置用单层细边界表达，通常从 1px 变色开始；不叠加 border、outline 与 ring。组合输入由一个外壳画边界，内部按钮仍有可辨的键盘位置。不得全局移除焦点样式。
+
+采用 `border-box`，透明边框也保留占位；尺寸以最小高度处理，长按钮文字调整操作组或换行，不硬裁。主按钮 hover 轻微改变原有色，次按钮用浅填充与清楚文字，文字按钮保留稳定命中区；不在 hover 时加大字重、描边或阴影。图标按钮居中并提供可访问名称；金额、步进等组合输入由一个外壳容纳前后缀和按钮，不在内部重复画框。
 
-- 层级由字号、字重、对比度和间距共同形成，不能只放大标题。行高以内容可读性为准。
-- 中文强调使用字重，不默认使用斜体或负字距。金额、编号和统计数字使用 `font-variant-numeric: tabular-nums`。
-- 默认系统字体栈；特殊字体经允许的依赖或资源打包进入产物，仅加载所需字重，不引入运行时外链字体 CDN。
-- 间距以 4px 基数和 8px 节奏组织；组间距大于组内间距。表格行高可从紧凑 40px、常规 48px、舒展 56px 选择，相同场景一致。
+选中、展开和焦点分别表达：已有值不代表持续聚焦，选中项可用轻填充与勾选；键盘移动项有自己的位置提示。loading 时保留按钮宽度并阻止重复提交；disabled 保留标签可读性，不响应操作。清理默认样式应在共享组件内完成，避免每个页面追加一组覆盖类。
 
-## 表格、表单与按钮
+## 5. 展开面板也是组件的一部分
 
-- 表格文本左对齐、数字右对齐；状态使用文字与语义色，不能只用颜色区分。操作列置于行尾，次要动作按需收纳。
-- 空值表达一致，例如“-”；长内容截断时提供键盘和触屏可用的完整查看方式，不仅依赖 hover。
-- 行分隔使用细线或斑马纹，避免冗余边框；列表同时设计加载、空、失败、部分数据和无权限状态。
-- 表单标签明确且与控件关联，占位符只提供示例。必填与错误提示一致，提交失败定位首个错误字段。
-- 主按钮、次按钮与文字按钮层级清晰，同一操作区域突出一个主要动作；危险动作写明对象和后果，不作为默认焦点。
-- 提交期间阻止重复操作；成功反馈对应真实业务结果，部分成功明确哪些操作需要继续处理。
+下拉、日期、时间与菜单须同时处理触发器和展开面板，面板、选项及选中/禁用/焦点状态继承当前主题，Portal 也不能丢失配色。
 
-## 控件与组件体系
+**本地、mock、不发布和省开发时间都不能成为使用未经设计的系统弹层的理由。** 除用户明确要求或平台硬约束外，不用浏览器原生 `select`、日期/时间弹层作为可见选择界面。先复用现有可主题化组件；缺失时按工程依赖规则采用成熟实现，不为统一外观重写完整日历、定位或焦点管理内核。补充组件时优先选择与现有 React、Tailwind、CVA 兼容的无头原语或轻量实现（如 Popover、Listbox、日历类组件），不引入第二套完整组件库或另一套 CSS 体系；只加当前用到的组件。默认组件栈与 starter 一致：Radix 无头原语（`@radix-ui/react-popover`、`@radix-ui/react-select`）负责弹层、定位与焦点，`react-day-picker` 负责日历；把工程主题变量映射到这些组件的 className，不为它们另写一套颜色。
 
-控件应纳入本应用设计变量和状态体系，同时优先保留可靠交互与可访问性：
+| 组件 | 当前用到时保留 |
+| --- | --- |
+| 下拉、多选 | 当前值、选项层级、选中与禁用、必要的搜索/清空；长列表局部滚动，长标签不撑破布局 |
+| 日期、时间 | 清楚的值格式、切换、选中与必要禁用状态；边界、精度、时段来自业务，遵循主流程日期协议 |
+| 菜单、弹窗、抽屉 | 正确定位、关闭与焦点恢复；面板不越出视口，模态交互保留焦点约束 |
 
-- 文本输入、textarea、checkbox、radio、range 等可用原生元素配统一边框、焦点和 accent-color。
-- 下拉、菜单、弹窗、Tooltip 等优先复用 starter 的组件模式，按需使用 Radix 无头原语、Tailwind token 与 CVA 变体。日期选择可使用 react-day-picker 配 Popover，不手写复杂日历或定位内核。
-- 移动端原生日期选择器等有明确体验收益时可以保留；同类使用场景保持一致。不要为视觉统一损害键盘或触屏体验。
-- 修改既有项目沿用组件库和主题；新建默认不为单个控件引入第二套完整组件库。确需替换时统一全站主题和设计变量。
-- 图标沿用 starter 的 lucide-react 线性风格，不混用不一致的图标库与 emoji。
+### 面板的具体起点
 
-## 设计变量与主题
+下面的参数用于缺少现成规范时，映射到成熟组件的样式接口，不要求新建实现：
 
-颜色、字体层级、间距、圆角、阴影、控件高度、过渡时长收敛为 CSS variables 或现有主题 token，组件复用同一套值。禁止为了微小局部差异不断增加近似值。
+- **下拉与操作菜单**：触发器与输入同高；面板与触发器保持约 4–8px 间距，内边距 4–6px，选项高度从 32–36px 起。单选面板通常不窄于触发器，操作菜单按内容确定宽度；长列表局部滚动并受视口约束。hover 用轻填充，选中可加勾选，禁用项不能点击；空结果给简短提示，不展示虚构选项。
+- **搜索多选**：选项状态与触发器中的值同步；长值可摘要为“已选 N 项”并提供可达的查看/移除入口，不无限增加触发器高度。搜索无匹配与没有任何选项分别表达，清空遵循业务允许的行为。
+- **日期与时间**：单月日历可从约 304–336px 宽、日期格 32–36px 高起，星期与日期七列对齐，月份和前后月操作同排。今天、选中、键盘位置和禁用分别表达；今天不能覆盖选中状态。月份切换、选择和清空真实更新值，范围选择按业务需要采用成熟范围组件。日期值的解析、时区和提交格式遵循[日期与时区](development.md#日期与时区)。固定时段用同主题列表，自由时间输入沿用业务精度，不擅自改成预设时段。
+- **弹窗与抽屉**：标题、内容和动作有共同边距，常规内边距可从 20–24px 起；高度限制在视口内，长内容内部滚动，动作可达。紧凑确认窗不套整页表单宽度，抽屉按详情内容分配宽度；窄屏保留边距或使用合适的全屏变体。
 
-默认浅色主题；用户品牌或使用环境需要暗色时在 token 层实现。仅要求一种主题时不额外实现主题切换。确保文本、边框、焦点和各类状态在所选主题下可辨认；状态色不挪作无关装饰。
+保留成熟组件的键盘和触屏行为。面板内搜索融入面板，不额外画输入框；点击搜索时不新增矩形框、底线或整行填充。鼠标展开默认不自动聚焦搜索；键盘进入仍有局部可辨的焦点提示。
 
-## 响应式与动效
+键盘可打开并移动选项、确认选择、用 Escape 关闭，关闭后焦点合理返回；日期支持跨月导航。鼠标点击搜索用插入光标表达位置，键盘进入可用搜索图标旁的短标记提示，不全局删除 `focus-visible`。状态不能仅靠颜色；浮层渲染到页面外时也必须继承主题。
 
-- 保留 viewport 配置，使用流式宽度、max-width、fr、min 与 clamp，避免固定页面宽度。
-- 窄屏重新组织网格和导航；宽表放入独立横向滚动区域，页面整体不溢出。
-- 触控目标默认至少 44×44px；固定控件考虑安全区，hover 有触屏替代反馈。
-- 桌面高频业务保持信息密度，移动端保证核心任务可完成；不能仅缩小桌面页面。
-- 工具页面动效用于反馈和状态过渡，默认 150–250ms；表达页才按内容需要增加入场编排。统一缓动并尊重 prefers-reduced-motion。
+Textarea 设置 `resize: none`，隐藏右下角拖拽斜线；随内容增高至合理上限后内部滚动，预填、粘贴和窄屏换行后仍能编辑完整内容。
 
-## 界面文案
+字段有明确标签，placeholder 只给示例。错误恢复后去掉相应错误，正常字段不补“已填写”、成功勾选或空帮助行；真实保存与校验结果区别表达。按任务处理加载、空、失败、禁用和提交状态，失败保留输入，提交防重复，不增加假等待或假成功。筛选、分页与切换实际改变内容，数值限制由业务提供。
 
-按钮描述动作结果，例如“保存修改”“删除 3 条记录”。同一概念和动作全站同名。空状态说明内容和下一步，错误说明可恢复动作，不使用只有“出错了”的提示。
+复选、单选、开关、分段、标签、分页与进度沿用同一文字、颜色和状态规则，不强行使用按钮高度。分段选中用轻底色或底部指示，标签表示状态或筛选条件，不能让每个状态都像按钮；移除动作可辨。进度只在有实际分母时显示，分页反映真实页码与可用动作。
 
-金额、日期和数字格式按业务及目标时区统一；不同时间精度有实际用途时可采用对应格式。页面不出现 SDK、SQL、binding、发布环境等与使用者任务无关的内部实现信息。避免营销口号、填充词、starter 残留文案及假成功状态。
+## 6. 文案、身份与内容
+
+页面头默认只放标题、必要范围和动作。只有缺少文字会影响当前选择、输入、读数或后果理解，且标题、控件、图例尚未表达时，才就近补充说明；不要把功能清单搬成副标题。
+
+- 删除“查看各门店班次分布，点击班次查看详情”等操作复述；图例和坐标已说明时间与指标时，不重复补一句。必要的单位、不同统计口径和错误恢复信息保留。
+- 不默认添加“演示环境 / Mock 数据 / 操作仅保存在本地”等横幅或页脚，通常在交付时说明；可能让人误认真实付款、奖励等结果时，就近保留最小辨识信息。不得改写用户录入内容来追求简洁。
+- 正式名称与 Logo 沿用。没有 Logo 的业务工具默认用文字名称，不自动生成“彩色首字方块 + 阴影 + 功能口号”，不另造品牌名。顶部不堆叠技术底座标识、功能口号及无当前任务用途的徽标。功能图标沿用同套风格，AI 功能不默认加机器人或星光。
+- 不为凑版面增加 KPI、素材或进度。图表服务比较：趋势用线、数量用条、精确值用表；零值不画非零长度，缺失不当零，变化须有比较依据。数据模式与统计口径沿用主流程。
+
+用删掉说明后的页面检验必要性：字段名和按钮已表达“排班需求 → 生成草稿”，无需再介绍系统如何结合营业时间、休假和工时限制；但限制会导致本次提交失败且界面尚未告知时，应在相关字段旁保留。图表已有“近 7 个月”坐标与系列图例时，删除重复副标题；不同筛选口径仍需标明。同一指标的数值、比例和徽标只保留有额外信息的表达，不为装饰重复强调。按钮直接写“保存修改”“生成草稿”等实际结果，不用泛化的“开启高效体验”。
+
+业务内容承担视觉重点：素材预览应能辨认产物，结果缺图时展示名称、类型与真实状态；不要用机器人图标和重复标题填满预览。
+
+### 业务界面默认静止
+
+卡片、指标、Logo、AI 入口及告警不使用循环跳动、上下漂浮、缩放呼吸、光晕闪烁或流动渐变；包括 `animate-bounce`、`animate-pulse`、`animate-ping` 及同类自定义动画。告警用稳定的文字、语义色和图标表达。卡片 hover 不抬升或缩放，不给静态内容加数字滚动、逐项入场或装饰轮播。
+
+动效只响应用户操作，或表示真实进行中的任务。hover/focus、展开和关闭可用短促过渡（约 100–180ms），不改变布局占位；加载指示限定在实际忙碌的按钮或区域，完成或失败后立即停止。首屏内容直接可用，数据刷新保留布局与已有内容，避免整块反复卸载造成闪跳。尊重 `prefers-reduced-motion`，减少动效时仍保留清楚的文字和状态反馈。
 
 ## 交付前自检
 
-- 设计方案能在代码中对应到实际 token、排版、密度与组件，而不是仅有文字说明。
-- 首屏内容和主要动作适合当前业务，无无关 hero、装饰卡片或过量渐变。
-- 表格对齐、表单错误、按钮层级和日期数字格式一致；图表选择与比较任务匹配，避免无必要的 3D、仪表盘或过多饼图分类。
-- 焦点、键盘、弹窗、空态、错误和部分成功均有实现；关键文本对比度充分。
-- 桌面和窄屏核心任务可达，无页面级横向溢出；减少动效设置有效。
-- 用户提供的品牌和已有界面得到保留。未做浏览器验证的项目明确列为未验证，不将静态自检报告为真实交互通过。
+在主流程已有检查中核对本次涉及的实现：
+
+1. 工作区获得主要空间，摘要紧凑；颜色按动作、状态和数据含义分工，没有逐卡换色或装饰叠加。
+2. 检查本次页面的外壳及区块容器：仅为布局分组添加的卡片表面已移除，包括无边无影的白色圆角底板；必要控件边界保留。
+3. 页面实际使用共用控件及主题；核对页面调用中不再有 `select`、`input[type=date]`、`input[type=time]` 或其封装作为可见选择界面，本地、mock、不发布不构成豁免；确属用户要求或平台硬约束时记录依据。
+4. 没有重复功能说明、装饰性占位 Logo、无用徽标、双重焦点或“已填写”补句。
+5. 根节点及本次涉及的导航、工具栏、表单、内容区和弹层按可用空间收缩或重排；长值、窄容器下不重叠、不逐字竖排、不裁掉必要内容，操作始终可达。
+6. 字体、必要边界、状态和交互清楚，真实内容与长值没有被布局隐藏。
+7. 本次实现的动画和过渡符合上文用途，没有循环跳动、呼吸光晕、hover 位移或重复入场；加载反馈随真实任务结束。
 
-完成实现后进入[发布与交付](release.md)；用户要求视觉验收时使用[诊断与验收](verification.md)规定的检查范围。
+设计指南不额外启动浏览器巡检、逐页截图或多轮美化流程。检查范围与方法沿用用户任务和主 Skill。结论注明证据层级：实现已核对、运行效果已验证、未验证。截图只证明其对应的页面、尺寸和状态；没有运行证据时不声称交互或视觉通过，也不为消除“未验证”自行扩大检查。有明确问题时修复对应实现，其余工作继续主流程。

package/skills/lark-base-database/references/mutations.md

@@ -0,0 +1,295 @@
+# Mutation Function
+
+Mutation 是固定单表的基础写入声明。读取继续用 Database Function；写入使用 `mutations/<functionId>/{meta.json,spec.json}`，Page 只传位置参数。表、可写字段、固定值和记录 ID 参数来源由发布者声明，不能由调用者扩展。写入方式按下节选择。
+
+CLI 的 `deploy` 自动校验、打包并注册声明，`pull` 恢复 `mutations/`。全部类型共享 Function ID 和最多 200 个 Function 的限制。保存成功不代表写入一定成功，调用后仍需检查错误与部分完成结果。
+
+## 写入方式选择
+
+**读取使用 Database Function；声明能完整表达的普通单表创建、按记录 ID 更新和删除（含批量及附件写入）优先使用 Mutation；需要声明之外的服务端业务校验、计算或编排时使用 FaaS。按业务动作选择，已有 FaaS 无需主动迁移。**
+
+| 业务要求 | 选择 |
+| --- | --- |
+| 固定单表、固定字段的创建，或按记录 ID 更新/删除；只需类型、缺失/null、长度、列表数量等声明内约束 | Mutation；支持一次改多个字段、批量记录和附件增量 |
+| 需要校验记录归属、当前状态、查重、非空白等业务规则，或基于旧值计算、跨表写入、多个业务写入存在依赖 | FaaS；按 [FaaS 协议](faas.md)实现 |
+
+例如修改指定任务的标题和状态、批量设置为完成属于基础写入；“只能修改自己的草稿”需要 FaaS。具体参数限制见[声明与参数](#声明与参数)。需要 FaaS 校验的动作不能另行暴露可绕过校验的 Mutation，也不经 FaaS 调用 Mutation。“上传文件 → 取得 token → Mutation 挂载”属于页面附件流程，本身不需要 FaaS；如需服务端业务校验再按上述边界选择。两条链路均不额外提供事务或 CAS。
+
+## 声明与参数
+
+`meta.json`：
+
+```json
+{"name":"创建任务","description":"提交一条待处理任务"}
+```
+
+Mutation 不声明角色；调用仍需通过应用统一准入。记录 ID 仅限定操作范围，不代表记录归属或行权限校验。
+
+`spec.json` 中 `param` 是 **从 1 开始的位置编号**。记录条件的 `param: 2` 表示从第 2 个参数读取 ID，和“修改两条”没有关系。目标参数必须是必填的单值 `RECORD_ID`，不能设置 `list: true`；多条记录通过 `batch` 逐条传参。
+
+支持 `TEXT / INT / DOUBLE / BOOL / TIMESTAMP / DURATION / USER_ID / GROUP_ID / RECORD_ID / ATTACHMENT`；`required` 默认 true，`list` 默认 false。`TEXT.max_length` 默认 100000，列表 `max_items` 默认 200。`required` 只拒绝缺失/null；TEXT 允许空字符串和纯空白，当前没有 `min_length`、正则或数字范围参数。不能额外传参、动态表/字段或任意 patch。
+
+可选参数传 null 或省略末尾位置表示不修改。文本传 `""` 写入空文本；多选及 `list:true` 的人员参数按完整数组替换，`[]` 清空，单人字段最多一个 ID。其他清空使用固定 `{ "clear": true }`；需要在一次保存中动态选择写入或清空日期时，当前声明无法直接表达，可使用 FaaS。
+
+`set` 每个字段只可选择一种来源：`const`、`param`、`current_user: true`、`now: true`、`clear: true`。人员参数使用内部数字 ID 字符串；调用者不能覆盖服务端注入的当前用户和时间。选项用 Catalog 中已有的选项名称，字段使用真实 field ID。附件的参数、整格替换与增量操作见[附件写入](#附件写入)。不要将公式、lookup、系统等不可写字段放入 `set`；调用后按下文检查 `ignored_fields` 等部分结果。
+
+电话、邮箱和超链接使用 `TEXT` 参数或字符串 `const`，支持 create/update、批量写入及 `clear`。电话传完整号码字符串。超链接传地址（如 `https://example.com`）或 `[展示文字](https://example.com)`，不传对象。`returning` 保留本次提交的字符串；超链接可通过原生 Base 记录接口回读。
+
+`TIMESTAMP` 参数接受毫秒整数或含时区的 RFC3339，保留毫秒精度。日期 `const` 使用含时区的字符串，例如 `{"const":"2026-09-15T08:00:00+08:00"}`，不要使用数字时间常量。`now` 使用服务端当前时间。验收日期写入时，通过 Database Function 回读核对实际时间，不能只检查 `returning`。
+
+## 记录范围
+
+`create` 不带 `precondition`。`update`、`delete`、`append_attachments`、`remove_attachments` 必须带 `precondition`，固定为 `conjunction: "and"`，`conditions` 中仅允许一个 `{"field_id":"rec_id","operator":"is","param":N}` 条件。`is` 表示等于单个记录 ID，每组参数只定位一条记录，不接受 ID 数组。
+
+当前 `precondition` 只定位记录，不读取记录做业务预检，不支持其他字段、多个条件、嵌套 `groups`、`or` 或其他操作符；旧 `record_id_param/record_ids_param`、`target` 和 `on_error` 也会在保存时被拒绝。需要服务端检查归属、状态或其他业务条件时使用 FaaS。
+
+不支持省略 ID 按条件修改或删除。可先通过 Database Function 查询 ID，再调用 Mutation；查询结果不保证写入时状态仍相同。
+
+## 创建单条与批量创建
+
+`mutations/createTask/spec.json` 示例；`tblTasks` / `fldTitle` 等替换成 Catalog 中的真实 ID。
+
+```json
+{
+  "table":{"table_id":"tblTasks"},
+  "operation":"create",
+  "params":[{"kind":"TEXT","max_length":100}],
+  "set":{
+    "fldTitle":{"param":1},
+    "fldStatus":{"const":"待处理"},
+    "fldOwner":{"current_user":true},
+    "fldCreatedAt":{"now":true}
+  },
+  "returning":["rec_id","fldTitle"]
+}
+```
+
+调用单条：`{"params":["准备评审"]}`。创建多条、每条内容不同：
+
+```json
+{"batch":[{"params":["准备评审"]},{"params":["补充文档"]}]}
+```
+
+## 多条记录设置相同值
+
+`mutations/renameTasks/spec.json`：
+
+```json
+{
+  "table":{"table_id":"tblTasks"},
+  "operation":"update",
+  "params":[{"kind":"TEXT"},{"kind":"RECORD_ID"}],
+  "precondition":{"conjunction":"and","conditions":[{"field_id":"rec_id","operator":"is","param":2}]},
+  "set":{"fldTitle":{"param":1}},
+  "returning":["rec_id","fldTitle"]
+}
+```
+
+调用：
+
+```json
+{"batch":[{"params":["统一标题","recA"]},{"params":["统一标题","recB"]}]}
+```
+
+每组的第 2 个参数都是单个记录 ID。
+
+## 多条记录设置不同值
+
+复用上例声明，分别传入每条记录的标题和 ID：
+
+```json
+{"batch":[{"params":["标题 A","recA"]},{"params":["标题 B","recB"]}]}
+```
+
+批量模式按同一个声明解释每组参数，每组操作一条记录。同一请求最多 200 组，不允许重复目标 ID。`batch` 与顶层 `params` 互斥，不支持在一批中混合不同表、操作或 Function。
+
+## 删除多条
+
+```json
+{
+  "table":{"table_id":"tblTasks"},
+  "operation":"delete",
+  "params":[{"kind":"RECORD_ID"}],
+  "precondition":{"conjunction":"and","conditions":[{"field_id":"rec_id","operator":"is","param":1}]},
+  "returning":["rec_id"]
+}
+```
+
+调用：`{"batch":[{"params":["recA"]},{"params":["recB"]}]}`。delete 不接受 `set`，返回只能包含 record ID。
+
+## 附件写入
+
+附件上传仍使用 [文件传输](file-transfer.md#上传) 中的 `siteRuntime.uploadAttachment()`；上传成功后复用已有 `fileToken` 和本地图片宽高调用 Mutation。基础追加使用 `append_attachments`，不先查询并重写旧列表。只有创建新记录时随记录提交附件，或业务明确要求替换整个单元格时，才使用 `create` / `update`。
+
+### 参数与操作边界
+
+`ATTACHMENT` 参数单项是附件对象，例如：
+
+```json
+{"file_token":"fileNew","image_width":640,"image_height":480}
+```
+
+将上传返回的 `fileToken` 映射为 `file_token`；非图片只传 token，图片附本地读取的原始宽高，见[图片宽高](file-transfer.md#图片宽高)。
+
+`{"kind":"ATTACHMENT"}` 接收一个对象，`{"kind":"ATTACHMENT","list":true}` 接收对象数组。附件 `const` 使用数组，例如 `{"const":[{"file_token":"fileNew"}]}`。以下示例使用列表参数。
+
+| 操作 | 声明与语义 |
+| --- | --- |
+| `create` | 附件字段的 `set` 使用 `param` 或 `const`，随新记录写入完整附件列表 |
+| `update` | 附件字段的 `set` 使用 `param` 或 `const`，替换整格；`{"clear":true}` 清空该字段 |
+| `append_attachments` / `remove_attachments` | `precondition` 与非空 `set` 必填，`set` 只包含附件字段，来源只允许 `param` / `const`；禁止 `clear`、`current_user`、`now` |
+
+增量操作的每个目标字段必须有非空附件列表。**一次调用跨 batch、目标记录和字段展开后，附件条目累计最多 50 个**；例如 2 个附件追加到 10 条记录计 20 个。同一文件可以用于不同目标，但每个目标都计数。记录批量限制同样生效。50 条仅是附件增量操作的请求限制；普通 create/update 仍遵守 Mutation 的列表预算与目标平台附件限制。
+
+### 追加已上传附件
+
+建立 `mutations/appendTaskAttachments/meta.json`：
+
+```json
+{"name":"追加任务附件"}
+```
+
+`mutations/appendTaskAttachments/spec.json`（ID 替换为 Catalog 中的真实值）：
+
+```json
+{
+  "table":{"table_id":"tblTasks"},
+  "operation":"append_attachments",
+  "params":[
+    {"kind":"RECORD_ID"},
+    {"kind":"ATTACHMENT","list":true,"max_items":50}
+  ],
+  "precondition":{"conjunction":"and","conditions":[{"field_id":"rec_id","operator":"is","param":1}]},
+  "set":{"fldFiles":{"param":2}},
+  "returning":["rec_id","fldFiles"]
+}
+```
+
+继续上传示例中的 `newAttachment`，Page 传记录 ID 和本次新增列表：
+
+```ts
+const result = await invokeDatabaseFunction('appendTaskAttachments', ['recA', [newAttachment]])
+```
+
+对应调用 JSON 为：
+
+```json
+{"params":["recA",[{"file_token":"fileNew","image_width":640,"image_height":480}]]}
+```
+
+假设原单元格已有 `fileOld`，成功响应是本次操作后的完整列表：
+
+```json
+{
+  "code":0,
+  "msg":"success",
+  "data":{
+    "record_ids":["recA"],
+    "records":[{
+      "rec_id":"recA",
+      "fldFiles":[
+        {"file_token":"fileOld","name":"需求.pdf","size":1200},
+        {"file_token":"fileNew","name":"设计.png","size":8000}
+      ]
+    }]
+  }
+}
+```
+
+Page 检查一次顶层 `code`；成功后从 `data.records` 找到对应 `rec_id`，用 `fldFiles` 更新本地附件列表。这里的 `returning` 是操作后的完整附件列表，包含保留下来的旧附件；旧数据的 `name` 可以为空字符串，`size` 可以为 0。不能把请求中的增量列表当成最终列表，也不能把 FaaS 原始路由的 `data.attachments` 当成 Mutation 响应。
+
+### 移除附件引用
+
+`meta.json` 沿用追加示例，将名称改为“移除任务附件”。
+
+`mutations/removeTaskAttachments/spec.json`：
+
+```json
+{
+  "table":{"table_id":"tblTasks"},
+  "operation":"remove_attachments",
+  "params":[
+    {"kind":"RECORD_ID"},
+    {"kind":"ATTACHMENT","list":true,"max_items":50}
+  ],
+  "precondition":{"conjunction":"and","conditions":[{"field_id":"rec_id","operator":"is","param":1}]},
+  "set":{"fldFiles":{"param":2}},
+  "returning":["rec_id","fldFiles"]
+}
+```
+
+Page 只提交待移除 token；若来自 Database Function 的附件对象，将其 `token` 填入 `file_token`：
+
+```ts
+const result = await invokeDatabaseFunction('removeTaskAttachments', ['recA', [{ file_token: 'fileNew' }]])
+```
+
+对应调用 JSON 与移除 `fileNew` 后的成功响应：
+
+```json
+{"params":["recA",[{"file_token":"fileNew"}]]}
+```
+
+```json
+{"code":0,"msg":"success","data":{"record_ids":["recA"],"records":[{"rec_id":"recA","fldFiles":[{"file_token":"fileOld","name":"需求.pdf","size":1200}]}]}}
+```
+
+移除仅删除单元格中的引用，不删除文件；移除后没有附件时返回该字段的空数组。多条记录使用 `invokeDatabaseMutationBatch`，每组传单个记录 ID，受上述附件总数限制。
+
+附件增量操作不保证原子性、并发不丢项或重试去重。部分结果的判断见[调用与结果](#调用与结果)。超时后保留 token 和宽高，按[结果未知的处理](file-transfer.md#超时与结果未知)做有限只读核对，不自动重传、重试或用旧列表整格覆盖。
+
+## 调用与结果
+
+响应 `code=0` 后仍须检查 `record_not_found` 和 `ignored_fields`：非空表示未全部完成，展示缺失记录或被忽略字段及原因。删除结果的 `record_ids` 可能包含未找到的 ID，不能仅按其长度统计成功数。`records` 不包含缺失记录或被忽略字段的请求值。非零业务错误、无说明的结果缺失、重复或陌生 ID 仍报错；超时或结果异常先只读核对，不自动重试整批。部分完成时也刷新数据，避免页面仍显示写入前的状态。批量调用不额外提供事务或 CAS。
+
+`returning` 仅允许 `rec_id` 和声明 `set` 中的字段。普通 create/update/delete 回显未被忽略字段的提交值（参数经过声明类型转换，常量保留原值），可选字段本次没提供时省略；append/remove 返回操作后的完整附件列表，见[附件写入](#附件写入)。普通 CRUD 的 `returning` 是提交值回显；需要最终存储值时在操作后重新查询。普通 CRUD 示例结果：
+
+```json
+{"code":0,"msg":"success","data":{"record_ids":["recA"],"records":[{"rec_id":"recA","fldTitle":"准备评审"}]}}
+```
+
+Page 结果类型与检查（单次、批量共用）：
+
+```ts
+type MutationResult = {
+  record_ids: string[]
+  record_not_found?: string[]
+  ignored_fields?: {id: string; name: string; reason: string}[]
+}
+function assertComplete(result: MutationResult) {
+  const missing = result.record_not_found ?? []
+  const ignored = result.ignored_fields ?? []
+  if (missing.length || ignored.length) {
+    throw new Error([
+      missing.length ? `记录不存在：${missing.join('、')}` : '',
+      ...ignored.map(field => `${field.name}：${field.reason}`),
+    ].filter(Boolean).join('；'))
+  }
+}
+```
+
+Page 一组参数调用（对应上文 `renameTasks`，一组参数修改一条记录）：
+
+```ts
+const result = await invokeDatabaseFunction<MutationResult>('renameTasks', ['统一标题', 'recA'])
+if (result.code !== 0) throw new Error(result.msg || '写入失败')
+if (!result.data) throw new Error('写入结果缺失，请刷新核对')
+assertComplete(result.data)
+```
+
+Page 多组参数调用（对应上文 `createTask`，每组创建一条记录）：
+
+```ts
+const result = await invokeDatabaseMutationBatch<MutationResult>('createTask', [['准备评审'], ['补充文档']])
+if (result.code !== 0) throw new Error(result.msg || '写入失败')
+if (!result.data) throw new Error('写入结果缺失，请刷新核对')
+assertComplete(result.data)
+```
+
+两个 helper 均来自 starter 的 `page/src/lib/database-runtime.ts`，返回 `{code, data?, msg?}`。先检查顶层业务码，再检查 `data` 中的部分结果，不重复解包。
+
+CLI 调用沿用项目级路由：
+
+```bash
+base-database-cli lark-cli -- api POST '/open-apis/base/v3/sites/<site-token>/invoke_function/<function-id>' --params '{"env":"preview"}' --data '{"batch":[{"params":["准备评审"]},{"params":["补充文档"]}]}' --json
+```

package/skills/lark-base-database/references/notifications.md

@@ -1,20 +1,20 @@
 # 原生通知集成
 
-需求包含原生 workflow 向使用者发送 应用 业务通知时读取。通知应属于用户明确要求的流程；先确认接收人范围、触发条件和业务动作。workflow JSON 按[原生能力路由](base-capability-routing.md)读取当前 CLI 文档，不推测 steps 协议。
+需求包含原生 workflow 向使用者发送应用业务通知时读取。通知应属于用户明确要求的流程；先确认接收人范围、触发条件和业务动作。workflow JSON 按[原生能力路由](base-capability-routing.md)读取当前 CLI 文档，不推测 steps 协议。
 
 ## 入口策略
 
-按用户明确要求优先判定，默认保持 应用 业务对象的操作入口：
+按用户明确要求优先判定，默认保持应用业务对象的操作入口：
 
 | 策略 | 条件 | 入口要求 |
 | --- | --- | --- |
-| `base_action` | 用户明确要求进入多维表格 | 可使用 Base URL 或 `recordLink`，不称为 应用 入口 |
+| `base_action` | 用户明确要求进入多维表格 | 可使用 Base URL 或 `recordLink`，不称为应用入口 |
 | `informational` | 用户明确要求纯展示、无需点击入口 | 可用 `btn_list=[]`，记录该要求；说明平台仍可能提供默认 Base 跳转 |
-| `site_action` | 其余与 应用 业务对象关联的通知 | 显式 `openLink`，进入 Page 已实现的业务路由并定位对象 |
+| `site_action` | 其余与应用业务对象关联的通知 | 显式 `openLink`，进入 Page 已实现的业务路由并定位对象 |
 
-正文已包含业务信息，不构成选择 informational 的依据。访客通知默认进入该登记详情，考试通知进入相应考试详情或答题页；这些是规则示例，不改变用户明确的入口要求。不能用 应用 首页冒充对象详情。
+正文已包含业务信息，不构成选择 informational 的依据。访客通知默认进入该登记详情，考试通知进入相应考试详情或答题页；这些是规则示例，不改变用户明确的入口要求。不能用应用首页冒充对象详情。
 
-`site_action` 使用本次 deploy 返回的顶层 `baseAppUrl`，保留已有查询参数，增加 Page 实际实现的功能定位参数与 workflow 上下文中的最小稳定对象标识。不能使用内部 `staticUrl`、Base URL/recordLink、管理后台或根据 应用 appToken 猜测地址。
+`site_action` 使用本次 deploy 返回的顶层 `baseAppUrl`，保留已有查询参数，增加 Page 实际实现的功能定位参数与 workflow 上下文中的最小稳定对象标识。不能使用内部 `staticUrl`、Base URL/recordLink、管理后台或根据应用 appToken 猜测地址。
 
 `btn_list=[]` 仅表示没有显式按钮，不保证整卡不可点击。用户要求任何点击都不能进入 Base 时，先发现可满足要求的方案；没有相应能力则报告限制，不用 informational 规避要求。
 
@@ -24,7 +24,7 @@
 2. 新 workflow 延后到 Preview 发布成功、且新建 Base 示例验证通过后创建，避免示例记录触发真实通知。当前 CLI 的新建 workflow 默认禁用；创建前仍检查当前 `+workflow-create --help`，传入稳定的本次 `client_token`。
 3. 取得最终 `baseAppUrl` 后构造完整定义并 create，再 get 核验。已有 workflow 先 get 当前定义和使用范围；正在服务生产用户的流程按[生产入口切换](#生产入口切换)保留原链接，其他流程只修改本次授权字段，用完整 read-modify-write update 后 get。不把旧样例或部分响应当完整配置。
 4. 逐个核对通知动作的入口策略、按钮链接、功能参数、对象标识及状态。site_action 必须定位到真实业务路由；其他策略需有明确需求依据。
-5. 按下表决定启停，必要时启用后再次 get。记录实际结果后返回[发布与交付](release.md)，不能把 应用 发布成功等同通知完成。
+5. 按下表决定启停，必要时启用后再次 get。记录实际结果后返回[发布与交付](release.md)，不能把应用发布成功等同通知完成。
 
 ## 状态与失败处理
 
@@ -43,6 +43,6 @@
 
 应用 Prod 发布成功后，使用本次返回的生产 `baseAppUrl`，按 Preview 清单逐一 get → 必要的完整 update → get。site_action 只替换环境入口，保留功能定位参数、动态对象参数、其他步骤和启停状态；最终链接不含 `mode=edit`。已有链接正确时仍回读核对，不做无变化写入。其他策略保留入口意图并复核状态。
 
-已有生产 应用 的 Preview 迭代不得把正在服务生产用户的 workflow 链接改为 owner-only Preview。先核对原链接与使用范围：保留生产入口，将新 Preview 的功能参数列入待切换清单；需要独立通知测试时，仅在用户授权的隔离测试流程中执行。
+已有生产应用的 Preview 迭代不得把正在服务生产用户的 workflow 链接改为 owner-only Preview。先核对原链接与使用范围：保留生产入口，将新 Preview 的功能参数列入待切换清单；需要独立通知测试时，仅在用户授权的隔离测试流程中执行。
 
-任一切换失败时分别报告 应用 发布与通知切换状态；修复后只恢复失败步骤。发布 应用 不会自动迁移外部 workflow，也不授权发送额外测试通知。
+任一切换失败时分别报告应用发布与通知切换状态；修复后只恢复失败步骤。发布应用不会自动迁移外部 workflow，也不授权发送额外测试通知。