Skip to content

v1.6.0

Choose a tag to compare

@steven-ld steven-ld released this 09 Nov 12:29
· 8 commits to master since this release
5ed902d

✨ 新功能

  • HTML 文章:仓库里的 .html / .htm 与 Markdown 一起收录为文章,共用目录、复制、原始视图、分享短链、SEO 标签和阅读数。声明 <meta name="powerwiki-render" content="sandbox"> 的页面会嵌入一个不带 allow-same-origin 的沙箱 iframe,脚本、Canvas、WebGL 与样式都能运行,但拿不到 Wiki 的 Cookie、localStorage 或同源接口。
  • /full/ 完整页面:原始 HTML 通过 /full/<仓库路径> 独立提供,支持目录索引与省略后缀的路径,只放行 HTML 与精选静态资源(图片、CSS/JS、字体、音视频、WASM);目录穿越、隐藏路径、符号链接和超过 50 MB 的文件都会被拒绝。JSON/YAML/TXT 等数据文件只在 static/ 目录下按文章资源提供。
  • 沙箱主题同步:父页面通过 postMessage 发送 { type: 'powerwiki:context', theme, lang },在 iframe 加载完成以及站点切换主题 / 语言时广播;沙箱页面也可以发送 powerwiki:request-context 主动索取一次。消息只包含界面偏好,不含 Cookie、统计数据或仓库内容。
  • 全屏入口:所有 HTML 文章在工具条显示主色「全屏」按钮,一键在新窗口打开 /full/ 完整页面;Markdown 与 PDF 自动隐藏,iframe 下方的文字链接保留作为无 JavaScript 时的兜底。
  • 稳定文章地址与 SEO:frontmatter 支持 slug 与 aliases,移动或重命名文件后可保持文章地址与分享短链不变;浏览器与爬虫共用 canonical、Open Graph、Twitter Card 和 JSON-LD,RSS 与 sitemap 使用同一地址;不存在的文章返回真实 404 并标记 noindex。
  • 上一篇 / 下一篇:按 Git 创建时间排序,忽略修改时间,同时间按路径稳定排序。
  • 自定义 404:通过 pages.notFound 指定仓库内页面;未配置或文件不存在时使用内置响应式 404。
  • 首页访问量与文章阅读数分开统计(homeViews),不再混入文章计数。

🐛 问题修复

  • 沙箱文档处于不透明源,浏览器会把它的子资源请求视为跨源。/full/ 静态资源改用 Cross-Origin-Resource-Policy: cross-origin 与 Access-Control-Allow-Origin: *,修复 CSS/JS 被拦截(ERR_BLOCKED_BY_RESPONSE.NotSameSite)。
  • 修复缓存目录名包含点(如 .git-cache)时 /api/image、/api/pdf、仓库静态资源与自定义 404 全部返回 403 的问题。
  • HTML 文章保留根绝对地址(/api/image/...、/post/...),不再重复加前缀。
  • HTML 标题或标题行包含越界数字实体(如 &#x110000;)时不再抛错导致文章 503。
  • 目录索引地址重定向到带斜杠的地址,页面内相对资源可以正确解析。

🔒 安全

  • 仓库资源统一经过安全路径解析:拒绝目录穿越、隐藏路径段、符号链接逃逸与不允许的扩展名;扫描时跳过隐藏文件和符号链接。
  • /full/ 使用 Content-Security-Policy: sandbox、nosniff、no-store 与 frame-ancestors 'self';直接打开的 SVG 文件禁用脚本。
  • 沙箱 iframe 不含 allow-same-origin,页面无法读取 Wiki 的身份、存储或同源接口。

📚 文档与演示

  • 中英文 README 补充 HTML 文章、/full/ 路由、主题同步与全屏入口说明。
  • 演示仓库新增「HTML 页面演示」:安全清洗示例、交互式落地页、数据看板、WebGL 与富媒体、文档站,以及多页面站点(目录索引、无扩展名路径、相对跳转、共享 CSS/JS、数据模块)。
  • 多页面站点与文档站演示接入 powerwiki:context,在沙箱内跟随站点明暗主题。

✅ 验证

  • 21 项测试通过,覆盖 HTML 文章清洗、沙箱渲染、/full/ 静态资源与安全响应头、路径校验、404、稳定地址与 SEO。
  • 浏览器验证沙箱页面的明暗主题同步、独立 /full/ 页面跟随系统主题、资源加载与全屏按钮。

升级说明

  • 无新增依赖,可直接从 v1.5.2 升级。
  • html.enabled、html.sanitize 默认开启;完整页面沙箱模式需要页面显式声明 meta。
  • pages.notFound 为可选配置;不配置时使用内置 404。

Full Changelog: v1.5.2...v1.6.0