同源权限
iframe 不包含 allow-same-origin,页面运行在不透明源里,
读不到 Wiki 的 Cookie、localStorage、IndexedDB,也不能调用同源 API。
ABOUT · SANDBOX BOUNDARIES
它是一个普通的多文件网站:页面、CSS、JavaScript 和数据文件各司其职。 特殊之处在于它跑在 PowerWiki 的沙箱里 —— 页面可以交互,但拿不到 Wiki 的身份和数据。
沙箱不是禁用 JavaScript,而是去掉“和 Wiki 同源”这件事。
iframe 不包含 allow-same-origin,页面运行在不透明源里,
读不到 Wiki 的 Cookie、localStorage、IndexedDB,也不能调用同源 API。
本演示的主题切换用 try / catch 包住 Web Storage:
在沙箱里写入会被拒绝,页面继续工作,只是跳转后不再记住选择。
页面内部的相对跳转始终可用;要跳出沙箱或打开新窗口,
需要 allow-popups 等显式能力,并且顶层跳转要由用户点击触发。
允许脚本、表单、弹窗、下载和用户触发的顶层导航,但不允许同源。
sandbox="allow-scripts allow-forms allow-popups allow-modals
allow-downloads allow-top-navigation-by-user-activation"
/full/<仓库路径> 用响应头
Content-Security-Policy: sandbox … 施加同样的限制,
并附带 nosniff、no-store 和同站资源策略。
沙箱读不到 Wiki 的 localStorage 和 data-theme,
所以父页面会通过 postMessage 把界面偏好传进来;站点切换主题时会再次广播。
// 父页面 → 沙箱 iframe
{ type: 'powerwiki:context', version: 1, theme: 'dark', lang: 'zh-CN' }
// 沙箱也可以先索取一次,减少首屏闪烁
parent.postMessage({ type: 'powerwiki:request-context' }, '*');
没有构建步骤,全部是仓库里的静态文件。
index.html、guide/index.html、modules.html、about.html
assets/site.css 负责样式与深浅色变量,assets/site.js 负责主题、导航高亮与数据渲染。
static/data.js 提供站点页面与模块清单,首页和模块页都从这里读取。