Files
marqdo/doc/design/ext-web-customization
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00
..

ext/web 定制修复:解决文档索引

状态 C0–C4 done
日期 2026-09-04
问题盘点 ../../research/ext-web-customization-limits.md
相关 ../ext-web.md · ../ext-web-net.md · ../../roadmap/ext-web.md

对应研究文 §1–§8,每项一份解决文档:目标 → 作者 API → 插件改动点 → 兼容策略 → 验收。

实现时优先 不破坏现有金样(tests/ext/web-*、examples/web-*);新能力用显式 opt-in 参数打开。


文档一览

# 主题 文档 建议优先级
1 路由与 /admin 前缀可让出 01-routes-and-admin-prefix.md P0
2 SHELL_CSS 可关 / 可层 02-shell-css.md P1
3 鉴权门禁可配置且行为一致 03-auth-gates.md P0
4 样式表作者体验 04-stylesheet-authoring.md P2
5 页面壳与插槽松绑 05-page-shell-slots.md P1
6 后台 CRUD / 表单边界 06-admin-crud-forms.md P3
7 静态资源与脚本生命周期 07-assets-script-lifecycle.md P2
8 扩展与部署耦合 08-ext-deploy-coupling.md P3

波次建议(实现用)

波次 内容 依赖
C0 可配置 admin_prefix;admin=False 时不挂内置路由;login_redirect / logout_redirect —
C1 gate:统一未登录策略;精确/前缀匹配;登录页自动放行;默认 gate 不再误伤 /admin-* C0
C2 shell_css=off|minimal|full;主题在壳前或隔离层;可选 layout=bare —
C3 样式:校验警告 / strict;page.css raw;脚本 defer/async/version + asset_version done
C4 壳:layout 预设(C2);条件导航 when / media done

路线图入口可在 ext-web.md 增补「定制波次 C0–C4」行,落地后再改状态。


产品原则(解法共同约束)

  1. .mq.md 仍是真相源 — 能声明的不进隐藏默认;新开关写在 app / page / listen 参数表。
  2. 内置 admin 是可选产品,不是不可替换的内核路由命名空间。
  3. 默认行为保持兼容 — 现有 tutorial / 示例零改动仍能跑;新站显式打开定制。
  4. 禁止为单站需求永久硬编码第二套旁路(如永远推荐 /desk + JS fetch 登录)。