主题是经典 PHP 模板，不依赖 Node 运行时，也不需要前端构建。常规浏览用到的样式与脚本全部随主题本地存放（含灯箱与页面切换库），不依赖 CDN；只有可选的 AI 语义搜索会在开启后按需加载推理运行时。

建议开启伪静态，并把 PHP 的 ZipArchive 打开（没有也能用，主题自带纯 PHP 的 ZIP 兜底）。

后台 → 外观 → 主题 → 添加主题 → 上传主题，选择打包好的 zip 后点「现在安装」。部署包必须是 deflate 压缩的标准 zip，Windows 资源管理器或 tar -a 生成的未压缩包会被部分主机 WAF 拦下。

安装完成后点「启用」。别把文件直接解压覆盖到正在使用的主题目录，容易留下旧文件。

设置 → 固定链接，选「自定义结构」填 /%post_id%/，保存两次让重写规则真正刷新。

写成 /%post_id%.html 会让文章页判断、翻篇与登录共用路径一并失效；评论区的 /{文章ID}/talk 也依赖这一步。

主题会自动建好 /login/、文章归档、关于、联系、友情链接、区块展厅、画展与本页，按 slug 自动匹配模板，正文可在后台编辑。

唯一需要手动新建的是 /user/ 用户中心：后台 → 页面 → 新建页面，slug 填 user 发布即可。

演示内容是一批示例文章与图片，用来检验卡片、幻灯片、图集与评论区。导入走后台 cookie + REST nonce，不需要额外建应用密码。

正式站点建议导入后逐篇替换，别把示例文字留在首页。

升级时上传同名主题 zip 覆盖即可，设置存在数据库里不会丢。开发者改完源文件后要重新生成压缩资源，再打包上传，否则前台可能继续用旧的压缩副本。

要改 PHP 模板或样式，请建子主题覆盖，别直接改父主题——下次升级会被覆盖掉。

编辑器里插入「提示框」区块，或直接写简码：

[tip type="info" title="补充说明"]内容[/tip]

type 可选 info / warning / success / danger，靠图标形状与左边线粗细区分，保持黑白。

[fold title="展开看看" open="1"]内容[/fold]，open="1" 表示默认展开。使用原生 details/summary，禁用 JavaScript 时依旧可点。

[code lang="php"]echo "Bang";[/code]。语言留空会按开头特征自动嗅探；右上角按钮走 Clipboard API，失败时退回选中复制。

图集区块选「主图 + 缩略条」或「拼贴宫格」；也可以写 [wall]，每行一个图片地址。正文里连续图片会自动并成宫格，中间空一行则是单张大图。

画展页面模板会把整页正文按这个规则排版，点任意图片进入灯箱。

金句卡是主题里唯一允许渐变的组件；链接卡的外链统一走站内中转确认页并在新标签打开；元信息条适合写时间、地点、天气、设备。

到 区块展厅 可以一次看全七组示例并直接复制写法。

新写文章推荐用编辑器区块，所见即所得；从别处迁移文章、或粘贴纯文本时，用简码最省事。两种写法最后都经过同样的转义与过滤，不会出现两套样式。

命令与文章即时搜索合一：切深浅色、打开归档、跳到用户中心，或直接输入关键词找文章。手机上从侧栏搜索框进入。

在命令面板里打开开关后，用量化小模型在本地把文章标题与摘要转成向量，按余弦相似度排序。向量缓存在浏览器 localStorage，模型权重优先读同源的 uploads/pk-hf-cache/，不占用服务器算力。

站内链接由页面切换库接管，配共享元素转场。回源慢时顶部有细加载条，超时会退回整页跳转，不会出现「地址变了页面不动」的死状态。hover 与首屏可见卡片会自动预取。

左滑到下一篇、右滑到上一篇，方向键同向。只位移头图与正文，避免生成新的固定定位包含块；地址栏用 replaceState 同步，不额外压历史栈。

点悬浮条「评论」时地址栏会变成 /29/talk，关闭回落到文章地址；直接访问或分享这个地址会渲染文章并自动拉开评论抽屉。canonical 仍指向文章本体，避免重复收录。

点图片会从缩略图原位放大浮起，背景是半透明磨砂层，正文依然看得见；左右键或滑动切换，滚轮 / 双击缩放，ESC 或点空白处关闭。

用的是随主题自带的 PhotoSwipe（本地 UMD，MIT），不需要任何外部 CDN。

/login/ 整页、页面右下常驻弹窗、/user/ 未登录态，用的是同一套表单。打开弹窗时地址栏同步成 /login/，关闭写回来源地址，不压历史栈。

拖到底换一张一次性票据，服务端再验一次：终点位置、采样密度、耗时与轨迹单调性都会检查。注册表单的滑块常驻；评论表单默认收起，点「发表评论」才展开，拖完自动续上这次提交。

在用户中心绑定设备后可用指纹 / 面容登录。挑战以十六进制写进 transient，避免二进制在序列化时损坏；信任设备最多保留 5 台。

点任意评论的「回复」会亮出「正在回复 @某人」，提交时带上 comment_parent；成功后服务端回整棵树，前端一次替换，不会把回复错塞到列表开头。

登录后可点赞文章；首页订阅卡收集邮箱，按 IP 限流，后台能看列表并导出 CSV。

内容变了才会重新弹。点「确认」把内容 hash 记下来；× / ESC / 点遮罩只关本次会话。

常规 / SEO / 高级三个 tab 共用同一个表单，切换只是隐藏字段，保存不会丢值。页面完全自绘，不套 WordPress 的 form-table。

宽屏首页顶部是自动播放的幻灯片，下方是无缝滚动的公告栏；内容不足一屏时脚本会补齐，避免滚到末端露白。公告内容可在后台一行一条配置，留空取最新文章标题。

正文底部输出标题、作者、首发链接与协议。后台可开关、选协议（CC BY-NC-SA / CC BY / 保留所有权利 / 不写）并补一段自己的说明。

首次打开会静默检查全站样式、交互脚本与页面切换库是否真的就绪；缺了才弹一张自包含提示卡，点「刷新重试」重新拉取资源，不会再让你下载文件。

所有新特性都包在 @supports 与 prefers-reduced-motion 里，基础态本身就是完成态；老浏览器或开了「减少动态效果」会自动退化成静态展示。

换页时地址栏会先更新，再等新页面内容。顶部细加载条显示进度；超过超时时间会直接退回整页跳转，不会一直卡住。hover 与首屏预取能把这段等待压到几乎为零。

正常态是半透明磨砂背景，能看到后面的文字。若变成整块纯色，说明本地灯箱脚本没加载成功，主题会退回原生 dialog；刷新一次多半就恢复，仍不行请告诉站长。

默认单行紧凑态，点一下变多行并显示「完善信息 / 发表评论」；提交成功自动收回。评论抽屉不再自动聚焦输入框，否则一打开就把紧凑态撑开了。

票据 10 分钟有效、最多用 5 次，提交失败会被解锁重新展开。连续失败太多次会按 IP 限流，等一会儿再试。

菜单名是「Bang 设置」，是独立顶级菜单，不在「外观」子菜单里。

WordPress 的重写规则要再次保存才会 flush。改完 /%post_id%/ 保存两次，再打开 /{文章ID}/talk 验证。