release: v0.3.0 — web/agent/quantum wave + docs
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 <cursoragent@cursor.com>
This commit is contained in:
1 parent
4c37e79dae
commit
601e920188
10 files changed
+252
-15
No files matched your search
@@ -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`**.
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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).
|
||||
|
||||
|
||||
Generated
+1
-1
@@ -1018,7 +1018,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad"
|
||||
|
||||
[[package]]
|
||||
name = "marqdo"
|
||||
version = "0.2.0"
|
||||
version = "0.3.0"
|
||||
dependencies = [
|
||||
"anyhow",
|
||||
"assert_cmd",
|
||||
|
||||
+1
-1
@@ -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"
|
||||
|
||||
@@ -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)
|
||||
---
|
||||
|
||||
## 命名
|
||||
|
||||
@@ -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` 黑白极简 + 静态文档** |
|
||||
|
||||
@@ -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 同层)
|
||||
@@ -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 可在表格 + 类方法作者面上完整实现。**
|
||||
|
||||
---
|
||||
|
||||
+2
-2
@@ -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=`类型`**
|
||||
|
||||
Reference in new issue
Block a user