Skip to content

v0.8.0 — sync 进度可见 + description 正文回归修复

Choose a tag to compare

@leeguooooo leeguooooo released this 08 Jun 07:32
· 29 commits to main since this release

🐛 回归修复(v0.7 引入):恢复 operation description 正文

v0.7 的鉴权 dedup「skip 到下一个 heading」会连带吞掉紧跟鉴权段后的 description 正文 —— 整段(项目符号列表 + 「为什么用游标」分页说明)在 Lark 文档里消失,callout 后直接跳到「参数」。

  • 鉴权 dedup 改为只跳过鉴权段自身那一段正文(遇空行即停),description 正文恢复完整渲染(<ul> 项目 + <b> 加粗 + 段落)。
  • callout 的 ⚠️ 注意 行此前泄漏原始 markdown(- **数据源**:…);现清洗 markdown,清洗后仍像 markup 则整行省略。callout 不再吞/重复整段 description。
  • 移除 callout 下方冗余的裸 METHOD /path 代码行(callout 首行已粗体展示)。

✨ sync 进度可见(UX)

长跑(~175 接口)此前规划期只零散打印、推送期无计数,读起来像卡死。新增(纯日志,不改渲染/推送语义):

  • 阶段标题:📋 阶段 1/2 规划结构(对账已有 wiki 节点) / 🚀 阶段 2/2 待推送:共 N 个接口(总数前置)。
  • 规划期滚动计数:规划中:已对账 k 个节点…(每 ~20 节点 / ~2s 节流)+ 结束 规划完成:X 节点 / Y 标签 / Z 分组 / W 待清理 zombie。
  • 每接口推送 [i/N] p%:[42/175] 24% ✓ <标题> — <METHOD path> … (2.5s)。
  • 失败/告警仍在结尾汇总;dry-run 也走推送计数。

实测 zugo(161 接口)dry-run:阶段标题、滚动计数、[1/161] 1% → [161/161] 100% 全部正常。

消费方:npx github:leeguooooo/openapi-lark 拉 main。