Repository navigation
v0.10.0 — 真彩色:post-push 块着色(必填→红)
真彩色 —— post-push 块着色 pass
Lark 文档的导入路径不携带颜色(markdown/XML import 会剥离),这是 v0.5.1 移除"死"颜色标记的原因。但颜色其实活在块级属性上,可在文档推送后通过 docx 块 API 设置。
v0.10 新增可复用的 post-push 块着色器(src/lark/block-style.ts)。每个本次实际推送成功的接口文档(cache-skip / dry-run 的不跑),推送后自动:
- 拉取文档 blocks(
GET .../documents/{id}/blocks --page-all)。 - 在 block 树上跑可插拔的 StyleRule[],定位目标文本元素,收集
{block_id, content, text_element_style}编辑。 - 一次
PATCH .../documents/{id}/blocks/batch_update应用全部编辑。
best-effort:拉取或更新失败仅打印告警、绝不把同步结果翻成 failed(内容已落地,颜色是增强)。规则集可扩展(后续加 highlight / callout 着色等)。
规则 #1(本版):必填正文单元格 → 红字
字段表(参数 / 响应 Schema / 请求体)的「必填」列,对正文行(按表结构跳过表头)值为「必填」的单元格设 text_color:1(红)。表头「必填」永不染色;可选单元格(—)不动。
渲染层配合:必填单元格从 v0.9 的 ✅ 改为字面**「必填」**,供着色器染红。
验证(实测 zugo presence-records)
推送后着色器报告 styled:4;回读 blocks 确认正文 roomNo / startTime / endTime(参数表)与 success(200 Schema 表)的必填单元格 text_color:1,四张表的表头「必填」均 text_color:None(未染色)。
调色板
text_color / background_color:1=红 2=橙 3=黄 4=绿 5=蓝 … 15≈灰。background_color(高亮)同理设置,已为后续 highlight 规则预留(styler 支持任意 text_element_style)。
消费方:npx github:leeguooooo/openapi-lark 拉 main。