Repository navigation
v0.6.0 — 分页调用流程图 + 调用前检查 + 缓存纳入版本
新增两块 DocxXML 富 block(endpoint 模式,均已 push-probe 确认能通过 Lark 导入)
🔀 调用流程 mermaid(条件)
仅当接口分页时,在 ## 调用流程 下输出 <whiteboard type="mermaid"> 的 graph TD。分页判定:cursor/nextCursor 参数或响应字段、hasMore/pagination 响应字段、或 limit+offset/page。非分页接口不输出(2 框流程是噪音)。
流程按真实操作生成:调用方 → 鉴权步骤(如「携带 X-Api-Key」)→ 必填参数(如「传 roomNo / startTime / endTime」)→ 可选过滤分支(如 activityType)→ 调用 → 读取 data 字段(如 activities + pagination)→ {hasMore = true?} →是→「用 nextCursor 请求下一页」循环 / →否→ 结束。
☑️ 调用前检查 checkbox(条件)
## 调用前检查 下输出 <checkbox>,仅列 spec 可推导项(已配置鉴权 / 必填参数已传 / 分页用 nextCursor),最多 4 条,少于 2 条整段跳过。不臆造通用项。
放置顺序:callout → 鉴权 → 参数 → 调用流程 → 响应 → 示例 → 调用前检查。
修复:sync 缓存纳入工具版本
跳过缓存的 hash 之前只基于源 markdown,渲染层单独升级时 hash 不变 → 报 unchanged 跳过推送,线上仍是旧版(v0.5.1 升级后实测 175 skipped / 0 pushed)。现 hash 前缀加 openapi-lark@<version>,每次工具升级普通 sync 自动重推全部接口,无需 --force。
说明
- 不输出
<button>(被 Lark 导入丢弃)与任何颜色属性(被剥离)。可正常落地:callout 结构+emoji、pre caption、whiteboard(mermaid)、checkbox。 - XML 生成/推送失败仍自动回退 markdown,绝不阻断 sync。
消费方:npx github:leeguooooo/openapi-lark 拉 main。