<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>变更记录 on Banyan</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/articles/changelog/</link><description>Recent content in 变更记录 on Banyan</description><generator>Hugo</generator><language>zh-Hans</language><lastBuildDate>Mon, 16 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://f6e67316.banyan-git-test.pages.dev/zh/articles/changelog/index.xml" rel="self" type="application/rss+xml"/><item><title>未发布</title><link>https://f6e67316.banyan-git-test.pages.dev/zh/p/unreleased/</link><pubDate>Fri, 06 Nov 2026 00:00:00 +0800</pubDate><guid>https://f6e67316.banyan-git-test.pages.dev/zh/p/unreleased/</guid><description>&lt;p&gt;本项目正在准备首次发布。以下说明首版交付范围；发布标签可用后，再按&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/p/getting-started/"&gt;开始使用&lt;/a&gt;安装。&lt;/p&gt;&#10;&lt;h2 id="主要能力"&gt;主要能力&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;&lt;code&gt;swban dev&lt;/code&gt; 启动含草稿的开发服，首次渲染后建立搜索索引，使用独立临时输出并在退出后清理。&lt;code&gt;dev/lan&lt;/code&gt; 支持局域网预览，&lt;code&gt;dev/pagefind.off&lt;/code&gt; 可跳过索引；追加参数传给 Hugo，启动时显示实际命令并保留工具输出。搜索索引通过重启开发服更新。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;提供独立搜索页，按当前语言实时搜索正文；结果使用正文列宽和加粗标题，整条结果可点击，并复用主题预选效果。搜索页支持 RSS 范围、HTML 文件匹配或目录数组，并用已有 HTML 选择器限定正文，无需添加 Pagefind 专用属性。根目录命令入口支持 &lt;code&gt;swban build&lt;/code&gt;，一键生成站点和 Pagefind 索引。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;构建拒绝覆盖源码目录及自定义挂载目录；无搜索页或 RSS 收录为空时不准备 Pagefind。空 RSS 可正常构建，缺少当前语言索引时显示无结果，搜索摘要正确显示转义字符。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;通过 Hugo Module 提供页面布局、脚本和样式，配套 &lt;code&gt;swaw-banyan&lt;/code&gt; Agent Skill 提供本地工具、构建检查和版本维护。浏览器检查支持部署子目录和默认语言子目录，SW 停用检查按实际部署范围执行。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;用栏目和文章引用组织内容。同一正文可以进入多个分类，保留一个发布网址；支持汇总列表和栏目 RSS。共享引用也适用于仅有非默认语言首页的栏目。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;提供目录列表、名称列表、产品列表和图片墙。面包屑列保留文章浏览来源，各列可独立排序；栏目可配置默认排序字段与升降序，进入子栏目时不继承父栏排序。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;支持多语言、从右向左排版、浅色与深色外观，以及自定义配色和首页艺术包。参考站提供英语、简体中文和阿拉伯语。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;支持 Web App Manifest、可选的 SW 缓存与离线页面、页面预取和原生预渲染。Manifest 地址和 SW 作用范围跟随部署子目录，SVG 浏览器图标支持原有尺寸及仅含 &lt;code&gt;viewBox&lt;/code&gt; 的图形。Powered by 页面提供版本信息与诊断入口。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;生成站点地图、RSS、&lt;code&gt;llms.txt&lt;/code&gt;、社交分享信息和结构化数据。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;从站点交付配置生成 Cloudflare Pages 或 EdgeOne Makers 的部署配置，并生成 CSP 与脚本完整性信息。Skill 提供内容、产物、HTTP 和浏览器检查。EdgeOne 配置只包含交付规则，构建命令和工具版本在平台设置；Skill 按平台分别提供 Git 构建和产物上传指引。&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="使用要求"&gt;使用要求&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;命令帮助改用 &lt;code&gt;help.en.txt&lt;/code&gt; 和 &lt;code&gt;help.zh.txt&lt;/code&gt;；首行为“用法＋两个空格＋#说明”，后续为正文。冷启动与正常运行读取同一份帮助。&lt;/li&gt;&#10;&lt;li&gt;主题要求 Hugo 0.168.0 或更新版本。Skill 命令行支持 Windows x64、Linux x64 和 macOS x64/ARM64；Linux 和 macOS 使用 sh，无需 Python。Git 缺少时会准备便携工具，无需安装系统 Git、Homebrew 或 Xcode。&lt;code&gt;swban build&lt;/code&gt; 会复用兼容的已有工具，并按需下载其他工具。&lt;/li&gt;&#10;&lt;li&gt;新站点从完整根参考站点起步。站点自行维护 &lt;code&gt;hugo.toml&lt;/code&gt;、&lt;code&gt;content/&lt;/code&gt;、&lt;code&gt;archetypes/&lt;/code&gt;、&lt;code&gt;assets/site/&lt;/code&gt; 和 &lt;code&gt;assets/i18n/&lt;/code&gt;；Module 不补充这些文件。&lt;/li&gt;&#10;&lt;li&gt;保留 &lt;code&gt;minify.disableJS = true&lt;/code&gt;，避免 HTML 压缩改变 CSP 授权的脚本正文。&lt;/li&gt;&#10;&lt;li&gt;启用 SW 时，每种已启用语言都要提供 HTML 离线页。参考配置默认关闭 SW 和预取。&lt;/li&gt;&#10;&lt;li&gt;云平台授权和上传由独立的 &lt;a href="https://github.com/SwawHQ/swaw-clouds"&gt;Swaw Clouds&lt;/a&gt; Skill 提供。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="已知限制"&gt;已知限制&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;账号、支付和评论尚未提供。产品列表只展示产品信息。&lt;/li&gt;&#10;&lt;li&gt;SW 更新不会自动刷新已打开的页面。停用已有 SW 时应使用 &lt;code&gt;disable&lt;/code&gt;；&lt;code&gt;off&lt;/code&gt; 不清理已安装的 SW。&lt;/li&gt;&#10;&lt;li&gt;预取和预渲染受浏览器能力与设置限制。配置档位不保证浏览器一定下载或渲染页面。&lt;/li&gt;&#10;&lt;li&gt;部署目录名不能使用 &lt;code&gt;a%20b&lt;/code&gt; 这类含歧义百分号编码的字面名称；构建会报错。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;配置方法见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/articles/docs-guide/"&gt;使用指南&lt;/a&gt;，源码维护与发布流程见&lt;a href="https://f6e67316.banyan-git-test.pages.dev/zh/articles/docs-dev/"&gt;开发资料&lt;/a&gt;。&lt;/p&gt;</description></item></channel></rss>