版本历史
本页记录 PowerWiki 的版本演进与每个版本的主要变化。完整的发布说明与源码变更请查看 GitHub Releases。
当前最新版本:
v1.6.2(发布于 2026-11-10)
版本一览
| 版本 | 发布日期 | 主要更新 |
|---|---|---|
| v1.6.2 | 2026-11-10 | 修复普通 HTML 文章无法滚动;全屏按钮按页面类型分流 |
| v1.6.1 | 2026-11-10 | 原地沉浸式阅读、HTML 首页沉浸态、沙箱高度自适应、首屏性能优化 |
| v1.6.0 | 2026-11-09 | HTML 文章与沙箱完整页面、/full/ 路由、主题同步、全屏入口、稳定地址与 SEO |
| v1.5.2 | 2026-10-10 | 冷启动、版本缓存、统计写入与 PDF 渲染优化;README 图文更新 |
| v1.5.1 | 2026-07-20 | 短链分享与短链访问统计 |
| v1.5.0 | 2026-07-20 | 复制原文、原始 / 渲染视图切换 |
| v1.4.8 | 2026-04-18 | 修复目录(TOC)残留问题 |
| v1.4.7 | 2026-02-24 | 前端模块化重构,主题 / 移动端修复 |
| v1.4.6 | 2026-02-09 | Mermaid 图表支持、零配置启动 |
| v1.4.5 | 2026-02-06 | 暗夜模式、i18n 日志、Windows 路径修复 |
| v1.4.0 | 2026-02-05 | 图片相对路径、src/ 模块化重构 |
| v1.3.0 | 2026-02-05 | 修复相对路径问题 |
| v1.2.0 | 2026-02-04 | 完整国际化、数据分析仪表板、本地图片 |
| v1.1.0 | 2025-12-26 | 维护性更新 |
| v1.0.1 | 2025-12-24 | 修复文件与文件夹选中状态冲突 |
| v1.0.0 | 2025-12-24 | 首个正式版本 |
v1.6.2
发布日期:2026-11-10
🐛 问题修复
- 普通 HTML 文章无法滚动:没有
powerwiki-render: sandbox标记的 HTML 文章会被清洗成普通正文,之前却被套上了沉浸态布局(html/body的overflow: hidden)。正文没有 iframe 承载滚动,外层滚动又被锁死,页面停在第一屏再也滑不动。现在只有沙箱页面进入沉浸态,普通 HTML 文章恢复整页滚动。 - 全屏按钮按页面类型分流:普通 HTML 文章的「全屏」改回直接打开
/full/完整页面,不再原地切换;沙箱页面与 HTML 首页仍原地展开。
📝 文档
- 示例配置
config.example.json的首页指向README.html,与演示仓库保持一致。
✅ 验证
npm test:21 项全部通过。- 本地实测:基础示例 可正常滚动(
scrollY0 → 600,overflow: visible);数据看板 与 HTML 首页仍保持沉浸态、iframe 与退出按钮正常。
详细说明见 Release。
v1.6.1
发布日期:2026-11-10
✨ 新功能
- 原地沉浸式阅读:HTML 文章的「全屏」不再跳转
/full/新页面,而是在当前页把正文画布展开到整屏。桌面端保留左侧目录,移动端收紧留白;右上角提供「退出全屏」,Esc也可退出。iframe 不重新加载,页面内部的滚动位置与状态都会保留。 - HTML 首页沉浸态:配置为
.html的首页自动铺满视口打开;退出后回到带站点外壳的常规阅读视图。本站首页已改为 README.html。 - 沙箱高度自适应:沙箱页面通过
postMessage上报内容高度,iframe 按内容高度展开(限制在 240–20000px)。退出沉浸态后不再出现内部第二根滚动条或大片空白。
⚡ 性能优化
- Mermaid 改为按需加载:首页与普通文章不再下载约 3MB 的图表库,只有正文里存在图表时才拉取。
- highlight.js 主题样式改为非阻塞加载,不再拖住首次绘制;保留
<noscript>回退。 - 服务端已渲染的首页与正文不再被前端清空重建,消除 HTML iframe 的二次请求和一次白屏。
- HTML 首页与 HTML 文章由服务端直接输出沉浸布局,首帧就是最终宽度,不再出现「先窄后宽」的跳变。
🐛 问题修复
- 修复 HTML 文章切换时「先退出沉浸态、再重新进入」造成的布局抖动。
- 修复沉浸式阅读接入后客户端单元测试的 mock 缺失,测试套件恢复全绿。
✅ 验证
npm test:21 项全部通过。- 本地实测:首页 FCP 约 28ms、DCL 约 20ms;
/full/首屏请求由 2 次降为 1 次,首页不再加载 Mermaid。
详细说明见 Release。
v1.6.0
发布日期:2026-11-09
✨ 新功能
- HTML 文章:仓库里的
.html/.htm与 Markdown 一起收录,共用目录、复制、原始视图、分享短链、SEO 标签和阅读数。声明<meta name="powerwiki-render" content="sandbox">的页面会以隔离沙箱 iframe 运行完整脚本与样式,但拿不到 Wiki 的 Cookie、localStorage 或同源接口。 /full/完整页面:原始 HTML 可从/full/<仓库路径>独立打开,支持目录索引与省略后缀的路径;只放行 HTML 与静态资源,JSON、YAML、TXT 等数据文件保持不公开。- 沙箱主题同步:父页面通过
postMessage把主题和语言传给沙箱,在 iframe 加载完成及站点切换明暗主题时同步,沙箱页面也可以主动索取一次。 - 全屏入口:HTML 文章工具条新增主色「全屏」按钮,一键在新窗口打开完整页面;Markdown 与 PDF 自动隐藏。
- 稳定文章地址与 SEO:frontmatter 支持
slug与aliases,移动或重命名文件后文章地址与分享短链保持不变;canonical、Open Graph、Twitter Card、JSON-LD、RSS 与 sitemap 使用同一地址。 - 上一篇 / 下一篇:按创建时间排序,忽略修改时间。
- 自定义 404:通过
pages.notFound指定仓库内页面,未配置时使用内置 404。
🛡️ 安全与修复
- 仓库资源统一经过路径校验:拒绝目录穿越、隐藏路径、符号链接与不允许的扩展名。
/full/使用 CSP sandbox、nosniff、no-store与frame-ancestors 'self';沙箱 iframe 不含allow-same-origin。- 修复沙箱页面的 CSS/JS 因跨源资源策略被浏览器拦截,以及缓存目录名含点导致静态资源 403 的问题。
- 修复 HTML 标题中的越界数字实体导致文章 503 的问题。
📚 演示
- 新增 HTML 页面演示:安全清洗示例、交互式落地页、数据看板、WebGL 与富媒体、文档站,以及多页面站点。
- 多页面站点覆盖目录索引、无扩展名路径、页面间相对跳转、共享 CSS/JS 与数据模块,并跟随站点明暗主题。
详细说明见 Release。
v1.5.2
发布日期:2026-10-10
- Git 扫描结果共享与长期缓存,启动同步后预热目录。
- 菜单和文章按内容版本复用,增加轻量版本检查与菜单 ETag。
- 统计改为内存累积与定时原子写入,兼容损坏的历史统计文件。
- 静态资源内容哈希缓存,PDF 可见页懒渲染与资源回收。
- README 添加官网截图,统一项目字标。
v1.5.1
发布日期:2026-07-20
- 文章页新增分享按钮,生成基于路径哈希的短链。
- 统计页增加短链访问量与 Top 10 明细。
- 统一复制图标,文章操作按钮独立成行并右对齐。
v1.5.0
发布日期:2026-07-20
✨ 新功能
- 复制原文:文章头部新增「复制」按钮,一键将当前文章的原始 Markdown 源码复制到剪贴板。
- 原始 / 渲染切换:新增「原始 / 渲染」按钮,可在渲染视图与原始 Markdown 源码视图之间自由切换,方便查看和复制排版前的内容。
- 新增原始 Markdown 视图样式(等宽字体、代码块风格排版),并完善中英文界面文案。
- PDF 文档下自动隐藏上述按钮。
🛠️ 改进
- 视图切换采用「显隐切换」实现:渲染内容始终保留、切换时不重建 DOM,切回渲染视图后代码复制、图片放大等交互依然可用。
- 切换按钮的悬浮提示(title)随视图状态同步。
- 新增社区 Issue / PR 模板,规范贡献流程。
感谢 @joey-ccb 贡献本次新功能 🎉
v1.4.8
发布日期:2026-04-18
🐛 问题修复
- 修复目录(TOC)残留:从「有目录」的文章切换到「无目录」的文章时,右侧目录栏不再显示上一篇的残留目录。
- 当前文章没有标题目录时,主动清空旧目录并隐藏目录栏。
- 仅在成功生成目录时才显示目录栏并绑定滚动监听。
✅ 测试
- 新增 2 个回归测试,覆盖无目录文章的目录清理与切换场景。
v1.4.7
发布日期:2026-02-24
✨ 新功能
- 前端模块化重构:将大型前端文件拆分为模块化结构,提升可维护性与可扩展性。
app.js(2084 行 → 270 行)拆分为 9 个 JS 模块。styles.css(1797 行)拆分为 7 个 CSS 模块。
🐛 问题修复
- 修复主题切换按钮在页面加载时点击无反应的问题(初始化时机)。
- 修复移动端左侧菜单按钮不显示的问题(CSS 加载顺序)。
📚 文档
- 更新全部 8 种语言的 README 目录结构说明(中、英、日、韩、德、法、西、俄)。
v1.4.6
发布日期:2026-02-09
✨ 新功能
- Mermaid 图表支持:可直接在 Markdown 中绘制流程图、时序图、甘特图等,暗黑模式下使用纯白背景提升可读性。
- 零配置启动:无配置文件时自动降级使用示例配置,开箱即用。
🐛 问题修复
- 修复国际化在非首页加载时丢失的问题。
- 修复文件树嵌套目录箭头状态错误,优化仅含 README 目录的渲染逻辑。
Mermaid 图表支持由贡献者 @sayunchuan 提供。
v1.4.5
发布日期:2026-02-06
✨ 新功能
- 暗夜模式(Dark Mode):智能主题切换,根据时间自动切换深色 / 浅色;手动设置仅当天有效,次日恢复智能切换。
- 优化部分日志打印的国际化(i18n)支持。
🎨 体验优化
- 侧边栏布局优化,增强暗色模式下选中项的视觉对比度,Admin 页面支持暗黑模式。
🐛 问题修复
- 修复 Windows 环境下反斜杠路径导致的解析问题。
- 修复页面刷新后主题图标不更新的问题。
v1.4.0
发布日期:2026-02-05
✨ 新功能
- Markdown 图片相对路径支持:支持
./images/、../images/、/images/以及直接引用等多种写法。 - 支持
PNG、JPG/JPEG、GIF、WEBP、SVG、ICO等格式。
🛠️ 改进
- 项目结构模块化重构:服务器代码迁移到
src/目录(routes/、config/、utils/分层)。 - 多语言日志全面覆盖,统一使用
t()翻译函数。 - 文章不存在时自动跳转首页。
v1.3.0
发布日期:2026-02-05
🐛 问题修复
- 修复图片等资源的相对路径解析问题。
v1.2.0
发布日期:2026-02-04
🌍 完整国际化支持
- 修复
LANG=en环境变量,控制台输出完整支持中英文切换。 - 新增德语、西班牙语、法语、日语、韩语、俄语 6 种语言的 README 文档。
/stats统计页面根据环境变量自动切换语言。
📊 高级数据分析仪表板
- 新增回访用户、用户留存率、平均访问深度等关键指标。
- 新增设备类型分布、访问来源分析、访问深度分类、一周访问分布等可视化图表。
🖼️ 本地图片支持
- 新增
images文件夹图片渲染能力,配图更方便。
多语言支持由贡献者 @sayunchuan 提供。
v1.1.0
发布日期:2025-12-26
- 维护性更新与细节优化。
v1.0.1
发布日期:2025-12-24
🐛 问题修复
- 修复文件与文件夹选中状态冲突的问题。
v1.0.0
发布日期:2025-12-24
首个正式版本,奠定 PowerWiki 的核心能力:
- 自动同步:从 Git 仓库自动拉取并更新文档。
- 代码高亮:支持多种编程语言语法高亮。
- 响应式设计:完美适配各种设备屏幕。
- 自动目录:自动生成文章目录,支持点击跳转。
- 飞书风格:简约现代的界面设计。
- PDF 支持:高清渲染 PDF 文件。
- 访问统计:自动统计文章查看量。
- 轻量级:无需数据库,纯文件系统存储。
相关链接
- GitHub Releases - 完整发布说明
- GitHub 仓库
- 关于 PowerWiki
- 用户指南