- 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。
3.8 KiB
Executable File
3.8 KiB
Executable File
官方扩展:ext/web 实现路线图
| 状态 | W0–W7 + P3 完结(审计/RBAC/相册/ETag/外键已落地) |
| 日期 | 2026-08-28 |
| 锁定设计 | design/ext-web.md |
| 相关 | ext-cli.md · ext-abi.md · ext-llm.md |
| 安装 | marqdo ext add web(web / 网页) |
本文只跟踪实现阶段。类模型、赋值绑定、后台、.env、异步边界、ABI 名等以设计文为准。
1. 目标回顾(一句)
表格完成动态站:页面表拼组件、组件表绑库与样式、样式表定外观;热路径进 ABI 插件;可选 S3 / Redis。人写目标见设计 §0.1 与 examples/man-write-site/。
2. 落地阶段
| 阶段 | 内容 | 状态 |
|---|---|---|
| W0 | CATALOG + L1 + web_listen Hello |
done |
| W1 | env 端口;page 四栏;nav 表;static |
done |
| W2 | SQLite define/migrate/all |
done |
| W3 | 三列绑定;变量名即表名;/admin CRUD+日志+布局 |
done |
| W3s | 安全硬化:argon2 密码哈希、CSRF、SQLite 会话持久化、CSPRNG、登录限速 | done |
| W3.5 | 人写面首版:web.assemble + `表`.`字段` + examples/man-write-site |
done(编排袋仍可再瘦) |
| W4 | Postgres;Redis / S3 驱动(见 ext-web-drivers.md) | done |
| W4c | 内容标配:SEO / Markdown / RSS / 分页 UI(见 web-net-capabilities.md) | done |
| W5 | 上传与媒体:multipart 接收 + 落盘 + 下载(见 web-net-capabilities.md A5) | done |
| W6 | 迁移 + FTS5 搜索;草稿/评论用既有 where/表;WS 广播 + 访问日志 | done |
| W7 | Cache-Control / 404·500 / 重定向 / sitemap·robots / init 唯一·索引 / HTTPS 反代说明 | done |
| P3 | 审计时间戳 / 外键 / RBAC / 相册 / ETag | done |
定制波次(规划中)
自研后台 / 主题 / 响应式踩坑见 ext-web-customization-limits.md;解法索引 ext-web-customization/。
| 波次 | 内容 | 状态 |
|---|---|---|
| C0 | admin 关则不占路径;admin_prefix / 登录回跳可配 |
done |
| C1 | gate 匹配与未登录策略一致;段边界默认 admin gate | done |
| C2 | shell_css + layout 松绑 |
done |
| C3 | 样式 strict / 脚本 defer·version | done |
| C4 | 条件导航 when/media(layout 见 C2) | done |
验收金样:tests/ext/web-smoke.mq.md、tests/ext/web-security-smoke.mq.md、tests/ext/web-drivers-smoke.mq.md、tests/ext/web-upload-smoke.mq.md、tests/ext/web-db-w6-smoke.mq.md、tests/ext/web-w7-finish-smoke.mq.md、tests/ext/web-p3-smoke.mq.md、ext_cli_add_web。
3. 已收敛的原开放点
| 原疑问 | 锁定结论(见设计文) |
|---|---|
| listen 阻塞 vs 后台任务 | # main 内 listen 同步阻塞;插件内部异步 |
| handler 形态 | 不主推手写 REST;表 href + bind + 自动后台 |
marqdo web 子命令 |
scaffold 经 web.scaffold;marqdo web new 可后续补 |
| Windows + SQLite | 路径用 DATABASE_URL |
4. 与其它文档
| 文档 | 关系 |
|---|---|
| design/ext-web.md | 真理 |
| user-site.md | 静态站互补 |
| ext-quantum.md | 同属官方 ext + ABI + ext add |
| ext-hosting.md · ext-hosting-gaps.md | W/C 之后:同域 SSE 中继、HTTP→##(不重开本表 W0–W7) |