From 1e5e6f4891f978ad26ae3d5778e212afde6fc7c0 Mon Sep 17 00:00:00 2001 From: cflmy Date: Sat, 29 Aug 2026 10:35:13 +0800 Subject: [PATCH] =?UTF-8?q?release:=20v0.3.0=20=E2=80=94=20web/agent/quant?= =?UTF-8?q?um=20wave=20+=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Ship W0–W7+P3, agent A1–A4, quantum Q7/Q8; fix web prose parse; document ASGI/proxy deploy; refresh README how-to for latest Marqdo. Co-authored-by: Cursor --- .github/workflows/release.yml | 8 +- .gitignore | 1 + CHANGELOG.md | 31 ++++ Cargo.lock | 2 +- Cargo.toml | 2 +- README.md | 52 +++++-- doc/README.md | 1 + doc/design/web-asgi-servers-and-marqdo.md | 164 ++++++++++++++++++++++ doc/design/web-net-capabilities.md | 2 + ext/web/网页.mq.md | 4 +- 10 files changed, 252 insertions(+), 15 deletions(-) create mode 100644 doc/design/web-asgi-servers-and-marqdo.md diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 210ab02..fee591c 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -92,11 +92,13 @@ jobs: body: | ## Marqdo ${{ github.ref_name }} - ### Highlights — extension libraries - - Official **`ext/`** packages: `llm`, `agent`, `web`, `quantum` (not stdlib) + ### Highlights — v0.3 + - **`ext/web`**: W0–W7 + P3 complete (sessions, cache, upload, WebSocket, style assembly); see marqdo-blog + - **`ext/quantum`**: Q7 linalg + Q8 themed SVG viz + - **`ext/agent`**: A1–A4 (OKF reuse, events, context budget, RAG/MCP fixtures) - Install: `marqdo ext list` / `marqdo ext add llm|agent|web|quantum` - Native plugins: `cargo build --release -p marqdo_plugin_*` then `ext add` - - Details: [CHANGELOG](https://github.com/cflmy/marqdo/blob/main/CHANGELOG.md) · [ext-cli.md](https://github.com/cflmy/marqdo/blob/main/doc/design/ext-cli.md) + - Details: [CHANGELOG](https://github.com/cflmy/marqdo/blob/main/CHANGELOG.md) · [README](https://github.com/cflmy/marqdo/blob/main/README.md) Also: embedded stdlib, writeback/subtask, Variables modal in `view`, VSIX from branch **`vscode-extension`**. diff --git a/.gitignore b/.gitignore index 09ae86c..9a1f8e6 100644 --- a/.gitignore +++ b/.gitignore @@ -51,6 +51,7 @@ plugins/*/tmp/ /examples/web-site-zh/data/ /examples/web-net-site/data/ /examples/web-net-site-zh/data/ +/examples/marqdo-blog/data/ # Quantum draw/SVG runtime outputs (sources & gold .mq.md stay tracked) /tests/ext/quantum-*.svg diff --git a/CHANGELOG.md b/CHANGELOG.md index c2af2eb..db2ed06 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,8 +2,36 @@ ## Unreleased +## v0.3.0 — 2026-08-29 + +### Highlights + +本版把 **`ext/web` 网络能力(W0–W7 + P3)**、**`ext/quantum` Q7/Q8**、**`ext/agent` A1–A4** 一并收口到正式发布;并修了网页扩展叙述行误解析、补充 ASGI/生产部署说明与 agent 下一波(B0–B5)缺口调研。 + +**如何拿到本版** + +```bash +# 从源码(推荐跟 main / 本 tag) +git clone https://github.com/cflmy/marqdo.git && cd marqdo +git checkout v0.3.0 +cargo build --release +./target/release/marqdo version + +# 或从 GitHub Releases 下载 Windows 包 / 源码 zip(见 Release 资产) +marqdo version --check +``` + +**扩展(非 stdlib)** + +```bash +cargo build --release -p marqdo_plugin_web -p marqdo_plugin_agent -p marqdo_plugin_quantum +marqdo ext add web && marqdo ext add agent && marqdo ext add quantum +# 中文 id:网页 / 智能体 / 量子 / 大模型 +``` + ### Added - **调研:`ext/agent` A0–A4 之后缺口** ([agent-framework-gaps-after-a4.md](doc/research/agent-framework-gaps-after-a4.md)):产品化示例、评测 harness、真 MCP、plan resume/HITL、飞轮指标与建议分期 B0–B5;挂到 [ext-agent-optimize.md](doc/roadmap/ext-agent-optimize.md) 与 [doc/README.md](doc/README.md)。 +- **生产部署调研(ASGI)** ([web-asgi-servers-and-marqdo.md](doc/design/web-asgi-servers-and-marqdo.md)):不能挂 Daphne/Uvicorn;路径为反向代理 → 嵌入式 `listen`(axum)。 - **`ext/agent` A4(RAG/MCP 证据工具)**: `corpus_search` 本地语料关键词检索;`mcp_list_tools` / `mcp_call` 读 JSON fixture;返回 `authority=workbook`。金样 `agent-tools-rag-a4`。 - **`ext/agent` A3(上下文预算)**: `source_brief` / 加深版 `skill_brief`;`build_step_context` 默认截断并提示 `READ:source|skill`;`step` 支持最多 `max_reads` 次加深;父 `READ:skill`。金样 `agent-context-budget-a3`。 - **`ext/agent` A2(过程可见)**: `plan` 过程事件默认写入返回 map 的 `events`(SSE 仍仅 `stream=True`);OKF 命中记 `REUSE` decision;view plan 卡渲染过程时间线。对齐 [agent-streaming.md](doc/roadmap/agent-streaming.md)。 @@ -14,6 +42,9 @@ - **`ext/quantum` Q7(高阶线性代数 + 高级可视化)**: 密度矩阵 / 部分迹 / Hermitian 谱 / Schmidt / Pauli 期望 / 纯度;SVG:hinton、city、density、paulivec、qsphere、multibloch。全部经 `plugins/quantum` ABI。设计 [ext-quantum-q7.md](doc/design/ext-quantum-q7.md);金样 `quantum-linalg-smoke`、`quantum-viz-advanced-smoke`;示例 [quantum-entanglement](examples/quantum-entanglement/)。 - **`ext/quantum` Q8a/Q8b(可视化美学)**: `draw theme=dark|light|bw`(默认 dark);标签芯片 + gutter 消除线穿字;门族分色;probs/bloch 共用令牌;view 对 `data-theme` 换图框。设计 [ext-quantum-viz-style.md](doc/design/ext-quantum-viz-style.md)。改插件后须 `marqdo ext add quantum` 再开 view。 +### Fixed +- **`ext/web` / `网页.mq.md`**:叙述行勿以反引号开头,避免被解析为语句(`examples/marqdo-blog` 可正常 `listen`)。 + ### Changed - **Frontmatter import syntax**: `import bind:target` / `导入 bind:target` (file `.mq.md` or short name `lib.member`). Removed legacy `> path.mq.md` / `> use` imports. See [module-namespace.md](doc/design/module-namespace.md). diff --git a/Cargo.lock b/Cargo.lock index de52b65..dfdaea9 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1018,7 +1018,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad" [[package]] name = "marqdo" -version = "0.2.0" +version = "0.3.0" dependencies = [ "anyhow", "assert_cmd", diff --git a/Cargo.toml b/Cargo.toml index 1ddba67..1ca62de 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo" -version = "0.2.0" +version = "0.3.0" edition = "2021" license = "Apache-2.0" description = "Marqdo — Markdown markers as an interpreted programming language" diff --git a/README.md b/README.md index 2981111..75dd5b6 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,7 @@ marqdo catalog public -o .marqdo --- -## 现状(v0.2.0) +## 现状(v0.3.0) - 映射与解释器:Phase I 树遍历 + 字节码后端可用;金样例在 `tests/` - **对象**:`#` = 类型/构造,`##`+ = 函数/方法;见 [objects.md](doc/design/objects.md) @@ -108,26 +108,62 @@ marqdo catalog public -o .marqdo - **`marqdo catalog` / `sync`**:OKF 风格 YAML + 模块概念页 - **`marqdo version --check`**:与 GitHub 最新 release 对比 - 标准库:**内置于二进制**(v0.1.2+);磁盘 `lib/` 或 `MARQDO_LIB` 可覆盖。模块含文本、文件、系统、时间、JSON、网络、数学、外联、插件、**自写回**、**子任务** -- **官方扩展库 `ext/`**(本版重点,**非** stdlib):`llm` · `agent` · **`web`(W0–W7 + P3 完结,见 [marqdo-blog](examples/marqdo-blog/))** · **`quantum`(Q0–Q7 + Q8a/b 主题 SVG,见 [quantum-entanglement](examples/quantum-entanglement/))**。安装:`marqdo ext list` / `add …` / `remove`(见 [ext-cli.md](doc/design/ext-cli.md);默认 `~/.marqdo/ext` 或 `MARQDO_EXT`)。原生插件先 `cargo build -p marqdo_plugin_*` 再 `ext add`。设计:[ext-llm](doc/design/ext-llm.md) · [ext-agent](doc/design/ext-agent.md) · [ext-web](doc/design/ext-web.md) · [web-net-capabilities](doc/design/web-net-capabilities.md) · [ext-quantum](doc/design/ext-quantum.md) · [ext-quantum-viz-style](doc/design/ext-quantum-viz-style.md) +- **官方扩展库 `ext/`**(**非** stdlib,本版收口): + - **`web`**:W0–W7 + P3 完结(会话 / 缓存 / 上传 / WebSocket / 样式装配等);示例 [marqdo-blog](examples/marqdo-blog/);生产路径见 [web-asgi-servers-and-marqdo.md](doc/design/web-asgi-servers-and-marqdo.md)(反向代理 → 嵌入式 `listen`,非 Daphne/Uvicorn) + - **`quantum`**:Q0–Q7 + Q8a/b 主题 SVG;示例 [quantum-entanglement](examples/quantum-entanglement/) + - **`agent`**:A1–A4(OKF 复用、过程事件、上下文预算、RAG/MCP fixture);下一波缺口 [agent-framework-gaps-after-a4.md](doc/research/agent-framework-gaps-after-a4.md) + - **`llm`**:OpenAI 兼容对话 + - 安装:`marqdo ext list` / `add …` / `remove`([ext-cli.md](doc/design/ext-cli.md);默认 `~/.marqdo/ext`)。原生插件先 `cargo build -p marqdo_plugin_*` 再 `ext add` - **原生插件 ABI**:[`include/marqdo_abi.h`](include/marqdo_abi.h) · [ext-abi.md](doc/design/ext-abi.md);`plugins/{demo,agent,web,quantum}` - **用户静态站**:`public/` → `view output` → CI 发布 [gh-pages](https://cflmy.github.io/marqdo/) - **VS Code 扩展**:分支 **`vscode-extension`**(`main` 不跟踪源码;见 [vscode-extension-commit.md](doc/design/vscode-extension-commit.md));Release 附带 `.vsix` - 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) +### 如何使用最新 Marqdo(v0.3.0) + +```bash +# 1) 源码安装(跟 tag 或 main) +git clone https://github.com/cflmy/marqdo.git && cd marqdo +git checkout v0.3.0 # 或留在 main +cargo build --release +export PATH="$PWD/target/release:$PATH" +marqdo version +marqdo version --check + +# 2) 跑解释器 / 文档站 / catalog +marqdo run tests/structure/hello.mq.md +marqdo run tests/structure/hello.mq.md --backend bytecode +marqdo view public --no-open +marqdo debug public --no-open +marqdo catalog public -o .marqdo + +# 3) 安装官方扩展(需先编原生插件) +cargo build --release -p marqdo_plugin_web -p marqdo_plugin_agent -p marqdo_plugin_quantum +marqdo ext add web # 或:网页 +marqdo ext add agent # 或:智能体 +marqdo ext add quantum # 或:量子 +marqdo ext add llm # 或:大模型 + +# 4) 动态站示例(扩展装好后) +marqdo run examples/marqdo-blog/index.mq.md +# 浏览器打开终端打印的 listen 地址 + +# 5) Windows:也可从 GitHub Releases 下载 exe / zip / vsix +# https://github.com/cflmy/marqdo/releases/tag/v0.3.0 +``` + +开发期也可用 `cargo run -- …` 代替已安装的 `marqdo`: + ```bash cargo run -- run tests/structure/hello.mq.md -cargo run -- run tests/structure/hello.mq.md --backend bytecode cargo run -- view public --no-open -cargo run -- debug public --no-open -cargo run -- catalog public -o .marqdo cargo run -- view output public -o public powershell -File ./scripts/build-public.ps1 ``` -**发布包(GitHub Releases)**:单独二进制 **已内置**官方 `lib/`(`import …:lib/…` 可直接导入)。仍提供带 `lib/` 的 zip 便于覆盖或离线分发。**扩展库**用 `marqdo ext add llm|agent|web|quantum` 安装(见 [CHANGELOG](CHANGELOG.md) 与 [ext-cli.md](doc/design/ext-cli.md));原生 `.so`/`.dll` 需本地编译或从带 `native/` 的安装目录解析。`marqdo version --check` 可查看是否有新版本。 - -文档:用户站 [public/](public/) · 设计 [doc/](doc/) · OKF / catalog [catalog-cli.md](doc/design/catalog-cli.md) · 调试 [view-debug.md](doc/design/view-debug.md) +**发布包(GitHub Releases)**:单独二进制 **已内置**官方 `lib/`(`import …:lib/…` 可直接导入)。仍提供带 `lib/` 的 zip 便于覆盖或离线分发。**扩展库**用 `marqdo ext add …` 安装(见 [CHANGELOG](CHANGELOG.md) 与 [ext-cli.md](doc/design/ext-cli.md));原生 `.so`/`.dll` 需本地编译或从带 `native/` 的安装目录解析。 +文档:用户站 [public/](public/) · 设计 [doc/](doc/) · OKF / catalog [catalog-cli.md](doc/design/catalog-cli.md) · 调试 [view-debug.md](doc/design/view-debug.md) · 变更 [CHANGELOG.md](CHANGELOG.md) --- ## 命名 diff --git a/doc/README.md b/doc/README.md index 86f3ba4..f6a1ac4 100644 --- a/doc/README.md +++ b/doc/README.md @@ -40,6 +40,7 @@ | [design/ext-agent-plan.md](design/ext-agent-plan.md) | **`## 多步` / `## plan` 锁定设计**(工作簿文件、subtask 执行、修订循环、`step` 默认写回) | | [design/ext-cli.md](design/ext-cli.md) | **`marqdo ext list/add/remove` 官方扩展安装器** | | [design/ext-web.md](design/ext-web.md) | **官方扩展 `ext/web`(页面/库表/绑定/后台;ABI + CLI;设计锁定)** | +| [design/web-asgi-servers-and-marqdo.md](design/web-asgi-servers-and-marqdo.md) | **Daphne/Uvicorn 等 vs Marqdo**:不能直接托管;反代 + axum `listen` | | [design/call-arguments.md](design/call-arguments.md) | **调用:具名 + 位置实参** | | [design/examples-and-tests.md](design/examples-and-tests.md) | **tests/ 金样例目录布局** | | [design/view.md](design/view.md) | **`marqdo view` / `view output` 黑白极简 + 静态文档** | diff --git a/doc/design/web-asgi-servers-and-marqdo.md b/doc/design/web-asgi-servers-and-marqdo.md new file mode 100644 index 0000000..cd9df93 --- /dev/null +++ b/doc/design/web-asgi-servers-and-marqdo.md @@ -0,0 +1,164 @@ +# 调研:Marqdo `ext/web` 能否对接 Daphne / 业界应用服务器 + +| | | +|---|---| +| 状态 | **调研笔记** | +| 日期 | 2026-08-29 | +| 范围 | Daphne、Uvicorn、Gunicorn、Hypercorn 等 ASGI/WSGI 服务器;对照 Marqdo `plugins/web`(axum) | +| 相关 | [web-net-capabilities.md](web-net-capabilities.md) · [ext-web.md](ext-web.md) · [ext-web-net.md](ext-web-net.md) | +| 触发 | `app.listen` 已能本地起站;问「能否像业界一样用 Daphne 等服务器」 | + +--- + +## 0. 一句话结论 + +**不能把 Marqdo 站点「塞进」Daphne / Uvicorn / Gunicorn 当 Python ASGI/WSGI 应用跑。** + +Marqdo 的 HTTP 服务**已经是**应用服务器:`plugins/web` 内嵌 **axum + tokio**,由 `` `app`.listen `` / `` `应用`.监听 `` 绑定端口。这在 Rust 生态里的角色,约等于 Python 里的 **Uvicorn/Daphne**,而不是 Django/Flask「应用代码」。 + +业界生产部署要支持的,通常不是「换成 Daphne」,而是: + +1. **反代 + TLS**(Nginx / Caddy / Traefik)→ 已文档锁定; +2. **进程监督**(systemd / Docker / k8s)→ 运维层,与框架无关; +3. (可选)多进程 / 多副本水平扩展 → 需会话外置等,见下文。 + +--- + +## 1. Daphne「等」服务器是什么 + +| 名称 | 协议面 | 典型搭档 | 角色 | +|------|--------|----------|------| +| **Daphne** | ASGI | Django Channels | Python 异步/WebSocket 参考服务器 | +| **Uvicorn** | ASGI | FastAPI、Django ASGI | 高性能 ASGI(常作 Gunicorn worker) | +| **Gunicorn** | 主要为 WSGI | Django/Flask | 进程管理 + worker;**不能**直接跑 ASGI/WebSocket | +| **Hypercorn** | ASGI | 需 HTTP/2/3 时 | ASGI 另一实现 | +| **Granian** | ASGI(Rust 实现) | Python 应用 | 用 Rust 加速 Python ASGI | + +共同点:它们都假设应用暴露 **Python ASGI/WSGI callable**(`application` / `asgi.py`)。服务器负责 accept、协议解析、生命周期;**业务在 Python 进程里**。 + +2026 常见生产组合示例: + +```text +Internet → Nginx/Caddy (TLS) → Uvicorn/Daphne (ASGI) → Django/FastAPI 应用 +``` + +--- + +## 2. Marqdo 今天怎么起服务 + +```text +.mq.md(ext/web 作者面) + → ABI:web_listen / 路由装配 + → plugins/web:组装 axum::Router + → tokio TcpListener + axum::serve ← 这里就是「应用服务器」 +``` + +关键事实(实现): + +- `plugins/web/src/http.rs`:`TcpListener::bind` + `axum::serve`; +- 依赖:`axum` 0.8、`tokio` multi-thread;含 WS、multipart、中间件层; +- HTTPS:设计上 **进程内 TLS 不作为默认**;生产用反代终止 TLS + `cookie_secure`(见 [web-net-capabilities.md](web-net-capabilities.md) W7)。 + +因此: + +| 问法 | 答案 | +|------|------| +| 能否 `daphne marqdo_app:app`? | **否** — 没有 Python ASGI 入口 | +| 能否 `gunicorn -k uvicorn.workers…`? | **否** — 同上 | +| 能否用 Nginx 反代到 `127.0.0.1:18085`? | **是** — 推荐生产路径 | +| Marqdo 有没有「业界级」HTTP 栈? | **有** — axum/hyper 即 Rust 侧业界默认之一 | + +--- + +## 3. 分层对照(避免角色错位) + +| 层级 | Python 典型 | Marqdo 对应 | +|------|-------------|-------------| +| 应用 / 路由 / 模板 / DB | Django / FastAPI | `ext/web` + `plugins/web` 装配 | +| 应用服务器(accept / HTTP / WS) | Daphne / Uvicorn | **内嵌 axum::serve** | +| 反代 / TLS / 静态边缘 | Nginx / Caddy | **外置反代**(文档已写) | +| 进程管理 | systemd / Gunicorn master | systemd / Docker / k8s | + +把 Daphne 接到 Marqdo,相当于要求「用 Python ASGI 服务器去托管 Rust axum 应用」——协议面不匹配,没有现成插槽。 + +--- + +## 4. 若目标是「生产级部署」,已支持什么 / 还差什么 + +### 4.1 已支持(或已锁定) + +| 能力 | 状态 | +|------|------| +| 本地 / 内网 `listen` | ✅ | +| HTTP + WebSocket | ✅(axum) | +| 反代终止 HTTPS | ✅ 文档路径 | +| 访问日志、限速、CORS、安全头等 | ✅ W1–W7 | +| 会话可 SQLite 持久化 | ✅(单机多启需注意) | + +### 4.2 与「Daphne 集群」对等时仍需注意 + +| 主题 | 说明 | +|------|------| +| **多进程副本** | 每进程各自 `listen` 时,内存会话 / 内存 cache / 内存 WS hub **不共享**;多副本需 sticky session,或会话/缓存外置(Redis 等,驱动面已有雏形) | +| **优雅重启 / 零停机** | axum 可接 signal;未做成一等作者 API(运维可用 systemd + 反代) | +| **HTTP/2 末端** | 多由反代提供;进程内 HTTP/1.1 足够常见场景 | +| **与 Python 生态混部** | 可同机 Nginx 分流:`/api/py` → Uvicorn,`/` → Marqdo;**不是**共用一个 Daphne | + +### 4.3 不建议的路线 + +1. **实现完整 ASGI 适配器让 Daphne 加载 Marqdo** + 成本高、收益低:等于在 Python 进程里再调一层 FFI/子进程,丢掉 axum 直驱优势。 +2. **把 axum 拆掉、改写为「纯应用、外挂任意服务器」** + Rust 没有统一 ASGI;外挂只能是自定义协议或「只当 CGI」,与当前架构相反。 + +### 4.4 可选增强(若要对标「可换服务器」的体验) + +| 方向 | 含义 | 优先级建议 | +|------|------|------------| +| **A. 部署文档 + 示例 Compose** | Nginx/Caddy + `marqdo run` + systemd | **高**(满足绝大多数「业界部署」诉求) | +| **B. listen 运维旋钮** | workers 说明、graceful shutdown、Unix socket | 中 | +| **C. 多副本清单** | 会话/WS/cache 外置检查表 | 中 | +| **D. 反向:Marqdo 作边缘、反代到既有 ASGI** | 已可用 HTTP 客户端/路由外置服务 | 按需 | +| **E. ASGI bridge** | 明确 **非目标** | 不做 | + +--- + +## 5. 推荐生产拓扑(等价于「Nginx + Daphne」) + +```text +客户端 + │ HTTPS + ▼ +Nginx / Caddy / Traefik ← TLS、压缩、限流、静态可旁路 + │ HTTP proxy_pass + ▼ +marqdo run index.mq.md ← 内部 axum::serve(角色 ≈ Uvicorn/Daphne) + (host=127.0.0.1 port=18085,cookie_secure=True) +``` + +要点: + +- Marqdo **只绑回环**;对外只暴露反代。 +- WebSocket:反代需 `Upgrade` / `Connection` 正确转发(与反代 Daphne 相同注意点)。 +- 多机:共享 DB(或 Postgres 驱动)、共享会话存储;WS 广播跨机需外置 pub/sub(当前 hub 为进程内)。 + +--- + +## 6. 结论与建议 + +| 问题 | 结论 | +|------|------| +| 能支持 Daphne 吗? | **不能直接托管**;协议是 Python ASGI,Marqdo 是 Rust axum 自托管。 | +| 能支持「业界服务器」吗? | **能**:用 **Nginx/Caddy 等业界反代** 挂在 `listen` 前面;应用服务器层已由 axum 承担。 | +| 缺的是换 Daphne,还是缺部署体验? | 主要是 **部署文档 / Compose / 多副本约定**,不是再嵌一套 ASGI 运行时。 | + +**建议下一刀(若产品化):** 写一份 `examples/` 或 `doc/design` 下的「反代部署」最小样例(Caddyfile / nginx.conf + `cookie_secure`),而不是调研 ASGI bridge。 + +--- + +## 7. 参考 + +- 本仓:[web-net-capabilities.md](web-net-capabilities.md)(HTTPS 反代锁定)· [ext-web.md](ext-web.md) +- Daphne:Django Channels 参考 ASGI 服务器 +- Uvicorn / Gunicorn worker:当代 Python ASGI 生产主流组合 +- axum:Tokio 生态 HTTP 应用框架(Rust 侧与 Uvicorn 同层) diff --git a/doc/design/web-net-capabilities.md b/doc/design/web-net-capabilities.md index 2124d1c..64f77a8 100644 --- a/doc/design/web-net-capabilities.md +++ b/doc/design/web-net-capabilities.md @@ -233,6 +233,8 @@ **后续可选(非阻塞)**:标签页内置模板(D6)、cookie 签名、会话条数硬上限、应用层反垃圾、进程内 TLS(仍建议反代)。 +**部署对照(Daphne / Uvicorn / 反代):** 见 [web-asgi-servers-and-marqdo.md](web-asgi-servers-and-marqdo.md) — Marqdo **不能**被 Daphne 托管;生产等价路径是 **反代 → 内嵌 axum `listen`**。 + **一句话:`ext/web` 已是可上线级别的 Marqdo 动态站扩展;博客/CMS/中小型 API 可在表格 + 类方法作者面上完整实现。** --- diff --git a/ext/web/网页.mq.md b/ext/web/网页.mq.md index 67f10ae..cf6adba 100644 --- a/ext/web/网页.mq.md +++ b/ext/web/网页.mq.md @@ -602,7 +602,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c + `值` + `过期`=None -`过期` 为秒;省略则不过期。 +过期时间为秒;省略则不过期。 *url = self[^url]* **> web_cache_set url=`url` key=`键` value=`值` ttl=`过期`** @@ -639,7 +639,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c + `路径`=None + `类型`="application/octet-stream" -`正文`(文本)与 `路径`(本地文件)二选一。 +正文(文本)与路径(本地文件)二选一。 *url = self[^url]* **> web_storage_put url=`url` key=`键` body=`正文` path=`路径` content_type=`类型`**