版本历史

本页记录 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 项全部通过。
  • 本地实测:基础示例 可正常滚动(scrollY 0 → 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 添加官网截图,统一项目字标。

详细说明见 性能与缓存 和 Release。

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 文件。
  • 访问统计:自动统计文章查看量。
  • 轻量级:无需数据库,纯文件系统存储。

相关链接