Plainstruct 3.7.0 Release

[3.7.0] - 2026-10-05

修复

• 发布不再清空 GitHub Pages 自定义域名：发布提交是不带 base_tree 的精确替换 —— 产物之外的文件会全部从发布分支移除,而分支根目录的 CNAME 正是自定义域名的事实来源(deploy from branch 模式),被清后下一次 Pages 构建会把域名设置一并清空,「覆盖云端」确认后自定义域名失效即由此而来。现发布时自动保留云端分支已有的 CNAME 与 .nojekyll(产物自带时以产物为准;分支上没有时按 Pages 设置的 cname 恢复),保留动作写入发布日志;域名/文件的读取与恢复失败不阻断发布
• 构建站点目录高亮与点按动画彻底修复（行为脚本与主题模板解耦）：目录滚动高亮、点按跳转动画、顶栏滚动态、置顶按钮与加载指示这些页面行为脚本，此前逐份内联在五款博客主题的模板里 —— 「从内置主题复制」创建的自定义主题会把复制时刻的模板快照到站点 .plainstruct/themes/<id>/，应用升级后模板里的脚本修复无法传导到这些快照，构建产物与各处预览依旧运行旧脚本：目录依旧不亮、点按没有动画。现将全部行为脚本抽出为渲染管线组页时统一注入的共享脚本（ps-blog.js），构建产物与应用内预览同源生效，与主题模板彻底解耦 —— 任何版本复制出的自定义主题快照都自动获得最新行为与后续修复，五份逐字重复的内联脚本（连同 head 引导脚本）一并从模板移除
• 目录高亮补齐 h1–h6 全层级，点按动画不再被连带失效：滚动高亮此前只收集正文 h2/h3 的标题，目录树却渲染 h1–h6 全部层级 —— 文章出现一级或四级及以下标题时，对应条目永远不点亮；且高亮与点按监听注册在同一处、以「收集到标题」为前提提前退出，一旦匹配为空点按跳转动画一并沉默。现高亮覆盖 h1–h6 全层级（目录里存在的标题才参与点亮），点按动画与高亮解耦，任何标题层级都可平滑跳转
• 滚动动画可被用户手势随时打断：目录点按与置顶按钮的滑动动画进行中，滚轮、触摸或按键立即接管停止 —— 不再出现「用户想停下细看，页面却被动画拖到目标位置」的对抗；点击目录后的落点、URL 锚点与当前高亮的联动行为不变

修复

• 文档拖入文件夹后图片路径多出 ../：移动/重命名后的引用换算中，站内链接正则会命中 Markdown 图片语法的子串（![alt](target) 包含 [alt](target)），对同一目标做第二次替换；替换采用纯子串匹配，已换算的 ../asset/… 中的 asset/… 再次命中，../ 被翻倍成 ../../，图片与站内链接全部失效。现换算统一改为上下文定界替换 —— Markdown 以 ]( 定位（保留 title），内联 HTML 以 src="…"（单双引号）定位，封面图仅在 cover: 行值精确一致时替换；同一文档混排图片/链接、其它引用含相同子串等场景均不再互相污染，重复换算幂等（附十余个场景的回归验证）
• 旧自定义主题的站点缺失 3.7.0 新页面样式：归档页、文件夹落地页、分类分组与固定封面比例的样式此前追加在五款内置主题的 style.css 里 —— 「从内置主题复制」创建的自定义主题快照停留在复制时刻的样式表，发布后新页面结构完好却没有任何样式（表现为「CSS 丢失」）。现将这批功能样式抽出为渲染管线注入的共享样式表（ps-blog.css，插到主题样式链接之前、主题自身同名规则仍可覆盖），与行为脚本同架构：任何版本复制的自定义主题自动获得新页面样式

新增

• 发布页支持设置自定义域名：发布配置新增**「自定义域名」输入框 —— 填写后发布自动把域名写入 CNAME(内容不变时经 blob sha 增量复用,不重复上传),Pages 构建完成后域名与 HTTPS 证书自动生效;域名格式即时校验**(非法格式、github.io 子域在发布端提前拦截并给出原因,不致 Pages 构建失败),粘贴带协议/路径的写法自动取主机名;发布完成的结果区显示所写域名,「查看站点」直接打开域名地址;留空则保留云端现有域名(上一条自动保留行为不变)
• 插入图片弹窗（方式/路径/对齐/尺寸/class 可配）：插入图片时弹出配置窗口 —— 插入方式可选 Markdown 图片或 HTML 代码嵌入;可确认/修改复制到站点的目标路径(content/ 相对,可含子目录,重名自动加序号)与 alt 文本;HTML 嵌入下还可设置图片位置(居中/左对齐/右对齐,以 <div align> 包裹)、宽度与高度(百分比或像素,留空不设置)与 图片 class(如 mws_ps_imgpreview 可配合图片预览插件点击进灯箱)。工具栏「插入图片」单选文件即弹窗(多选仍批量直插 Markdown),从资产栏拖图到正文同样弹窗预填,确认后按落点插入;「图片预览块」按钮维持原有快捷路径
• 博客主页配置头（分类卡片流）：博客站点的根 index.md 在「编辑配置头」中新增主页专属配置区 —— 「卡片流按分类分组」开启后,主页卡片流按分类分组展示(分类取自顶层文件夹,有 index.md 的以其标题命名;组标题可点击进入分类落地页;组内文章保持日期排序);分组下可开关**「显示未分类文章」(不在任何顶层文件夹中的文章,缺省显示)并自定义「未分类」的组标题**;分组显示整流展示,不再生成分页页;主题配置的卡片流设置(每页篇数、并排列数、卡片外观等)在分组模式下保持有效。写入 front-matter 的 homeGroups / homeUncategorized / homeUncategorizedLabel 字段,构建与预览同源生效
• 博客文件夹落地页（卡片流 / 列表可配）：无 index.md 的文件夹自动生成独立落地页,缺省以文章卡片流展示该文件夹(含子文件夹)内的文章 —— 主页分类分组标题点击后跳转到的正是这些页面;文件树右键文件夹新增**「文件夹页面设置」,可切换为目录列表**(原行为),配置存于站点 .plainstruct/folders.json;含 index.md 的文件夹仍以该正文页面为准
• 博客归档页 + 顶栏归档入口（五款博客主题）：每个博客站点自动生成归档页面(收录全部非隐藏文章),页面内提供**「列表 / 分类 / 卡片流」三种视图切换** —— 列表视图按年份分组(无日期文章归入「未注明日期」),分类视图按顶层文件夹分组(组标题可点击进入分类落地页),卡片流视图即文章卡片流;主题配置「顶栏与导航」组新增**「顶栏显示归档入口」**开关(缺省开启),顶栏导航末尾出现「归档」链接(导航为空时同样显示);归档页不进搜索索引,避免整页文章标题稀释搜索质量
• 博客主题新增「固定封面图显示比例」开关（五款博客主题）：「布局」配置组新增封面比例设置 —— 开启**「固定封面图显示比例」后,卡片封面(含无封面占位块)按「封面比例」**(16:9 / 3:2 / 4:3 / 1:1,缺省 16:9)统一裁切显示,不再使用「封面图高度」;关闭时维持原有固定像素高度

变更

• 旧模板快照的兼容：升级前创建的自定义主题快照若仍带着内联版行为脚本，注入的共享脚本会在捕获阶段接管目录点按并拦下旧脚本的监听 —— 新旧脚本共存时不会双重滚动，滚动高亮同帧由新脚本收敛，升级无需重建或修改任何自定义主题