Repository navigation
Releases
Releases · Geek0ne/VOID-Plus
VOID-Plus 3.6.0
功能增强与工程基建
✨ 新增
- 文章分享扩至十个平台：除原有的微博、Twitter 外，新增微信、QQ、Facebook、Instagram、Telegram、LinkedIn、Pinterest、Tumblr
- 微信扫码分享：点击后弹出二维码，微信扫一扫即可把文章链接与标题分享给好友或朋友圈
- QQ 官方分享页：改用腾讯官方分享组件，可分享到 QQ 好友、群组与 QQ 空间，页面自带二维码
- 404 页面重做：居中卡片式布局，含大号 404 标识、站内搜索框、返回首页与返回上一页按钮，支持亮色与暗色模式
- 404 页面背景：渐变光斑、网格纹理与数字水印三层装饰，站点未配置头图时也不单调
- README 徽章：补充 Typecho 最低版本、PHP 最低版本与最后提交时间
🎨 体验与样式
- 分享按钮点击不再弹出空白标签页
- 分享提示浮层改为贴在按钮上方，不再出现在页面顶部
- 微信、Instagram、QQ 优先调起系统分享面板（移动端可直接在面板里选对应应用），
标题与链接一并带过去；微信在桌面端改为二维码扫码分享，Instagram 则唤起 App 并复制文案
（腾讯旧的 QQ 分享接口已对未备案站点返回空白页，故改用官方分享页） - ENJOY 点赞按钮改为胶囊形
- 文章卡片悬停时的标题与边框由国徽红改为绿色，明暗两色下均保持足够对比度
- 主题自有的样式与脚本引用改为带版本号，用户更新主题后浏览器不再沿用旧缓存
- 分享图标沿用主题既有图标字体，无需额外资源，样式与原来两个按钮完全一致
🔧 工程与维护
- 样式源码恢复可编译：修复 SCSS 中缺失的分号，
npm run build现在能正常产出全部前端资源 - 依赖源修复：
package-lock.json的下载地址换回官方 registry，CI 装包与 Dependabot 更新恢复正常 - CI 一致性校验：新增
consistencyjob，检查版本号三处声明一致、README 与 change-log 更新日志逐字一致、SCSS 选择器与 CSS 产物同步 - Dependabot：自动检查 npm 依赖与 GitHub Actions 的版本更新
- 贡献指南：新增
CONTRIBUTING.md，整理环境要求、构建方式、代码风格、提交规范与发版流程
✅ 兼容性
- Typecho 1.2 / 1.3 与 PHP 7.0 – 8.4 实测通过（PHP 8.4.27 全部文件语法检查无误）
- 本版不改动主题设置项，老站升级后覆盖目录即可
安装 / 升级
全新安装
- 在发布页下载
VOID-Plus-3.6.0.zip - 解压后得到两个目录：
1.主题/VOID-Plus→ 整个目录上传到站点的/usr/themes目录2.配套插件/VOIDPlus→ 整个目录上传到站点的/usr/plugins目录
- 后台「外观」启用 VOID-Plus 主题
- 后台「插件」启用 VOIDPlus 插件（文章字数统计、点赞、浏览量统计依赖它）
- 可选：把主题
assets/VOID-Plus-CacheRule.js复制一份到站点根目录，并在主题设置「自定义 Service Worker」中填好该文件名
从 3.5.7 升级
- 直接覆盖站点的
usr/themes/VOID-Plus目录即可，主题设置不会丢失 - 配套插件如有更新，同样覆盖
usr/plugins/VOIDPlus目录
升级注意事项
- 本版没有新增后台设置项，不需要重新填写任何配置
- 分享按钮从两个增加到十个，如果觉得图标过多，可以自行在
includes/main.php中删掉不用的按钮
VOID-Plus 3.5.7
功能更新、安全加固与问题修复
✨ 新增
- 后台可设置建站时间：填入
2019-5-3（也支持2019/5/3、2019.5.3、2019年5月3日、20190503）后，页脚版权年份显示为「起始年-当前年」，「感谢陪伴」计时也从该日期起算 - 版权许可协议改为下拉选择：后台三选一（知识共享 署名 / 署名-非商业性使用 / 署名-相同方式共享 4.0 国际）或留空，页脚与文章末尾自动按所选协议生成
- README 新增「超高级设置」章节：逐项说明 29 个高级选项的类型、默认值与含义
🔐 安全加固
- 自定义字段（主图、摘要等）不再裸输出到 HTML 属性与 meta
- 社交卡片 JSON-LD 的描述与摘要补上转义
- 后台自定义字体的链接与字形样式改为白名单校验
- 移除主题目录下的
.htaccess：它只作用于主题静态资源，而页面由站点根目录的index.php渲染，且 nginx 完全不读取该文件，对页面安全无实质作用
🐛 问题修复
- 文章主图链接未转义，填入含引号的链接会注入 HTML 属性
- 高级设置 JSON 填写有误时触发 PHP 警告，且设置被静默忽略
- 配套插件图片解析接口的参数未做整型转换
- 插件中的全局错误屏蔽改为只影响单次调用
- 页脚备案号中间出现多余空格
- 社交账号留空时不再输出空的 @ 符号
- 社交卡片图片在文章未设主图时指向无效地址
- 页脚陪伴计时首屏空白，要等脚本加载完才出现
- 页脚陪伴计时与服务端相差一个时区偏移
- 后台自定义字段的说明文字压住输入框
🎨 体验与样式
- 版权许可协议改为下拉选择，不再需要手写 HTML
- 页脚版权说明独占一整行居中显示，桌面与移动端均已适配
- 页脚备案号改用官方国徽图，并自动去掉多余空格
- 版权声明中的链接文字不再比同行文字偏高
- 后台「网站外观」的主题描述改为一句英文摘要
- README 更新日志只保留最近三次，更早版本移至版本更新日志
✅ 兼容性
- Typecho 1.2 / 1.3 与 PHP 7.0 – 8.4 实测通过（PHP 8.4.27 全部文件语法检查无误）
- Typecho 官方最新正式版为 1.3.0（1.3.1 现为 RC 预览版），主题沿用 1.3 的兼容别名
安装 / 升级
全新安装
- 在发布页下载
VOID-Plus-3.5.7.zip - 解压后得到两个目录：
1.主题/VOID-Plus→ 整个目录上传到站点的/usr/themes目录2.配套插件/VOIDPlus→ 整个目录上传到站点的/usr/plugins目录
- 后台「外观」启用 VOID-Plus 主题
- 后台「插件」启用 VOIDPlus 插件（文章字数统计、点赞、浏览量统计依赖它）
- 可选：把主题
assets/VOID-Plus-CacheRule.js复制一份到站点根目录，并在主题设置「自定义 Service Worker」中填好该文件名
从 3.5.6 升级
- 直接覆盖站点的
usr/themes/VOID-Plus目录即可，主题设置不会丢失 - 升级后到后台「主题设置」重新选择一次「版权许可协议」，并按需填写「建站时间」
升级注意事项
- 「版权许可协议」现为下拉框，此前在「版权说明」里手填的 HTML 不再使用，升级后需重新选择一次
- 「建站时间」留空时，仍自动取最早一篇文章的写作时间
- 本版移除了主题目录下的
.htaccess；如需 CSP、X-Frame-Options等响应头，请按自身服务器环境配置
VOID 3.5.4
VOID 3.5.4 — 发行包随附配套插件，结构与原版一致（1.主题/VOID + 2.配套插件/VOID）。
新增
- 发行包随附配套插件（
2.配套插件/VOID，同步 VOID-Plugin 仓库 2023-11 更新：单次图片处理数量上限设置等修复） - 补回上游遗漏的
OwO_02表情资源（assets/libs/owo/）
调整
- 插件获取说明改为随发行包提供（不再依赖上游插件仓库）
- 项目品牌信息更新为 Geek0ne：README 徽章/链接清理、移除旧公告与收款码、License 署名、代码作者信息统一
- 版本号统一为 3.5.4
安装
下载 VOID.zip：
- 将
1.主题/VOID上传至站点/usr/themes，后台启用主题 - 将
2.配套插件/VOID上传至站点/usr/plugins，后台启用插件（浏览量/点赞/字数统计等功能依赖插件）
可选：将主题 assets 文件夹下的 VOIDCacheRule.js 复制一份到站点根目录，并在主题设置「自定义 Service Worker」中填写文件名 VOIDCacheRule.js，即可启用 Service Worker 缓存。
VOID 3.5.3
VOID 3.5.3 — 安全、兼容性与工程化维护版本（基于 3.5.1）。
安全
- 新增
Utils::esc()输出转义，头图/摘要等自定义字段全部转义后输出 - 修复
data-image/data-excerpt等处的存储型 XSS 输出面 brandFont仅允许 http(s) 或站内相对 URL，字体样式/字重白名单校验- 高级设置数字字段强制整型，Twitter ID 校验
- 随主题提供
.htaccess（安全响应头、目录保护、隐藏文件拒绝、缓存与压缩）
兼容性（Typecho 1.3 / PHP 8.x）
- 修复评论父级内容接口签名不一致导致的 Fatal error
- 修复搜索/分类/首页等列表页永久链接计算触发的 Router 异常
- 修复 PHP 8 未定义键告警、评论链接/取消回复链接错误
- 移除全局
error_reporting(0)错误屏蔽
新增
sitemap.php站点地图（支持?type=post|page|all、?days=N，按路由输出正确永久链接）robots.txt模板
优化与修复
- SEO 标签补全：
rel=canonical、og:locale、og:image:alt、twitter:image:alt、article:author等 - 无头图时以主题图标作为
og:image - 修复夜间模式切换时的首屏白屏闪烁（前置内联脚本）
工程化
- 前端构建产物纳入版本库，克隆即可部署
- 工具链迁移 node-sass → dart-sass；新增 CI（PHP lint、未转义输出守卫、构建校验）
- 后台更新检查改用本仓库 Releases；版本号统一为 3.5.3
安装
下载 VOID.zip，解压后将 VOID 文件夹上传至站点 /usr/themes 目录并启用。浏览量/点赞/字数统计等依赖配套插件，请前往 VOID-Plugin 仓库获取。
VOID-Plus 3.5.6
新增、样式优化与修复
- ✨ 页眉右上角新增昼夜模式切换按钮：深浅色图标随当前模式切换，点击立即生效；后台的「自动 / 强制日间 / 强制夜间」仍作为默认行为，用户手动选择后以用户选择为准
- ✨ 新增备案号设置：后台可开关并填写备案号，页脚显示带国徽图标的备案号，并链接至工信部备案查询
- ✨ 新增版权说明：页脚显示单行声明「本网站内容均采用 [CC 图标 知识共享署名 4.0 国际许可协议] 进行许可。」，每篇文章末尾以引用框展示相同声明，并追加「本文链接」与「转载或引用请标注来源」，内容可在后台自定义
- 🐛 修复归档页文章链接丢失：归档页文章链接全部为空，页面中还会混入 PHP 警告文本
- ✨ 代码块增强：代码块右上角显示语言标签与一键复制按钮，语法高亮扩充至 60+ 种语言
- ✨ 无主图文章回退默认头图：文章未设置主图时自动回退使用主题默认头图
- 🎨 移动端文章正文字号调小两号：18px → 16px
- 🎨 正文链接蓝紫配色：未访问显示蓝色、已访问显示紫色，暗色模式同步适配
安装 / 升级
全新安装
- 在发布页下载
VOID-Plus-3.5.6.zip - 解压后得到两个目录：
1.主题/VOID-Plus→ 整个目录上传到站点的/usr/themes目录2.配套插件/VOIDPlus→ 整个目录上传到站点的/usr/plugins目录
- 后台「外观」启用 VOID-Plus 主题
- 后台「插件」启用 VOIDPlus 插件（文章字数统计、点赞、浏览量统计依赖它）
- 可选：把主题
assets/VOID-Plus-CacheRule.js复制一份到站点根目录，并在主题设置「自定义 Service Worker」中填好该文件名
从 3.5.5 及更早版本升级
VOID 更名为 VOID-Plus、插件目录由 VOID 更名为 VOIDPlus，请按下列顺序操作，避免残留旧目录：
- 后台「外观」停用并删除旧主题
VOID；后台「插件」停用并删除旧插件VOID - 上传
1.主题/VOID-Plus到/usr/themes，上传2.配套插件/VOIDPlus到/usr/plugins - 重新启用主题与插件
主题设置会被重置：Typecho 在切换外观时会删除旧外观的设置记录。若你此前配置过 head / footer 代码、高级设置等，请重新填写一次。
想保留原有设置，可在切换外观之前把数据库中的设置项改名：
UPDATE typecho_options SET name = 'theme:VOID-Plus' WHERE name = 'theme:VOID';
升级注意事项
- 插件目录名变化后，原插件的设置项（单次图片处理数量上限）需在新插件中重新设置
- 主题设置中的「自定义 Service Worker」若指向旧文件名
VOIDCacheRule.js，请同步改为VOID-Plus-CacheRule.js - 数据库中若残留
theme:VOID、plugin:VOID两项，可在确认新版本运行正常后手动删除
VOID 3.5.5
修复与体验优化
- 🐛 修复首页刷新闪现无样式页面（FOUC）：页面模板先输出
<body>再输出<!DOCTYPE>/<head>，浏览器落入怪异模式(Quirks)导致 CSS 不再阻塞渲染；修正index/post/page/Archives模板加载顺序（head.php先于header.php），Google Fonts 改为异步加载不阻塞首屏 - 🐛 修复"回到顶部"按钮点击无反应：怪异模式下
documentElement.scrollTop恒为 0 导致平滑滚动立即终止；平滑滚动改用document.scrollingElement，任何模式下均可靠 - 🐛 修复文章目录高亮冻结/点击不跳转：文章标题缺少 id 锚点导致 tocbot 目录链接退化为
#；自动为无锚点标题生成锚点 id（toc-heading-N），新增headingsOffset: 60修正固定顶栏下的高亮判定与跳转落点 - 🔧 精简控制台冗余设置：移除右下角齿轮设置面板（手动明暗切换/字号调节/字体切换）、前台登录表单与后台入口、已登录态快捷按钮；仅保留"回到顶部"与"文章目录伸缩"按钮（无目录时自动隐藏）