Blume

Blume 发布 blume@2.2.3 补丁版：Ask AI 助手现在把页面间相对链接（如 ./install、../setup.md）解析为真实路由后再引用，引用链接可落到目标页面，远程/CMS 源页面在所有 agent 表面同样重写；文档摘录及 search_docs、read_page 结果改为以 Markdown 链接标题呈现并要求模型复制，含空格/括号/百分号的路由百分比编码，提升小模型引用可靠性；Orama 分词修复为保留所有拉丁字母整词（när、Prüfung 不再拆散），折音标匹配、软连字符不拆词；语言切换链接保留 URL fragment；新增 SEO 配置：seo.jsonLd 共享实体 id、seo.og.image 默认社交图、seo.datePublished:"git"、sitemap hreflang alternates。

Blume 发布 blume@2.2.0：blume migrate 迁移源扩展到 12 种以上，新增 VitePress、VuePress、Docus、MkDocs、mdBook、Fern、GitBook、Redocly、ReadMe、Docsify、Jekyll（Just the Docs）与 GitHub wiki，含各平台 codemod 及锚点保留、OpenAPI 重定向映射、include 摘录生成脚本；新增 <Changelog /> 组件，手写 /changelog 页可复用自动发布列表并同步到 .md、llms-full.txt、MCP 与搜索；最低 Node.js 升至 22.19，undici 8 支持 HTTP(S)_PROXY 代理远程规范抓取；另含 API 参考排序与 URL 301 规范化、OpenAPI 请求体/响应及多示例进入 Markdown/MCP/llms-full.txt，及 sharp 0.35.5 修复 librsvg 远程代码执行漏洞。

Blume 发布 blume@2.2.1 补丁版：站点页脚新增 footer.copyright 版权行配置，支持纯文本或多语言映射，居中显示在链接与社交图标之间，blume-migrate 迁移时会保留原站页脚版权；新增 agents.mcp.clients 配置，可控制 Connect to MCP 页面动作在 Copy server URL 后列出哪些客户端，支持内置 claude-code、codex、cursor、vscode 键，或以 {label, command} 接入未内置客户端并支持多语言标签与图标；blume/ratelimit 新增 unkey() 限流器，经 Unkey 限流 API 以 UNKEY_ROOT_KEY 在指定命名空间（默认 docs）计数，未配置密钥前退回内存计数且构建时告警。

Blume 发布 blume@2.1.2 补丁版：旁白 narration 新增 openai() 语音提供方，可使用 OpenAI 语音模型或任何兼容 /audio/speech 的服务（如自托管 Kokoro-FastAPI、Speaches、LiteLLM）生成朗读音频，apiKeyEnv 控制密钥转发，MP3 以外的响应不再缓存；新增 clics() 统计适配器统计浏览量与出站点击；notion() 支持 mdx:true 渲染 Notion 页面组件与表达式；首页输出 WebPage JSON-LD 结构化数据并将 Last updated 包入 time 元素；修复 Cloudflare 构建产物超 64MiB 部署失败、reduce-motion 下图片缩放卡住、API 参考 meta 描述悬空冒号及侧边栏 index 页链接等问题。

Blume 发布 blume@2.1.3 补丁版：修复 npm install blume 与 npx blume init 中断问题——@vitejs/plugin-react 6.1.2 与 @astrojs/react 7.0.0 各自要求不同版本 oxc-transform-react（0.152 对 0.145），npm 在两者间反复切换直至内存耗尽；现固定 @vitejs/plugin-react 至与其自带 oxc-transform-react 匹配的 6.1.1，npm、pnpm 与 Bun 均可无 peer 警告完成安装。同时升级依赖：@astrojs/mdx 8.0.2、@astrojs/node 11.1.6、@iconify-json/lucide 1.2.140、@scalar/openapi-parser 0.29.11、dotenv 18.0.5。

Blume 发布 blume@2.1.1 补丁版。Ask AI 助手：跨域暴露 Retry-After、检索按 locale 限定语言、长对话只发送符合 24,000 字符/40 条限制的最近轮次。搜索：Algolia 超 10KB 长页拆条并按 url 去重，Typesense 改为新集合+别名零停机更新并支持 locale 分词，Mixedbread 加防抖/限流，Pagefind 修复链接与多语言，新增非拉丁分词。API 文档支持 OpenAPI 3.2/QUERY 方法，x-codeSamples 进入 llms-full.txt、MCP 与助手语料，GraphQL 新增 auth。eval 修复 Claude Code 配置泄露与工具隔离；audit 实测重定向、robots.txt 全 User-agent 并支持 --ignore；MCP filters 数字/布尔匹配修复。

Blume 发布 2.1.0：助手获得 search_docs/read_page 工具调用能力（单问最多 5 步检索），可直连 OpenAI、Anthropic、Gemini、Grok；新增页面朗读 narration（浏览器语音或 OpenAI TTS 神经音频）；API 参考支持 18 种语言代码示例、Webhook/回调文档与手工端点组件；另加人机验证、内容变量、Cookie 同意、目录列表、页面布局模式、模式重定向、速率限制与站点页脚。

Blume 发布 2.0.0 重大版本：将搜索、部署、内容源、API 参考、分析与 Ask AI 后端统一改为从 blume/* 子路径导入的适配器架构，机器可读配置从 ai 迁移到新的 agents 键，components.ts 改为静态规划。部署新增 vercel/netlify/cloudflare/node 适配器（blume/deploy）；内容源新增 Contentful、Payload、Strapi 适配器；新增 blume migrate 命令，支持从 Mintlify/Fumadocs/Docusaurus/Starlight/Nextra 迁移；新增 blume upgrade 命令自动升级并按文件、行号列出替换方案，--claude/--codex 可交给编码 Agent。

Blume 发布 blume@1.7.3：默认在 /.well-known/ai-catalog.json（镜像 ard.json）发布 AI Catalog/ARD 清单，汇总站点 MCP server card、agent skills、OpenAPI 文档、API 参考与 llms.txt，每项带 urn:air 标识、媒体类型与语义搜索示例，使 agent 注册表仅凭域名即可索引；ai.catalog:false 可关闭。经 Link 头、head link、llms.txt 通告，并在 Netlify/Cloudflare/Vercel 为 .well-known 文档开启 CORS*。Ask AI 新增 ask/ask_answer/ask_error 分析埋点；另修复侧边栏 index 链接、kbd 样式及 Pagefind 索引写入。

Blume 发布 blume@1.7.2 补丁版：Ask AI 端点新增 ai.ask.cors 配置，允许指定来源（或 "*"）跨站调用生成的 Ask AI 接口，路由自动响应浏览器预检并在流式回答与错误状态响应上回写来源，营销页可直接内嵌提问框而无需自建端点或 eject；新增 ai.ask.reasoning 配置，可设 none 到 xhigh 的推理强度，分别映射到 AI SDK 的 reasoning 选项、OpenRouter 的 reasoning.effort 与 OpenAI 兼容端点的 reasoning_effort，不设则保持模型默认；修复配置 header tabs 时分页侧边栏分组区块首次打开 404 的问题。

Blume 发布 blume@1.6.5 补丁版：OpenAPI/AsyncAPI/GraphQL 规范中的 description（schema 属性、参数、请求体、响应、鉴权方案、消息、字段/枚举/返回类型）此前按纯文本渲染，现统一经 marked 渲染为 Markdown，并采用安全链接策略（仅作者明确书写的绝对 URL/根相对路径/锚点/mailto 才成链，裸 URL 不自动链接、原始 HTML 转义），描述内表格加入滚动框；样式收敛为单 class 样式块，消除大参考页约 1.5MB 重复类名导致超出 Googlebot 2MB 抓取上限的问题；新增 analytics.cloudflare 配置（传 token 即注入 Cloudflare Web Analytics beacon，供非代理站点使用）；统一参考行与表格单元格间距尺度；升级 Mermaid 12、React 19.3、Zod 4.6、ai 7.0.99 等依赖，并固定旧版 dagre 布局与 classic 外观保持图表兼容。

Blume 发布 blume@1.6.4 补丁版：API 参考组件 <Operation>/<ApiTagOperations>/<ApiOverview> 在 /<route>.md、llms-full.txt、MCP get_page、Ask AI 语料及站点搜索中从裸标签降级为端点记号（如 GET /pets/{id}、SEND user/signup、query pets、type Pet）加弃用标记，修复智能体读不到端点路径的问题（449 页站点中 266 页受影响）；多语言站点根相对链接、blume check 与 translate 锚点现解析到同语言路由；修复 basePath 下语言切换器双重前缀死链；llms.txt 审计不再误报启用中的 MCP 流式路由为过期条目而阻断发布；搜索在自定义页/changelog/404/API 外壳上限定当前语言；安装块新增 nub/aube 标签；修复代码块间距与 rafThrottle 报错；升级 Astro 7.3.2、Sharp 0.35.4（修复 AVIF 远程代码执行 GHSA-26w7-cxv4-gfx2）。

Blume 发布 blume@1.6.1 补丁版：所有复制入口（Copy as Markdown、代码块、MCP 命令、提示词、色板、API 面板）在 Clipboard API 不可用或被拒绝时回退到 legacy copy 命令，并在仍失败时显示本地化 Copy failed 提示；Copy as Markdown 现支持 Safari/Firefox（改为在点击内以 Promise ClipboardItem 写入）；默认 404 页新增 /404.md Markdown 双胞胎，供智能体从过期 URL 恢复；支持扫描项目根之外的 examples.source 目录满足 monorepo 场景；生成 OG 卡片改用页面自身描述作副标题；Astro/Vite 缓存移入 .blume 运行时避免多项目共享数据存储导致 404；openapi/asyncapi/graphql 引用块新增 seoDescriptionSuffix 选项；运行时数据快照改为从内存虚拟模块服务。

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 许可证。