Skip to content

Plainstruct 3.4.1 Release

Choose a tag to compare

@MogroWang MogroWang released this 01 Oct 16:11
· 73 commits to main since this release

[3.4.1] - 2026-10-01

修复

  • 紧急修复:发布到组织仓库必然失败(403):发布配置此前只有「用户名」一个入口,仓库不存在时一律走个人接口 /user/repos 自动创建 —— 填组织名时 GitHub 会以 403(无权限)或 404 拒绝,仓库也不会落到组织下;现发布页先选账户类型,组织仓库经 /orgs/{组织}/repos 创建,个人仓库仍走 /user/repos,两种账户不再共用一条接口
  • 修复组织仓库无权访问时报错含糊:「验证连接」此前把 403 一律当成「仓库不存在」,组织受限时提示与真实原因不符;现区分 403(令牌无权访问该仓库 / 组织)与 404(确实不存在),并逐条给出原因与处置(令牌未授权该组织、组织不允许成员建仓、组织禁用了 Pages 均落到提示与运行日志)
  • 修复账户类型填错无人察觉:验证连接会核对填写的所有者究竟是个人还是组织(读 GitHub /users/{owner} 的 type),选错时当场提示切换账户类型;个人账户下用户名与令牌所属账号不一致时,也会提示自动创建的仓库会落在令牌账号名下
  • 修复首次发布开启 Pages 失败无迹可循:开启 Pages 的失败此前被静默忽略;现按状态码区分并写入运行日志(403 = 令牌缺少 Pages 权限或组织禁用 Pages),内容推送不受影响

新增

  • 主题配置分类导航(全主题):十款内置主题的配置项全部按语义分组(博客主题:顶栏与导航 / 品牌与标识 / 布局 / 卡片外观 / 颜色与字体 / 目录与动效 / 内容显示;文档主题:颜色与字体 / 布局 / 动效 / 内容显示),面板顶部新增吸顶的分类按钮栏,点击即滚动到对应分组;theme.json 的字段新增可选 category 字段,自定义主题同样生效(无分类的旧主题保持平铺不受影响)
  • 顶栏显示当前页面标题(五款博客主题):主题配置新增开关,开启后顶栏在品牌与导航之间显示当前页面标题(超出省略号截断);首页不显示(避免与站点名重复),窄屏自动隐藏,默认关闭、外观不变
  • 资产详情面板可折叠(悬浮圆角面板):详情窗改为悬浮圆角面板(上/右/下离边留白,不再与内容区拼接),新增左缘折叠/展开把手 —— 折叠后收成窄轨、把手横移到轨上居中,展开/折叠与滑入/滑出均为非线性过渡(宽度与位移分开驱动,适配减弱动态偏好);拖拽调宽保留,多选批量操作与单选预览结构不变
  • 五款博客主题新增卡片阴影颜色:「卡片阴影」与「卡片悬停阴影」两态各自新增阴影颜色设置,预设档位(轻 / 中 / 深)与自定义档位共用同一颜色、只按档位换算不透明度;默认黑色,与 3.4.0 外观完全一致,深色主题可换成浅色阴影
  • 自定义取色器(不再使用系统原生颜色控件):主题配置面板内所有颜色字段(强调色、顶栏背景色、卡片阴影颜色等)改用自绘取色器 —— 触发器是色块加十六进制值,面板内含饱和度/明度区与色相条,按下即取色、拖动 1:1 跟随指针(指针捕获,拖出面板不脱手,可随时反向),十六进制值也可直接键入;拖动中的取样值按 80ms 节流写入配置,界面反馈保持零延迟,松手立即提交最终值;支持方向键微调(Shift 十倍步长)、Esc 收起并把焦点交回触发器,并适配减弱动态偏好
  • 账户类型分段控件:发布页顶部的两段式选择(个人用户 / 组织),选中段以滑动药丸呈现;切换后「用户名」字段随之变为「组织名」,选择立即保存

变更

  • 活动栏「主题」与「构建」互换位置:「主题」上移到「站点设置」之下,「构建」下移挨着「发布」,按「写 → 管 → 排 → 发」的动线排列
  • 资产页顶栏收纳工具按钮:视图切换(卡片/列表)与新建文件夹从列表区工具行移到页头顶栏(与刷新并排),列表区工具行只保留资产计数与已选数
  • 博客主题尺寸设置单位调整(五款):「Logo 宽度/高度」改用像素(16–128px,默认即各主题原始尺寸 26/26/22/30/20px,旧百分比字面值不再迁移,按新默认值显示);「顶栏宽度」与「主页卡片流宽度」改用百分比(50–100%,随窗口自适应,默认 75%,接近旧版 920/916px 在常见窗口宽度的观感);「主页卡片流宽度」选项移到「封面图高度」下方;移除「封面图宽度」选项(封面恒满宽,旧的窄宽居中样式不再提供)
  • 发布页所有者字段文案随账户类型变化:个人用户显示「用户名」、组织显示「组织名」,字段下方的说明文字随之讲清该类型下的建仓位置与令牌所需权限
  • 内置主题版本号升至 3.4.1;五款博客主题的卡片阴影改为颜色变量驱动(--ps-shadow-color / --ps-shadow-hv-color),预设档位与自定义档位共用同一条规则