Blume

Blume 发布 blume@1.5.2 补丁版：新增 ai.ask.retrieval 三个参数（maxResults/excerptChars/contextBudget）控制 Ask AI 每次提问注入模型提示的检索文献规模，缓解自托管后端固定 1 万字符 grounding 导致单问超 40 秒的首 token 延迟；Ask AI 面板改由客户端路由 transition:persist 跨页存活；新增 ai.openInChat 配置让页面 'Open in chat' 按钮指向 v0/ChatGPT/Claude/Cursor 等提供商子集；原生 OpenAPI 与 AsyncAPI 操作页新增交互式 Try It 面板（参数/请求体表单实时联动示例、Send 浏览器直发、playground.proxy 与内置 CORS 代理）；页面导航改用 Astro 客户端路由实现无闪烁切换并支持深色模式 favicon；默认非拉丁 locale（西里尔/希腊/希伯来/天城文）搜索不再塌缩为零词。

Blume 发布 blume@1.5.3 补丁版：修复客户端路由导航期间初始帧完全无样式的问题——Astro 会把 head 流式传输后渲染组件的 CSS（如页面 MDX 内容）以样式表链接形式提升到 body，而客户端路由既不预取也不持久化 body 样式表，导致页面交换时先渲染出无 CSS 的帧。布局现在会将进入页面的 body 样式表加载进 head 并在切换前等待其就绪，并在切换后保留已加载副本。

Blume 发布 blume@1.5.0：新增文档版本管理——blume version <id> 命令冻结历史版本快照并注册到 blume.config.ts，头部自动生成版本切换器、归档页显示旧版本提示并将 canonical 指向在线文档；搜索按当前版本限定范围并提供 All versions 切换（Orama/FlexSearch/Algolia/Typesense），MCP search_docs/list_pages 工具版本感知并新增 locale 过滤，llms.txt 归档段标注 archived；新增原生 AsyncAPI 渲染器（一操作一页面、按 tag 分组侧边栏、消息/参数/协议绑定 schema 表、协议感知示例、AsyncAPI 2.x 自动升级 3.x）；audit 标题与 meta 描述长度改为按显示列宽计量，侧边栏组支持 flat/group/page 显示模式，blume eject 不再丢失 ai.ask.instructions。

Blume 发布 blume@1.5.1 补丁版：changelog 索引页生成 Open Graph 卡片并修复标题重复；PageLayout 默认输出 schema.org JSON-LD 结构化数据并新增 ogImageAlt/ogImageSize 属性；默认展示字体改为 Inter（单字体族省流量），保留 inter-tight slug；浅克隆 git 历史时构建发出 BLUME_SHALLOW_GIT_HISTORY 警告（指引 VERCEL_DEEP_CLONE / fetch-depth:0 修复 sitemap 日期丢失）；链接悬停/视口预取并支持同源跨文档 view transition 平滑导航；仅预加载首屏所需字重、按需 @font-face 加载；Vercel 上带尾斜杠 URL 以 308 重定向到无斜杠规范形式。

Blume 发布 blume@1.4.3 补丁版：新增 ai.ask.instructions 可自定义 Ask AI 系统提示词（身份/语言/语气）并追加到各后端内置指令，保留依据与引用契约；Ask AI 依据检索与搜索索引改用 Intl.Segmenter 分词，中日韩泰文提问可定位到匹配章节；站点超 5 万 URL 自动拆分 sitemap 索引分片；搜索对话框补齐 combobox 无障碍语义并加固摘要 HTML 清洗；audit 抓取与 Notion 源请求改用限并发池（默认 3）并抖动 429 退避；Windows 上 claude/codex 交接与 eval、translate runner 改用 cross-spawn 启动；CMS/OpenAPI slug 保留 Unicode 字母。

Blume 发布 blume@1.4.2 补丁版：智能体发现链接从仅首页响应头扩展到每个渲染页面的 HTML head，从搜索结果或分享链接直接进入深层页面的 agent 也能拿到 describedby 指向 agent-readability.json 和 llms.txt、以及 text/markdown alternate 指向该页原始 Markdown 镜像；因为链接随预渲染 HTML 分发，在无法设置响应头的 GitHub Pages、S3 等托管上同样生效。同时提升 astro、mermaid、dompurify、undici、js-yaml 与 @astrojs/vercel 最低版本以引入上游安全修复。

Blume 发布 blume@1.4.1 补丁版：内置 Ask AI 面板改走公开 useAskAI hook，该 hook 新增 errorMessage 选项供自定义 UI 控制失败提示；audit 的 OG 图检查改用 image-size 支持 WebP/AVIF，robots.txt 改用 robots-parser，sitemap 改用 fast-xml-parser 支持 CDATA 与命名空间；blume dev 改用 chokidar 监听页面、配置与主题文件；CLI 输出遵循 NO_COLOR/FORCE_COLOR；doctor 用 semver 校验 engines.node；.env 改用 dotenv、tsconfig 改用 get-tsconfig、远程源 include 改用 picomatch、OpenAPI 示例改用 openapi-sampler 并排除 readOnly 字段、图片灯箱改用 medium-zoom、原子写入改用 write-file-atomic。

Blume 发布 blume@1.4.0：新增 `blume translate` 代理驱动 i18n 翻译（--claude/--codex 调本地 agent CLI 翻译缺失或过期页面，blume.translations.json 记录源哈希支持增量重跑，--check 作为只读 CI 漂移门禁，locale 可配 style 定调）；新增声明式 facets，自定义 frontmatter 键变为可过滤元数据，MCP search_docs/list_pages 接受 filters；MCP 客户端可按 contentTypes 内容类型缩小检索范围；新增按类型 frontmatter schema（Zod/Valibot/ArkType 校验）。补丁修复 Cloudflare server 构建的 Accept: text/markdown 协商、redirects 状态码、_headers 输出、产物目录与 blume dev 下 React island 崩溃等。

Blume 发布 blume@1.3.0：AI SDK 升至 v7（Ask AI 端点改用 instructions）；新增本地图片构建期优化（压缩、转 WebP、写入宽高，内置 sharp）与 image 远程域名配置，agent 面向输出的图片链接改写到 /blume-assets/content/…；theme.fonts 支持 Google/Fontsource/Bunny/Fontshare 及本地字体并自动用于 OG 卡片；新增 Web Bot Auth 签名目录、按 Agent Skills Discovery RFC v0.2.0 发布 Agent Skills、RFC 9727 api-catalog、Vercel 上 Accept: text/markdown 内容协商、每页 WebMCP 工具 search_docs/get_page/list_pages、首页 RFC 8288 Link 头；MCP server card 对齐 SEP-2127；blume audit 新增 DNS-AID 发现检查；中日文搜索改按整词 bigram 排序，zod 升至 v4。

Blume 发布 blume@1.3.1 补丁版：首页即使是用户自建 landing page 也能协商 Accept: text/markdown，回退到 /index.md 的 llms.txt 站点索引，并接入 dev server、Vercel 路由配置和首页 Link 头 rel="alternate"；修复 Vercel 部署下首页 Link 头与 Vary: Accept 从不发送（头部路由从 filesystem 后的 miss 阶段前提到主阶段）；Markdown 响应新增 x-markdown-tokens 估算 token 数头部（约 4 字符/token，遵循 Cloudflare Markdown for Agents 约定）；并移除字体名 slug 化中存在多项式回溯风险的正则。

Blume 发布 blume@1.2.1 补丁版本：当 i18n.defaultLocale 设为日语、中文、韩语、泰语等无空格书写语言时，默认 Orama 搜索提供程序改用基于 Intl.Segmenter 的分词器，修复此前这些语言查询因分词失败而始终返回零结果的问题；修复覆盖搜索对话框、MCP 服务器 search_docs 工具和 Ask AI 依据检索，并保持混合语言站点拉丁词大小写不敏感匹配；同时统一侧边栏导航圆角与桌面滚动条样式，并将 Tailwind CSS 4.3 定为最低版本。

Blume 发布 blume@1.2.0：新增 `blume eval` 文档测试套件，由用户本地安装的 AI 代理（默认 Claude Code，`--agent codex` 可换 Codex）通过私有 MCP stdio 桥仅凭文档回答 evals.yaml 中的问题，评判器对照预期事实打分，答不出的问题使 CI 失败（可用 --threshold 放宽），支持 --json 机器报告、--fix 交互式修文档、`blume eval init` 从现有文档生成初始 evals；blume.config.ts 新增顶层 integrations 数组注册 Astro 集成并经 schema 校验；头部标签页可用 href 声明链接目标；支持静态站点上的外部 Ask AI 端点及按数据源的 OpenAPI 搜索、llms.txt、爬虫索引控制；另修复 Cloudflare 构建多余 KV/Images 绑定、Pagefind 搜索排除不生效、嵌套折叠组件 chevron 状态串扰、dev 模式 EPUB 导出失败等问题。

Blume 发布 blume@1.1.4 补丁版本：修复 Ask AI 面板被搜索框 Escape 连带关闭、Ctrl+Shift+I/K 带 Shift/Alt 组合键误触发面板与搜索的问题；blume audit 修复 subpath 部署下 canonical/sitemap/重定向误报、非 ASCII 路由误报、--claude/--codex 非 ENOENT 启动失败被误报为未安装等；MCP 工具 search_docs 返回承诺的 route 字段、get_page 支持完整 URL 或 base 前缀路径；另修复 dateFormat 配置丢失、.md 页面 dev 模式内容不更新、Sanity/Notion slug 斜杠被删除、OpenAPI 非拉丁标签 slug 冲突、侧边栏导航后滚动位置重置等 30 余项问题。

Blume 发布 blume@1.1.2 补丁版本：markdown.codeBlocks.theme.light/dark 支持自定义 Shiki 主题对象，自定义主题贯通围栏代码块、行内高亮、<CodeBlock> 与 <Diff>；修复 i18n 非默认语言环境和 basePath 下根标签页侧边栏作用域误判问题；<Component> 预览面板改用 ResizeObserver 按渲染结果实际高度自适应；修复构建缓存恢复后 .blume/node_modules 指向旧版本导致的崩溃。

Blume 发布 blume@1.1.1 补丁版本：新增 seo.og.titles 按路由命名自定义 .astro 页面的 OG 卡片标题；GitHub changelog 发布页获得基于 release notes 的独立 meta description；修复严格 tsconfig 下 blume check 对生成文件的类型检查失败；Twoslash 改用 Blume 自带固定版本 TypeScript 编译以兼容 TypeScript 7 (tsgo)；agent 输出序列化器现在能求值 {frontmatter.*} 属性表达式；blume build 在任何页面 frontmatter 校验失败时退出码为 1（可用 --no-strict 恢复宽松模式）；blume doctor/check 新增侧边栏同序号警告 BLUME_DUPLICATE_SIDEBAR_ORDER 和首页标题不一致警告 BLUME_NAV_INDEX_TITLE_MISMATCH；修复 npm 提升 astro 后嵌套集成解析失败及 llms.txt 误报 changelog RSS 为失效条目。

Blume 发布 blume@1.1.0 版本，新增 blume audit 离线站点审计工具，运行 87 项检查覆盖 SEO、内容质量、链接、重定向、社交媒体标签、本地化、资源、sitemap、robots.txt、结构化数据和 AI 可发现性，支持 --claude/--codex 交互式修复和 CI 集成；新增 frontmatter.extend 自定义 frontmatter 键值验证；新增 seo.og.fonts 加载 Google Font 字体族修复 CJK 等非拉丁文 OG 卡片渲染；新增 search.popular 自定义 Cmd+K 快捷链接；新增可主题化内容列宽；OpenAPI 参考页新增认证安全要求渲染。

Blume 发布 blume@1.0.4 补丁版本，新增 blume-migrate 智能体技能，可引导 AI 代理将 Mintlify/Docusaurus/Fumadocs/Nextra/Starlight 等现有文档站点迁移为 Blume 项目，并修复 Mermaid 图表渲染、Cloudflare 适配器预渲染、生成运行时类型检查等多个问题。

Hayden Bleasel 发布 Blume v1.0.3 开源文档框架，支持零配置 Markdown 生成文档站点，内置 llms.txt、MCP 服务器和 Ask AI 等 AI-ready 特性，MIT 许可证。