SuperAPI AI 工具集

desktop-whats-new

办公与效率

查看项目

更新于 10-15 20:12

技能介绍

用途:当团队希望向桌面应用用户集中介绍近期新功能,或需要发布 what's-new 弹窗、刷新“设置 → 关于”中的亮点时使用。桌面应用发布频繁,单次版本不在应用内公告,只有积累足够重要功能后才做一次汇总弹窗,在携带该弹窗的更新后首次启动时显示一次。

主要能力:内容位于 apps/examples/desktop-app/webview/lib/whats-new-content.ts 的 WHATS_NEW_RELEASES,按最新在前排列,每条含稳定 id、标题和 3–4 条亮点(标题、描述、lucide 图标)。webview/lib/whats-new.ts 用 localStorage(cline.code.whats-new.v1)记录已见 id,应用外壳在最新 id 与记录不同时显示 WhatsNewDialog。全新安装不会看到汇总,完成引导即标记最新条目已见。“设置 → 关于”的“Show what's new”按钮可重放最新条目且不标记已见,用于预览。弹窗布局固定,不做逐条布局选项、图片或额外按钮;spotlight 条目仅在团队明确要求时添加。

使用方式:先判断是否值得汇总,查看 git log 与 CHANGELOG.md 自上次汇总以来的变更,需有 3–4 个会改变用户工作方式的新能力,而非修复或打磨;不足则停止。起草标题(3–6 词)、亮点标题(1–3 词)、描述(一句、约 90 字符内)与图标,先提交草稿等待批准再改文件。将新条目加到数组顶部,导入新图标,保留旧条目。验证:cd apps/examples/desktop-app 后运行 bunx vitest run webview/lib/whats-new.test.ts --config vitest.config.ts 与 bun run typecheck,再启动 bun run dev:sidecar 和 bun run dev:web(或 bun run dev)预览,检查两种主题、描述不超过三行、标题在 560px 下不换行,并清除 localStorage 后重载确认返回用户可见。随下一次桌面发布上线,无需额外步骤,也不要为汇总本身添加 changelog 条目。

限制:id 唯一且不可复用或修改,否则会重新展示;不要绑定具体版本号;WHATS_NEW_RELEASES[0] 必须最新;Cline Beta 与稳定版共享内容。