更新日志

查看 Lotus 的发布版本，了解有哪些变更、修复，以及升级是否会影响你的文档站点。

尚未发布

• 在这里添加即将发布的变更。

0.7.3

2026-09-02

• 在默认页面操作菜单中加入 Grok 和 Perplexity，并移除下拉菜单中重复的“复制页面”项。
• 修复 CodeBlock 的构建方式，改用 astro/components/Code.astro。

0.7.2

2026-08-30

• 将共享图标、Markdown 转换和图片画廊设置统一到 @prosefly/astro-components/integration 集成中。
• 将 Pagefind 改为可选 peer dependency；选择 Pagefind 搜索提供器时请单独 安装 pagefind。

0.7.1

2026-08-28

• 修复异步搜索结果覆盖更新查询结果，以及搜索加载错误覆盖新状态的问题。
• 复用已解析的文档导航上下文，避免页面渲染时重复解析侧边栏。
• 修复未配置语言标签时 root locale 默认使用不稳定显示名称的问题。
• 为目录、移动端文档导航、侧边栏滚动和下拉菜单添加 Astro 页面切换期间的清理与重新初始化。
• 固定发布包的集成依赖版本，确保安装结果可复现。

0.7.0

2026-08-22

• 添加 @prosefly/astro-theme-lotus/blocks，提供可复用的 Hero、 FeatureGrid、FeatureCard、Pricing、PricingCard 和 CTA 页面区块。
• 将 PageContainer 和 PageSection 从 @prosefly/astro-theme-lotus/layouts 迁移到 @prosefly/astro-theme-lotus/blocks。
• 添加 Page Blocks 文档，并提供 landing page、pricing page 和自定义 Astro routes 的渲染示例。
• 优化移动端文档侧边栏分区切换器的样式和层级。

0.6.2

2026-07-25

• 将 @prosefly/astro-components 更新到 ^0.5.0，确保内置的 Expressive Code header icon plugin 在包开发和发布安装时都能正常解析。
• 为 Expressive Code frame header 添加文件类型图标；无标题代码块会显示语言标签。
• 跳过 terminal frame 的 header 图标，因为 terminal frame 本身已经提供了终端语境。
• 将 CodeBlock header 的高度和背景与 Expressive Code frame header 对齐。
• 将 Expressive Code 正文样式拆分到独立样式文件。

0.6.1

2026-07-23

• 添加全局 head 配置，可用于 metadata、social cards、verification tags、 scripts 和项目 CSS。
• 添加 head style source 支持，会在 Lotus 默认样式之后追加项目 CSS，并在 开发时监听这些文件。
• 添加 --lotus-header-background 和 --lotus-footer-background token，用于 让页面头部和底部使用不同于页面背景的颜色。
• 将 data-accent、data-gray、data-radius 和 data-theme token selector 改为支持局部预览区域，而不必修改整个文档。
• 将发布的 JSON Schema URL 更新为 https://prosefly.dev/schema/lotus.json。
• 将 ThemeModeButton 改为只显示图标，避免导航栏宽度变化。
• 将 footer credit 链接更新为 https://prosefly.dev/themes/lotus/。
• 优化 Expressive Code frame header，让有标题和无标题的 frame 使用相同高度， 并使用 Lotus 页面背景。
• 修复 prose code 样式，让 not-prose 内容可以跳出 inline code 和 code block 规则。

0.6.0

2026-07-21

• 将 theme config 中的 navbar 重命名为 siteNav，sidebars 重命名为 docsNav。
• 添加自动读取 theme.config.json，并在 /schema.json 发布 JSON Schema； 传给 lotus({...}) 的选项会覆盖 JSON 中的值。
• 将语言选择器移动到站点品牌旁边，并从移动端菜单界面中移除。
• 在移动端视口隐藏标题锚点。
• 将 @prosefly/astro-components 声明为面向主题用户的 peer dependency。

0.5.0

2026-07-21

• 将 @prosefly/astro-components 更新到 ^0.4.0，并将 Prosefly 组件 token 和 class 前缀从 pl 迁移到 pf。
• 添加 lotus-prose 尺寸变体，并支持在正文容器上使用 text-sm、text-base 和 text-lg。
• 导出 DocsLayout，作为带主内容区和右侧栏插槽的可复用文档外壳布局。
• 导出可复用的 Sidebar 主题组件，方便自定义页面和模板使用。
• 添加 markdown.cjkFriendly，配置中文、日文或韩文语言环境时会自动启用。
• 构建侧边栏导航时支持解析基于 Promise 的侧边栏项目组。
• 修复侧边栏滚动到顶部或底部后无法继续带动页面滚动的问题。
• 将 @prosefly/astro-components 更新到 ^0.4.1，并将 Badge 圆角映射到 当前 Lotus 圆角尺度。
• 收窄根包导出，只保留已文档化的集成和主题配置 API。

0.4.0

2026-07-19

• 启用来自 @prosefly/astro-components 的 Prosefly 提示块指令语法。
• 将 @prosefly/astro-components 更新到 ^0.3.0。
• 将 Markdown 相关集成选项收拢到 markdown 下；移除顶层 expressiveCode、calloutDirectives 和 packageManagerTabs。
• 添加 themeModeControl，无需覆盖 ThemeSwitch 即可选择内置主题模式控件。
• 修复独立 SiteHeader 在搜索和 assistant 触发器都关闭时，移动端菜单没有靠右的问题。

0.3.1

2026-07-19

• 添加 llms 配置，用于关闭 /llms.txt 或生成 /llms-full.txt。
• 只有启用 Pagefind 搜索提供器时，才输出 Pagefind 索引属性。

0.3.0

2026-07-19

• 为 h2、h3 和 h4 添加 SSR 标题锚点。
• 为自定义页面添加基于 Shiki 高亮的 CodeBlock 导出。
• 为自定义页面添加 Prose 导出。
• 为文档页面元数据添加 Markdown 替代链接。
• 添加自动生成的 /llms.txt 端点，用于供 AI 读取的文档发现。
• 为 info、success、warning 和 danger 添加语义化状态颜色 token。
• 将 @prosefly/astro-components 更新到 0.2.1。
• 将 SiteHeader 重构为独立站点页眉。
• 修复标题内正文链接的样式。
• 改进移动端标题锚点样式。
• 修复宽屏下文档内容宽度，避免页面操作与目录重叠。

0.2.0

2026-07-18

• 添加繁体中文、日文、韩文、法文、德文、西班牙文、巴西葡萄牙文、意大利文、 俄文和阿拉伯文的内置 UI 翻译。
• 为阿拉伯语、波斯语、希伯来语、乌尔都语等常见 RTL 语言环境添加方向推断。
• 为页眉、下拉菜单、移动端文档菜单、侧边栏、目录、页面操作和上一页/下一页导航添加 RTL 感知行为。
• 添加侧边栏诊断，用于检测缺失条目、空的自动生成目录、重复分区和重复页面归属。
• 增强侧边栏生成，支持 autogenerate.structure、autogenerate.depth 和 autogenerate.exclude。
• 将侧边栏生成拆分为解析、自动生成、索引和诊断模块。
• 简化文档首页路由：现在由 docsBase 控制文档渲染位置，设置 docsBase: '/docs' 时，/ 可以留给自定义首页。
• 移除单独的 homepage 配置选项。
• 移除 source.contentRoot；编辑链接和贡献者源码路径现在直接使用内容条目文件路径。
• 更新发布工作流，自动生成 GitHub 发布说明。
• 改进下拉菜单、本地搜索、移动端文档导航和页面操作的 ARIA 状态、焦点处理与键盘行为。
• 修复已部署页面中的页面操作 URL，避免生成的助手链接保留本地开发源。
• 改进移动端复制页面的剪贴板处理。
• 为页眉 logo 图片添加高加载优先级。
• 在 RTL 正文内容中保持代码、键盘输入和示例文本从左到右显示。

0.1.1

2026-07-17

• 修复包发布中的 Tailwind CSS 问题。

0.1.0

2026-07-17

• 初始发布 @prosefly/astro-theme-lotus。