Repository navigation
v1.6.0
✨ 新功能
- 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 标题或标题行包含越界数字实体(如
�)时不再抛错导致文章 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