- 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。
2.7 KiB
Executable File
2.7 KiB
Executable File
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」行,落地后再改状态。
产品原则(解法共同约束)
.mq.md仍是真相源 — 能声明的不进隐藏默认;新开关写在app/page/listen参数表。- 内置 admin 是可选产品,不是不可替换的内核路由命名空间。
- 默认行为保持兼容 — 现有 tutorial / 示例零改动仍能跑;新站显式打开定制。
- 禁止为单站需求永久硬编码第二套旁路(如永远推荐
/desk+ JS fetch 登录)。