mirror of
https://github.com/larksuite/cli.git
synced 2026-08-03 08:32:46 +08:00
refactor:visual consistency
This commit is contained in:
@@ -173,6 +173,7 @@ lark-cli auth login --domain slides
|
||||
- 不要让版式先于内容;先判断这一页的逻辑关系,再决定几何结构。
|
||||
- 不要创建纯文本页;plain title + bullets 只能作为草稿,不是正式交付。
|
||||
- 不要只设计一页,其余页面保持 plain;视觉系统必须全篇贯彻,或者全篇保持有意克制。
|
||||
- 不要让普通内容页在深色、浅色、图片背景之间来回切换;背景明暗变化必须服务封面、章节、强调或总结等明确页面角色。
|
||||
- 不要混用太多字体、字号、圆角、阴影和强调色;变化必须有层级意义。
|
||||
- 不要用图表承载多个结论,也不要因为有数字就机械画图。
|
||||
- 不要在标题下方画装饰强调线作为默认设计手法;优先用空间关系、局部低饱和色块、尺度、分区和对齐建立层级。
|
||||
|
||||
@@ -31,7 +31,7 @@ metadata:
|
||||
|
||||
**CRITICAL — PPT 生成与模板编辑硬约束:PPT 的尺寸是 960x540,确保主体内容在页面边界内。多用生图,辅助搜图,必须要图文并茂。不要为了画出一个具象物体而堆叠 3 个以上仅用于拟形的 shape。生成背景图时必须在 prompt 中明确要求不要出现任何文字。用户指定 PPT 模板时,用 lark-drive 技能导入成 lark slides,回读理解每页版式后,直接在该 slides 上编辑,可以填改文字和图片、按需增删模板页,必须严格沿用原版式和字体,只改内容不做设计,完成后回读并微调,凝练文字或缩减字号消除文字溢出,调整 shape 顺序或位置避免文字遮挡。**
|
||||
|
||||
**CRITICAL — 创建或大幅改写后,MUST 按 [validation-checklist.md](references/validation-checklist.md) 做显式验证:回读全文 XML、核对页数和关键元素、检查空白/破损页、明显溢出、布局风险;XML 语法和文本重叠静态检查优先使用 [`scripts/xml_text_overlap_lint.py`](scripts/xml_text_overlap_lint.py)。**
|
||||
**CRITICAL — 创建或大幅改写后,MUST 按 [validation-checklist.md](references/validation-checklist.md) 做显式验证:回读全文 XML、核对页数和关键元素、检查空白/破损页、视觉系统一致性、明显溢出、布局风险;XML 语法和文本重叠静态检查优先使用 [`scripts/xml_text_overlap_lint.py`](scripts/xml_text_overlap_lint.py)。**
|
||||
|
||||
**CRITICAL — 创建前自检或失败排障时,MUST 按 [troubleshooting.md](references/troubleshooting.md) 检查 XML 转义、结构、shell 截断、图片 token、3350001 和布局风险。**
|
||||
|
||||
@@ -87,7 +87,7 @@ lark-cli auth login --domain slides
|
||||
|
||||
- **主题化配色**:配色必须服务本次主题、行业和受众,不要默认蓝色商务风。如果把同一套颜色换到另一个完全不同主题仍然成立,说明配色不够具体。
|
||||
- **主次比例**:选择 1 个主色承担约 60-70% 视觉权重,1-2 个辅助色承担结构和分区,1 个强调色只用于关键数字、结论或行动点。不要让所有颜色权重相同。
|
||||
- **背景一致性**:先确定全 deck 的背景策略,默认保持同一明暗基调和底色体系;只有分节、转场或强调页才有意改变背景,并必须通过相同主色、纹理、边栏或 motif 让变化看起来属于同一套设计。无论深浅,都要保证正文、图标和线条对比充足。
|
||||
- **背景一致性**:先确定全 deck 的背景策略,默认保持同一明暗基调和底色体系;普通内容页不要在深色、浅色、图片背景之间来回切换。只有分节、转场、强调页或总结页才有意改变背景,并必须通过相同主色、纹理、边栏或 motif 让变化看起来属于同一套设计。无论深浅,都要保证正文、图标和线条对比充足。
|
||||
- **统一 motif**:选择一个可复用视觉母题贯穿全文,例如粗侧边栏、圆形图标底、半出血图片区、编号节点、卡片左上角色块或大号数字。不要每页换一套装饰语言。
|
||||
|
||||
每页至少要有一个视觉元素:图片、图标、图表、表格、流程、对比结构、大号数字、示意图或由 shape 组成的抽象视觉。文本框本身不算主视觉。
|
||||
@@ -253,7 +253,7 @@ lark-cli slides <resource> <method> [flags] # 调用 API
|
||||
|
||||
## 核心规则
|
||||
|
||||
1. **先规划再写 XML**:新建演示文稿或大幅改写页面时,先确定 deck 目标、受众、页序、视觉系统和每页关键消息;不要从用户提示直接跳到 XML
|
||||
1. **先规划再写 XML**:新建演示文稿或大幅改写页面时,先确定 deck 目标、受众、页序、视觉系统和每页关键消息;同时明确普通内容页的统一背景明暗基调,不要从用户提示直接跳到 XML
|
||||
2. **创建流程**:简单短 XML(1-3 页、结构简单、特殊字符少)可用 `slides +create --slides '[...]'` 一步创建;复杂内容、含图片/中文大段文本/嵌套引号/较多特殊字符,或超过 10 页时,默认先 `slides +create` 创建空白 PPT,再用 `xml_presentation.slide.create` 逐页添加
|
||||
3. **`<slide>` 直接子元素只有 `<style>`、`<data>`、`<note>`**:文本和图形必须放在 `<data>` 内
|
||||
4. **文本通过 `<content>` 表达**:必须用 `<content><p>...</p></content>`,不能把文字直接写在 shape 内
|
||||
|
||||
@@ -13,8 +13,9 @@
|
||||
5. 检查没有明显空白页、破损页、缺失标题或缺失主视觉。
|
||||
6. 检查页面不是全部退化为标题加 bullet list。
|
||||
7. 检查视觉层级:标题、主视觉、支撑信息三者可区分。
|
||||
8. 检查明显溢出和布局风险:重叠、越界、底部拥挤、长文本框。
|
||||
9. 在最终回复中给出简短验证记录。
|
||||
8. QA 检查:确保视觉系统一致性,普通内容页默认复用同一明暗基调和底色体系。
|
||||
9. 检查明显溢出和布局风险:重叠、越界、底部拥挤、长文本框。
|
||||
10. 在最终回复中给出简短验证记录。
|
||||
|
||||
回读命令:
|
||||
|
||||
@@ -84,6 +85,16 @@ python3 skills/lark-slides/scripts/xml_text_overlap_lint.py --input <presentatio
|
||||
- SVG 和 Mermaid 内容的正确性无法通过回读 XML 验证,需要人工视觉验收。
|
||||
- 不要在验证记录中声称 whiteboard 内容已验证,除非用户确认了视觉效果。
|
||||
|
||||
## Visual System Consistency
|
||||
|
||||
逐页检查 deck 级视觉系统是否稳定:
|
||||
|
||||
- 普通内容页默认复用同一明暗基调和底色体系;不要在深色内容页和浅色内容页之间随意跳变。
|
||||
- 只有封面、章节页、强调页、总结页可以有意改变背景明暗,并且必须保留同一主色、边栏、纹理或视觉母题。
|
||||
- 主色、背景色、正文色和强调色沿用同一套令牌;`accent` 只用于关键数字、结论或行动点。
|
||||
- 字体族、标题处理、字号层级、圆角、阴影、图标/图形风格保持同一语言。
|
||||
- 留白密度、对齐方式和页面边距稳定;不要出现某几页像另一套模板。
|
||||
|
||||
## Layout And Overflow Risk
|
||||
|
||||
优先修复这些明显风险:
|
||||
|
||||
Reference in New Issue
Block a user