Plainstruct 4.0.0 Release

[4.0.0] - 2026-10-06

修复

• 搜索插件：移动端设置下拉的重复选项与顶栏入口样式：主题配置面板里「移动端搜索入口形式/位置」的首个选项此前显示「沿用设置 · 当前值」,与下拉中已有的同值选项重复 —— 现改为固定的「沿用 PC 设置」,不再出现两上;搜索位置为「顶栏最右侧」时,文档主题顶栏内的搜索入口改为与目录按钮同款的扁圆角矩形条(同高 36、同毛玻璃材质、描边与阴影,明暗随站点配色),PC 与移动端不再同款不同样
• 文档主题：PC 端侧栏折叠开关点击无效果（五款文档主题，含预设重做）：桌面端的折叠开关此前点任何反应都没有 —— 双重叠放问题叠加所致：开关是 position: sticky 侧栏的子元素,sticky 容器形成叠放上下文,开关的 z-index 被困在其中;而正文列的页面过渡动画以 animation-fill-mode: both 永久持有 transform/clip-path,形成更高一级的叠放上下文并把开关永久压在正文之下(命中探针实证:按钮中心命中的是 .ps-main 而非按钮);现把开关移出侧栏、作为其兄弟节点参与根叠放上下文,无论页面过渡如何设置按钮都可点;顺带按产品语义重做开关预设:移除显示在列表栏外部的「侧栏边缘/顶部/底部」,改为显示在侧栏内部底角 —— 右下角(缺省)/左下角/隐藏,旧配置值自动回退右下角;无头浏览器实测:默认动画下五主题按钮均可命中,点击后侧栏负移出屏、正文占满全宽、开关贴回左缘
• 搜索插件：移动端独立设置保存后无效：主题配置面板里设置的「移动端搜索入口形式/位置」从未生效 —— savePlugins 写回插件配置时丢弃了 searchStyleM / searchPositionM 两个字段,导致设置停留在一空;现随 PC 配置一并落盘,移动端断点(文档主题 900px / 博客主题 640px)变化时入口按移动端设置重建;配置面板中双端设置也按设备标签归位 —— PC 端标签只列 PC 设置,移动端标签只列移动端设置,与主题字段同结构
• 页脚友情链接：五款文档主题条目无样式破版：文档主题只给了友链容器样式,条目与图标无任何规则 —— 链接以浏览器默认蓝色下划线渲染、图标按图片原始尺寸直接擑进页脚;现补齐 .ps-footer-link / .ps-footer-link-icon(行内图标 16px 圆角、悬停强调色);博客主题由共享样式覆盖,不受影响
• 文档主题：移动端目录按钮与搜索按钮同步为扁圆角矩形条：目录按钮由 44px 圆形改为与搜索按钮同款的扁圆角矩形条(60×36,同毛玻璃材质、描边与阴影),移动端顶栏高度按新尺寸重算;博客主题的移动端目录按钮(≤640px)同步为同款;搜索按钮入口在移动端(≤900px)同样压扁为圆角矩形条,列表与搜索在视觉上呼应
• 独立预览窗口：「返回软件界面」按钮悬停提示缺失：壳层右上角的「返回软件界面」按钮此前悬停显示的是键名 —— previewShell.backToApp 国际化键从未写入;现补齐中英文案,并顺带修复两处同类缺失(imageInsert.klass 引用指向不存在的 class 键、tree.folderConfigSaved 键未定义)
• 主题配置：全部主题配置名称清理与双端归位（十款主题）：配置名称尾部的括号提示全部移除 —— 「（桌面端）/（移动端）」由面板的设备端分段开关表达,单位括号移入提示文案(缺提示时补「单位：px/%/ms/项/个/篇」);逐字段复查十款主题:移动端字段(key 以 M 结尾)只出现在移动端标签,双端共用与 PC 专属字段归桌面端标签,移动端标签的分组标题与桌面端一一对应
• 文档主题：移动端抽屉收起按钮「看得见点不动」（双根因，五款文档主题）：抽屉头部的收起按钮此前点击毫无反应 —— 根因一,按钮内 fill="none" 的 SVG 箭头透明填充区默认不参与指针命中(visiblePainted),点击穿透到下层元素,点中按钮中心甚至会触发下方站点链接、直接跳转首页;根因二,:active 的纵向位移变换在移动端(静止态为 transform: none)让按钮按下瞬间上跳半个身位,抬手时指针已落在按钮之外,click 永远无法触发 —— 事件探针证实 pointerdown/mousedown 均到达而 click 丢失;现按钮内 SVG 统一 pointer-events: none(目录按钮、目录折叠箭头同享),移动端复位纵向偏移变量,整个按钮任意位置可点,双轮「打开 → 点击 → 关闭」实测通过
• 独立预览窗口：开关状态与实际窗口脱节：浏览器 mock 下关闭壳层标签页后按钮常亮、点击无反应(现检查 closed 并回退为重新打开);Tauri 下窗口创建失败走异步 error 事件而非抛错,标志卡在「已开启」(现监听 tauri://error 复位);主窗口 webview 重载后 tauri://destroyed 监听丢失,关窗后标志不复位(复用窗口时补绑生命周期监听,标志位防重复绑定);focusPreviewWindow 找不到窗口时复位开关状态并回退为重新打开;构建失败不再弹出预览窗口(避免壳层加载过期或缺失的产物);按钮 tooltip 文案同步「再次点击 = 切换到独立窗口,不关闭」
• 友情链接可视化编辑：「添加链接」此前无效（第二处根因）：上一处修复只覆盖「已有内容」场景 —— 站点从未添加过链接时,linksToText 对空行映射出空串、拼接后仍为空串,写回后 parseLinks("") 解析为零行,从空状态点「添加链接」依然出不来行;现每行恒写三段（空行 = ||,可无损解析回空行;尾空段构建端按三段拆分兼容）,空状态点添加即出新行,所见即所得

新增

• 文档主题：移动端顶栏下拉变形、当前文档标题可居中与桌面端折叠/常显顶栏（五款文档主题）：「布局」组新增三项配置 —— 「顶栏下拉变形」(无/药丸/圆角矩形):向下滚动后顶栏浮起变形,药丸收成胶囊条、圆角矩形收成圆角条(移动端隐藏第二行的当前文档标题,桌面端顶栏同步生效),模仿博客主题的顶栏滚动形态;「顶栏显示」(折叠时显示/常显/不显示):桌面端列表栏折叠后自动显示顶栏(缺省,站点标识居左、当前文档标题居右,正文自动让位),也可改为始终显示或不显示;「当前文档标题对齐」(右对齐/居中/左对齐):移动端顶栏第二行的当前文档标题可居中展示
• 主界面：悬停入口新增「预览站点」：站点构建完毕后,悬停左上角品牌区在「返回主菜单」之后以竖线分隔多出**「预览站点」**入口 —— 点击打开/切到独立预览窗口(已在则原位刷新产物并聚焦);未构建过时不出现
• 问候语扩充：状态区空闲问候语从 7 句扩至 14 句 —— 新增七句让心情变好、激发灵感的短句,轮换周期不变
• 主题配置：友链图标支持从站点资产选择：友情链接编辑行的图标框旁新增**「从资产选择」按钮 —— 弹窗网格列出站点 asset/ 目录下的全部文件(缩略图 + 文件名),点选即写入站内路径;按钮内实时预览当前选中的站内图标,另有一键清除图标**;图标框仍可直接填写外链 URL
• 主界面：左上角状态区与吉祥物问候：标题栏的「素构」二字让位给状态区 —— 即时显示保存状态(自动保存倒计时「N 秒后自动保存」、保存中、已保存、未保存提醒)与发布进展(发布中 done/total、Pages 构建中、失败提示),空闲时轮换显示吉祥物的问候语(45 秒换一句),发布成功后播报祝福语(与发布彩带同帧出现,12 秒后回到问候);状态类别切换带短距淡入淡出,倒计时数字跳动不触发动画,系统「减弱动态」时直接切换;鼠标悬停品牌区浮现**「查看发布状态 | 返回主菜单」**(竖线分隔、两侧留出空隙;存在发布上下文时才出现查看入口),点击分别直达发布页 / 返回主菜单;macOS 品牌区贴右上时同样适用
• 文档主题：侧栏当前文档效果可选（五款文档主题）：「悬停反馈」组新增**「当前文档效果」** —— 默认(保持主题原样式)/ 无 / 底色 / 强调色 / 加粗 / 下划线(强调色下划线,随主题强调色);原「左侧标记」档改为「下划线」,旧站点的已有配置值自动按同效果兼容,改选一次即归位
• 文档主题：侧栏折叠开关位置可配置（双端独立，五款文档主题）：「布局」组新增**「折叠开关位置(桌面端)」(侧栏边缘[缺省,右缘滑出式把手] / 侧栏顶部 / 侧栏底部 / 隐藏)与「折叠开关位置(移动端)」**(抽屉顶部[缺省,抽屉头部的圆形收起按钮,与点击遮罩等效] / 隐藏);开关位置即刻生效,隐藏后不再显示
• 文档主题：站点标识配置（双端独立，五款文档主题）：新增**「站点标识」配置组 —— 站点 Logo 与站点标题的显示开关**、Logo 大小(像素)与Logo 位置(标题左侧 / 标题上方),桌面端(侧栏头部)与移动端(≤900px,抽屉头部与顶栏)双端独立设置;Logo 以 CSS 变量下发并保持图片宽高比,「墨阅」的块式站点标识(Logo 在标题上方)也可切换为横向(标题左侧);两处开关同时关闭时品牌区自动收起,不残留空位
• 文档主题：移动端顶栏目录按钮与搜索按钮同款 + 当前文档标题移至站点标识下方（五款文档主题）：目录按钮升级为与搜索按钮同尺寸(44px)同材质(圆形毛玻璃,同阴影与描边),视觉语言统一;当前文档标题(面包屑)换行至顶栏第二行、右缘与站点标识的内边距对齐 —— 显示在站点标题 / Logo 正下方,同轴不漂移;站点名过长自动截断,不再把第二行标题挤出顶栏;顶栏高度按两行内容精确排布
• 文档主题：侧栏折叠开关（五款文档主题）：桌面端侧栏右缘新增滑出式开关（22×56 贴边圆角小把手，悬停强调）—— 点击后侧栏滑出屏幕、正文占满全宽，开关贴回左缘、箭头转向提示展开；状态记忆 localStorage，刷新后保持；过渡仅桌面生效，不干扰移动端抽屉的 transform 过渡；≤900px 隐藏开关并复位，抽屉行为不变；系统「减弱动态」时无过渡
• 搜索插件：双端独立设置与入口精简：长条搜索框去掉左侧装饰图标 —— 只保留输入框与右侧搜索按钮，更聚焦；搜索入口的形式与位置支持 PC / 移动端各自独立设置（主题配置面板「插件」组新增「移动端搜索入口形式」「移动端搜索入口位置」，留空沿用上方设置），移动端断点（文档主题 900px / 博客主题 640px）变化时入口自动重建
• 图片预览插件：像素渲染彻底无抗锯齿：像素渲染改用与视口等大的 canvas 最近邻采样光栅化 —— CSS transform 缩放由合成器插值、image-rendering: pixelated 在合成层不生效，现以 imageSmoothingEnabled = false 逐帧绘制，一个源像素渲染成整齐色块，缩放/平移/旋转全部保持点对点清晰
• 发布页：圆形大按钮与发布状态动效：发布按钮改为圆形大号按钮（92px,强调色底），发布中两道圆环从按钮循环向外扩散（非线性缓出），成功后按钮转为绿色打勾并浮现**「重新发布」圆形按钮**；账户类型分段控件居中；发布页全部文案精简并统一全角标点
• 发布成功彩带：夸张档上下对喷 + 预览按钮：「夸张」档新增持续喷射流 —— 底部左右两束与顶部两束交替对喷至 1.5 秒，纸屑量与覆盖面翻倍；设置页「发布成功彩带」档位旁新增预览按钮（眼睛图标），点击即以当前档位实况预览
• 独立预览窗口：立即重建按钮：预览壳层右上角新增**「立即重新构建」按钮** —— 点击后请求主窗口立即重新构建（绕过自动重建的防抖延迟），构建完成预览原位刷新；等待期间按钮呈自转等待态，完成或超时后复位
• 资产页：导入文件与拖入快速导入（接纳全部文件类型）：右上角新增**「导入文件」按钮**，也支持把文件从访达/资源管理器直接拖到资产页任意位置快速导入 —— 拖入时整页出现落点遮罩，松手即导入并自动选中；不再局限于图片，文档、音视频、字体等任意文件均可收入 asset 文件夹（仅可执行类扩展名被拒并提示），非图片文件在列表与详情中以扩展名徽标占位展示。WebView 拿不到拖入文件的磁盘路径，前端把文件读为字节后经新命令以 base64 传给后端落盘；内部图片拖拽（拖图到文件夹标题移动）不带 Files 类型，不会误触发导入
• 文档主题：悬停反馈全面可配置（五款文档主题）：「素构 · 浅色 / 暗色」「墨阅」「终端」「画廊」新增**「悬停反馈」配置组 —— 导航悬停反馈（侧栏文档导航，无 / 加深 / 强调色 / 下划线 / 底色）、Logo 悬停反馈（无 / 淡化 / 放大 / 强调色）、站点名悬停反馈（无 / 淡化 / 强调色 / 下划线，墨阅因站点名自带双线装饰不设下划线档）、正文链接悬停反馈（无 / 加深 / 下划线 / 底色，按各主题链接样式适配选项集）与上下页卡片悬停反馈**（无 / 上浮 / 强调色 / 底色）；五档悬停均默认保持各主题原有样式，选择其他档位才接管
• 文档主题：页面加载动画（五款文档主题）：「动效」组新增**「页面加载动画」**（转圈 / 点点 / 进度条，缺省关闭）—— 与博客主题同一套指示器，页面资源加载完成自动淡出
• 文档主题：终端 / 画廊补齐页面过渡动画：「页面过渡动画」九档预设（关闭 / 淡入 / 淡入上浮 / 缩放浮现 / 滑入 / 弹性浮现 / 模糊聚焦 / 翻页 / 揭开）此前仅素构 · 浅色 / 暗色与墨阅可用，现「终端」「画廊」同样支持 —— 十款主题全部具备页面过渡
• 文档主题：页脚配置（五款文档主题）：新增**「页脚」配置组 —— 页脚说明（一行文字，留空不显示）、显示构建版本与日期及构建信息格式**（{date} / {time} / {version} 令牌按钮插入）与友情链接（每行「名称|链接|图标地址」，图标可选），与博客主题同一套结构；全部关闭时页脚不占位
• 文档主题：桌面端 / 移动端尺寸独立设置（五款文档主题）：「颜色与字体」组新增**「正文字号(桌面端)」与「正文字号(移动端)」（0.5px 步进，≤900px 时移动端生效）；「终端」「画廊」「墨阅」新增「侧栏宽度」（此前只有素构 · 浅色 / 暗色可调，现五款齐备，并与「移动端抽屉宽度(%)」独立 —— 窄屏侧栏抽屉按视口百分比显示，缺省 84%）；素构 · 浅色 / 暗色新增「正文宽度(px)」**（此前固定 760px，现 560–960px 可调，页脚随正文同宽）
• 弹窗：背景模糊与开关：所有弹窗遮罩新增背景模糊（半透明压暗 + 毛玻璃），个性化设置新增**「弹窗背景模糊」**开关（默认开启；系统「减弱透明度」时自动退化为纯色）
• 搜索插件：搜索框形态重做：长条文本框改为真输入框 —— 直接在入口输入文本，回车或点击搜索按钮后才弹出结果面板并按已输入的关键词出结果（面板内仍可继续输入即时过滤）；入口位置为**「顶栏最右侧」时，PC 端文档站点主题改在侧栏站点标题下方**整行展示搜索框或按钮，窄屏（侧栏折叠为抽屉时）随断点自动迁回顶栏
• 图片预览插件：像素渲染点对点：切换到像素渲染时，≥100% 的倍率自动吸附到最近整数倍 —— 一个图像像素对应整数个屏幕像素，像素点清晰可见；切入时立即吸附当前倍率，双击放大在像素模式下为 200%（抗锯齿保持 250%）
• 博客主题：正文链接 / 封面图悬停反馈与卡片入场动画（五款博客主题）：「颜色与字体」组新增**「正文链接悬停反馈」（无 / 加深 / 底色 —— 加深即原行为：悬停时下划线 / 虚线颜色变实；底色为悬停衬一层淡色底）；「卡片外观」组新增「封面图悬停反馈」（无 / 微放大 / 放大 / 淡化 —— 悬停整张卡片时封面以缓出曲线渐变缩放，减弱动态时不位移）与「卡片入场动画」**（关闭 / 淡入 / 上浮 / 交错上浮 —— 交错上浮按卡片顺序每 60ms 依次浮现，第 8 张起同拍到达，系统「减弱动态」时不播放）
• 博客主题：移动端 Logo 尺寸独立设置（五款博客主题）：「品牌与标识」组新增**「移动端 Logo 宽度(px)」与「移动端 Logo 高度(px)」**（≤640px 时生效）—— 窄屏顶栏的 Logo 可单独缩小，不再沿用桌面端尺寸

变更

• 弹窗：点击空白不再关闭：点击遮罩空白处不再关闭弹窗，关闭一律通过右上角关闭按钮、取消按钮或 Esc，避免误触丢失已填内容
• 弹窗：更流畅的开关动画（关闭过渡修复）：浮现改为更明显的非线性缓出（缩放 + 上浮），离场走镜像缓入；修复自绘弹窗关闭时缺失过渡 —— 进出场状态类声明移至 .modal-card 常态规则之后接管过渡，并补齐「外层容器为过渡根」与「卡片自身为过渡根」两种结构的选择器
• 文案精简与全角标点：全应用的副标题、提示与弹窗文案压缩为简要说明；中文文案统一使用全角标点符号
• 十款内置主题版本号升至 4.0.0；应用版本升至 4.0.0