Close GAP-01–05 with ext/web streaming reverse proxy and HTTP→## invoke, transitive object method lookup, corpus_search plugin ensure, and agent MCP server stdio so downstream apps can drop Python side relays. Co-authored-by: Cursor <cursoragent@cursor.com>
73 lines
3.8 KiB
Markdown
73 lines
3.8 KiB
Markdown
# 官方扩展:`ext/web` 实现路线图
|
||
|
||
| | |
|
||
|---|---|
|
||
| 状态 | **W0–W7 + P3 完结**(审计/RBAC/相册/ETag/外键已落地) |
|
||
| 日期 | 2026-08-28 |
|
||
| **锁定设计** | [design/ext-web.md](../design/ext-web.md) |
|
||
| 相关 | [ext-cli.md](../design/ext-cli.md) · [ext-abi.md](../design/ext-abi.md) · [ext-llm.md](../design/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](../design/ext-web-drivers.md)) | **done** |
|
||
| **W4c** | 内容标配:SEO / Markdown / RSS / 分页 UI(见 [web-net-capabilities.md](../design/web-net-capabilities.md)) | **done** |
|
||
| **W5** | 上传与媒体:multipart 接收 + 落盘 + 下载(见 [web-net-capabilities.md](../design/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](../research/ext-web-customization-limits.md);解法索引 [ext-web-customization/](../design/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](../design/ext-web.md) | **真理** |
|
||
| [user-site.md](../design/user-site.md) | 静态站互补 |
|
||
| [ext-quantum.md](ext-quantum.md) | 同属官方 ext + ABI + `ext add` |
|
||
| [ext-hosting.md](ext-hosting.md) · [ext-hosting-gaps.md](../research/ext-hosting-gaps.md) | **W/C 之后**:同域 SSE 中继、HTTP→`##`(不重开本表 W0–W7) |
|