feat(markup): finish v0.3 stock migration and green gold

Migrate remaining .mq.md (tests/ext/public/examples), stop elevating local assigns to params, inject form_target in Go libweb, and skip live LLM gold without a real key.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
cflmyandCursor committed 2026-09-13 23:43:44 +08:00
1 parent bfb10d172b
commit b5c07385e9
324 files changed
+4572 -4339

No files matched your search

+17 -17
View File
@@ -2,7 +2,7 @@
| | |
|---|---|
| 状态 | **Active(v0.3 默认 · 无双模式;markup-v03 金样绿)** |
| 状态 | **Active(v0.3 sole · 存量已迁移 · gold 绿)** |
| 日期 | 2026-09-13 |
| 设计 | [markdown-mapping-v0.3.md](../design/markdown-mapping-v0.3.md) |
| ADR | [0005-prose-unified-markup.md](../adr/0005-prose-unified-markup.md) |
@@ -39,27 +39,27 @@
### M2 — 形参推断
- [ ] `InferParams`:首次 `` `名` `` = 必选;`` `名`=默认 `` = 可选
- [ ] 体赋值 `n=n+1` 不误判为默认
- [ ] 与显式 `+` 合并规则 + 警告
- [ ] 方法 `self`/`自` 排除
- [ ] 金样例:默认实参、位置/具名调用、粗体内调用
- [x] `InferParams`:首次 `` `名` `` = 必选;`` `名`=默认 `` = 可选
- [x] 体赋值 `n=n+1` 不误判为默认
- [x] 与显式 `+` 合并规则 + 警告
- [x] 方法 `self`/`自` 排除
- [x] 金样例:默认实参、位置/具名调用、粗体内调用
**出门:** 推断签名与 `+` 兼容套件绿。
### M3 — 调用面与消歧
- [ ] `**callee args**` ≡ `> callee args`
- [ ] else 臂 `N. *` 与返回斜体消歧
- [ ] 一行多 `**…**` 按序执行
- [ ] 金样例:`---` / `*None*` / 整行 `**` / 兼容 `****`;叙述死绑定不升参
- [x] `**callee args**` ≡ `> callee args`
- [x] else 臂 `N. *` 与返回斜体消歧
- [x] 一行多 `**…**` 按序执行
- [x] 金样例:`---` / `*None*` / 整行 `**` / 兼容 `****`;叙述死绑定不升参
- [ ] 诊断:必选缺失、未知 callee;空返回残缺粗体;死变量仅可选 lint
**出门:** `tests/markup-v03/*` 覆盖设计 §9 示例。
### M4 — 双后端与工具
- [ ] 字节码发射跟随新 Stmt 源
- [x] 字节码发射跟随新 Stmt 源
- [ ] `view` / Variables:显示推断形参与 prose Decl
- [ ] (可选)`marqdo migrate markup-v03` 机械改写提示/工具
@@ -67,14 +67,14 @@
### M5 — 默认切换与存量迁移
- [ ] 默认 `MarkupEdition::V03`
- [ ] 迁移 `tests/**`、`lib/**`、`ext/**`、`public/**`、教程
- [ ] 更新 `.cursor/skills/marqdo/SKILL.md` 硬规则
- [ ] 修订 [markdown-mapping.md](../design/markdown-mapping.md) 为 v0.3 正式正文(或声明由 v0.3 文件接任)
- [ ] ADR 0005 → **Accepted**
- [x] 默认 `MarkupEdition::V03`
- [x] 迁移 `tests/**`、`lib/**`、`ext/**`、`public/**`、教程
- [x] 更新 `.cursor/skills/marqdo/SKILL.md` 硬规则
- [x] 修订 [markdown-mapping.md](../design/markdown-mapping.md) 为 v0.3 正式正文(或声明由 v0.3 文件接任)
- [x] ADR 0005 → **Accepted**
- [ ] CHANGELOG / 发版说明(破坏性:标记对调)
**出门:** 全量 gold 默认绿;v0.2 仅 `--markup v0.2` 保留一个过渡版本周期。
**出门:** 全量 gold 默认绿(live LLM 无钥跳过);无 v0.2 双模式。
---
+14 -14
View File
@@ -13,7 +13,7 @@ import sys:lib/sys.mq.md
OKF flywheel offline: promote → plan same goal → `cache=hit` (no live LLM required for the hit path).
*p = > plugin.native_path name="agent"*
**p = > plugin.native_path name="agent"**
1. `p`
> plugin.load path=`p`
2. *
@@ -21,14 +21,14 @@ OKF flywheel offline: promote → plan same goal → `cache=hit` (no live LLM re
> sys.exit code=1
> sys.env_set name="OPENAI_API_KEY" value="offline-okf-dummy"
*model = > llm.llm*
*tools = > json.parse text=[]*
*助手 = > agent.agent model=`model` tools=`tools` standing="offline okf flywheel"*
**model = > llm.llm**
**tools = > json.parse text=[]**
**助手 = > agent.agent model=`model` tools=`tools` standing="offline okf flywheel"**
*kb = ".marqdo/agent-kb-example-flywheel"*
*wb = ".marqdo/agent-runs/example-pong-solid.mq.md"*
*goal = "Reply with exactly the word pong and nothing else."*
*body = "---\ntitle: okf pong\n---\n\n# main\n\n*msg = \"pong\"*\n\n**msg**\n"*
**kb = ".marqdo/agent-kb-example-flywheel"**
**wb = ".marqdo/agent-runs/example-pong-solid.mq.md"**
**goal = "Reply with exactly the word pong and nothing else."**
**body = "---\ntitle: okf pong\n---\n\n# main\n\n*msg = \"pong\"*\n\n**msg**\n"**
1. > fs.exists path=`kb`
> fs.remove path=`kb`
@@ -37,20 +37,20 @@ OKF flywheel offline: promote → plan same goal → `cache=hit` (no live LLM re
> fs.write_text path=`wb` text=`body`
*prom = > agent_kb_promote kb_dir=`kb` goal=`goal` workbook=`wb`*
*okp = > json.get value=`prom` key="promoted"*
**prom = > agent_kb_promote kb_dir=`kb` goal=`goal` workbook=`wb`**
**okp = > json.get value=`prom` key="promoted"**
1. `okp`
> print text=promoted
2. *
> print text=promote-fail
> sys.exit code=1
*out = > `助手`.plan goal=`goal` max_rounds=2 writeback=False kb_dir=`kb` explore_n=0 promote=False*
*cache = > json.get value=`out` key="cache"*
**out = > `助手`.plan goal=`goal` max_rounds=2 writeback=False kb_dir=`kb` explore_n=0 promote=False**
**cache = > json.get value=`out` key="cache"**
> print text=`cache`
*match = > json.get value=`out` key="match"*
**match = > json.get value=`out` key="match"**
> print text=`match`
*val = > json.get value=`out` key="result"*
**val = > json.get value=`out` key="result"**
> print text=`val`
1. `cache` == "hit"
+20 -20
View File
@@ -15,12 +15,12 @@ import time:lib/time.mq.md
Return today's date string (tool visible in source to the model).
*u = > time.now_unix*
**> time.format unix=`u` pattern="%Y-%m-%d"**
**u = > time.now_unix**
*> time.format unix=`u` pattern="%Y-%m-%d"*
# main
*p = > plugin.native_path name="agent"*
**p = > plugin.native_path name="agent"**
1. `p`
> plugin.load path=`p`
2. *
@@ -35,53 +35,53 @@ Return today's date string (tool visible in source to the model).
|------|
| 获取时间 |
*model = > llm.llm*
*助手 = > agent.agent model=`model` tools=`工具表` standing="You are a Marqdo agent. Prefer CALL:获取时间 when the task needs today's date."*
**model = > llm.llm**
**助手 = > agent.agent model=`model` tools=`工具表` standing="You are a Marqdo agent. Prefer CALL:获取时间 when the task needs today's date."**
Assert constitution markers in the assembled prompt (call site before how-to-act):
*ctx = > agent.build_step_context agent=`助手` task="What is today's date? Use the tool in this runbook."*
**ctx = > agent.build_step_context agent=`助手` task="What is today's date? Use the tool in this runbook."**
*parts = > split value=`ctx` sep="--- call site ---"*
*n = > len value=`parts`*
**parts = > split value=`ctx` sep="--- call site ---"**
**n = > len value=`parts`**
1. `n` > 1
> print text=call-site-ok
2. *
> print text=call-site-missing
> sys.exit code=1
*parts2 = > split value=`ctx` sep="--- source (.mq.md) ---"*
*n2 = > len value=`parts2`*
**parts2 = > split value=`ctx` sep="--- source (.mq.md) ---"**
**n2 = > len value=`parts2`**
1. `n2` > 1
> print text=source-ok
2. *
> print text=source-missing
> sys.exit code=1
*parts3 = > split value=`ctx` sep="获取时间"*
*n3 = > len value=`parts3`*
**parts3 = > split value=`ctx` sep="获取时间"**
**n3 = > len value=`parts3`**
1. `n3` > 1
> print text=tool-in-source-ok
2. *
> print text=tool-in-source-missing
> sys.exit code=1
*site = > agent_call_site*
*fn = > json.get value=`site` key="function"*
**site = > agent_call_site**
**fn = > json.get value=`site` key="function"**
> print text=`fn`
Optional live step — set env AGENT_LIVE=1 and put keys in repo-root `.env`:
*live = > sys.env_get name="AGENT_LIVE"*
*key = > sys.env_get name="OPENAI_API_KEY"*
**live = > sys.env_get name="AGENT_LIVE"**
**key = > sys.env_get name="OPENAI_API_KEY"**
1. `live` == "1"
1. `key`
*out = > `助手`.step task="请调用获取时间工具,然后只回复日期字符串。" writeback=False*
*status = > json.get value=`out` key="status"*
**out = > `助手`.step task="请调用获取时间工具,然后只回复日期字符串。" writeback=False**
**status = > json.get value=`out` key="status"**
> print text=`status`
*tool = > json.get value=`out` key="tool"*
**tool = > json.get value=`out` key="tool"**
> print text=`tool`
*result = > json.get value=`out` key="result"*
**result = > json.get value=`out` key="result"**
> print text=`result`
2. *
> print text=live-skipped-no-key
+1 -1
View File
@@ -35,7 +35,7 @@ description: 暗恋见君壳层 — head 资源表、导航 HTML、页脚 HTML
| script | "/static/js/feed_board.js" | 真 |
| script | "/static/js/index.js" | 真 |
**`头`**
*`头`*
## 导航HTML
+46 -46
View File
@@ -10,55 +10,55 @@ import text:lib/text.mq.md
给定帖子行记录列表,输出 `ul.home-posts-list` 标记(首页与列表页共用)。
*段 = None*
**段 = None**
- [帖](行)
*板 = 帖[^board]*
*题 = 帖[^title]*
*链 = 帖[^slug]*
*作 = 帖[^author]*
*评 = 帖[^comments_count]*
*时 = 帖[^created_at]*
**板 = 帖[^board]**
**题 = 帖[^title]**
**链 = 帖[^slug]**
**作 = 帖[^author]**
**评 = 帖[^comments_count]**
**时 = 帖[^created_at]**
1. not 作
*作 = "匿名"*
**作 = "匿名"**
2. *
1. not 评
*评 = 0*
**评 = 0**
2. *
1. not 时
*时 = ""*
**时 = ""**
2. *
*一项 = "<li><article class=\"home-post-card feed-post-card\"><a href=\"/post/" + 链 + "\" class=\"home-post-card-link feed-post-card-link\"><span class=\"home-post-board feed-post-board\">" + 板 + "</span><div class=\"home-post-body feed-post-body\"><h3 class=\"home-post-title feed-post-title\">" + 题 + "</h3><div class=\"home-post-meta feed-post-meta\"><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--user\" aria-hidden=\"true\"></span> " + 作 + "</span><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--comment\" aria-hidden=\"true\"></span> " + 评 + "</span><time>" + 时 + "</time></div></div><span class=\"home-post-arrow feed-post-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></span></a></article></li>"*
*段 = > table.append list=段 item=一项*
**一项 = "<li><article class=\"home-post-card feed-post-card\"><a href=\"/post/" + 链 + "\" class=\"home-post-card-link feed-post-card-link\"><span class=\"home-post-board feed-post-board\">" + 板 + "</span><div class=\"home-post-body feed-post-body\"><h3 class=\"home-post-title feed-post-title\">" + 题 + "</h3><div class=\"home-post-meta feed-post-meta\"><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--user\" aria-hidden=\"true\"></span> " + 作 + "</span><span class=\"home-post-meta-item feed-post-meta-item\"><span class=\"anlian-icon anlian-icon--comment\" aria-hidden=\"true\"></span> " + 评 + "</span><time>" + 时 + "</time></div></div><span class=\"home-post-arrow feed-post-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></span></a></article></li>"**
**段 = > table.append list=段 item=一项**
1. 段
*内 = > text.str_join xs=段 sep=""*
**"<ul class=\"home-posts-list feed-posts-list\">" + 内 + "</ul>"**
**内 = > text.str_join xs=段 sep=""**
*"<ul class=\"home-posts-list feed-posts-list\">" + 内 + "</ul>"*
2. *
**"<ul class=\"home-posts-list feed-posts-list\"><li class=\"home-posts-empty feed-empty\">暂无帖子,<a href=\"/post/public\">去发帖</a></li></ul>"**
*"<ul class=\"home-posts-list feed-posts-list\"><li class=\"home-posts-empty feed-empty\">暂无帖子,<a href=\"/post/public\">去发帖</a></li></ul>"*
## 新闻时间线HTML
+ `行`
给定新闻行记录列表,输出 `.news-timeline` 标记。
*段 = None*
**段 = None**
- [讯](行)
*题 = 讯[^title]*
*链 = 讯[^slug]*
*板 = 讯[^board]*
*时 = 讯[^created_at]*
**题 = 讯[^title]**
**链 = 讯[^slug]**
**板 = 讯[^board]**
**时 = 讯[^created_at]**
1. not 板
*板 = ""*
**板 = ""**
2. *
1. not 时
*时 = ""*
**时 = ""**
2. *
*一项 = "<li class=\"news-timeline-item\"><span class=\"news-timeline-node\" aria-hidden=\"true\"></span><article class=\"news-timeline-card\"><div class=\"news-timeline-meta\"><time class=\"news-timeline-date\">" + 时 + "</time><span class=\"news-timeline-board\">" + 板 + "</span></div><h3 class=\"news-timeline-title\"><a href=\"/news/" + 链 + "\" class=\"news-timeline-link\">" + 题 + "</a></h3></article></li>"*
*段 = > table.append list=段 item=一项*
**一项 = "<li class=\"news-timeline-item\"><span class=\"news-timeline-node\" aria-hidden=\"true\"></span><article class=\"news-timeline-card\"><div class=\"news-timeline-meta\"><time class=\"news-timeline-date\">" + 时 + "</time><span class=\"news-timeline-board\">" + 板 + "</span></div><h3 class=\"news-timeline-title\"><a href=\"/news/" + 链 + "\" class=\"news-timeline-link\">" + 题 + "</a></h3></article></li>"**
**段 = > table.append list=段 item=一项**
1. 段
*内 = > text.str_join xs=段 sep=""*
**"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right news-timeline-arrow-icon--right\"></span><span class=\"anlian-icon anlian-icon--chevron-down news-timeline-arrow-icon--down\"></span></span></div><ol class=\"news-timeline-items\">" + 内 + "</ol></div>"**
**内 = > text.str_join xs=段 sep=""**
*"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"><span class=\"anlian-icon anlian-icon--chevron-right news-timeline-arrow-icon--right\"></span><span class=\"anlian-icon anlian-icon--chevron-down news-timeline-arrow-icon--down\"></span></span></div><ol class=\"news-timeline-items\">" + 内 + "</ol></div>"*
2. *
**"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"></span></div><ol class=\"news-timeline-items\"><li class=\"news-timeline-item news-timeline-item-empty\"><article class=\"news-timeline-card\"><p class=\"news-timeline-empty\">暂无新闻</p></article></li></ol></div>"**
*"<div class=\"news-timeline\"><div class=\"news-timeline-rail\" aria-hidden=\"true\"><span class=\"news-timeline-line\"></span><span class=\"news-timeline-arrow\" aria-hidden=\"true\"></span></div><ol class=\"news-timeline-items\"><li class=\"news-timeline-item news-timeline-item-empty\"><article class=\"news-timeline-card\"><p class=\"news-timeline-empty\">暂无新闻</p></article></li></ol></div>"*
## 板块栏HTML
+ `板块`
@@ -68,30 +68,30 @@ import text:lib/text.mq.md
板块 Tab 栏。`前缀` 如 `/post/ten/`;`查询键` 为 `board_id` 或 `news_board_id`;`全部类` 为 Tab 共用 class(含 js hook)。
*数据属 = "data-board"*
*全标签 = "全部"*
**数据属 = "data-board"**
**全标签 = "全部"**
1. 查询键 == "news_board_id"
*数据属 = "data-news-board"*
*全标签 = "所有板块"*
**数据属 = "data-news-board"**
**全标签 = "所有板块"**
2. *
*段 = None*
*全链 = 前缀 + "?" + 查询键 + "=0"*
*全项 = "<a href=\"" + 全链 + "\" class=\"" + 全部类 + " active\" " + 数据属 + "=\"0\">" + 全标签 + "</a>"*
*段 = > table.append list=段 item=全项*
**段 = None**
**全链 = 前缀 + "?" + 查询键 + "=0"**
**全项 = "<a href=\"" + 全链 + "\" class=\"" + 全部类 + " active\" " + 数据属 + "=\"0\">" + 全标签 + "</a>"**
**段 = > table.append list=段 item=全项**
- [板](板块)
*名 = 板[^name]*
*号 = 板[^id]*
*链 = 前缀 + "?" + 查询键 + "=" + 号*
*项 = "<a href=\"" + 链 + "\" class=\"" + 全部类 + "\" " + 数据属 + "=\"" + 号 + "\">" + 名 + "</a>"*
*段 = > table.append list=段 item=项*
**名 = 板[^name]**
**号 = 板[^id]**
**链 = 前缀 + "?" + 查询键 + "=" + 号**
**项 = "<a href=\"" + 链 + "\" class=\"" + 全部类 + "\" " + 数据属 + "=\"" + 号 + "\">" + 名 + "</a>"**
**段 = > table.append list=段 item=项**
1. 查询键 == "news_board_id"
*更多 = "<a href=\"/news\" class=\"home-posts-tab home-posts-tab-more\">全部新闻</a>"*
*段 = > table.append list=段 item=更多*
**更多 = "<a href=\"/news\" class=\"home-posts-tab home-posts-tab-more\">全部新闻</a>"**
**段 = > table.append list=段 item=更多**
2. *
*内 = > text.str_join xs=段 sep=""*
*栏类 = "home-posts-board-bar"*
**内 = > text.str_join xs=段 sep=""**
**栏类 = "home-posts-board-bar"**
1. 查询键 == "news_board_id"
*栏类 = "home-posts-board-bar home-news-board-bar"*
**栏类 = "home-posts-board-bar home-news-board-bar"**
2. *
**"<div class=\"" + 栏类 + "\" data-feed-board><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-left\" aria-label=\"向左滚动\"><span class=\"anlian-icon anlian-icon--chevron-left\"></span></button><div class=\"home-posts-segment-outer\"><div class=\"home-posts-segment\"><div class=\"home-posts-spotlight\" aria-hidden=\"true\"></div><div class=\"home-posts-tabs-scroll\"><div class=\"home-posts-tabs\" role=\"tablist\">" + 内 + "</div></div></div></div><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-right\" aria-label=\"向右滚动\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></button></div>"**
*"<div class=\"" + 栏类 + "\" data-feed-board><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-left\" aria-label=\"向左滚动\"><span class=\"anlian-icon anlian-icon--chevron-left\"></span></button><div class=\"home-posts-segment-outer\"><div class=\"home-posts-segment\"><div class=\"home-posts-spotlight\" aria-hidden=\"true\"></div><div class=\"home-posts-tabs-scroll\"><div class=\"home-posts-tabs\" role=\"tablist\">" + 内 + "</div></div></div></div><button type=\"button\" class=\"home-posts-scroll home-posts-scroll-right\" aria-label=\"向右滚动\"><span class=\"anlian-icon anlian-icon--chevron-right\"></span></button></div>"*
+1 -1
View File
@@ -12,4 +12,4 @@
| 公聊 | /chat |
| sitemap | /sitemap.xml |
**`页脚`**
*`页脚`*
@@ -9,13 +9,13 @@ import feed:feed.mq.md
## 帖子十
+ `board_id`="0"
*store = > db.打开*
*行 = > store.查询 表="posts" 上限=10 排序="-created_at"*
**> feed.帖子列表HTML 行=`行`**
**store = > db.打开**
**行 = > store.查询 表="posts" 上限=10 排序="-created_at"**
*> feed.帖子列表HTML 行=`行`*
## 新闻五
+ `news_board_id`="0"
*store = > db.打开*
*行 = > store.查询 表="news" 上限=5 排序="-created_at"*
**> feed.新闻时间线HTML 行=`行`**
**store = > db.打开**
**行 = > store.查询 表="news" 上限=5 排序="-created_at"**
*> feed.新闻时间线HTML 行=`行`*
+27 -27
View File
@@ -12,36 +12,36 @@ import feed:feed.mq.md
查询 notices / boards / news_boards / news(5) / posts(10),拼装首页四段 HTML(不含导航与页脚)。调用方传入已打开的 store。
*公告行 = > 库.查询 表="notices" 上限=20 排序="-created_at"*
*板块行 = > 库.查询 表="boards" 上限=50*
*新闻板块行 = > 库.查询 表="news_boards" 上限=50*
*新闻行 = > 库.查询 表="news" 上限=5 排序="-created_at"*
*帖子行 = > 库.查询 表="posts" 上限=10 排序="-created_at"*
**公告行 = > 库.查询 表="notices" 上限=20 排序="-created_at"**
**板块行 = > 库.查询 表="boards" 上限=50**
**新闻板块行 = > 库.查询 表="news_boards" 上限=50**
**新闻行 = > 库.查询 表="news" 上限=5 排序="-created_at"**
**帖子行 = > 库.查询 表="posts" 上限=10 排序="-created_at"**
*公告段 = None*
**公告段 = None**
- [告](公告行)
*文 = 告[^content]*
*时 = 告[^created_at]*
*一项 = "<div class=\"notice-item\"><article class=\"notice-content\">" + 文 + "</article><p class=\"notice-create-time\">" + 时 + "</p></div>"*
*公告段 = > table.append list=公告段 item=一项*
**文 = 告[^content]**
**时 = 告[^created_at]**
**一项 = "<div class=\"notice-item\"><article class=\"notice-content\">" + 文 + "</article><p class=\"notice-create-time\">" + 时 + "</p></div>"**
**公告段 = > table.append list=公告段 item=一项**
1. 公告段
*公告内 = > text.str_join xs=公告段 sep=""*
**公告内 = > text.str_join xs=公告段 sep=""**
2. *
*公告内 = "<p class=\"text-muted\">暂无公告</p>"*
**公告内 = "<p class=\"text-muted\">暂无公告</p>"**
*新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news/five" 查询键="news_board_id" 全部类="home-posts-tab js-home-news-tab"*
*新闻板 = > feed.新闻时间线HTML 行=新闻行*
*帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post/ten" 查询键="board_id" 全部类="home-posts-tab js-home-post-tab"*
*帖子表 = > feed.帖子列表HTML 行=帖子行*
**新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news/five" 查询键="news_board_id" 全部类="home-posts-tab js-home-news-tab"**
**新闻板 = > feed.新闻时间线HTML 行=新闻行**
**帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post/ten" 查询键="board_id" 全部类="home-posts-tab js-home-post-tab"**
**帖子表 = > feed.帖子列表HTML 行=帖子行**
*段 = None*
*英雄 = "<section class=\"hero\"><div class=\"section-wrap\"><header><img src=\"/static/img/logo.svg\" alt=\"logo\" width=\"30\" height=\"30\" decoding=\"async\"><a class=\"head-logo\" href=\"/\"><span>暗恋</span>见君</a></header><div class=\"hero-content\"><div class=\"left\"><h1 class=\"main-text\">期待人们能够继续相信<span style=\"color:#ffd0d0\">爱情</span></h1><h2 class=\"sub-text\">粉玻璃社区 · 匿名与实名同在</h2></div><div class=\"right\"><img src=\"/static/img/bg-hero-640.webp\" alt=\"首页展示图\" width=\"640\" height=\"482\" fetchpriority=\"high\" decoding=\"async\"></div></div><div class=\"social\"></div></div></section>"*
*段 = > table.append list=段 item=英雄*
*公告区 = "<section class=\"notice\"><div class=\"section-wrap\"><h2 class=\"notice-title\">公告信息</h2><div class=\"notice-content-container\"><div class=\"notice-list\">" + 公告内 + "</div></div></div></section>"*
*段 = > table.append list=段 item=公告区*
*新闻区 = "<section class=\"news home-news\" id=\"news\"><div class=\"section-wrap home-news-stage\"><h2 class=\"news-title\">新闻动态</h2>" + 新闻栏 + "<div class=\"news-timeline-wrap\"><div id=\"homeNewsPanel\" class=\"news-timeline-panel home-panel-swap\">" + 新闻板 + "</div></div></div></section>"*
*段 = > table.append list=段 item=新闻区*
*更多 = "<a href=\"/post\" class=\"home-posts-more-link\">查看更多帖子</a>"*
*帖子区 = "<section class=\"home-posts\" id=\"post\"><div class=\"section-wrap home-posts-stage\"><h2 class=\"home-posts-title\">论坛交流</h2>" + 帖子栏 + "<div id=\"tenPostContainer\" class=\"home-posts-panel home-panel-swap\">" + 帖子表 + 更多 + "</div></div></section>"*
*段 = > table.append list=段 item=帖子区*
**> text.str_join xs=段 sep=""**
**段 = None**
**英雄 = "<section class=\"hero\"><div class=\"section-wrap\"><header><img src=\"/static/img/logo.svg\" alt=\"logo\" width=\"30\" height=\"30\" decoding=\"async\"><a class=\"head-logo\" href=\"/\"><span>暗恋</span>见君</a></header><div class=\"hero-content\"><div class=\"left\"><h1 class=\"main-text\">期待人们能够继续相信<span style=\"color:#ffd0d0\">爱情</span></h1><h2 class=\"sub-text\">粉玻璃社区 · 匿名与实名同在</h2></div><div class=\"right\"><img src=\"/static/img/bg-hero-640.webp\" alt=\"首页展示图\" width=\"640\" height=\"482\" fetchpriority=\"high\" decoding=\"async\"></div></div><div class=\"social\"></div></div></section>"**
**段 = > table.append list=段 item=英雄**
**公告区 = "<section class=\"notice\"><div class=\"section-wrap\"><h2 class=\"notice-title\">公告信息</h2><div class=\"notice-content-container\"><div class=\"notice-list\">" + 公告内 + "</div></div></div></section>"**
**段 = > table.append list=段 item=公告区**
**新闻区 = "<section class=\"news home-news\" id=\"news\"><div class=\"section-wrap home-news-stage\"><h2 class=\"news-title\">新闻动态</h2>" + 新闻栏 + "<div class=\"news-timeline-wrap\"><div id=\"homeNewsPanel\" class=\"news-timeline-panel home-panel-swap\">" + 新闻板 + "</div></div></div></section>"**
**段 = > table.append list=段 item=新闻区**
**更多 = "<a href=\"/post\" class=\"home-posts-more-link\">查看更多帖子</a>"**
**帖子区 = "<section class=\"home-posts\" id=\"post\"><div class=\"section-wrap home-posts-stage\"><h2 class=\"home-posts-title\">论坛交流</h2>" + 帖子栏 + "<div id=\"tenPostContainer\" class=\"home-posts-panel home-panel-swap\">" + 帖子表 + 更多 + "</div></div></section>"**
**段 = > table.append list=段 item=帖子区**
*> text.str_join xs=段 sep=""*
+1 -1
View File
@@ -15,4 +15,4 @@
| 登录 | /admin/login | | | guest |
| 后台 | /admin | | | auth |
**`导航`**
*`导航`*
+5 -5
View File
@@ -11,8 +11,8 @@ import chrome:chrome.mq.md
导航 + 正文 + 页脚;体类如 `page-home`。
*顶 = > chrome.导航HTML*
*底 = > chrome.页脚HTML*
*鉴权脚本 = "<script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"*
*鉴权样式 = "<style>.nav-when-auth{display:none}</style>"*
**鉴权样式 + 顶 + "<main class=\"anlian-main " + 体类 + "\">" + 正文 + "</main>" + 底 + 鉴权脚本**
**顶 = > chrome.导航HTML**
**底 = > chrome.页脚HTML**
**鉴权脚本 = "<script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"**
**鉴权样式 = "<style>.nav-when-auth{display:none}</style>"**
*鉴权样式 + 顶 + "<main class=\"anlian-main " + 体类 + "\">" + 正文 + "</main>" + 底 + 鉴权脚本*
+21 -21
View File
@@ -10,16 +10,16 @@ import seed:seed.mq.md
打开 sqlite:data/anlian-mq.db,初始化全部表;帖子建 FTS;若 posts 为空则写入种子。返回 store。
*store = > 网页.数据库 地址="sqlite:data/anlian-mq.db"*
*帖子字段 = > schema.posts*
*新闻字段 = > schema.news*
*板块字段 = > schema.boards*
*新闻板块字段 = > schema.news_boards*
*公告字段 = > schema.notices*
*评论字段 = > schema.comments*
*房间字段 = > schema.chat_rooms*
*专题字段 = > schema.topics*
*密钥字段 = > schema.api_keys*
**store = > 网页.数据库 地址="sqlite:data/anlian-mq.db"**
**帖子字段 = > schema.posts**
**新闻字段 = > schema.news**
**板块字段 = > schema.boards**
**新闻板块字段 = > schema.news_boards**
**公告字段 = > schema.notices**
**评论字段 = > schema.comments**
**房间字段 = > schema.chat_rooms**
**专题字段 = > schema.topics**
**密钥字段 = > schema.api_keys**
> `store`.初始化 名=posts 字段=`帖子字段`
> `store`.初始化 名=news 字段=`新闻字段`
> `store`.初始化 名=boards 字段=`板块字段`
@@ -40,18 +40,18 @@ import seed:seed.mq.md
> `store`.全文 表=posts 列=`全文列` 名=posts_fts
*已有 = > store.查询 表="posts" 上限=1*
**已有 = > store.查询 表="posts" 上限=1**
1. `已有`
**store**
*store*
2. *
*板块 = > seed.boards*
*新闻板块 = > seed.news_boards*
*帖子 = > seed.posts*
*新闻 = > seed.news*
*公告 = > seed.notices*
*评论 = > seed.comments*
*房间 = > seed.chat_rooms*
*专题 = > seed.topics*
**板块 = > seed.boards**
**新闻板块 = > seed.news_boards**
**帖子 = > seed.posts**
**新闻 = > seed.news**
**公告 = > seed.notices**
**评论 = > seed.comments**
**房间 = > seed.chat_rooms**
**专题 = > seed.topics**
> `store`.插入 表=boards 行=`板块`
> `store`.插入 表=news_boards 行=`新闻板块`
> `store`.插入 表=posts 行=`帖子`
@@ -60,4 +60,4 @@ import seed:seed.mq.md
> `store`.插入 表=comments 行=`评论`
> `store`.插入 表=chat_rooms 行=`房间`
> `store`.插入 表=topics 行=`专题`
**store**
*store*
+9 -9
View File
@@ -19,7 +19,7 @@
| created_at | timestamp | true | |
| updated_at | timestamp | true | |
**`posts`**
*`posts`*
## news
@@ -39,7 +39,7 @@
| created_at | timestamp | true | |
| updated_at | timestamp | true | |
**`news`**
*`news`*
## boards
@@ -53,7 +53,7 @@
| name | text | false | |
| slug | text | false | 是 |
**`boards`**
*`boards`*
## news_boards
@@ -67,7 +67,7 @@
| name | text | false | |
| slug | text | false | 是 |
**`news_boards`**
*`news_boards`*
## notices
@@ -81,7 +81,7 @@
| content | text | false |
| created_at | timestamp | true |
**`notices`**
*`notices`*
## comments
@@ -98,7 +98,7 @@
| author | text | true |
| created_at | timestamp | true |
**`comments`**
*`comments`*
## chat_rooms
@@ -113,7 +113,7 @@
| name | text | false | |
| summary | text | true | |
**`chat_rooms`**
*`chat_rooms`*
## topics
@@ -128,7 +128,7 @@
| title | text | false | |
| summary | text | true | |
**`topics`**
*`topics`*
## api_keys
@@ -143,4 +143,4 @@ API Key 校验用哈希表(应用层 scopes)。
| hash | text | false |
| scopes | text | true |
**`api_keys`**
*`api_keys`*
+8 -8
View File
@@ -10,7 +10,7 @@
| 2 | 开发 | develop |
| 3 | 聊天 | chat |
**`boards`**
*`boards`*
## news_boards
@@ -23,7 +23,7 @@
| 1 | 站务 | site |
| 2 | 技术 | tech |
**`news_boards`**
*`news_boards`*
## posts
@@ -37,7 +37,7 @@
| 2 | 如何用表格写论坛 | tables-for-forums | 导航、表单、种子数据都是可读表格。 | 若某功能逼你写一长串 json.set,请先审视 ext/web 是否缺命名方法。 | 开发 | 2 | 站务 | 0 | 18 |
| 3 | 公聊室已开放 | chat-open | WebSocket 广播房间。 | 打开 /chat,连上 /chat/ws,消息会扇出给同房间所有人。 | 聊天 | 3 | 站务 | 0 | 9 |
**`posts`**
*`posts`*
## news
@@ -50,7 +50,7 @@
| 1 | 站点迁往 Marqdo | migrate-to-marqdo | 原生层换 Go libweb,作者面保持表格。 | 暗恋见君的验收目标:登录、发帖、列表详情、聊天与站长工具都能用 .mq.md 写完。 | 站务 | 1 |
| 2 | 外接 PostgreSQL / Redis | pg-redis | 生产可用外接驱动。 | 本示例默认 sqlite:;把数据库地址换成 postgres:// 即可。 | 技术 | 2 |
**`news`**
*`news`*
## notices
@@ -64,7 +64,7 @@
| 2 | 站点正用 Marqdo 表格重写验收:导航、首页四段、列表与公聊对齐原站 DOM。 | 2026-09-08 14:30:00 |
| 3 | 发帖与评论请遵守社区规范;站务公告将在此置顶。 | 2026-09-10 09:00:00 |
**`notices`**
*`notices`*
## comments
@@ -77,7 +77,7 @@
| 1 | post | welcome | 终于等到用表格写论坛的一天。 | 路人甲 | 2026-09-10 11:00:00 |
| 2 | post | welcome | 期待人们能够继续相信爱情。 | 见君 | 2026-09-10 12:15:00 |
**`comments`**
*`comments`*
## chat_rooms
@@ -90,7 +90,7 @@
| 1 | lobby | 大厅 | 全站公共聊天室。 |
| 2 | casual | 闲聊 | 轻松闲聊,勿刷屏。 |
**`chat_rooms`**
*`chat_rooms`*
## topics
@@ -103,4 +103,4 @@
| 1 | glass-ui | 粉玻璃界面 | 首页与列表的毛玻璃视觉专题(占位)。 |
| 2 | tables-as-code | 表格即代码 | Marqdo GFM 表装配专题(占位)。 |
**`topics`**
*`topics`*
+105 -105
View File
@@ -87,124 +87,124 @@ import db:db/index.mq.md
|------|------|------|------|------|
| "public/img/favicon-32.png" | icon | "image/png" | 32x32 | "/favicon.ico" |
*store = > db.打开*
*头 = > chrome.头资源*
*顶 = > chrome.导航HTML*
*底 = > chrome.页脚HTML*
*鉴权补丁 = "<style>.nav-when-auth{display:none}</style><script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"*
**store = > db.打开**
**头 = > chrome.头资源**
**顶 = > chrome.导航HTML**
**底 = > chrome.页脚HTML**
**鉴权补丁 = "<style>.nav-when-auth{display:none}</style><script>(function(){var c=document.cookie.indexOf('marqdo_sid=')>=0;document.querySelectorAll('.nav-when-guest').forEach(function(el){el.style.display=c?'none':'';});document.querySelectorAll('.nav-when-auth').forEach(function(el){el.style.display=c?'':'none';});})();</script>"**
*主页体 = > home.装配 库=`store`*
*主页文 = > page.包装 正文=`主页体` 体类="page-home"*
*首页 = > 网页.页面 标题="暗恋见君论坛" 引言=`主页文` 壳样式="off" 布局="bare"*
*首页 = > 首页.头装配 表=`头`*
**主页体 = > home.装配 库=`store`**
**主页文 = > page.包装 正文=`主页体` 体类="page-home"**
**首页 = > 网页.页面 标题="暗恋见君论坛" 引言=`主页文` 壳样式="off" 布局="bare"**
**首页 = > 首页.头装配 表=`头`**
*板块行 = > store.查询 表="boards" 上限=50*
*帖子行 = > store.查询 表="posts" 上限=50 排序="-created_at"*
*帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post" 查询键="board_id" 全部类="feed-tab"*
*帖子表 = > feed.帖子列表HTML 行=帖子行*
*帖子列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">论坛交流</h1>" + 帖子栏 + 帖子表 + "<p style=\"margin-top:1rem\"><a href=\"/post/public\">发布帖子</a></p></div></section>"*
*帖子列表文 = > page.包装 正文=`帖子列表体` 体类="page-post-list"*
*帖子列表 = > 网页.页面 标题="帖子 · 暗恋见君" 引言=`帖子列表文` 壳样式="off" 布局="bare"*
*帖子列表 = > 帖子列表.头装配 表=`头`*
**板块行 = > store.查询 表="boards" 上限=50**
**帖子行 = > store.查询 表="posts" 上限=50 排序="-created_at"**
**帖子栏 = > feed.板块栏HTML 板块=板块行 前缀="/post" 查询键="board_id" 全部类="feed-tab"**
**帖子表 = > feed.帖子列表HTML 行=帖子行**
**帖子列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">论坛交流</h1>" + 帖子栏 + 帖子表 + "<p style=\"margin-top:1rem\"><a href=\"/post/public\">发布帖子</a></p></div></section>"**
**帖子列表文 = > page.包装 正文=`帖子列表体` 体类="page-post-list"**
**帖子列表 = > 网页.页面 标题="帖子 · 暗恋见君" 引言=`帖子列表文` 壳样式="off" 布局="bare"**
**帖子列表 = > 帖子列表.头装配 表=`头`**
*新闻板块行 = > store.查询 表="news_boards" 上限=50*
*新闻行 = > store.查询 表="news" 上限=50 排序="-created_at"*
*新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news" 查询键="news_board_id" 全部类="feed-tab"*
*新闻表 = > feed.新闻时间线HTML 行=新闻行*
*新闻列表体 = "<section class=\"feed-list-page home-news\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">新闻动态</h1>" + 新闻栏 + 新闻表 + "</div></section>"*
*新闻列表文 = > page.包装 正文=`新闻列表体` 体类="page-news-list"*
*新闻列表 = > 网页.页面 标题="新闻 · 暗恋见君" 引言=`新闻列表文` 壳样式="off" 布局="bare"*
*新闻列表 = > 新闻列表.头装配 表=`头`*
**新闻板块行 = > store.查询 表="news_boards" 上限=50**
**新闻行 = > store.查询 表="news" 上限=50 排序="-created_at"**
**新闻栏 = > feed.板块栏HTML 板块=新闻板块行 前缀="/news" 查询键="news_board_id" 全部类="feed-tab"**
**新闻表 = > feed.新闻时间线HTML 行=新闻行**
**新闻列表体 = "<section class=\"feed-list-page home-news\"><div class=\"section-wrap\"><h1 class=\"feed-list-title\">新闻动态</h1>" + 新闻栏 + 新闻表 + "</div></section>"**
**新闻列表文 = > page.包装 正文=`新闻列表体` 体类="page-news-list"**
**新闻列表 = > 网页.页面 标题="新闻 · 暗恋见君" 引言=`新闻列表文` 壳样式="off" 布局="bare"**
**新闻列表 = > 新闻列表.头装配 表=`头`**
*帖子页 = > 网页.页面 标题="帖子详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"*
*帖子页 = > 帖子页.头装配 表=`头`*
*帖子页 = > 帖子页.壳HTML 导航=`顶` 页脚=`底` 体类="page-post-detail"*
*帖子页 = > 帖子页.主体装配 主体=`帖子详情`*
*帖子页 = > 帖子页.查询条件 条件=`帖子条件`*
*帖子页 = > 帖子页.详情 详情=True*
**帖子页 = > 网页.页面 标题="帖子详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"**
**帖子页 = > 帖子页.头装配 表=`头`**
**帖子页 = > 帖子页.壳HTML 导航=`顶` 页脚=`底` 体类="page-post-detail"**
**帖子页 = > 帖子页.主体装配 主体=`帖子详情`**
**帖子页 = > 帖子页.查询条件 条件=`帖子条件`**
**帖子页 = > 帖子页.详情 详情=True**
*新闻页 = > 网页.页面 标题="新闻详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"*
*新闻页 = > 新闻页.头装配 表=`头`*
*新闻页 = > 新闻页.壳HTML 导航=`顶` 页脚=`底` 体类="page-news-detail"*
*新闻页 = > 新闻页.主体装配 主体=`新闻详情`*
*新闻页 = > 新闻页.查询条件 条件=`新闻条件`*
*新闻页 = > 新闻页.详情 详情=True*
**新闻页 = > 网页.页面 标题="新闻详情" 引言=`鉴权补丁` 壳样式="off" 布局="stacked"**
**新闻页 = > 新闻页.头装配 表=`头`**
**新闻页 = > 新闻页.壳HTML 导航=`顶` 页脚=`底` 体类="page-news-detail"**
**新闻页 = > 新闻页.主体装配 主体=`新闻详情`**
**新闻页 = > 新闻页.查询条件 条件=`新闻条件`**
**新闻页 = > 新闻页.详情 详情=True**
*发帖表 = > 网页.表单 表="posts" 动作="插入"*
*发帖表 = > 发帖表.字段 字段=`发帖字段`*
*发帖表 = > 发帖表.规则 规则=`发帖规则`*
*发帖引言 = > page.包装 正文="<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>发布帖子</h1><p>需登录(admin / anlian)</p></div></section>" 体类="page-post-public"*
*发帖页 = > 网页.页面 标题="发帖 · 暗恋见君" 引言=`发帖引言` 壳样式="off" 布局="bare"*
*发帖页 = > 发帖页.头装配 表=`头`*
*发帖页 = > 发帖页.表单装配 id="post" 表单=`发帖表`*
**发帖表 = > 网页.表单 表="posts" 动作="插入"**
**发帖表 = > 发帖表.字段 字段=`发帖字段`**
**发帖表 = > 发帖表.规则 规则=`发帖规则`**
**发帖引言 = > page.包装 正文="<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>发布帖子</h1><p>需登录(admin / anlian)</p></div></section>" 体类="page-post-public"**
**发帖页 = > 网页.页面 标题="发帖 · 暗恋见君" 引言=`发帖引言` 壳样式="off" 布局="bare"**
**发帖页 = > 发帖页.头装配 表=`头`**
**发帖页 = > 发帖页.表单装配 id="post" 表单=`发帖表`**
*房间行 = > store.查询 表="chat_rooms" 上限=50*
*房间段 = None*
**房间行 = > store.查询 表="chat_rooms" 上限=50**
**房间段 = None**
- [房](房间行)
*名 = 房[^name]*
*链 = 房[^slug]*
*摘 = 房[^summary]*
*项 = "<article class=\"chat-room-card\"><h3><a href=\"/chat/" + 链 + "\">" + 名 + "</a></h3><p>" + 摘 + "</p></article>"*
*房间段 = > table.append list=房间段 item=项*
*房间内 = > text.str_join xs=房间段 sep=""*
*聊天列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>聊天室</h1><div class=\"chat-room-grid\">" + 房间内 + "</div></div></section>"*
*聊天列表文 = > page.包装 正文=`聊天列表体` 体类="page-chat"*
*聊天列表 = > 网页.页面 标题="聊天 · 暗恋见君" 引言=`聊天列表文` 壳样式="off" 布局="bare"*
*聊天列表 = > 聊天列表.头装配 表=`头`*
**名 = 房[^name]**
**链 = 房[^slug]**
**摘 = 房[^summary]**
**项 = "<article class=\"chat-room-card\"><h3><a href=\"/chat/" + 链 + "\">" + 名 + "</a></h3><p>" + 摘 + "</p></article>"**
**房间段 = > table.append list=房间段 item=项**
**房间内 = > text.str_join xs=房间段 sep=""**
**聊天列表体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>聊天室</h1><div class=\"chat-room-grid\">" + 房间内 + "</div></div></section>"**
**聊天列表文 = > page.包装 正文=`聊天列表体` 体类="page-chat"**
**聊天列表 = > 网页.页面 标题="聊天 · 暗恋见君" 引言=`聊天列表文` 壳样式="off" 布局="bare"**
**聊天列表 = > 聊天列表.头装配 表=`头`**
*大厅体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>大厅</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"*
*大厅文 = > page.包装 正文=`大厅体` 体类="page-chat-room"*
*大厅页 = > 网页.页面 标题="大厅 · 暗恋见君" 引言=`大厅文` 壳样式="off" 布局="bare"*
*大厅页 = > 大厅页.头装配 表=`头`*
**大厅体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>大厅</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"**
**大厅文 = > page.包装 正文=`大厅体` 体类="page-chat-room"**
**大厅页 = > 网页.页面 标题="大厅 · 暗恋见君" 引言=`大厅文` 壳样式="off" 布局="bare"**
**大厅页 = > 大厅页.头装配 表=`头`**
*闲聊体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>闲聊</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"*
*闲聊文 = > page.包装 正文=`闲聊体` 体类="page-chat-room"*
*闲聊页 = > 网页.页面 标题="闲聊 · 暗恋见君" 引言=`闲聊文` 壳样式="off" 布局="bare"*
*闲聊页 = > 闲聊页.头装配 表=`头`*
**闲聊体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>闲聊</h1><div class=\"chat-box\"><div id=\"chat-log\" class=\"chat-log\"></div><p class=\"search-bar\"><input id=\"chat-msg\" placeholder=\"说点什么…\" aria-label=\"消息\"><button id=\"chat-send\" type=\"button\">发送</button></p></div><script src=\"/static/chat.js\"></script></div></section>"**
**闲聊文 = > page.包装 正文=`闲聊体` 体类="page-chat-room"**
**闲聊页 = > 网页.页面 标题="闲聊 · 暗恋见君" 引言=`闲聊文` 壳样式="off" 布局="bare"**
**闲聊页 = > 闲聊页.头装配 表=`头`**
*专题行 = > store.查询 表="topics" 上限=50*
*专题段 = None*
**专题行 = > store.查询 表="topics" 上限=50**
**专题段 = None**
- [题](专题行)
*题名 = 题[^title]*
*链 = 题[^slug]*
*摘 = 题[^summary]*
*项 = "<article class=\"topic-card\"><h3>" + 题名 + "</h3><p>" + 摘 + "</p><p class=\"text-muted\">slug: " + 链 + "</p></article>"*
*专题段 = > table.append list=专题段 item=项*
*专题内 = > text.str_join xs=专题段 sep=""*
*专题体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>专题书架</h1><div class=\"topic-shelf\">" + 专题内 + "</div></div></section>"*
*专题文 = > page.包装 正文=`专题体` 体类="page-topics"*
*专题页 = > 网页.页面 标题="专题 · 暗恋见君" 引言=`专题文` 壳样式="off" 布局="bare"*
*专题页 = > 专题页.头装配 表=`头`*
**题名 = 题[^title]**
**链 = 题[^slug]**
**摘 = 题[^summary]**
**项 = "<article class=\"topic-card\"><h3>" + 题名 + "</h3><p>" + 摘 + "</p><p class=\"text-muted\">slug: " + 链 + "</p></article>"**
**专题段 = > table.append list=专题段 item=项**
**专题内 = > text.str_join xs=专题段 sep=""**
**专题体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>专题书架</h1><div class=\"topic-shelf\">" + 专题内 + "</div></div></section>"**
**专题文 = > page.包装 正文=`专题体` 体类="page-topics"**
**专题页 = > 网页.页面 标题="专题 · 暗恋见君" 引言=`专题文` 壳样式="off" 布局="bare"**
**专题页 = > 专题页.头装配 表=`头`**
*搜索体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>搜索</h1><form class=\"search-bar\" method=\"get\" action=\"/search\"><input name=\"q\" placeholder=\"关键词\" aria-label=\"关键词\"><button type=\"submit\">搜</button></form><p class=\"text-muted\">全文检索走 SQLite FTS(posts_fts);结果面板后续可按 q 扩展。</p></div></section>"*
*搜索文 = > page.包装 正文=`搜索体` 体类="page-search"*
*搜索页 = > 网页.页面 标题="搜索 · 暗恋见君" 引言=`搜索文` 壳样式="off" 布局="bare"*
*搜索页 = > 搜索页.头装配 表=`头`*
**搜索体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>搜索</h1><form class=\"search-bar\" method=\"get\" action=\"/search\"><input name=\"q\" placeholder=\"关键词\" aria-label=\"关键词\"><button type=\"submit\">搜</button></form><p class=\"text-muted\">全文检索走 SQLite FTS(posts_fts);结果面板后续可按 q 扩展。</p></div></section>"**
**搜索文 = > page.包装 正文=`搜索体` 体类="page-search"**
**搜索页 = > 网页.页面 标题="搜索 · 暗恋见君" 引言=`搜索文` 壳样式="off" 布局="bare"**
**搜索页 = > 搜索页.头装配 表=`头`**
*指南体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>API 自动化指南</h1><p>使用 Bearer / X-Api-Key 调用自动化接口。本验收切片提供 <code>api_keys</code> 表与 <code>web_api_key_check</code> 原语;业务 scopes 写在 .mq.md。</p><pre>Authorization: Bearer &lt;token&gt;</pre></div></section>"*
*指南文 = > page.包装 正文=`指南体` 体类="page-guide"*
*指南页 = > 网页.页面 标题="API 指南 · 暗恋见君" 引言=`指南文` 壳样式="off" 布局="bare"*
*指南页 = > 指南页.头装配 表=`头`*
**指南体 = "<section class=\"feed-list-page\"><div class=\"section-wrap\"><h1>API 自动化指南</h1><p>使用 Bearer / X-Api-Key 调用自动化接口。本验收切片提供 <code>api_keys</code> 表与 <code>web_api_key_check</code> 原语;业务 scopes 写在 .mq.md。</p><pre>Authorization: Bearer &lt;token&gt;</pre></div></section>"**
**指南文 = > page.包装 正文=`指南体` 体类="page-guide"**
**指南页 = > 网页.页面 标题="API 指南 · 暗恋见君" 引言=`指南文` 壳样式="off" 布局="bare"**
**指南页 = > 指南页.头装配 表=`头`**
*应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180*
*应用 = > 应用.路由 路径="/post" 页面=`帖子列表`*
*应用 = > 应用.路由 路径="/post/public" 页面=`发帖页`*
*应用 = > 应用.路由 路径="/post/{slug}" 页面=`帖子页`*
*应用 = > 应用.路由 路径="/news" 页面=`新闻列表`*
*应用 = > 应用.路由 路径="/news/{slug}" 页面=`新闻页`*
*应用 = > 应用.路由 路径="/chat" 页面=`聊天列表`*
*应用 = > 应用.路由 路径="/chat/lobby" 页面=`大厅页`*
*应用 = > 应用.路由 路径="/chat/casual" 页面=`闲聊页`*
*应用 = > 应用.路由 路径="/topics" 页面=`专题页`*
*应用 = > 应用.路由 路径="/search" 页面=`搜索页`*
*应用 = > 应用.路由 路径="/guide/automation-api" 页面=`指南页`*
*应用 = > 应用.静态 目录="public" 挂载="/static"*
*应用 = > 应用.图标 表=`图标`*
*应用 = > 应用.鉴权 用户表=`用户表` 会话时长=7200 登录路径="/accounts/login" 登录回跳="/post/public" 登出回跳="/"*
*应用 = > 应用.门禁 路径="/post/public" 角色="admin" 匹配="prefix" 拒绝="redirect" 排除="/accounts/login"*
*应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"*
*应用 = > 应用.调用 路径="/post/ten" 方法="GET" 函数="fragments.帖子十" 正文="query" 返回="html"*
*应用 = > 应用.调用 路径="/news/five" 方法="GET" 函数="fragments.新闻五" 正文="query" 返回="html"*
*应用 = > 应用.站点地图 路径="/sitemap.xml" 基址="http://127.0.0.1:18180" 条目=`地图项`*
*应用 = > 应用.爬虫协议 站点地图="http://127.0.0.1:18180/sitemap.xml"*
**应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180**
**应用 = > 应用.路由 路径="/post" 页面=`帖子列表`**
**应用 = > 应用.路由 路径="/post/public" 页面=`发帖页`**
**应用 = > 应用.路由 路径="/post/{slug}" 页面=`帖子页`**
**应用 = > 应用.路由 路径="/news" 页面=`新闻列表`**
**应用 = > 应用.路由 路径="/news/{slug}" 页面=`新闻页`**
**应用 = > 应用.路由 路径="/chat" 页面=`聊天列表`**
**应用 = > 应用.路由 路径="/chat/lobby" 页面=`大厅页`**
**应用 = > 应用.路由 路径="/chat/casual" 页面=`闲聊页`**
**应用 = > 应用.路由 路径="/topics" 页面=`专题页`**
**应用 = > 应用.路由 路径="/search" 页面=`搜索页`**
**应用 = > 应用.路由 路径="/guide/automation-api" 页面=`指南页`**
**应用 = > 应用.静态 目录="public" 挂载="/static"**
**应用 = > 应用.图标 表=`图标`**
**应用 = > 应用.鉴权 用户表=`用户表` 会话时长=7200 登录路径="/accounts/login" 登录回跳="/post/public" 登出回跳="/"**
**应用 = > 应用.门禁 路径="/post/public" 角色="admin" 匹配="prefix" 拒绝="redirect" 排除="/accounts/login"**
**应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"**
**应用 = > 应用.调用 路径="/post/ten" 方法="GET" 函数="fragments.帖子十" 正文="query" 返回="html"**
**应用 = > 应用.调用 路径="/news/five" 方法="GET" 函数="fragments.新闻五" 正文="query" 返回="html"**
**应用 = > 应用.站点地图 路径="/sitemap.xml" 基址="http://127.0.0.1:18180" 条目=`地图项`**
**应用 = > 应用.爬虫协议 站点地图="http://127.0.0.1:18180/sitemap.xml"**
> `应用`.监听
+17 -17
View File
@@ -32,37 +32,37 @@ import sys:lib/sys.mq.md
|----|--------|------|------|
| 1 | admin | anlian | admin |
*store = > db.打开*
*壳CSS = > shell.全局*
*首页 = > 网页.页面 标题="暗恋见君" 引言="<h1>ok</h1>"*
*首页 = > 首页.组件装配 组件=`壳`*
*首页 = > 首页.主体装配 主体=`帖子卡片`*
*首页 = > 首页.样式 样式=`壳CSS`*
**store = > db.打开**
**壳CSS = > shell.全局**
**首页 = > 网页.页面 标题="暗恋见君" 引言="<h1>ok</h1>"**
**首页 = > 首页.组件装配 组件=`壳`**
**首页 = > 首页.主体装配 主体=`帖子卡片`**
**首页 = > 首页.样式 样式=`壳CSS`**
*应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180*
*应用 = > 应用.鉴权 用户表=`用户表`*
*应用 = > 应用.门禁 路径="/write" 角色="admin" 匹配="prefix" 拒绝="redirect"*
*应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"*
**应用 = > 网页.应用 页面=`首页` 数据库=`store` 后台=True 主机="127.0.0.1" 端口=18180**
**应用 = > 应用.鉴权 用户表=`用户表`**
**应用 = > 应用.门禁 路径="/write" 角色="admin" 匹配="prefix" 拒绝="redirect"**
**应用 = > 应用.路由实时 路径="/chat/ws" 模式="broadcast"**
*gates = 应用[^gates]*
*n = > len value=`gates`*
**gates = 应用[^gates]**
**n = > len value=`gates`**
1. `n` >= 2
> print text=gates-ok
2. *
> print text=gates-fail
> sys.exit code=1
*ws = 应用[^ws_routes]*
*room = ws[^/chat/ws]*
*mode = room[^mode]*
**ws = 应用[^ws_routes]**
**room = ws[^/chat/ws]**
**mode = room[^mode]**
1. `mode` == "broadcast"
> print text=ws-ok
2. *
> print text=ws-fail
> sys.exit code=1
*list = > store.查询 表="posts" 上限=10*
*nr = > len value=`list`*
**list = > store.查询 表="posts" 上限=10**
**nr = > len value=`list`**
1. `nr` >= 1
> print text=seed-ok
2. *
+23 -23
View File
@@ -54,7 +54,7 @@ import text:lib/text.mq.md
| .main-intro | margin | 0 auto |
| .main-intro | padding | 1.25rem 1.5rem 0 |
**`基础`**
*`基础`*
## 动效
@@ -75,7 +75,7 @@ import text:lib/text.mq.md
| @keyframes cardRise 100% | opacity | "1" |
| @keyframes cardRise 100% | transform | translateY(0) |
**`动效`**
*`动效`*
## 顶栏
@@ -126,7 +126,7 @@ import text:lib/text.mq.md
| ul.nav li:first-child a:hover | transform | none |
| ul.nav li:first-child a:hover | background | transparent |
**`顶栏`**
*`顶栏`*
## Hero
@@ -223,7 +223,7 @@ import text:lib/text.mq.md
| .page-stage p | margin | "0" |
| .page-stage p | color | var(--muted) |
**`Hero`**
*`Hero`*
## 卡片
@@ -336,7 +336,7 @@ import text:lib/text.mq.md
| .search-bar button | font-weight | "600" |
| .search-bar button | cursor | pointer |
**`卡片`**
*`卡片`*
## 页脚
@@ -366,7 +366,7 @@ import text:lib/text.mq.md
| ul.foot-nav a | font-weight | "500" |
| ul.foot-nav a:hover | color | var(--accent-text) |
**`页脚`**
*`页脚`*
## 响应式
@@ -393,25 +393,25 @@ import text:lib/text.mq.md
| (prefers-reduced-motion: reduce) | ul.nav li:first-child a::before | animation | none |
| (prefers-reduced-motion: reduce) | article.card | animation | none |
**`响应式`**
*`响应式`*
## 全局
*基础表 = > 基础*
*动效表 = > 动效*
*顶栏表 = > 顶栏*
*Hero表 = > Hero*
*卡片表 = > 卡片*
*页脚表 = > 页脚*
*响应式表 = > 响应式*
**基础表 = > 基础**
**动效表 = > 动效**
**顶栏表 = > 顶栏**
**Hero表 = > Hero**
**卡片表 = > 卡片**
**页脚表 = > 页脚**
**响应式表 = > 响应式**
*css基础 = > 网页.样式装配 名="基础" 表=`基础表`*
*css动效 = > 网页.样式装配 名="动效" 表=`动效表`*
*css顶栏 = > 网页.样式装配 名="顶栏" 表=`顶栏表`*
*cssHero = > 网页.样式装配 名="Hero" 表=`Hero表`*
*css卡片 = > 网页.样式装配 名="卡片" 表=`卡片表`*
*css页脚 = > 网页.样式装配 名="页脚" 表=`页脚表`*
*css响应式 = > 网页.样式装配 名="响应式" 表=`响应式表`*
**css基础 = > 网页.样式装配 名="基础" 表=`基础表`**
**css动效 = > 网页.样式装配 名="动效" 表=`动效表`**
**css顶栏 = > 网页.样式装配 名="顶栏" 表=`顶栏表`**
**cssHero = > 网页.样式装配 名="Hero" 表=`Hero表`**
**css卡片 = > 网页.样式装配 名="卡片" 表=`卡片表`**
**css页脚 = > 网页.样式装配 名="页脚" 表=`页脚表`**
**css响应式 = > 网页.样式装配 名="响应式" 表=`响应式表`**
`css段` =
@@ -425,5 +425,5 @@ import text:lib/text.mq.md
| `css页脚` |
| `css响应式` |
*css = > text.str_join xs=`css段` sep=""*
**css**
**css = > text.str_join xs=`css段` sep=""**
*css*
+75 -75
View File
@@ -8,10 +8,10 @@ import text:lib/text.mq.md
# main
*`ticks` = 0*
*`bag` = ""*
*`path` = "/"*
*`ws_id` = "echo"*
**`ticks` = 0**
**`bag` = ""**
**`path` = "/"**
**`ws_id` = "echo"**
`wire` =
@@ -52,26 +52,26 @@ import text:lib/text.mq.md
|------|----------|---------|
| `wire` | `nav` | `st` |
**boot**
*boot*
## add
+ `value`=""
1. `value` != ""
1. `bag` == ""
*`bag` = value*
**`bag` = value**
2. *
*`bag` = bag + "\n" + value*
*`parts` = > text.str_split s=bag sep="\n"*
*`html` = ""*
**`bag` = bag + "\n" + value**
**`parts` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](parts)
1. `item` != ""
*`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"*
*`ret` = > browser.set_html sel="#items" html=html*
*`clr` = > browser.set_value sel="#draft" value=""*
*`ret` = > browser.merge a=ret b=clr*
*`f` = > browser.focus sel="#draft"*
**> browser.merge a=ret b=f**
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`clr` = > browser.set_value sel="#draft" value=""**
**`ret` = > browser.merge a=ret b=clr**
**`f` = > browser.focus sel="#draft"**
*> browser.merge a=ret b=f*
2. *
****
@@ -79,25 +79,25 @@ import text:lib/text.mq.md
+ `data_id`=""
1. `data_id` != ""
*`parts` = > text.str_split s=bag sep="\n"*
*`next` = ""*
**`parts` = > text.str_split s=bag sep="\n"**
**`next` = ""**
- [item](parts)
1. `item` != ""
1. `item` != `data_id`
1. `next` == ""
*`next` = item*
**`next` = item**
2. *
*`next` = next + "\n" + item*
*`bag` = next*
*`parts2` = > text.str_split s=bag sep="\n"*
*`html` = ""*
**`next` = next + "\n" + item**
**`bag` = next**
**`parts2` = > text.str_split s=bag sep="\n"**
**`html` = ""**
- [item](parts2)
1. `item` != ""
*`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"*
*`ret` = > browser.set_html sel="#items" html=html*
*`msg` = "removed " + data_id*
*`t` = > browser.set_text sel="#log" text=msg*
**> browser.merge a=ret b=t**
**`html` = html + "<li><span>" + item + "</span> <button type=\"button\" data-id=\"" + item + "\">删</button></li>"**
**`ret` = > browser.set_html sel="#items" html=html**
**`msg` = "removed " + data_id**
**`t` = > browser.set_text sel="#log" text=msg**
*> browser.merge a=ret b=t*
2. *
****
@@ -110,9 +110,9 @@ import text:lib/text.mq.md
|----|-----|-------|
| set | mq-draft | `value` |
*`msg` = > browser.set_text sel="#log" text="draft saved"*
*`s` = > browser.storage spec=st*
**> browser.merge a=msg b=s**
**`msg` = > browser.set_text sel="#log" text="draft saved"**
**`s` = > browser.storage spec=st**
*> browser.merge a=msg b=s*
## load_draft
@@ -122,7 +122,7 @@ import text:lib/text.mq.md
|----|-----|------|
| get | mq-draft | on_draft |
**> browser.storage spec=st**
*> browser.storage spec=st*
## on_draft
+ `ok`=True
@@ -130,47 +130,47 @@ import text:lib/text.mq.md
+ `found`=False
1. `found`
*`ret` = > browser.set_value sel="#draft" value=value*
*`msg` = > browser.set_text sel="#log" text="draft loaded"*
**> browser.merge a=ret b=msg**
**`ret` = > browser.set_value sel="#draft" value=value**
**`msg` = > browser.set_text sel="#log" text="draft loaded"**
*> browser.merge a=ret b=msg*
2. *
**> browser.set_text sel="#log" text="no draft"**
*> browser.set_text sel="#log" text="no draft"*
## start_tick
**> browser.interval ms=1000 then="on_tick" id="tick"**
*> browser.interval ms=1000 then="on_tick" id="tick"*
## stop_tick
**> browser.clear_interval id="tick"**
*> browser.clear_interval id="tick"*
## on_tick
+ `ok`=True
+ `id`=""
*`ticks` = ticks + 1*
*`label` = > str ticks*
**> browser.set_text sel="#tick" text=label**
**`ticks` = ticks + 1**
**`label` = > str ticks**
*> browser.set_text sel="#tick" text=label*
## go_home
*`path` = "/"*
**> show_path**
**`path` = "/"**
*> show_path*
## go_about
*`path` = "/about"*
**> show_path**
**`path` = "/about"**
*> show_path*
## go_net
*`path` = "/net"*
**> show_path**
**`path` = "/net"**
*> show_path*
## on_pop
+ `path`=""
*`path` = path*
**> show_path**
**`path` = path**
*> show_path*
## show_path
*`hide` = > table.put in=None at="hidden" value=""*
*`show` = > table.put in=None at="hidden" value=False*
**`hide` = > table.put in=None at="hidden" value=""**
**`show` = > table.put in=None at="hidden" value=False**
1. `path` == "/about"
`attrs` =
@@ -190,12 +190,12 @@ import text:lib/text.mq.md
| #panel-home | #panel-about | #panel-net |
|-------------|--------------|------------|
| `show` | `hide` | `hide` |
*`label` = "path: " + path*
*`ret` = > browser.set_text sel="#path" text=label*
*`a` = > browser.wrap key="set_attr" value=attrs*
*`ret` = > browser.merge a=ret b=a*
*`nav` = > browser.navigate url=path*
**> browser.merge a=ret b=nav**
**`label` = "path: " + path**
**`ret` = > browser.set_text sel="#path" text=label**
**`a` = > browser.wrap key="set_attr" value=attrs**
**`ret` = > browser.merge a=ret b=a**
**`nav` = > browser.navigate url=path**
*> browser.merge a=ret b=nav*
## do_fetch_all
@@ -206,15 +206,15 @@ import text:lib/text.mq.md
| 1 | "https://httpbin.org/uuid" |
| 2 | "https://httpbin.org/uuid" |
*`msg` = > browser.set_text sel="#net-out" text="fetch_all…"*
*`fa` = > browser.fetch_all requests=reqs then="on_fetch_all"*
**> browser.merge a=msg b=fa**
**`msg` = > browser.set_text sel="#net-out" text="fetch_all…"**
**`fa` = > browser.fetch_all requests=reqs then="on_fetch_all"**
*> browser.merge a=msg b=fa*
## on_fetch_all
+ `ok`=True
+ `results`=None
**> browser.set_text sel="#net-out" text="fetch_all done (see console / results in session)"**
*> browser.set_text sel="#net-out" text="fetch_all done (see console / results in session)"*
## ws_open
@@ -224,32 +224,32 @@ import text:lib/text.mq.md
|----|----|-----|-----------|--------------|------------|------------|
| open | `ws_id` | "wss://echo.websocket.events" | on_ws_open | on_ws_msg | on_ws_err | on_ws_close |
**> browser.ws spec=w**
*> browser.ws spec=w*
## on_ws_open
+ `ok`=True
+ `id`=""
**> browser.set_text sel="#net-out" text="ws open"**
*> browser.set_text sel="#net-out" text="ws open"*
## on_ws_msg
+ `ok`=True
+ `data`=""
*`msg` = "ws ← " + data*
**> browser.set_text sel="#net-out" text=msg**
**`msg` = "ws ← " + data**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_err
+ `ok`=False
+ `error`=""
*`msg` = "ws error: " + error*
**> browser.set_text sel="#net-out" text=msg**
**`msg` = "ws error: " + error**
*> browser.set_text sel="#net-out" text=msg*
## on_ws_close
+ `ok`=True
**> browser.set_text sel="#net-out" text="ws closed"**
*> browser.set_text sel="#net-out" text="ws closed"*
## ws_send
+ `value`=""
@@ -260,7 +260,7 @@ import text:lib/text.mq.md
|----|----|------|
| send | `ws_id` | `value` |
**> browser.ws spec=w**
*> browser.ws spec=w*
## ws_close
@@ -270,14 +270,14 @@ import text:lib/text.mq.md
|----|----|
| close | `ws_id` |
**> browser.ws spec=w**
*> browser.ws spec=w*
## copy_log
*`msg` = > browser.set_text sel="#log" text="copied bag to clipboard"*
*`c` = > browser.clipboard text=bag*
**> browser.merge a=msg b=c**
**`msg` = > browser.set_text sel="#log" text="copied bag to clipboard"**
**`c` = > browser.clipboard text=bag**
*> browser.merge a=msg b=c*
## dl_list
*`msg` = > browser.set_text sel="#log" text="download started"*
*`d` = > browser.download body=bag filename="items.txt"*
**> browser.merge a=msg b=d**
**`msg` = > browser.set_text sel="#log" text="download started"**
**`d` = > browser.download body=bag filename="items.txt"**
*> browser.merge a=msg b=d*
+7 -7
View File
@@ -6,7 +6,7 @@ import browser:lib/browser.mq.md
# main
*`count` = 0*
**`count` = 0**
`wire` =
@@ -15,13 +15,13 @@ import browser:lib/browser.mq.md
| 1 | "#bump" | click | bump |
| 2 | "#reset" | click | reset |
**`wire`**
*`wire`*
## bump
*`count` = count + 1*
*`label` = > str count*
**> browser.set_text sel="#count" text=label**
**`count` = count + 1**
**`label` = > str count**
*> browser.set_text sel="#count" text=label*
## reset
*`count` = 0*
**> browser.set_text sel="#count" text="0"**
**`count` = 0**
*> browser.set_text sel="#count" text="0"*
+10 -10
View File
@@ -13,12 +13,12 @@ import browser:lib/browser.mq.md
| 1 | "#load" | click | load |
| 2 | "#ping" | click | ping |
**`wire`**
*`wire`*
## load
*`msg` = > browser.set_text sel="#status" text="loading…"*
*`req` = > browser.fetch url="https://httpbin.org/uuid" then="on_uuid"*
**> browser.merge a=msg b=req**
**`msg` = > browser.set_text sel="#status" text="loading…"**
**`req` = > browser.fetch url="https://httpbin.org/uuid" then="on_uuid"**
*> browser.merge a=msg b=req*
## on_uuid
+ `ok`
@@ -27,16 +27,16 @@ import browser:lib/browser.mq.md
+ `error`=""
1. ok
**> browser.set_text sel="#status" text=body**
*> browser.set_text sel="#status" text=body*
2. *
**> browser.set_text sel="#status" text="fetch failed"**
*> browser.set_text sel="#status" text="fetch failed"*
## ping
*`msg` = > browser.set_text sel="#status" text="wait 600ms…"*
*`t` = > browser.after ms=600 then="on_ping"*
**> browser.merge a=msg b=t**
**`msg` = > browser.set_text sel="#status" text="wait 600ms…"**
**`t` = > browser.after ms=600 then="on_ping"**
*> browser.merge a=msg b=t*
## on_ping
+ `ok`=True
**> browser.set_text sel="#status" text="pong"**
*> browser.set_text sel="#status" text="pong"*
+11 -11
View File
@@ -13,21 +13,21 @@ import table:lib/table.mq.md
|---|--------|------|------|
| 1 | "#name" | input | on_input |
**`wire`**
*`wire`*
## on_input
+ `value`=""
+ `event`=""
1. `value` != ""
*`label` = "你好," + value*
*`ret` = > browser.set_text sel="#echo" text=label*
*`cls` = > browser.set_class sel="#echo" class="hi"*
*`ret` = > browser.merge a=ret b=cls*
*`attrs` = > table.put in=None at="data-name" value=value*
*`attr` = > browser.set_attr sel="#echo" attrs=attrs*
**> browser.merge a=ret b=attr**
**`label` = "你好," + value**
**`ret` = > browser.set_text sel="#echo" text=label**
**`cls` = > browser.set_class sel="#echo" class="hi"**
**`ret` = > browser.merge a=ret b=cls**
**`attrs` = > table.put in=None at="data-name" value=value**
**`attr` = > browser.set_attr sel="#echo" attrs=attrs**
*> browser.merge a=ret b=attr*
2. *
*`ret` = > browser.set_text sel="#echo" text="(等待输入)"*
*`cls` = > browser.set_class sel="#echo" class=""*
**> browser.merge a=ret b=cls**
**`ret` = > browser.set_text sel="#echo" text="(等待输入)"**
**`cls` = > browser.set_class sel="#echo" class=""**
*> browser.merge a=ret b=cls*
+51 -51
View File
@@ -9,7 +9,7 @@ import table:lib/table.mq.md
Route F demo: author data stays in tables; effects via `browser.*`.
*`obs_on` = False*
**`obs_on` = False**
`wire` =
@@ -25,15 +25,15 @@ Route F demo: author data stays in tables; effects via `browser.*`.
| 8 | "#dropzone" | dragover | on_dragover | |
| 9 | "#dropzone" | drop | on_drop | |
*`ready` = > browser.set_text sel="#log" text="ready (route F)"*
*`boot` = > table.put in=None at="wire" value=wire*
**> browser.merge a=boot b=ready**
**`ready` = > browser.set_text sel="#log" text="ready (route F)"**
**`boot` = > table.put in=None at="wire" value=wire**
*> browser.merge a=boot b=ready*
## read_text
**> browser.read_file sel="#file" then="on_file" as="text"**
*> browser.read_file sel="#file" then="on_file" as="text"*
## read_dataurl
**> browser.read_file sel="#file" then="on_file" as="data_url"**
*> browser.read_file sel="#file" then="on_file" as="data_url"*
## on_file
+ `ok`=False
@@ -46,25 +46,25 @@ Route F demo: author data stays in tables; effects via `browser.*`.
1. `ok`
1. `as` == "data_url"
*`n` = > len value=data_url*
*`ns` = > str `n`*
*`preview` = name + " data_url chars=" + ns*
*`ret` = > browser.set_text sel="#log" text=preview*
**`n` = > len value=data_url**
**`ns` = > str `n`**
**`preview` = name + " data_url chars=" + ns**
**`ret` = > browser.set_text sel="#log" text=preview**
1. `data_url` != ""
*`h` = "<img alt=\"preview\" src=\"" + data_url + "\" style=\"max-width:12rem;max-height:8rem\" />"*
*`img` = > browser.set_html sel="#preview" html=h*
**> browser.merge a=ret b=img**
**`h` = "<img alt=\"preview\" src=\"" + data_url + "\" style=\"max-width:12rem;max-height:8rem\" />"**
**`img` = > browser.set_html sel="#preview" html=h**
*> browser.merge a=ret b=img*
2. *
**ret**
*ret*
2. *
*`n` = > len value=body*
*`ns` = > str `n`*
*`ss` = > str `size`*
*`preview` = name + " (" + ss + " B, chars=" + ns + ") ok"*
**> browser.set_text sel="#log" text=preview**
**`n` = > len value=body**
**`ns` = > str `n`**
**`ss` = > str `size`**
**`preview` = name + " (" + ss + " B, chars=" + ns + ") ok"**
*> browser.set_text sel="#log" text=preview*
2. *
*`preview` = "file error: " + error*
**> browser.set_text sel="#log" text=preview**
**`preview` = "file error: " + error**
*> browser.set_text sel="#log" text=preview*
## draw_box
@@ -78,17 +78,17 @@ Canvas commands as a readable `@` table:
| 2 | strokerect | 20 | 20 | 100 | 60 | | "#122018" | |
| 3 | filltext | 40 | 55 | | | "#f5faf6" | | Marqdo |
*`cv` = > browser.canvas sel="#pad" commands=commands clear=True*
*`msg` = > browser.set_text sel="#log" text="canvas drawn"*
**> browser.merge a=cv b=msg**
**`cv` = > browser.canvas sel="#pad" commands=commands clear=True**
**`msg` = > browser.set_text sel="#log" text="canvas drawn"**
*> browser.merge a=cv b=msg*
## play_tone
*`tone` = > browser.audio op="play" id="demo" src="beep" freq=523 ms=220*
*`msg` = > browser.set_text sel="#log" text="audio beep"*
**> browser.merge a=tone b=msg**
**`tone` = > browser.audio op="play" id="demo" src="beep" freq=523 ms=220**
**`msg` = > browser.set_text sel="#log" text="audio beep"**
*> browser.merge a=tone b=msg*
## start_watch
*`obs_on` = True*
**`obs_on` = True**
`obs` =
@@ -97,12 +97,12 @@ Canvas commands as a readable `@` table:
| 1 | intersect | "#beacon" | beacon | on_intersect | 0.25 |
| 2 | resize | "#pad" | pad | on_resize | |
*`o` = > browser.observe specs=obs*
*`msg` = > browser.set_text sel="#log" text="observers on"*
**> browser.merge a=o b=msg**
**`o` = > browser.observe specs=obs**
**`msg` = > browser.set_text sel="#log" text="observers on"**
*> browser.merge a=o b=msg*
## stop_watch
*`obs_on` = False*
**`obs_on` = False**
`ids` =
@@ -111,23 +111,23 @@ Canvas commands as a readable `@` table:
| 1 | beacon |
| 2 | pad |
*`u` = > browser.unobserve specs=ids*
*`msg` = > browser.set_text sel="#log" text="observers off"*
**> browser.merge a=u b=msg**
**`u` = > browser.unobserve specs=ids**
**`msg` = > browser.set_text sel="#log" text="observers off"**
*> browser.merge a=u b=msg*
## on_intersect
+ `intersecting`=False
+ `ratio`=0
1. `obs_on`
*`state` = "hidden"*
**`state` = "hidden"**
1. `intersecting`
*`state` = "visible"*
**`state` = "visible"**
2. *
---
*`r` = > str `ratio`*
*`msg` = "beacon " + state + " ratio=" + r*
**> browser.set_text sel="#obs" text=msg**
**`r` = > str `ratio`**
**`msg` = "beacon " + state + " ratio=" + r**
*> browser.set_text sel="#obs" text=msg*
2. *
****
@@ -136,18 +136,18 @@ Canvas commands as a readable `@` table:
+ `height`=0
1. `obs_on`
*`w` = > str `width`*
*`h` = > str `height`*
*`msg` = "pad size " + w + "×" + h*
**> browser.set_text sel="#obs" text=msg**
**`w` = > str `width`**
**`h` = > str `height`**
**`msg` = "pad size " + w + "×" + h**
*> browser.set_text sel="#obs" text=msg*
2. *
****
## on_drag
+ `drag`=""
*`msg` = "dragging: " + drag*
**> browser.set_text sel="#log" text=msg**
**`msg` = "dragging: " + drag**
*> browser.set_text sel="#log" text=msg*
## on_dragover
****
@@ -155,8 +155,8 @@ Canvas commands as a readable `@` table:
## on_drop
+ `drop_text`=""
*`msg` = "dropped: " + drop_text*
*`h` = "<strong>" + drop_text + "</strong>"*
*`t` = > browser.set_text sel="#log" text=msg*
*`box` = > browser.set_html sel="#dropzone" html=h*
**> browser.merge a=t b=box**
**`msg` = "dropped: " + drop_text**
**`h` = "<strong>" + drop_text + "</strong>"**
**`t` = > browser.set_text sel="#log" text=msg**
**`box` = > browser.set_html sel="#dropzone" html=h**
*> browser.merge a=t b=box*
+6 -6
View File
@@ -21,14 +21,14 @@ $$
\begin{pmatrix}1\\2\\2\end{pmatrix}
$$
*`A` = > la.from_formula formula=`A`*
*`b` = > la.from_formula formula=`b`*
**`A` = > la.from_formula formula=`A`**
**`b` = > la.from_formula formula=`b`**
*`_` = > la.draw factor=`A` kind="heatmap" theme="light" path="ls-heatmap.svg"*
**`_` = > la.draw factor=`A` kind="heatmap" theme="light" path="ls-heatmap.svg"**
*`ls` = > la.lstsq a=`A` b=`b`*
*`x` = ls[^x]*
*`resid` = ls[^residual_fro]*
**`ls` = > la.lstsq a=`A` b=`b`**
**`x` = ls[^x]**
**`resid` = ls[^residual_fro]**
> print text=`x`
> print text=`resid`
+5 -5
View File
@@ -15,11 +15,11 @@ $$
\begin{bmatrix}4&0\\0&2\end{bmatrix}
$$
*`M` = > la.from_formula formula=`M`*
*`f` = > la.factorize matrix=`M` kind="svd"*
*`S` = f[^S]*
*`_` = > la.draw factor=`f` kind="svd" theme="light" path="svd-structure.svg"*
*`hm` = > la.draw factor=`M` kind="hinton" path="svd-hinton.svg"*
**`M` = > la.from_formula formula=`M`**
**`f` = > la.factorize matrix=`M` kind="svd"**
**`S` = f[^S]**
**`_` = > la.draw factor=`f` kind="svd" theme="light" path="svd-structure.svg"**
**`hm` = > la.draw factor=`M` kind="hinton" path="svd-hinton.svg"**
> print text=`S`
> print text=svd-ok
+5 -5
View File
@@ -17,11 +17,11 @@ Declare shapes in a table, form \(P = AB\), then check \((AB)^\top = B^\top A^\t
| 1 | A | 2 | 3 |
| 2 | B | 3 | 2 |
*`env` = > la.declare table=`shapes`*
*`A` = env[^A]*
*`B` = env[^B]*
*`P` = `A` * `B`*
*`t` = > `P`.T_ascii*
**`env` = > la.declare table=`shapes`**
**`A` = env[^A]**
**`B` = env[^B]**
**`P` = `A` * `B`**
**`t` = > `P`.T_ascii**
> print text=`t`
1. `t` == "B^T*A^T"
> print text=identity-ok
+1 -1
View File
@@ -10,4 +10,4 @@
| 关于 | /about | |
| 后台 | /admin | |
**`页脚`**
*`页脚`*
+1 -1
View File
@@ -12,4 +12,4 @@
| 关于 | /about | |
| 后台 | /admin | |
**`导航`**
*`导航`*
+1 -1
View File
@@ -12,4 +12,4 @@
| 发布文章 | /admin/new | |
| 实时终端 | /#live | |
**`侧栏`**
*`侧栏`*
+10 -10
View File
@@ -8,21 +8,21 @@ import seed:seed.mq.md
## 打开
*store = > 网页.数据库 地址="sqlite:data/marqdo-blog.db"*
*字段 = > schema.posts*
*标签字段 = > schema.tags*
*关联字段 = > schema.post_tags*
**store = > 网页.数据库 地址="sqlite:data/marqdo-blog.db"**
**字段 = > schema.posts**
**标签字段 = > schema.tags**
**关联字段 = > schema.post_tags**
> `store`.初始化 名=posts 字段=`字段`
> `store`.初始化 名=tags 字段=`标签字段`
> `store`.初始化 名=post_tags 字段=`关联字段`
*行 = > store.查询 表="posts" 上限=1*
**行 = > store.查询 表="posts" 上限=1**
1. `行`
**store**
*store*
2. *
*文章 = > seed.posts*
*标签 = > seed.tags*
*关联 = > seed.post_tags*
**文章 = > seed.posts**
**标签 = > seed.tags**
**关联 = > seed.post_tags**
> `store`.插入 表=posts 行=`文章`
> `store`.插入 表=tags 行=`标签`
> `store`.插入 表=post_tags 行=`关联`
**store**
*store*
+3 -3
View File
@@ -15,7 +15,7 @@
| created_at | text | true |
| updated_at | text | true |
**`schema`**
*`schema`*
## tags
@@ -29,7 +29,7 @@
| name | text | false |
| slug | text | false |
**`tags`**
*`tags`*
## post_tags
@@ -43,4 +43,4 @@
| post_id | integer | false |
| tag_id | integer | false |
**`post_tags`**
*`post_tags`*
+3 -3
View File
@@ -13,7 +13,7 @@
| 5 | 会话与登录鉴权 | session-auth | 后台用 session 门禁保护,只有登录用户能发布文章。 | 用 app.鉴权 配置管理员用户表,/admin 下的 CRUD 页面都需要有效会话。 | web | 2026-08-18 | 2026-08-20 |
| 6 | 数据库与 CRUD | database-crud | 博客的文章、标签、关联全部由 SQLite 支撑。 | db.初始化 建表、db.插入 写种子、后台表单增删改。文章与标签通过 post_tags 关联。 | database | 2026-08-20 | 2026-08-21 |
**`posts`**
*`posts`*
## tags
@@ -29,7 +29,7 @@
| 4 | 数据库 | database |
| 5 | 实时 | realtime |
**`tags`**
*`tags`*
## post_tags
@@ -50,4 +50,4 @@
| 9 | 6 | 4 |
| 10 | 6 | 1 |
**`post_tags`**
*`post_tags`*
+38 -38
View File
@@ -83,49 +83,49 @@ import db:db/index.mq.md
|----|------|----|------|------|------|
| "/static/logo.svg" | Marqdo | brand-logo | "/" | 40 | eager |
*store = > db.打开*
**store = > db.打开**
*首页CSS = > theme.全局*
**首页CSS = > theme.全局**
*page = > 网页.页面 标题="Marqdo 博客" 引言="<h1>Marqdo 博客</h1><p>用 web 扩展库搭建的博客:表格装配页面、SQLite 数据、动态路由、实时终端。</p><h2 id=\"live\">实时终端</h2><p id=\"live-status\" class=\"live-pill\">connecting…</p><input id=\"live-msg\" placeholder=\"输入一条消息…\"><button id=\"live-send\" disabled>发送</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"*
*page = > page.组件装配 组件=`首页`*
*page = > page.主体装配 主体=`列表`*
*page = > page.排序 排序="-created_at"*
*page = > page.样式 样式=`首页CSS`*
*page = > page.头装配 表=`头资源`*
*page = > page.图片装配 表=`品牌图`*
**page = > 网页.页面 标题="Marqdo 博客" 引言="<h1>Marqdo 博客</h1><p>用 web 扩展库搭建的博客:表格装配页面、SQLite 数据、动态路由、实时终端。</p><h2 id=\"live\">实时终端</h2><p id=\"live-status\" class=\"live-pill\">connecting…</p><input id=\"live-msg\" placeholder=\"输入一条消息…\"><button id=\"live-send\" disabled>发送</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"**
**page = > page.组件装配 组件=`首页`**
**page = > page.主体装配 主体=`列表`**
**page = > page.排序 排序="-created_at"**
**page = > page.样式 样式=`首页CSS`**
**page = > page.头装配 表=`头资源`**
**page = > page.图片装配 表=`品牌图`**
*about = > 网页.页面 标题="关于" 引言="<h1>关于本站</h1><p>一个用 Marqdo 的 web 扩展库(ext/web)写成的博客系统。</p><p>它演示了:GFM 表格装配导航与侧栏、SQLite 驱动的主体绑定、动态路由 /post/{slug}、标签归档、以及受 session 保护的后台 CRUD。</p>"*
*about = > about.组件装配 组件=`首页`*
*about = > about.样式 样式=`首页CSS`*
**about = > 网页.页面 标题="关于" 引言="<h1>关于本站</h1><p>一个用 Marqdo 的 web 扩展库(ext/web)写成的博客系统。</p><p>它演示了:GFM 表格装配导航与侧栏、SQLite 驱动的主体绑定、动态路由 /post/{slug}、标签归档、以及受 session 保护的后台 CRUD。</p>"**
**about = > about.组件装配 组件=`首页`**
**about = > about.样式 样式=`首页CSS`**
*post = > 网页.页面 标题="文章"*
*post = > post.组件装配 组件=`首页`*
*post = > post.主体装配 主体=`详情绑定`*
*post = > post.查询条件 条件=`文章条件`*
*post = > post.详情 详情=True*
*post = > post.样式 样式=`首页CSS`*
**post = > 网页.页面 标题="文章"**
**post = > post.组件装配 组件=`首页`**
**post = > post.主体装配 主体=`详情绑定`**
**post = > post.查询条件 条件=`文章条件`**
**post = > post.详情 详情=True**
**post = > post.样式 样式=`首页CSS`**
*tags = > 网页.页面 标题="标签归档" 引言="<h1>标签归档</h1><p>点击标签查看该主题下的文章。</p>"*
*tags = > tags.组件装配 组件=`首页`*
*tags = > tags.主体装配 主体=`标签列表`*
*tags = > tags.链接前缀 前缀="/tag/"*
*tags = > tags.样式 样式=`首页CSS`*
**tags = > 网页.页面 标题="标签归档" 引言="<h1>标签归档</h1><p>点击标签查看该主题下的文章。</p>"**
**tags = > tags.组件装配 组件=`首页`**
**tags = > tags.主体装配 主体=`标签列表`**
**tags = > tags.链接前缀 前缀="/tag/"**
**tags = > tags.样式 样式=`首页CSS`**
*tagged = > 网页.页面 标题="标签"*
*tagged = > tagged.组件装配 组件=`首页`*
*tagged = > tagged.主体装配 主体=`列表`*
*tagged = > tagged.查询条件 条件=`标签条件`*
*tagged = > tagged.排序 排序="-created_at"*
*tagged = > tagged.样式 样式=`首页CSS`*
**tagged = > 网页.页面 标题="标签"**
**tagged = > tagged.组件装配 组件=`首页`**
**tagged = > tagged.主体装配 主体=`列表`**
**tagged = > tagged.查询条件 条件=`标签条件`**
**tagged = > tagged.排序 排序="-created_at"**
**tagged = > tagged.样式 样式=`首页CSS`**
*app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18085*
*app = > app.路由 路径="/about" 页面=about*
*app = > app.路由 路径="/post/{slug}" 页面=post*
*app = > app.路由 路径="/tags" 页面=tags*
*app = > app.路由 路径="/tag/{slug}" 页面=tagged*
*app = > app.静态 目录="public" 挂载="/static"*
*app = > app.图标 表=`站点图标`*
*app = > app.路由实时 路径="/live" 回显=True*
*app = > app.鉴权 用户表=`管理员` 会话时长=3600*
**app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18085**
**app = > app.路由 路径="/about" 页面=about**
**app = > app.路由 路径="/post/{slug}" 页面=post**
**app = > app.路由 路径="/tags" 页面=tags**
**app = > app.路由 路径="/tag/{slug}" 页面=tagged**
**app = > app.静态 目录="public" 挂载="/static"**
**app = > app.图标 表=`站点图标`**
**app = > app.路由实时 路径="/live" 回显=True**
**app = > app.鉴权 用户表=`管理员` 会话时长=3600**
> `app`.监听
+26 -26
View File
@@ -47,7 +47,7 @@ import text:lib/text.mq.md
| body.has-sidebar | grid-template-areas | "top top" "side main" "foot foot" |
| body.no-sidebar | grid-template-areas | "top" "main" "foot" |
**`基础`**
*`基础`*
## 顶栏
@@ -96,7 +96,7 @@ import text:lib/text.mq.md
| ul.nav li:first-child a | padding-left | .2rem |
| ul.nav li:first-child a | padding-right | .2rem |
**`顶栏`**
*`顶栏`*
## 侧栏
@@ -129,7 +129,7 @@ import text:lib/text.mq.md
| ul.side-nav a:hover | transform | translateX(4px) |
| ul.side-nav a:hover | box-shadow | 0 1px 3px rgba(28,25,23,.08) |
**`侧栏`**
*`侧栏`*
## 主体
@@ -154,7 +154,7 @@ import text:lib/text.mq.md
| .main-intro p | margin | 0 |
| .main-intro p | font-size | 1.05rem |
**`主体`**
*`主体`*
## 卡片
@@ -210,7 +210,7 @@ import text:lib/text.mq.md
| .content.cards p | font-size | .95rem |
| .content.cards p | flex | 1 |
**`卡片`**
*`卡片`*
## 页脚
@@ -240,7 +240,7 @@ import text:lib/text.mq.md
| ul.foot-nav a | text-decoration | none |
| ul.foot-nav a:hover | color | var(--accent) |
**`页脚`**
*`页脚`*
## 表单
@@ -341,7 +341,7 @@ import text:lib/text.mq.md
| .site-form .admin-list a | text-decoration | none |
| .site-form .admin-list a | font-size | .9rem |
**`表单`**
*`表单`*
## 响应式
@@ -364,29 +364,29 @@ import text:lib/text.mq.md
| (max-width: 860px) | .content.cards | grid-template-columns | 1fr |
| (max-width: 520px) | ul.nav | flex-wrap | wrap |
**`响应式`**
*`响应式`*
## 全局
用 样式装配 函数逐个把段落表装配成 CSS,再拼接成完整样式表。
*基础表 = > 基础*
*顶栏表 = > 顶栏*
*侧栏表 = > 侧栏*
*主体表 = > 主体*
*卡片表 = > 卡片*
*页脚表 = > 页脚*
*表单表 = > 表单*
*响应式表 = > 响应式*
**基础表 = > 基础**
**顶栏表 = > 顶栏**
**侧栏表 = > 侧栏**
**主体表 = > 主体**
**卡片表 = > 卡片**
**页脚表 = > 页脚**
**表单表 = > 表单**
**响应式表 = > 响应式**
*css基础 = > 网页.样式装配 名="基础" 表=`基础表`*
*css顶栏 = > 网页.样式装配 名="顶栏" 表=`顶栏表`*
*css侧栏 = > 网页.样式装配 名="侧栏" 表=`侧栏表`*
*css主体 = > 网页.样式装配 名="主体" 表=`主体表`*
*css卡片 = > 网页.样式装配 名="卡片" 表=`卡片表`*
*css页脚 = > 网页.样式装配 名="页脚" 表=`页脚表`*
*css表单 = > 网页.样式装配 名="表单" 表=`表单表`*
*css响应式 = > 网页.样式装配 名="响应式" 表=`响应式表`*
**css基础 = > 网页.样式装配 名="基础" 表=`基础表`**
**css顶栏 = > 网页.样式装配 名="顶栏" 表=`顶栏表`**
**css侧栏 = > 网页.样式装配 名="侧栏" 表=`侧栏表`**
**css主体 = > 网页.样式装配 名="主体" 表=`主体表`**
**css卡片 = > 网页.样式装配 名="卡片" 表=`卡片表`**
**css页脚 = > 网页.样式装配 名="页脚" 表=`页脚表`**
**css表单 = > 网页.样式装配 名="表单" 表=`表单表`**
**css响应式 = > 网页.样式装配 名="响应式" 表=`响应式表`**
`css段` =
@@ -401,5 +401,5 @@ import text:lib/text.mq.md
| `css表单` |
| `css响应式` |
*css = > text.str_join xs=`css段` sep=""*
**css**
**css = > text.str_join xs=`css段` sep=""**
*css*
+4 -4
View File
@@ -19,9 +19,9 @@ H on qubit 0, then CNOT(0→1). Ideal measurement: |00⟩ and |11⟩ each with p
| 1 | H | 0 |
| 2 | CX | 0,1 |
*qc = > quantum.circuit qubits=2 steps=`steps`*
*p = > qc.probabilities*
*_ = > qc.draw path="bell.svg"*
*_ = > qc.draw kind="probs" path="bell-probs.svg"*
**qc = > quantum.circuit qubits=2 steps=`steps`**
**p = > qc.probabilities**
**_ = > qc.draw path="bell.svg"**
**_ = > qc.draw kind="probs" path="bell-probs.svg"**
> print text=`p`
+15 -15
View File
@@ -18,25 +18,25 @@ Build |Φ⁺⟩ with H then CX. Full-state purity stays 1; tracing out one qubit
| 1 | H | 0 |
| 2 | CX | 0,1 |
*qc = > quantum.circuit qubits=2 steps=`steps`*
*p = > `qc`.probabilities*
**qc = > quantum.circuit qubits=2 steps=`steps`**
**p = > `qc`.probabilities**
*rho = > `qc`.density*
*pur = > `rho`.purity*
*red = > `rho`.partial_trace keep=0*
*rpur = > `red`.purity*
**rho = > `qc`.density**
**pur = > `rho`.purity**
**red = > `rho`.partial_trace keep=0**
**rpur = > `red`.purity**
*zz = "ZZ"*
*ezz = > `qc`.expect obs=`zz`*
**zz = "ZZ"**
**ezz = > `qc`.expect obs=`zz`**
*sch = > `qc`.schmidt cut=1*
*ent = sch[^entropy]*
**sch = > `qc`.schmidt cut=1**
**ent = sch[^entropy]**
*_ = > `qc`.draw path="entangle-circuit.svg" theme="dark"*
*_ = > `qc`.draw kind="hinton" path="entangle-hinton.svg"*
*_ = > `qc`.draw kind="qsphere" path="entangle-qsphere.svg"*
*_ = > `qc`.draw kind="multibloch" path="entangle-multibloch.svg"*
*_ = > `rho`.draw kind="city" path="entangle-city.svg"*
**_ = > `qc`.draw path="entangle-circuit.svg" theme="dark"**
**_ = > `qc`.draw kind="hinton" path="entangle-hinton.svg"**
**_ = > `qc`.draw kind="qsphere" path="entangle-qsphere.svg"**
**_ = > `qc`.draw kind="multibloch" path="entangle-multibloch.svg"**
**_ = > `rho`.draw kind="city" path="entangle-city.svg"**
> print text=`p`
> print text=`pur`
+6 -6
View File
@@ -18,11 +18,11 @@ H on qubit 0, CX(0→1), CX(0→2). Ideal: |000⟩ and |111⟩ each with probabi
| 2 | CX | 0,1 |
| 3 | CX | 0,2 |
*qc = > quantum.circuit qubits=3 steps=`steps`*
*p = > qc.probabilities*
*_ = > qc.draw path="ghz.svg"*
*_ = > qc.draw kind="probs" path="ghz-probs.svg"*
*H = > quantum.gate name="H"*
*_ = > H.draw kind="matrix" path="ghz-h-matrix.svg"*
**qc = > quantum.circuit qubits=3 steps=`steps`**
**p = > qc.probabilities**
**_ = > qc.draw path="ghz.svg"**
**_ = > qc.draw kind="probs" path="ghz-probs.svg"**
**H = > quantum.gate name="H"**
**_ = > H.draw kind="matrix" path="ghz-h-matrix.svg"**
> print text=`p`
+5 -5
View File
@@ -9,11 +9,11 @@ import web:ext/web/web.mq.md
Server page with a counter UI. Client logic lives in `static/client.mq.md`
(loaded by official bridge via `client_embed`).
*`embed` = > web.client_embed bridge="/static/marqdo-bridge.js" wasm="/static/marqdo_wasm.wasm" source="/static/client.mq.md" boot=True*
**`embed` = > web.client_embed bridge="/static/marqdo-bridge.js" wasm="/static/marqdo_wasm.wasm" source="/static/client.mq.md" boot=True**
*`intro` = "<h1>Marqdo client site</h1><p>SSR + WASM session. No author JS.</p><div id=\"count\">0</div><p><button id=\"bump\" type=\"button\" disabled>Bump</button> <button id=\"reset\" type=\"button\" disabled>Reset</button></p><pre id=\"log\">booting…</pre>" + embed*
**`intro` = "<h1>Marqdo client site</h1><p>SSR + WASM session. No author JS.</p><div id=\"count\">0</div><p><button id=\"bump\" type=\"button\" disabled>Bump</button> <button id=\"reset\" type=\"button\" disabled>Reset</button></p><pre id=\"log\">booting…</pre>" + embed**
*page = > web.page title="Marqdo client site" intro=intro*
*app = > web.app page=page host="127.0.0.1" port=18090*
*app = > app.static dir="static" mount="/static"*
**page = > web.page title="Marqdo client site" intro=intro**
**app = > web.app page=page host="127.0.0.1" port=18090**
**app = > app.static dir="static" mount="/static"**
> `app`.listen
+9 -9
View File
@@ -7,7 +7,7 @@ import table:lib/table.mq.md
# main
*`count` = 0*
**`count` = 0**
`wire` =
@@ -16,15 +16,15 @@ import table:lib/table.mq.md
| 1 | "#bump" | click | bump |
| 2 | "#reset" | click | reset |
*`ready` = > browser.set_text sel="#log" text="client.mq.md ready"*
*`boot` = > table.put in=None at="wire" value=wire*
**> browser.merge a=boot b=ready**
**`ready` = > browser.set_text sel="#log" text="client.mq.md ready"**
**`boot` = > table.put in=None at="wire" value=wire**
*> browser.merge a=boot b=ready*
## bump
*`count` = count + 1*
*`label` = > str count*
**> browser.set_text sel="#count" text=label**
**`count` = count + 1**
**`label` = > str count**
*> browser.set_text sel="#count" text=label*
## reset
*`count` = 0*
**> browser.set_text sel="#count" text="0"**
**`count` = 0**
*> browser.set_text sel="#count" text="0"*
@@ -7,4 +7,4 @@
| Marqdo 网络扩展示例 | https://github.com | |
| 文档 | /tools | |
**`页脚`**
*`页脚`*
@@ -12,4 +12,4 @@
| 工具 | /tools | |
| 后台 | /admin | |
**`导航`**
*`导航`*
@@ -12,4 +12,4 @@
| 表单 | /new | |
| lib/net | /tools | |
**`侧栏`**
*`侧栏`*
+2 -2
View File
@@ -8,7 +8,7 @@
| title | text | false |
| body | text | true |
**`字段`**
*`字段`*
## 种子
@@ -20,4 +20,4 @@
| 2 | 登录门禁后台 | /admin 页面需要 session 会话。 |
| 3 | WebSocket 实时 | /live 端点会把你的消息实时回显。 |
**`行`**
*`行`*
+6 -6
View File
@@ -7,13 +7,13 @@ import articles:articles.mq.md
## 打开
*store = > 网页.数据库 地址="sqlite:data/site-net-zh.db"*
*字段 = > articles.结构*
**store = > 网页.数据库 地址="sqlite:data/site-net-zh.db"**
**字段 = > articles.结构**
> `store`.初始化 名=articles 字段=`字段`
*行 = > store.查询 表="articles" 上限=1*
**行 = > store.查询 表="articles" 上限=1**
1. `行`
**store**
*store*
2. *
*种子 = > articles.种子*
**种子 = > articles.种子**
> `store`.插入 表=articles 行=`种子`
**store**
*store*
+29 -29
View File
@@ -44,29 +44,29 @@ import db:db/index.mq.md
| title | max:120 | 标题太长 |
| body | max:8000 | 正文太长 |
*store = > db.打开*
*page = > 网页.页面 标题="网络扩展站" 引言="<h1>网络扩展站</h1><p>SQLite 文章列表、WebSocket 实时小部件、登录门禁后台、以及标准库 lib/net 的解析工具。</p><h2 id=\"live\">实时 WebSocket</h2><p id=\"live-status\">connecting…</p><input id=\"live-msg\" placeholder=\"输入一条消息…\"><button id=\"live-send\" disabled>发送</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"*
*page = > page.组件装配 组件=`首页`*
*page = > page.主体装配 主体=`列表`*
**store = > db.打开**
**page = > 网页.页面 标题="网络扩展站" 引言="<h1>网络扩展站</h1><p>SQLite 文章列表、WebSocket 实时小部件、登录门禁后台、以及标准库 lib/net 的解析工具。</p><h2 id=\"live\">实时 WebSocket</h2><p id=\"live-status\">connecting…</p><input id=\"live-msg\" placeholder=\"输入一条消息…\"><button id=\"live-send\" disabled>发送</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"**
**page = > page.组件装配 组件=`首页`**
**page = > page.主体装配 主体=`列表`**
*about = > 网页.页面 标题="关于" 引言="<h1>关于</h1><p>演示网络扩展后的 web 库:会话、登录鉴权、WebSocket、multipart/cookie 解析。</p>"*
*about = > about.组件装配 组件=`首页`*
**about = > 网页.页面 标题="关于" 引言="<h1>关于</h1><p>演示网络扩展后的 web 库:会话、登录鉴权、WebSocket、multipart/cookie 解析。</p>"**
**about = > about.组件装配 组件=`首页`**
<!-- 工具页:用 lib/net 解析展示 -->
*解析请求 = > net.解析Cookie 内容="session=abc123; theme=dark"*
*请求块 = 解析请求[^1]*
**解析请求 = > net.解析Cookie 内容="session=abc123; theme=dark"**
**请求块 = 解析请求[^1]**
*解析响应 = > net.解析Cookie 内容="id=42; Path=/; HttpOnly; SameSite=Lax" 是响应头=True*
*响应块 = 解析响应[^1]*
**解析响应 = > net.解析Cookie 内容="id=42; Path=/; HttpOnly; SameSite=Lax" 是响应头=True**
**响应块 = 解析响应[^1]**
`边界` = ----b
`正文` = "--`边界`\nContent-Disposition: form-data; name=\"title\"\n\n你好\n--`边界`\nContent-Disposition: form-data; name=\"封面\"; filename=\"pic.png\"\nContent-Type: image/png\n\n<字节>\n--`边界`--\n"
*多部分 = > net.解析多部分 正文=`正文` 边界=`边界`*
*字段块 = 多部分[^1]*
*文件块 = 多部分[^2]*
**多部分 = > net.解析多部分 正文=`正文` 边界=`边界`**
**字段块 = 多部分[^1]**
**文件块 = 多部分[^2]**
`工具段` =
@@ -83,17 +83,17 @@ import db:db/index.mq.md
| `文件块`[^name] · `文件块`[^filename] · `文件块`[^content_type] |
| </p></article></section> |
*工具引言 = > text.str_join xs=`工具段` sep=""*
*tools = > 网页.页面 标题="工具" 引言=`工具引言`*
*tools = > tools.组件装配 组件=`首页`*
**工具引言 = > text.str_join xs=`工具段` sep=""**
**tools = > 网页.页面 标题="工具" 引言=`工具引言`**
**tools = > tools.组件装配 组件=`首页`**
*article_form = > 网页.表单 表="articles" 动作="插入"*
*article_form = > article_form.字段 字段=`文章字段`*
*article_form = > article_form.规则 规则=`文章规则`*
**article_form = > 网页.表单 表="articles" 动作="插入"**
**article_form = > article_form.字段 字段=`文章字段`**
**article_form = > article_form.规则 规则=`文章规则`**
*new = > 网页.页面 标题="发布" 引言="<h1>发布</h1><p>表单插入到 articles 表。</p>"*
*new = > new.组件装配 组件=`首页`*
*new = > new.表单装配 id="article" 表单=article_form*
**new = > 网页.页面 标题="发布" 引言="<h1>发布</h1><p>表单插入到 articles 表。</p>"**
**new = > new.组件装配 组件=`首页`**
**new = > new.表单装配 id="article" 表单=article_form**
`管理员` =
@@ -101,11 +101,11 @@ import db:db/index.mq.md
|----|--------|------|
| 1 | admin | secret |
*app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18084*
*app = > app.路由 路径="/about" 页面=about*
*app = > app.路由 路径="/new" 页面=new*
*app = > app.路由 路径="/tools" 页面=tools*
*app = > app.静态 目录="public" 挂载="/static"*
*app = > app.路由实时 路径="/live" 回显=True*
*app = > app.鉴权 用户表=`管理员` 会话时长=3600*
**app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18084**
**app = > app.路由 路径="/about" 页面=about**
**app = > app.路由 路径="/new" 页面=new**
**app = > app.路由 路径="/tools" 页面=tools**
**app = > app.静态 目录="public" 挂载="/static"**
**app = > app.路由实时 路径="/live" 回显=True**
**app = > app.鉴权 用户表=`管理员` 会话时长=3600**
> `app`.监听
+4 -4
View File
@@ -7,7 +7,7 @@
| background | #ffffff |
| border-bottom | 1px solid #e7e5e4 |
**`顶栏`**
*`顶栏`*
## 侧栏面板
@@ -17,7 +17,7 @@
|------|-----|
| background | #f5f5f4 |
**`侧栏面板`**
*`侧栏面板`*
## 卡片标题
@@ -28,7 +28,7 @@
| font-size | 1.15rem |
| margin | 0 0 0.35rem |
**`卡片标题`**
*`卡片标题`*
## 卡片正文
@@ -39,4 +39,4 @@
| color | #57534e |
| margin | 0 |
**`卡片正文`**
*`卡片正文`*
+1 -1
View File
@@ -7,4 +7,4 @@
| Marqdo web-net example | https://github.com | |
| Docs | /tools | |
**`foot`**
*`foot`*
+1 -1
View File
@@ -12,4 +12,4 @@ Site top navigation. The Admin tab points at the login-gated admin page.
| Tools | /tools | |
| Admin | /admin | |
**`nav`**
*`nav`*
+1 -1
View File
@@ -12,4 +12,4 @@ Sidebar index of what this example demonstrates.
| Forms | /new | |
| net lib | /tools | |
**`side`**
*`side`*
+2 -2
View File
@@ -8,7 +8,7 @@
| title | text | false |
| body | text | true |
**`fields`**
*`fields`*
## seed
@@ -20,4 +20,4 @@
| 2 | Login-gated admin | The /admin page requires a session cookie. |
| 3 | WebSocket live | The /live endpoint echoes your message in real time. |
**`rows`**
*`rows`*
+6 -6
View File
@@ -7,13 +7,13 @@ import articles:articles.mq.md
## open
*store = > web.db url="sqlite:data/site-net.db"*
*fields = > articles.schema*
**store = > web.db url="sqlite:data/site-net.db"**
**fields = > articles.schema**
> `store`.init name=articles fields=`fields`
*rows = > store.select table="articles" limit=1*
**rows = > store.select table="articles" limit=1**
1. `rows`
**store**
*store*
2. *
*seed = > articles.seed*
**seed = > articles.seed**
> `store`.insert table=articles rows=`seed`
**store**
*store*
+29 -29
View File
@@ -31,27 +31,27 @@ import db:db/index.mq.md
Home intro also embeds the live WebSocket widget (HTML is served raw).
*store = > db.open*
*page = > web.page title="Marqdo Net Site" intro="<h1>Net Site</h1><p>Articles from SQLite, a live WebSocket widget, login-gated admin, and net-library parsing tools.</p><h2 id=\"live\">Live WebSocket</h2><p id=\"live-status\">connecting…</p><input id=\"live-msg\" placeholder=\"type a message…\"><button id=\"live-send\" disabled>send</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"*
*page = > page.compose_components components=home*
*page = > page.compose_main main=index*
**store = > db.open**
**page = > web.page title="Marqdo Net Site" intro="<h1>Net Site</h1><p>Articles from SQLite, a live WebSocket widget, login-gated admin, and net-library parsing tools.</p><h2 id=\"live\">Live WebSocket</h2><p id=\"live-status\">connecting…</p><input id=\"live-msg\" placeholder=\"type a message…\"><button id=\"live-send\" disabled>send</button><div id=\"live-out\"></div><script src=\"/static/live.js\"></script>"**
**page = > page.compose_components components=home**
**page = > page.compose_main main=index**
About page: same shell.
*about = > web.page title="About" intro="<h1>About</h1><p>Demonstrates the network-extended web library: sessions, auth, WebSocket, multipart/cookie parsing.</p>"*
*about = > about.compose_components components=home*
**about = > web.page title="About" intro="<h1>About</h1><p>Demonstrates the network-extended web library: sessions, auth, WebSocket, multipart/cookie parsing.</p>"**
**about = > about.compose_components components=home**
<!-- Tools page (lib/net parsing) -->
Parse a `Cookie` request header with the standard library.
*parsed_req = > net.cookie_parse text="session=abc123; theme=dark"*
*req_cookie = parsed_req[^1]*
**parsed_req = > net.cookie_parse text="session=abc123; theme=dark"**
**req_cookie = parsed_req[^1]**
Parse a `Set-Cookie` response header.
*parsed_resp = > net.cookie_parse text="id=42; Path=/; HttpOnly; SameSite=Lax" is_response=True*
*resp_cookie = parsed_resp[^1]*
**parsed_resp = > net.cookie_parse text="id=42; Path=/; HttpOnly; SameSite=Lax" is_response=True**
**resp_cookie = parsed_resp[^1]**
Parse a `multipart/form-data` body.
@@ -59,9 +59,9 @@ Parse a `multipart/form-data` body.
`_body` = "--`_b`\nContent-Disposition: form-data; name=\"title\"\n\nHello\n--`_b`\nContent-Disposition: form-data; name=\"cover\"; filename=\"pic.png\"\nContent-Type: image/png\n\n<bytes>\n--`_b`--\n"
*mp = > net.multipart_parse body=`_body` boundary=`_b`*
*mp_title = mp[^1]*
*mp_cover = mp[^2]*
**mp = > net.multipart_parse body=`_body` boundary=`_b`**
**mp_title = mp[^1]**
**mp_cover = mp[^2]**
Build the tools page as one HTML intro (intro is served raw).
@@ -80,9 +80,9 @@ Build the tools page as one HTML intro (intro is served raw).
| `mp_cover`[^name] · `mp_cover`[^filename] · `mp_cover`[^content_type] |
| </p></article></section> |
*tools_intro = > text.str_join xs=`tools_parts` sep=""*
*tools = > web.page title="Tools" intro=`tools_intro`*
*tools = > tools.compose_components components=home*
**tools_intro = > text.str_join xs=`tools_parts` sep=""**
**tools = > web.page title="Tools" intro=`tools_intro`**
**tools = > tools.compose_components components=home**
Article create form: field table + rules table.
@@ -101,15 +101,15 @@ Article create form: field table + rules table.
| title | max:120 | Title is too long |
| body | max:8000 | Body is too long |
*article_form = > web.form table="articles" action="insert"*
*article_form = > article_form.fields fields=article_fields*
*article_form = > article_form.rules rules=article_rules*
**article_form = > web.form table="articles" action="insert"**
**article_form = > article_form.fields fields=article_fields**
**article_form = > article_form.rules rules=article_rules**
New article page: form embedded in the main slot.
*new = > web.page title="Publish" intro="<h1>Publish</h1><p>Form inserts into articles.</p>"*
*new = > new.compose_components components=home*
*new = > new.compose_form id="article" form=article_form*
**new = > web.page title="Publish" intro="<h1>Publish</h1><p>Form inserts into articles.</p>"**
**new = > new.compose_components components=home**
**new = > new.compose_form id="article" form=article_form**
Admin users table (english + chinese column headers both work).
@@ -119,11 +119,11 @@ Admin users table (english + chinese column headers both work).
|----|----------|----------|
| 1 | admin | secret |
*app = > web.app page=page db=store admin=True host="127.0.0.1" port=18083*
*app = > app.route path="/about" page=about*
*app = > app.route path="/new" page=new*
*app = > app.route path="/tools" page=tools*
*app = > app.static dir="public" mount="/static"*
*app = > app.route_ws path="/live" echo=True*
*app = > app.auth users=`admins` session_ttl=3600*
**app = > web.app page=page db=store admin=True host="127.0.0.1" port=18083**
**app = > app.route path="/about" page=about**
**app = > app.route path="/new" page=new**
**app = > app.route path="/tools" page=tools**
**app = > app.static dir="public" mount="/static"**
**app = > app.route_ws path="/live" echo=True**
**app = > app.auth users=`admins` session_ttl=3600**
> `app`.listen
+4 -4
View File
@@ -7,7 +7,7 @@
| background | #ffffff |
| border-bottom | 1px solid #e7e5e4 |
**`topnav`**
*`topnav`*
## side_panel
@@ -17,7 +17,7 @@
|------|-----|
| background | #f5f5f4 |
**`side_panel`**
*`side_panel`*
## card_title
@@ -28,7 +28,7 @@
| font-size | 1.15rem |
| margin | 0 0 0.35rem |
**`card_title`**
*`card_title`*
## card_body
@@ -39,4 +39,4 @@
| color | #57534e |
| margin | 0 |
**`card_body`**
*`card_body`*
+1 -1
View File
@@ -6,4 +6,4 @@
|------|-----|------|
| Marqdo | https://github.com | |
**`foot`**
*`foot`*
+1 -1
View File
@@ -9,4 +9,4 @@
| 写文章 | /new | |
| 后台 | /admin | |
**`nav`**
*`nav`*
+1 -1
View File
@@ -7,4 +7,4 @@
| 笔记 | / | |
| 文档 | https://github.com | |
**`side`**
*`side`*
+2 -2
View File
@@ -8,7 +8,7 @@
| title | text | false |
| body | text | true |
**`fields`**
*`fields`*
## seed
@@ -19,4 +19,4 @@
| 1 | 你好 Marqdo | 第一篇来自 GFM 表格。 |
| 2 | 代码即文档 | 页面表就是程序。 |
**`rows`**
*`rows`*
+6 -6
View File
@@ -7,13 +7,13 @@ import articles:articles.mq.md
## open
*store = > 网页.数据库 地址="sqlite:data/site-zh.db"*
*fields = > articles.schema*
**store = > 网页.数据库 地址="sqlite:data/site-zh.db"**
**fields = > articles.schema**
> `store`.初始化 名=articles 字段=`fields`
*rows = > store.查询 表="articles" 上限=1*
**rows = > store.查询 表="articles" 上限=1**
1. `rows`
**store**
*store*
2. *
*seed = > articles.seed*
**seed = > articles.seed**
> `store`.插入 表=articles 行=`seed`
**store**
*store*
+16 -16
View File
@@ -42,24 +42,24 @@ import db:db/index.mq.md
| title | max:120 | 标题太长 |
| body | max:8000 | 正文太长 |
*store = > db.open*
*page = > 网页.页面 标题="Marqdo 中文站" 引言="<h1>中文站</h1><p>表格 + 类方法。</p>"*
*page = > page.组件装配 组件=home*
*page = > page.主体装配 主体=index*
**store = > db.open**
**page = > 网页.页面 标题="Marqdo 中文站" 引言="<h1>中文站</h1><p>表格 + 类方法。</p>"**
**page = > page.组件装配 组件=home**
**page = > page.主体装配 主体=index**
*about = > 网页.页面 标题="关于" 引言="<h1>关于</h1><p>导入网页.mq.md 即用中文 API。</p>"*
*about = > about.组件装配 组件=home*
**about = > 网页.页面 标题="关于" 引言="<h1>关于</h1><p>导入网页.mq.md 即用中文 API。</p>"**
**about = > about.组件装配 组件=home**
*article_form = > 网页.表单 表="articles" 动作="插入"*
*article_form = > article_form.字段 字段=article_fields*
*article_form = > article_form.规则 规则=article_rules*
**article_form = > 网页.表单 表="articles" 动作="插入"**
**article_form = > article_form.字段 字段=article_fields**
**article_form = > article_form.规则 规则=article_rules**
*new = > 网页.页面 标题="写文章" 引言="<h1>写文章</h1><p>表单嵌在主区。</p>"*
*new = > new.组件装配 组件=home*
*new = > new.表单装配 id="article" 表单=article_form*
**new = > 网页.页面 标题="写文章" 引言="<h1>写文章</h1><p>表单嵌在主区。</p>"**
**new = > new.组件装配 组件=home**
**new = > new.表单装配 id="article" 表单=article_form**
*app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18082*
*app = > app.路由 路径="/about" 页面=about*
*app = > app.路由 路径="/new" 页面=new*
*app = > app.静态 目录="public" 挂载="/static"*
**app = > 网页.应用 页面=page 数据库=store 后台=True 主机="127.0.0.1" 端口=18082**
**app = > app.路由 路径="/about" 页面=about**
**app = > app.路由 路径="/new" 页面=new**
**app = > app.静态 目录="public" 挂载="/static"**
> `app`.监听
+4 -4
View File
@@ -7,7 +7,7 @@
| background | #ffffff |
| border-bottom | 1px solid #e7e5e4 |
**`topnav`**
*`topnav`*
## side_panel
@@ -17,7 +17,7 @@
|------|-----|
| background | #f5f5f4 |
**`side_panel`**
*`side_panel`*
## card_title
@@ -28,7 +28,7 @@
| font-size | 1.15rem |
| margin | 0 0 0.35rem |
**`card_title`**
*`card_title`*
## card_body
@@ -39,4 +39,4 @@
| color | #57534e |
| margin | 0 |
**`card_body`**
*`card_body`*
+1 -1
View File
@@ -6,4 +6,4 @@
|------|-----|------|
| Marqdo | https://github.com | |
**`foot`**
*`foot`*
+1 -1
View File
@@ -11,4 +11,4 @@ Static top links for the shell.
| New | /new | |
| Admin | /admin | |
**`nav`**
*`nav`*
+1 -1
View File
@@ -7,4 +7,4 @@
| Notes | / | |
| Docs | https://github.com | |
**`side`**
*`side`*
+2 -2
View File
@@ -8,7 +8,7 @@
| title | text | false |
| body | text | true |
**`fields`**
*`fields`*
## seed
@@ -19,4 +19,4 @@
| 1 | Hello Marqdo | First article from a GFM table. |
| 2 | Code as docs | The page table is the program. |
**`rows`**
*`rows`*
+6 -6
View File
@@ -8,13 +8,13 @@ import fs:lib/fs.mq.md
## open
*store = > web.db url="sqlite:data/site.db"*
*fields = > articles.schema*
**store = > web.db url="sqlite:data/site.db"**
**fields = > articles.schema**
> `store`.init name=articles fields=`fields`
*rows = > store.select table="articles" limit=1*
**rows = > store.select table="articles" limit=1**
1. `rows`
**store**
*store*
2. *
*seed = > articles.seed*
**seed = > articles.seed**
> `store`.insert table=articles rows=`seed`
**store**
*store*
+16 -16
View File
@@ -46,28 +46,28 @@ Article create form (design §5.5): field table + rules table.
| title | max:120 | Title is too long |
| body | max:8000 | Body is too long |
*store = > db.open*
*page = > web.page title="Marqdo Web Site" intro="<h1>Web Site</h1><p>Tables + class methods.</p>"*
*page = > page.compose_components components=home*
*page = > page.compose_main main=index*
**store = > db.open**
**page = > web.page title="Marqdo Web Site" intro="<h1>Web Site</h1><p>Tables + class methods.</p>"**
**page = > page.compose_components components=home**
**page = > page.compose_main main=index**
About page: same shell, different intro (no main bind).
*about = > web.page title="About" intro="<h1>About</h1><p>Marqdo web = tables + class methods.</p>"*
*about = > about.compose_components components=home*
**about = > web.page title="About" intro="<h1>About</h1><p>Marqdo web = tables + class methods.</p>"**
**about = > about.compose_components components=home**
*article_form = > web.form table="articles" action="insert"*
*article_form = > article_form.fields fields=article_fields*
*article_form = > article_form.rules rules=article_rules*
**article_form = > web.form table="articles" action="insert"**
**article_form = > article_form.fields fields=article_fields**
**article_form = > article_form.rules rules=article_rules**
New article: form embedded in the page main slot (design §5.5.4).
*new = > web.page title="New article" intro="<h1>New article</h1><p>Form lives in the main slot.</p>"*
*new = > new.compose_components components=home*
*new = > new.compose_form id="article" form=article_form*
**new = > web.page title="New article" intro="<h1>New article</h1><p>Form lives in the main slot.</p>"**
**new = > new.compose_components components=home**
**new = > new.compose_form id="article" form=article_form**
*app = > web.app page=page db=store admin=True host="127.0.0.1" port=18081*
*app = > app.route path="/about" page=about*
*app = > app.route path="/new" page=new*
*app = > app.static dir="public" mount="/static"*
**app = > web.app page=page db=store admin=True host="127.0.0.1" port=18081**
**app = > app.route path="/about" page=about**
**app = > app.route path="/new" page=new**
**app = > app.static dir="public" mount="/static"**
> `app`.listen
+4 -4
View File
@@ -7,7 +7,7 @@
| background | #ffffff |
| border-bottom | 1px solid #e7e5e4 |
**`topnav`**
*`topnav`*
## side_panel
@@ -17,7 +17,7 @@
|------|-----|
| background | #f5f5f4 |
**`side_panel`**
*`side_panel`*
## card_title
@@ -28,7 +28,7 @@
| font-size | 1.15rem |
| margin | 0 0 0.35rem |
**`card_title`**
*`card_title`*
## card_body
@@ -39,4 +39,4 @@
| color | #57534e |
| margin | 0 |
**`card_body`**
*`card_body`*
+1123 -1123
View File
File diff suppressed because it is too large. Load diff
+28 -28
View File
@@ -12,50 +12,50 @@ import table:lib/table.mq.md
Load `.env` from cwd (optional named arg `path=`). Does not override existing variables.
**> sys.load_dotenv path=`path`**
*> sys.load_dotenv path=`path`*
## stream_result
+ `events`
Reduce a `complete stream=True` event list to the final `done.result` text (or `error.message`). Unknown types (e.g. `reasoning`) are ignored.
*answer = ""*
**answer = ""**
- [ev](events)
*t = ev[^type]*
**t = ev[^type]**
1. `t` == "done"
*answer = ev[^result]*
**answer = ev[^result]**
2. `t` == "error"
*answer = ev[^message]*
**answer = ev[^message]**
3. `t` == "delta"
4. *
*_ = 1*
**_ = 1**
**answer**
*answer*
# llm
Construct an LLM handle from `OPENAI_*` / `MARQDO_LLM_*`.
*api_key = > sys.env_get name="OPENAI_API_KEY"*
**api_key = > sys.env_get name="OPENAI_API_KEY"**
1. not `api_key`
*api_key = > sys.env_get name="MARQDO_LLM_API_KEY"*
**api_key = > sys.env_get name="MARQDO_LLM_API_KEY"**
1. not `api_key`
> print text=ext/ai/llm: set OPENAI_API_KEY or MARQDO_LLM_API_KEY
> sys.exit code=1
*base_url = > sys.env_get name="OPENAI_BASE_URL"*
**base_url = > sys.env_get name="OPENAI_BASE_URL"**
1. not `base_url`
*base_url = > sys.env_get name="MARQDO_LLM_BASE_URL"*
**base_url = > sys.env_get name="MARQDO_LLM_BASE_URL"**
1. not `base_url`
*base_url = "https://api.openai.com/v1"*
**base_url = "https://api.openai.com/v1"**
*model = > sys.env_get name="OPENAI_MODEL"*
**model = > sys.env_get name="OPENAI_MODEL"**
1. not `model`
*model = > sys.env_get name="MARQDO_LLM_MODEL"*
**model = > sys.env_get name="MARQDO_LLM_MODEL"**
1. not `model`
*model = "gpt-4o-mini"*
**model = "gpt-4o-mini"**
`h` =
@@ -63,7 +63,7 @@ Construct an LLM handle from `OPENAI_*` / `MARQDO_LLM_*`.
|---------|----------|-------|--------|--------|
| `api_key` | `base_url` | `model` | /chat/completions | "Bearer " |
**h**
*h*
## complete
+ `prompt`
@@ -74,9 +74,9 @@ Chat completion using `self` handle fields.
Wire body is `{model, messages:[{role,content}], stream?}`. Messages are an `@` row table; headers and optional `stream` use `table.put`. `json` is only for stringify/parse.
*url = self[^base_url] + self[^suffix]*
*auth = self[^bearer] + self[^api_key]*
*headers = > table.put in=None at="Authorization" value=`auth`*
**url = self[^base_url] + self[^suffix]**
**auth = self[^bearer] + self[^api_key]**
**headers = > table.put in=None at="Authorization" value=`auth`**
`messages` =
@@ -91,21 +91,21 @@ Wire body is `{model, messages:[{role,content}], stream?}`. Messages are an `@`
| self[^model] | `messages` |
1. `stream`
*req = > table.put in=`req` at="stream" value=True*
*body = > json.stringify value=`req`*
*resp = > net.http_post_sse url=`url` body=`body` headers=`headers` echo=`echo`*
**req = > table.put in=`req` at="stream" value=True**
**body = > json.stringify value=`req`**
**resp = > net.http_post_sse url=`url` body=`body` headers=`headers` echo=`echo`**
1. resp[^status] == 200
**resp[^events]**
*resp[^events]*
2. *
> print text=ext/ai/llm: HTTP error (stream)
> print text=resp[^status]
> sys.exit code=1
2. *
*body = > json.stringify value=`req`*
*resp = > net.http_post url=`url` body=`body` headers=`headers`*
**body = > json.stringify value=`req`**
**resp = > net.http_post url=`url` body=`body` headers=`headers`**
1. resp[^status] == 200
*data = > json.parse text=resp[^body]*
**data[^choices][^1][^message][^content]**
**data = > json.parse text=resp[^body]**
*data[^choices][^1][^message][^content]*
2. *
> print text=ext/ai/llm: HTTP error
> print text=resp[^status]
@@ -121,4 +121,4 @@ Wire body is `{model, messages:[{role,content}], stream?}`. Messages are an `@`
Alias for `complete`.
**> self.complete prompt=`prompt` stream=`stream` echo=`echo`**
*> self.complete prompt=`prompt` stream=`stream` echo=`echo`*
+28 -28
View File
@@ -12,50 +12,50 @@ import json:lib/json.mq.md
从工作目录加载 `.env`(可选命名实参 `路径=`)。不覆盖已有变量。
**> 系统.加载环境 路径=`路径`**
*> 系统.加载环境 路径=`路径`*
## 流式结果
+ `事件`
把 `运行 流式=真` 的事件列表收成最终 `done.result`(或 `error.message`)。未知类型(如 `reasoning`)忽略。
*answer = ""*
**answer = ""**
- [ev](事件)
*t = ev[^type]*
**t = ev[^type]**
1. `t` == "done"
*answer = ev[^result]*
**answer = ev[^result]**
2. `t` == "error"
*answer = ev[^message]*
**answer = ev[^message]**
3. `t` == "delta"
4. *
*_ = 1*
**_ = 1**
**answer**
*answer*
# 大模型
从 `OPENAI_*` / `MARQDO_LLM_*` 构造句柄。
*api_key = > 系统.取环境 名="OPENAI_API_KEY"*
**api_key = > 系统.取环境 名="OPENAI_API_KEY"**
1. 非 `api_key`
*api_key = > 系统.取环境 名="MARQDO_LLM_API_KEY"*
**api_key = > 系统.取环境 名="MARQDO_LLM_API_KEY"**
1. 非 `api_key`
> 打印 内容=ext/ai/大模型: 请设置 OPENAI_API_KEY 或 MARQDO_LLM_API_KEY
> 系统.退出 码=1
*base_url = > 系统.取环境 名="OPENAI_BASE_URL"*
**base_url = > 系统.取环境 名="OPENAI_BASE_URL"**
1. 非 `base_url`
*base_url = > 系统.取环境 名="MARQDO_LLM_BASE_URL"*
**base_url = > 系统.取环境 名="MARQDO_LLM_BASE_URL"**
1. 非 `base_url`
*base_url = "https://api.openai.com/v1"*
**base_url = "https://api.openai.com/v1"**
*model = > 系统.取环境 名="OPENAI_MODEL"*
**model = > 系统.取环境 名="OPENAI_MODEL"**
1. 非 `model`
*model = > 系统.取环境 名="MARQDO_LLM_MODEL"*
**model = > 系统.取环境 名="MARQDO_LLM_MODEL"**
1. 非 `model`
*model = "gpt-4o-mini"*
**model = "gpt-4o-mini"**
`h` =
@@ -63,7 +63,7 @@ import json:lib/json.mq.md
|---------|----------|-------|--------|--------|
| `api_key` | `base_url` | `model` | /chat/completions | "Bearer " |
**h**
*h*
## 运行
+ `提示`
@@ -74,9 +74,9 @@ import json:lib/json.mq.md
线上 body 为 `{model, messages:[{role,content}], stream?}`。消息用 `@` 行向表;headers 与可选 `stream` 用 `表.改`。`json` 只做 stringify/parse。
*url = 自[^base_url] + 自[^suffix]*
*auth = 自[^bearer] + 自[^api_key]*
*headers = > 表.改 入=None 于="Authorization" 值=`auth`*
**url = 自[^base_url] + 自[^suffix]**
**auth = 自[^bearer] + 自[^api_key]**
**headers = > 表.改 入=None 于="Authorization" 值=`auth`**
`messages` =
@@ -91,21 +91,21 @@ import json:lib/json.mq.md
| 自[^model] | `messages` |
1. `流式`
*req = > 表.改 入=`req` 于="stream" 值=True*
*body = > json.stringify value=`req`*
*resp = > 网络.提交流式 地址=`url` 内容=`body` headers=`headers` 打印增量=`打印增量`*
**req = > 表.改 入=`req` 于="stream" 值=True**
**body = > json.stringify value=`req`**
**resp = > 网络.提交流式 地址=`url` 内容=`body` headers=`headers` 打印增量=`打印增量`**
1. resp[^status] == 200
**resp[^events]**
*resp[^events]*
2. *
> 打印 内容=ext/ai/大模型: HTTP 错误(流式)
> 打印 内容=resp[^status]
> 系统.退出 码=1
2. *
*body = > json.stringify value=`req`*
*resp = > 网络.提交 地址=`url` 内容=`body` headers=`headers`*
**body = > json.stringify value=`req`**
**resp = > 网络.提交 地址=`url` 内容=`body` headers=`headers`**
1. resp[^status] == 200
*data = > json.parse text=resp[^body]*
**data[^choices][^1][^message][^content]**
**data = > json.parse text=resp[^body]**
*data[^choices][^1][^message][^content]*
2. *
> 打印 内容=ext/ai/大模型: HTTP 错误
> 打印 内容=resp[^status]
@@ -121,4 +121,4 @@ import json:lib/json.mq.md
运行 的别名。
**> 自.运行 提示=`提示` 流式=`流式` 打印增量=`打印增量`**
*> 自.运行 提示=`提示` 流式=`流式` 打印增量=`打印增量`*
+83 -83
View File
@@ -16,11 +16,11 @@ import json:lib/json.mq.md
+ `源码深度`=default
+ `技能深度`=default
组装可读提示:站立提示、任务、**调用位置**、工具、**预算**源码 + Skill,以及人可见的行动约定。
组装可读提示:站立提示、任务、*调用位置*、工具、*预算*源码 + Skill,以及人可见的行动约定。
编排 `.mq.md` 即真相源(代码即文档)。默认预算防爆窗;可先 `读取:source|skill` 加深再答或 `调用:`。
实现委托 `agent.build_step_context`(与英文版同源)。
**> agent.build_step_context agent=`智能体` task=`任务` source_depth=`源码深度` skill_depth=`技能深度`**
*> agent.build_step_context agent=`智能体` task=`任务` source_depth=`源码深度` skill_depth=`技能深度`*
---
@@ -29,31 +29,31 @@ import json:lib/json.mq.md
解析人可读调用行:`CALL:<名>` 或 `调用:<名>` / `调用:<名>`。
*esc = > json.parse text={"nl":"\n"}*
*nl = > json.get value=`esc` key="nl"*
*text = > trim value=`回复`*
*lines = > split value=`text` sep=`nl`*
*found = 空*
**esc = > json.parse text={"nl":"\n"}**
**nl = > json.get value=`esc` key="nl"**
**text = > trim value=`回复`**
**lines = > split value=`text` sep=`nl`**
**found = 空**
- [`line`](`lines`)
*t = > trim value=`line`*
*parts = > split value=`t` sep=:*
*n = > len value=`parts`*
**t = > trim value=`line`**
**parts = > split value=`t` sep=:**
**n = > len value=`parts`**
1. `n` > 1
*head = > at value=`parts` index=0*
*head = > trim value=`head`*
*rest = > at value=`parts` index=1*
*rest = > trim value=`rest`*
**head = > at value=`parts` index=0**
**head = > trim value=`head`**
**rest = > at value=`parts` index=1**
**rest = > trim value=`rest`**
1. `head` == CALL
*found = rest*
**found = rest**
2. `head` == 调用
*found = rest*
**found = rest**
3. *
*_ = 1*
**_ = 1**
2. *
*_ = 1*
**_ = 1**
**found**
*found*
---
@@ -63,13 +63,13 @@ import json:lib/json.mq.md
白名单校验后,经 `lib/子任务`(`启动 函数=` → `等待`)调用 runbook 中的 `##`。
*allowed = > agent_tool_allowed tools=`工具` name=`名`*
**allowed = > agent_tool_allowed tools=`工具` name=`名`**
1. `allowed`
*id = > 子任务.启动 函数=`名`*
**> 子任务.等待 id=`id`**
**id = > 子任务.启动 函数=`名`**
*> 子任务.等待 id=`id`*
2. *
*msg = "Tool not allowed:"*
**msg + `名`**
**msg = "Tool not allowed:"**
*msg + `名`*
# 智能体
+ `大模型`
@@ -78,31 +78,31 @@ import json:lib/json.mq.md
加载 ABI v2 agent 插件(会话袋 + 上下文查询)。
*p = > 插件.原生路径 名="agent"*
**p = > 插件.原生路径 名="agent"**
1. `p`
> 插件.加载 路径=`p`
2. *
> 打印 内容=ext/ai/智能体: 未找到原生 agent 插件(请先 cargo build -p marqdo_plugin_agent 或 marqdo ext add agent)
> 系统.退出 码=1
*id = > agent_alloc*
*h = > json.parse text={"_type":"智能体"}*
*h = > json.set map=`h` key="id" value=`id`*
*h = > json.set map=`h` key="model" value=`大模型`*
*h = > json.set map=`h` key="tools" value=`工具`*
**id = > agent_alloc**
**h = > json.parse text={"_type":"智能体"}**
**h = > json.set map=`h` key="id" value=`id`**
**h = > json.set map=`h` key="model" value=`大模型`**
**h = > json.set map=`h` key="tools" value=`工具`**
1. `站立提示`
*h = > json.set map=`h` key="standing" value=`站立提示`*
**h = > json.set map=`h` key="standing" value=`站立提示`**
2. *
*_ = 1*
**_ = 1**
**h**
*h*
## 清空历史
清空本智能体 id 的插件会话袋。
*id = > json.get value=`自` key="id"*
**id = > json.get value=`自` key="id"**
> agent_history_clear id=`id`
****
@@ -112,76 +112,76 @@ import json:lib/json.mq.md
+ `流式`=假
+ `打印增量`=假
原子一轮:上下文 → 大模型 → 可选子任务调工具。返回 **map**(`status`、`task`、`decision`;成功含 `result`,可选 `tool` / `tool_result`;失败含 `error`)。默认(`写回=真`)将结果写入调用行下的命名槽 `ok` / `error`;传 `写回=假` 可关闭。
原子一轮:上下文 → 大模型 → 可选子任务调工具。返回 *map*(`status`、`task`、`decision`;成功含 `result`,可选 `tool` / `tool_result`;失败含 `error`)。默认(`写回=真`)将结果写入调用行下的命名槽 `ok` / `error`;传 `写回=假` 可关闭。
流式=真 时走 SSE;打印增量=真 边读边打印。返回 map 仍是最终 result 文本。
*ctx = > 构建单步上下文 智能体=`自` 任务=`任务`*
*id = > json.get value=`自` key="id"*
*model = > json.get value=`自` key="model"*
*tools = > json.get value=`自` key="tools"*
**ctx = > 构建单步上下文 智能体=`自` 任务=`任务`**
**id = > json.get value=`自` key="id"**
**model = > json.get value=`自` key="model"**
**tools = > json.get value=`自` key="tools"**
*user_turn = > json.parse text={"role":"user"}*
*user_turn = > json.set map=`user_turn` key="content" value=`任务`*
**user_turn = > json.parse text={"role":"user"}**
**user_turn = > json.set map=`user_turn` key="content" value=`任务`**
> agent_history_append id=`id` item=`user_turn`
1. `流式`
*evs = > model.运行 提示=`ctx` 流式=真 打印增量=`打印增量`*
*reply = > 大模型.流式结果 事件=`evs`*
**evs = > model.运行 提示=`ctx` 流式=真 打印增量=`打印增量`**
**reply = > 大模型.流式结果 事件=`evs`**
2. *
*reply = > model.运行 提示=`ctx`*
**reply = > model.运行 提示=`ctx`**
*reply = > trim value=`reply`*
*decision = reply*
*tool_name = > 提取工具名 回复=`reply`*
*out = > json.parse text={"status":"ok"}*
*out = > json.set map=`out` key="task" value=`任务`*
*out = > json.set map=`out` key="decision" value=`decision`*
**reply = > trim value=`reply`**
**decision = reply**
**tool_name = > 提取工具名 回复=`reply`**
**out = > json.parse text={"status":"ok"}**
**out = > json.set map=`out` key="task" value=`任务`**
**out = > json.set map=`out` key="decision" value=`decision`**
1. `tool_name`
*tool_out = > 运行工具 工具=`tools` 名=`tool_name`*
*tool_s = > json.stringify value=`tool_out`*
*deny = > split value=`tool_s` sep="Tool not allowed"*
*deny_n = > len value=`deny`*
**tool_out = > 运行工具 工具=`tools` 名=`tool_name`**
**tool_s = > json.stringify value=`tool_out`**
**deny = > split value=`tool_s` sep="Tool not allowed"**
**deny_n = > len value=`deny`**
1. `deny_n` > 1
*out = > json.set map=`out` key="status" value="error"*
*out = > json.set map=`out` key="error" value=`tool_s`*
*reply = tool_s*
**out = > json.set map=`out` key="status" value="error"**
**out = > json.set map=`out` key="error" value=`tool_s`**
**reply = tool_s**
2. *
*task_s = > json.stringify value=`任务`*
*fp = "The user asked:"*
*fp = fp + task_s*
*fp = fp + ". Tool"*
*fp = fp + tool_name*
*fp = fp + "ran via subtask and returned:"*
*fp = fp + tool_s*
*fp = fp + ". Reply to the user briefly."*
**task_s = > json.stringify value=`任务`**
**fp = "The user asked:"**
**fp = fp + task_s**
**fp = fp + ". Tool"**
**fp = fp + tool_name**
**fp = fp + "ran via subtask and returned:"**
**fp = fp + tool_s**
**fp = fp + ". Reply to the user briefly."**
1. `流式`
*evs2 = > model.运行 提示=`fp` 流式=真 打印增量=`打印增量`*
*reply = > 大模型.流式结果 事件=`evs2`*
**evs2 = > model.运行 提示=`fp` 流式=真 打印增量=`打印增量`**
**reply = > 大模型.流式结果 事件=`evs2`**
2. *
*reply = > model.运行 提示=`fp`*
*out = > json.set map=`out` key="tool" value=`tool_name`*
*out = > json.set map=`out` key="tool_result" value=`tool_s`*
*out = > json.set map=`out` key="result" value=`reply`*
**reply = > model.运行 提示=`fp`**
**out = > json.set map=`out` key="tool" value=`tool_name`**
**out = > json.set map=`out` key="tool_result" value=`tool_s`**
**out = > json.set map=`out` key="result" value=`reply`**
2. *
*out = > json.set map=`out` key="result" value=`reply`*
**out = > json.set map=`out` key="result" value=`reply`**
*as_turn = > json.parse text={"role":"assistant"}*
*as_turn = > json.set map=`as_turn` key="content" value=`reply`*
**as_turn = > json.parse text={"role":"assistant"}**
**as_turn = > json.set map=`as_turn` key="content" value=`reply`**
> agent_history_append id=`id` item=`as_turn`
1. `写回`
*body = > json.stringify value=`out`*
*st = > json.get value=`out` key="status"*
**body = > json.stringify value=`out`**
**st = > json.get value=`out` key="status"**
1. `st` == "ok"
> 自写回.写回 值=`body` 键="ok"
2. *
> 自写回.写回 值=`body` 键="error"
2. *
*_ = 1*
**_ = 1**
**out**
*out*
## 多步
+ `目标`
@@ -207,8 +207,8 @@ import json:lib/json.mq.md
多步工作簿默认写入 OKF `知识库目录/resources/<slug>.mq.md`;仅当传入 `工作簿目录` 时才用临时 runs。转发至英文 `agent.plan`。`流式` / `打印增量` / `轨迹` 对应 `stream` / `echo` / `trace`;`软命中` → `soft_match`;`近义命中` / `近义阈值` → `near_match` / `near_threshold`。
*model = > json.get value=`self` key="model"*
*tools = > json.get value=`self` key="tools"*
*standing = > json.get value=`self` key="standing"*
*en = > agent.agent model=`model` tools=`tools` standing=`standing`*
**> en.plan goal=`目标` workbook_dir=`工作簿目录` workbook=`工作簿` max_rounds=`最大轮次` confirm=`确认分解` writeback=`写回` skeleton=`骨架` reuse=`复用` optimize=`优化` force=`强制` soft_match=`软命中` near_match=`近义命中` near_threshold=`近义阈值` promote=`晋升` kb_dir=`知识库目录` improve_every=`改进周期` explore_n=`探索次数` stream=`流式` echo=`打印增量` trace=`轨迹`**
**model = > json.get value=`self` key="model"**
**tools = > json.get value=`self` key="tools"**
**standing = > json.get value=`self` key="standing"**
**en = > agent.agent model=`model` tools=`tools` standing=`standing`**
*> en.plan goal=`目标` workbook_dir=`工作簿目录` workbook=`工作簿` max_rounds=`最大轮次` confirm=`确认分解` writeback=`写回` skeleton=`骨架` reuse=`复用` optimize=`优化` force=`强制` soft_match=`软命中` near_match=`近义命中` near_threshold=`近义阈值` promote=`晋升` kb_dir=`知识库目录` improve_every=`改进周期` explore_n=`探索次数` stream=`流式` echo=`打印增量` trace=`轨迹`*
+58 -58
View File
@@ -9,7 +9,7 @@ import sys:lib/sys.mq.md
Load the ABI v2 `linalg` plugin once.
*p = > plugin.native_path name="linalg"*
**p = > plugin.native_path name="linalg"**
1. `p`
> plugin.load path=`p`
2. *
@@ -20,7 +20,7 @@ Load the ABI v2 `linalg` plugin once.
## ping
> ensure_plugin
**> linalg_ping**
*> linalg_ping*
## mul
+ `a`
@@ -29,27 +29,27 @@ Load the ABI v2 `linalg` plugin once.
Matrix product (lazy MatMul; shape-checked).
> ensure_plugin
**> linalg_mul a=`a` b=`b`**
*> linalg_mul a=`a` b=`b`*
## add
+ `a`
+ `b`
> ensure_plugin
**> linalg_add a=`a` b=`b`**
*> linalg_add a=`a` b=`b`*
## sub
+ `a`
+ `b`
> ensure_plugin
**> linalg_sub a=`a` b=`b`**
*> linalg_sub a=`a` b=`b`*
## transpose
+ `expr`
> ensure_plugin
**> linalg_transpose expr=`expr`**
*> linalg_transpose expr=`expr`*
## inv
+ `expr`
@@ -57,7 +57,7 @@ Matrix product (lazy MatMul; shape-checked).
Symbolic inverse (lazy).
> ensure_plugin
**> linalg_inv expr=`expr`**
*> linalg_inv expr=`expr`*
## simplify
+ `expr`
@@ -65,29 +65,29 @@ Symbolic inverse (lazy).
Apply MatExpr rewrite rules (R1–R5).
> ensure_plugin
**> linalg_simplify expr=`expr`**
*> linalg_simplify expr=`expr`*
## ascii
+ `expr`
+ `raw`=False
Display ASCII (default **simplify** first). Pass `raw=True` to keep the written tree.
Display ASCII (default simplify first). Pass `raw=True` to keep the written tree.
> ensure_plugin
**> linalg_ascii expr=`expr` raw=`raw`**
*> linalg_ascii expr=`expr` raw=`raw`*
## latex
+ `expr`
+ `raw`=False
> ensure_plugin
**> linalg_latex expr=`expr` raw=`raw`**
*> linalg_latex expr=`expr` raw=`raw`*
## shape
+ `expr`
> ensure_plugin
**> linalg_shape expr=`expr`**
*> linalg_shape expr=`expr`*
## show
+ `expr`
@@ -97,20 +97,20 @@ Display ASCII (default **simplify** first). Pass `raw=True` to keep the written
Record a formula SVG via host plot channel (default simplify). Returns the expr map.
> ensure_plugin
**> linalg_show expr=`expr` path=`path` raw=`raw`**
*> linalg_show expr=`expr` path=`path` raw=`raw`*
## eye
+ `n`
> ensure_plugin
**> linalg_eye n=`n`**
*> linalg_eye n=`n`*
## zeros
+ `rows`
+ `cols`
> ensure_plugin
**> linalg_zeros rows=`rows` cols=`cols`**
*> linalg_zeros rows=`rows` cols=`cols`*
## from_list
+ `data`
@@ -118,7 +118,7 @@ Record a formula SVG via host plot channel (default simplify). Returns the expr
Dense leaf from nested list.
> ensure_plugin
**> linalg_from_list data=`data`**
*> linalg_from_list data=`data`*
## from_formula
+ `formula`
@@ -126,28 +126,28 @@ Dense leaf from nested list.
Absorb a `$$` numeric matrix formula (or nested list / dense map) as a dense leaf.
> ensure_plugin
**> linalg_from_formula formula=`formula`**
*> linalg_from_formula formula=`formula`*
## explicit
+ `expr`
+ `raw`=False
Evaluate to dense (default **simplify** first).
Evaluate to dense (default simplify first).
> ensure_plugin
**> linalg_explicit expr=`expr` raw=`raw`**
*> linalg_explicit expr=`expr` raw=`raw`*
## det
+ `expr`
> ensure_plugin
**> linalg_det expr=`expr`**
*> linalg_det expr=`expr`*
## trace
+ `expr`
> ensure_plugin
**> linalg_trace expr=`expr`**
*> linalg_trace expr=`expr`*
## solve
+ `a`=None
@@ -157,7 +157,7 @@ Evaluate to dense (default **simplify** first).
Solve `a x = b` (Gaussian elimination), or reuse `factorize kind=lu` via `factor` + `b`.
> ensure_plugin
**> linalg_solve a=`a` b=`b` factor=`factor`**
*> linalg_solve a=`a` b=`b` factor=`factor`*
## matmul
+ `a`
@@ -166,7 +166,7 @@ Solve `a x = b` (Gaussian elimination), or reuse `factorize kind=lu` via `factor
Dense matrix product → `linalg_dense`.
> ensure_plugin
**> linalg_matmul a=`a` b=`b`**
*> linalg_matmul a=`a` b=`b`*
## kron
+ `a`
@@ -175,7 +175,7 @@ Dense matrix product → `linalg_dense`.
Lazy Kronecker product (does not expand).
> ensure_plugin
**> linalg_kron a=`a` b=`b`**
*> linalg_kron a=`a` b=`b`*
## block
+ `blocks`
@@ -183,7 +183,7 @@ Lazy Kronecker product (does not expand).
Block matrix from a nested list of expressions.
> ensure_plugin
**> linalg_block blocks=`blocks`**
*> linalg_block blocks=`blocks`*
## collapse
+ `expr`
@@ -191,7 +191,7 @@ Block matrix from a nested list of expressions.
Block-level collapse (`Block*Block` → block of products).
> ensure_plugin
**> linalg_collapse expr=`expr`**
*> linalg_collapse expr=`expr`*
## factorize
+ `matrix`
@@ -200,7 +200,7 @@ Block-level collapse (`Block*Block` → block of products).
Dense factorization → `linalg_factor` (`kind` = `lu` | `qr` | `svd` | `eig` | `chol`).
> ensure_plugin
**> linalg_factorize matrix=`matrix` kind=`kind`**
*> linalg_factorize matrix=`matrix` kind=`kind`*
## draw
+ `factor`
@@ -211,7 +211,7 @@ Dense factorization → `linalg_factor` (`kind` = `lu` | `qr` | `svd` | `eig` |
Structure SVG (`eig` | `svd` | `qr` | `lu` | `ge` | `chol` | `structure` | `heatmap` | `hinton`). Theme tokens match quantum Q8: `light` | `dark` | `bw`.
> ensure_plugin
**> linalg_draw factor=`factor` kind=`kind` path=`path` theme=`theme`**
*> linalg_draw factor=`factor` kind=`kind` path=`path` theme=`theme`*
## lstsq
+ `a`
@@ -220,7 +220,7 @@ Structure SVG (`eig` | `svd` | `qr` | `lu` | `ge` | `chol` | `structure` | `heat
Least squares `min ||a x - b||` (QR if tall, SVD if wide).
> ensure_plugin
**> linalg_lstsq a=`a` b=`b`**
*> linalg_lstsq a=`a` b=`b`*
## norm
+ `expr`
@@ -229,7 +229,7 @@ Least squares `min ||a x - b||` (QR if tall, SVD if wide).
Matrix norm: `fro` | `1` | `inf` | `2`. Complex dense supports `fro` only.
> ensure_plugin
**> linalg_norm expr=`expr` ord=`ord`**
*> linalg_norm expr=`expr` ord=`ord`*
## cond
+ `expr`
@@ -237,7 +237,7 @@ Matrix norm: `fro` | `1` | `inf` | `2`. Complex dense supports `fro` only.
Spectral condition number via SVD (`ord=2`).
> ensure_plugin
**> linalg_cond expr=`expr`**
*> linalg_cond expr=`expr`*
## rank
+ `expr`
@@ -245,7 +245,7 @@ Spectral condition number via SVD (`ord=2`).
Numerical rank (SVD).
> ensure_plugin
**> linalg_rank expr=`expr`**
*> linalg_rank expr=`expr`*
## declare
+ `table`
@@ -253,7 +253,7 @@ Numerical rank (SVD).
Declare several matrix symbols from an `@` record table (`name` / `rows` / `cols`). Returns a map env.
> ensure_plugin
**> linalg_declare table=`table` type_tag="matrix"**
*> linalg_declare table=`table` type_tag="matrix"*
## symbol
+ `name`
@@ -263,7 +263,7 @@ Declare several matrix symbols from an `@` record table (`name` / `rows` / `cols
Abstract matrix symbol. Returns a `# matrix` instance (supports `+` / `*` and methods).
> ensure_plugin
**> matrix name=`name` rows=`rows` cols=`cols`**
*> matrix name=`name` rows=`rows` cols=`cols`*
# matrix
+ `name`=None
@@ -277,96 +277,96 @@ Matrix value (`_type=matrix`). Prefer infix `A + B` / `A * B`, or methods `` `A`
> ensure_plugin
1. `formula`
**> linalg_from_formula formula=`formula`**
*> linalg_from_formula formula=`formula`*
2. `data`
**> linalg_from_list data=`data`**
*> linalg_from_list data=`data`*
3. `name`
**> linalg_symbol name=`name` rows=`rows` cols=`cols`**
*> linalg_symbol name=`name` rows=`rows` cols=`cols`*
4. `n`
**> linalg_eye n=`n`**
*> linalg_eye n=`n`*
5. `rows`
**> linalg_zeros rows=`rows` cols=`cols`**
*> linalg_zeros rows=`rows` cols=`cols`*
6. *
> print text=ext/linalg: matrix needs name= / data= / formula= / n= / rows=
**None**
*None*
## T
**> linalg_transpose expr=`self`**
*> linalg_transpose expr=`self`*
## T_ascii
Transpose then display ASCII (auto-simplified). Handy for lecture identities.
*`Pt` = > linalg_transpose expr=`self`*
**> linalg_ascii expr=`Pt` raw=False**
**`Pt` = > linalg_transpose expr=`self`**
*> linalg_ascii expr=`Pt` raw=False*
## add
+ `b`
**> linalg_add a=`self` b=`b`**
*> linalg_add a=`self` b=`b`*
## sub
+ `b`
**> linalg_sub a=`self` b=`b`**
*> linalg_sub a=`self` b=`b`*
## mul
+ `b`
**> linalg_mul a=`self` b=`b`**
*> linalg_mul a=`self` b=`b`*
## inv
**> linalg_inv expr=`self`**
*> linalg_inv expr=`self`*
## simplify
**> linalg_simplify expr=`self`**
*> linalg_simplify expr=`self`*
## ascii
**> linalg_ascii expr=`self` raw=False**
*> linalg_ascii expr=`self` raw=False*
## latex
**> linalg_latex expr=`self` raw=False**
*> linalg_latex expr=`self` raw=False*
## explicit
**> linalg_explicit expr=`self` raw=False**
*> linalg_explicit expr=`self` raw=False*
## det
**> linalg_det expr=`self`**
*> linalg_det expr=`self`*
## trace
**> linalg_trace expr=`self`**
*> linalg_trace expr=`self`*
## show
+ `path`=None
+ `raw`=False
**> linalg_show expr=`self` path=`path` raw=`raw`**
*> linalg_show expr=`self` path=`path` raw=`raw`*
## eye
+ `n`
**> linalg_eye n=`n`**
*> linalg_eye n=`n`*
## zeros
+ `rows`
+ `cols`
**> linalg_zeros rows=`rows` cols=`cols`**
*> linalg_zeros rows=`rows` cols=`cols`*
## from_list
+ `data`
**> linalg_from_list data=`data`**
*> linalg_from_list data=`data`*
## from_formula
+ `formula`
**> linalg_from_formula formula=`formula`**
*> linalg_from_formula formula=`formula`*
+58 -58
View File
@@ -9,7 +9,7 @@ import sys:lib/sys.mq.md
加载 ABI v2 `linalg` 插件一次。
*p = > plugin.native_path name="linalg"*
**p = > plugin.native_path name="linalg"**
1. `p`
> plugin.load path=`p`
2. *
@@ -20,7 +20,7 @@ import sys:lib/sys.mq.md
## 探测
> 确保插件
**> linalg_ping**
*> linalg_ping*
## 乘
+ `左`
@@ -29,33 +29,33 @@ import sys:lib/sys.mq.md
矩阵乘(惰性;检查形状)。
> 确保插件
**> linalg_mul a=`左` b=`右`**
*> linalg_mul a=`左` b=`右`*
## 加
+ `左`
+ `右`
> 确保插件
**> linalg_add a=`左` b=`右`**
*> linalg_add a=`左` b=`右`*
## 减
+ `左`
+ `右`
> 确保插件
**> linalg_sub a=`左` b=`右`**
*> linalg_sub a=`左` b=`右`*
## 转置
+ `式`
> 确保插件
**> linalg_transpose expr=`式`**
*> linalg_transpose expr=`式`*
## 逆
+ `式`
> 确保插件
**> linalg_inv expr=`式`**
*> linalg_inv expr=`式`*
## 化简
+ `式`
@@ -63,29 +63,29 @@ import sys:lib/sys.mq.md
应用矩阵表达式重写规则(R1–R5)。
> 确保插件
**> linalg_simplify expr=`式`**
*> linalg_simplify expr=`式`*
## 文本
+ `式`
+ `原始`=False
展示 ASCII(默认先 **化简**)。`原始=True` 保留书写树。
展示 ASCII(默认先 化简)。`原始=True` 保留书写树。
> 确保插件
**> linalg_ascii expr=`式` raw=`原始`**
*> linalg_ascii expr=`式` raw=`原始`*
## 乳胶
+ `式`
+ `原始`=False
> 确保插件
**> linalg_latex expr=`式` raw=`原始`**
*> linalg_latex expr=`式` raw=`原始`*
## 形状
+ `式`
> 确保插件
**> linalg_shape expr=`式`**
*> linalg_shape expr=`式`*
## 展示
+ `式`
@@ -95,26 +95,26 @@ import sys:lib/sys.mq.md
写入公式 SVG(默认化简)。
> 确保插件
**> linalg_show expr=`式` path=`路径` raw=`原始`**
*> linalg_show expr=`式` path=`路径` raw=`原始`*
## 单位
+ `阶`
> 确保插件
**> linalg_eye n=`阶`**
*> linalg_eye n=`阶`*
## 零阵
+ `行`
+ `列`
> 确保插件
**> linalg_zeros rows=`行` cols=`列`**
*> linalg_zeros rows=`行` cols=`列`*
## 自列表
+ `数据`
> 确保插件
**> linalg_from_list data=`数据`**
*> linalg_from_list data=`数据`*
## 自公式
+ `公式`
@@ -122,28 +122,28 @@ import sys:lib/sys.mq.md
吸收 `$$` 数值矩阵公式为稠密叶。
> 确保插件
**> linalg_from_formula formula=`公式`**
*> linalg_from_formula formula=`公式`*
## 求值
+ `式`
+ `原始`=False
求成稠密(默认先 **化简**)。
求成稠密(默认先 化简)。
> 确保插件
**> linalg_explicit expr=`式` raw=`原始`**
*> linalg_explicit expr=`式` raw=`原始`*
## 行列式
+ `式`
> 确保插件
**> linalg_det expr=`式`**
*> linalg_det expr=`式`*
## 迹
+ `式`
> 确保插件
**> linalg_trace expr=`式`**
*> linalg_trace expr=`式`*
## 求解
+ `左`=None
@@ -153,14 +153,14 @@ import sys:lib/sys.mq.md
解 `左 · x = 右`,或复用 `分解`(`kind=lu`)+ `右`。
> 确保插件
**> linalg_solve a=`左` b=`右` factor=`分解`**
*> linalg_solve a=`左` b=`右` factor=`分解`*
## 稠密乘
+ `左`
+ `右`
> 确保插件
**> linalg_matmul a=`左` b=`右`**
*> linalg_matmul a=`左` b=`右`*
## 克罗内克
+ `左`
@@ -169,7 +169,7 @@ import sys:lib/sys.mq.md
惰性 Kronecker 积(默认不展开)。
> 确保插件
**> linalg_kron a=`左` b=`右`**
*> linalg_kron a=`左` b=`右`*
## 分块
+ `块`
@@ -177,7 +177,7 @@ import sys:lib/sys.mq.md
由嵌套表达式列表构造分块矩阵。
> 确保插件
**> linalg_block blocks=`块`**
*> linalg_block blocks=`块`*
## 分块化简
+ `式`
@@ -185,7 +185,7 @@ import sys:lib/sys.mq.md
分块级塌缩(`Block*Block` → 块乘加)。
> 确保插件
**> linalg_collapse expr=`式`**
*> linalg_collapse expr=`式`*
## 分解
+ `矩阵`
@@ -194,7 +194,7 @@ import sys:lib/sys.mq.md
稠密分解 → `linalg_factor`(`类型` = `lu` | `qr` | `svd` | `eig` | `chol`)。
> 确保插件
**> linalg_factorize matrix=`矩阵` kind=`类型`**
*> linalg_factorize matrix=`矩阵` kind=`类型`*
## 绘图
+ `分解`
@@ -205,7 +205,7 @@ import sys:lib/sys.mq.md
结构 SVG(`eig` | `svd` | `qr` | `lu` | `ge` | `chol` | `structure` | `heatmap` | `hinton`)。主题与 quantum Q8 对齐:`light` | `dark` | `bw`。
> 确保插件
**> linalg_draw factor=`分解` kind=`类型` path=`路径` theme=`主题`**
*> linalg_draw factor=`分解` kind=`类型` path=`路径` theme=`主题`*
## 最小二乘
+ `左`
@@ -214,7 +214,7 @@ import sys:lib/sys.mq.md
最小二乘 `min ||左 · x - 右||`(高瘦用 QR,宽用 SVD)。
> 确保插件
**> linalg_lstsq a=`左` b=`右`**
*> linalg_lstsq a=`左` b=`右`*
## 范数
+ `式`
@@ -223,7 +223,7 @@ import sys:lib/sys.mq.md
矩阵范数:`fro` | `1` | `inf` | `2`。复数稠密暂仅 `fro`。
> 确保插件
**> linalg_norm expr=`式` ord=`范数`**
*> linalg_norm expr=`式` ord=`范数`*
## 条件数
+ `式`
@@ -231,7 +231,7 @@ import sys:lib/sys.mq.md
谱条件数(SVD,`ord=2`)。
> 确保插件
**> linalg_cond expr=`式`**
*> linalg_cond expr=`式`*
## 秩
+ `式`
@@ -239,7 +239,7 @@ import sys:lib/sys.mq.md
数值秩(SVD)。
> 确保插件
**> linalg_rank expr=`式`**
*> linalg_rank expr=`式`*
## 声明
+ `表`
@@ -247,7 +247,7 @@ import sys:lib/sys.mq.md
用 `@` 记录表一次声明多个符号矩阵(`名` / `行` / `列`)。返回环境 map。
> 确保插件
**> linalg_declare table=`表` type_tag="矩阵"**
*> linalg_declare table=`表` type_tag="矩阵"*
## 符号
+ `名`
@@ -257,7 +257,7 @@ import sys:lib/sys.mq.md
抽象矩阵符号。返回 `# 矩阵` 实例(可用 `+` / `*` 与方法)。
> 确保插件
**> 矩阵 名=`名` 行=`行` 列=`列`**
*> 矩阵 名=`名` 行=`行` 列=`列`*
# 矩阵
+ `名`=None
@@ -271,97 +271,97 @@ import sys:lib/sys.mq.md
> 确保插件
1. `公式`
**> linalg_from_formula formula=`公式`**
*> linalg_from_formula formula=`公式`*
2. `数据`
**> linalg_from_list data=`数据`**
*> linalg_from_list data=`数据`*
3. `名`
**> linalg_symbol name=`名` rows=`行` cols=`列`**
*> linalg_symbol name=`名` rows=`行` cols=`列`*
4. `阶`
**> linalg_eye n=`阶`**
*> linalg_eye n=`阶`*
5. `行`
**> linalg_zeros rows=`行` cols=`列`**
*> linalg_zeros rows=`行` cols=`列`*
6. *
> print text=ext/linalg: 矩阵需要 名= / 数据= / 公式= / 阶= / 行=
**None**
*None*
## 转置
**> linalg_transpose expr=`self`**
*> linalg_transpose expr=`self`*
## 转置文本
转置后输出 ASCII(默认化简)。适合讲义恒等式验收。
*`转` = > linalg_transpose expr=`self`*
**> linalg_ascii expr=`转` raw=False**
**`转` = > linalg_transpose expr=`self`**
*> linalg_ascii expr=`转` raw=False*
## 加
+ `右`
**> linalg_add a=`self` b=`右`**
*> linalg_add a=`self` b=`右`*
## 减
+ `右`
**> linalg_sub a=`self` b=`右`**
*> linalg_sub a=`self` b=`右`*
## 乘
+ `右`
**> linalg_mul a=`self` b=`右`**
*> linalg_mul a=`self` b=`右`*
## 逆
**> linalg_inv expr=`self`**
*> linalg_inv expr=`self`*
## 化简
**> linalg_simplify expr=`self`**
*> linalg_simplify expr=`self`*
## 文本
**> linalg_ascii expr=`self` raw=False**
*> linalg_ascii expr=`self` raw=False*
## 乳胶
**> linalg_latex expr=`self` raw=False**
*> linalg_latex expr=`self` raw=False*
## 求值
+ `原始`=False
**> linalg_explicit expr=`self` raw=`原始`**
*> linalg_explicit expr=`self` raw=`原始`*
## 行列式
**> linalg_det expr=`self`**
*> linalg_det expr=`self`*
## 迹
**> linalg_trace expr=`self`**
*> linalg_trace expr=`self`*
## 展示
+ `路径`=None
+ `原始`=False
**> linalg_show expr=`self` path=`路径` raw=`原始`**
*> linalg_show expr=`self` path=`路径` raw=`原始`*
## 单位
+ `阶`
**> linalg_eye n=`阶`**
*> linalg_eye n=`阶`*
## 零阵
+ `行`
+ `列`
**> linalg_zeros rows=`行` cols=`列`**
*> linalg_zeros rows=`行` cols=`列`*
## 自列表
+ `数据`
**> linalg_from_list data=`数据`**
*> linalg_from_list data=`数据`*
## 自公式
+ `公式`
**> linalg_from_formula formula=`公式`**
*> linalg_from_formula formula=`公式`*
+43 -43
View File
@@ -10,7 +10,7 @@ import json:lib/json.mq.md
Load the ABI v2 `quantum` plugin once.
*p = > plugin.native_path name="quantum"*
**p = > plugin.native_path name="quantum"**
1. `p`
> plugin.load path=`p`
2. *
@@ -25,7 +25,7 @@ Load the ABI v2 `quantum` plugin once.
Tensor product of two states or square matrices.
> ensure_plugin
**> quantum_kron a=`a` b=`b`**
*> quantum_kron a=`a` b=`b`*
## schmidt
+ `state`
@@ -34,7 +34,7 @@ Tensor product of two states or square matrices.
Schmidt decomposition of a pure state / circuit across `cut` (subsystem A = low qubits).
> ensure_plugin
**> quantum_schmidt state=`state` cut=`cut`**
*> quantum_schmidt state=`state` cut=`cut`*
## fidelity
+ `a`
@@ -43,7 +43,7 @@ Schmidt decomposition of a pure state / circuit across `cut` (subsystem A = low
Pure-state fidelity |⟨a|b⟩|².
> ensure_plugin
**> quantum_fidelity a=`a` b=`b`**
*> quantum_fidelity a=`a` b=`b`*
# circuit
+ `qubits`=1
@@ -52,98 +52,98 @@ Pure-state fidelity |⟨a|b⟩|².
State-vector circuit (default |0…0⟩). Optional `steps=` gate table (column or row records). Methods append gates and return an updated handle.
> ensure_plugin
**> quantum_circuit_new qubits=`qubits` steps=`steps`**
*> quantum_circuit_new qubits=`qubits` steps=`steps`*
## h
+ `qubit`=0
**> quantum_h circuit=`self` qubit=`qubit`**
*> quantum_h circuit=`self` qubit=`qubit`*
## x
+ `qubit`=0
**> quantum_x circuit=`self` qubit=`qubit`**
*> quantum_x circuit=`self` qubit=`qubit`*
## y
+ `qubit`=0
**> quantum_y circuit=`self` qubit=`qubit`**
*> quantum_y circuit=`self` qubit=`qubit`*
## z
+ `qubit`=0
**> quantum_z circuit=`self` qubit=`qubit`**
*> quantum_z circuit=`self` qubit=`qubit`*
## s
+ `qubit`=0
**> quantum_s circuit=`self` qubit=`qubit`**
*> quantum_s circuit=`self` qubit=`qubit`*
## t
+ `qubit`=0
**> quantum_t circuit=`self` qubit=`qubit`**
*> quantum_t circuit=`self` qubit=`qubit`*
## i
+ `qubit`=0
**> quantum_i circuit=`self` qubit=`qubit`**
*> quantum_i circuit=`self` qubit=`qubit`*
## rx
+ `qubit`=0
+ `theta`
**> quantum_rx circuit=`self` qubit=`qubit` theta=`theta`**
*> quantum_rx circuit=`self` qubit=`qubit` theta=`theta`*
## ry
+ `qubit`=0
+ `theta`
**> quantum_ry circuit=`self` qubit=`qubit` theta=`theta`**
*> quantum_ry circuit=`self` qubit=`qubit` theta=`theta`*
## rz
+ `qubit`=0
+ `theta`
**> quantum_rz circuit=`self` qubit=`qubit` theta=`theta`**
*> quantum_rz circuit=`self` qubit=`qubit` theta=`theta`*
## cx
+ `control`=0
+ `target`=1
**> quantum_cx circuit=`self` control=`control` target=`target`**
*> quantum_cx circuit=`self` control=`control` target=`target`*
## cz
+ `control`=0
+ `target`=1
**> quantum_cz circuit=`self` control=`control` target=`target`**
*> quantum_cz circuit=`self` control=`control` target=`target`*
## swap
+ `a`=0
+ `b`=1
**> quantum_swap circuit=`self` a=`a` b=`b`**
*> quantum_swap circuit=`self` a=`a` b=`b`*
## barrier
Visual separator only (no state change).
**> quantum_barrier circuit=`self`**
*> quantum_barrier circuit=`self`*
## measure
+ `qubits`=None
Mark computational-basis readout (`None` / empty = all qubits). Affects which bits `run` reports.
**> quantum_measure circuit=`self` qubits=`qubits`**
*> quantum_measure circuit=`self` qubits=`qubits`*
## append
+ `op`
Append another circuit's ops or a `{gate,qubits}` op map.
**> quantum_append circuit=`self` op=`op`**
*> quantum_append circuit=`self` op=`op`*
## apply
+ `gate`
@@ -151,7 +151,7 @@ Append another circuit's ops or a `{gate,qubits}` op map.
Apply a gate handle (named or custom `matrix=`) on `qubits` (int or list).
**> quantum_apply circuit=`self` gate=`gate` qubits=`qubits`**
*> quantum_apply circuit=`self` gate=`gate` qubits=`qubits`*
## noise
+ `kind`
@@ -159,25 +159,25 @@ Apply a gate handle (named or custom `matrix=`) on `qubits` (int or list).
Teaching noise for `run` trajectories (`bitflip` / `depolarizing` / `amplitude_damping`). Ignored by `simulate` / `probabilities`.
**> quantum_noise circuit=`self` kind=`kind` p=`p`**
*> quantum_noise circuit=`self` kind=`kind` p=`p`*
## simulate
Return state vector amplitudes `{re,im}` (ideal; no noise).
**> quantum_simulate circuit=`self`**
*> quantum_simulate circuit=`self`*
## state
Ideal state vector (same amplitudes as `simulate`).
**> quantum_state circuit=`self`**
*> quantum_state circuit=`self`*
## probabilities
Return map of basis label → probability (qubit 0 = rightmost bit). Ideal; ignores noise.
**> quantum_probabilities circuit=`self`**
*> quantum_probabilities circuit=`self`*
## run
+ `shots`=1024
@@ -185,7 +185,7 @@ Return map of basis label → probability (qubit 0 = rightmost bit). Ideal; igno
Sample computational-basis shots (deterministic with `seed=`). Applies circuit `noise` if set.
**> quantum_run circuit=`self` shots=`shots` seed=`seed`**
*> quantum_run circuit=`self` shots=`shots` seed=`seed`*
## draw
+ `path`=None
@@ -195,27 +195,27 @@ Sample computational-basis shots (deterministic with `seed=`). Applies circuit `
Circuit rail / probability bars / Bloch / advanced state plots (`kind=circuit|probs|bloch|hinton|city|density|paulivec|qsphere|multibloch`). Theme `dark` (default tech lab) / `light` / `bw`. Records into view/CLI plots via host `record_plot`.
**> quantum_draw_circuit circuit=`self` path=`path` kind=`kind` qubit=`qubit` theme=`theme`**
*> quantum_draw_circuit circuit=`self` path=`path` kind=`kind` qubit=`qubit` theme=`theme`*
## density
Pure-state density matrix ρ=|ψ⟩⟨ψ| after ideal simulate.
**> density state=`self`**
*> density state=`self`*
## expect
+ `obs`
Pauli string (left = high bit) or matrix expectation on the ideal state.
**> quantum_density_expect density=`self` obs=`obs`**
*> quantum_density_expect density=`self` obs=`obs`*
## schmidt
+ `cut`=1
Schmidt / singular values across a bipartition (`cut` = qubits in subsystem A, low bits).
**> quantum_schmidt state=`self` cut=`cut`**
*> quantum_schmidt state=`self` cut=`cut`*
# gate
+ `name`=None
@@ -225,17 +225,17 @@ Schmidt / singular values across a bipartition (`cut` = qubits in subsystem A, l
Named built-in gate (`name=H`) or custom unitary from `matrix=` (nested list or formula matrix fence). Optional `name=` label for custom gates (default `U`).
> ensure_plugin
**> quantum_gate_new name=`name` theta=`theta` matrix=`matrix`**
*> quantum_gate_new name=`name` theta=`theta` matrix=`matrix`*
## matrix
**> quantum_gate_matrix gate=`self`**
*> quantum_gate_matrix gate=`self`*
## matches_matrix
+ `matrix`
+ `tol`=0.000000001
**> quantum_gate_matches_matrix gate=`self` matrix=`matrix` tol=`tol`**
*> quantum_gate_matches_matrix gate=`self` matrix=`matrix` tol=`tol`*
## draw
+ `path`=None
@@ -243,7 +243,7 @@ Named built-in gate (`name=H`) or custom unitary from `matrix=` (nested list or
Gate glyph or complex-matrix heatmap (`kind=gate|matrix`). Records via host `record_plot`.
**> quantum_gate_draw gate=`self` path=`path` kind=`kind`**
*> quantum_gate_draw gate=`self` path=`path` kind=`kind`*
# density
+ `state`=None
@@ -253,37 +253,37 @@ Density matrix from a state/circuit (`state=`) or an explicit Hermitian `matrix=
> ensure_plugin
1. `matrix`
**> quantum_density_from_matrix matrix=`matrix`**
*> quantum_density_from_matrix matrix=`matrix`*
2. *
**> quantum_density_from_state state=`state`**
*> quantum_density_from_state state=`state`*
## matrix
**> quantum_density_matrix density=`self`**
*> quantum_density_matrix density=`self`*
## purity
Tr(ρ²).
**> quantum_density_purity density=`self`**
*> quantum_density_purity density=`self`*
## partial_trace
+ `keep`
Keep listed qubits (LSB=0); trace out the rest.
**> quantum_density_partial_trace density=`self` keep=`keep`**
*> quantum_density_partial_trace density=`self` keep=`keep`*
## eig
Hermitian spectrum → `{eigenvalues, eigenvectors}`.
**> quantum_density_eig density=`self`**
*> quantum_density_eig density=`self`*
## expect
+ `obs`
**> quantum_density_expect density=`self` obs=`obs`**
*> quantum_density_expect density=`self` obs=`obs`*
## draw
+ `path`=None
@@ -291,4 +291,4 @@ Hermitian spectrum → `{eigenvalues, eigenvectors}`.
Hinton / city / density-cells / Pauli vector SVG (`kind=hinton` or city or density or paulivec).
**> quantum_density_draw density=`self` path=`path` kind=`kind`**
*> quantum_density_draw density=`self` path=`path` kind=`kind`*
+43 -43
View File
@@ -10,7 +10,7 @@ import json:lib/json.mq.md
加载 ABI v2 `quantum` 插件。
*p = > plugin.native_path name="quantum"*
**p = > plugin.native_path name="quantum"**
1. `p`
> plugin.load path=`p`
2. *
@@ -25,14 +25,14 @@ import json:lib/json.mq.md
两态或方阵的张量积。
> 确保插件
**> quantum_kron a=`左` b=`右`**
*> quantum_kron a=`左` b=`右`*
## 施密特分解
+ `态`
+ `分割`=1
> 确保插件
**> quantum_schmidt state=`态` cut=`分割`**
*> quantum_schmidt state=`态` cut=`分割`*
## 保真度
+ `左`
@@ -41,7 +41,7 @@ import json:lib/json.mq.md
纯态保真度 |⟨a|b⟩|²。
> 确保插件
**> quantum_fidelity a=`左` b=`右`**
*> quantum_fidelity a=`左` b=`右`*
# 电路
+ `比特数`=1
@@ -50,98 +50,98 @@ import json:lib/json.mq.md
状态向量电路(默认 |0…0⟩)。可选 `步骤=` 门序列表。方法追加门并返回更新后的句柄。
> 确保插件
**> quantum_circuit_new qubits=`比特数` steps=`步骤`**
*> quantum_circuit_new qubits=`比特数` steps=`步骤`*
## 哈达玛
+ `比特`=0
**> quantum_h circuit=`self` qubit=`比特`**
*> quantum_h circuit=`self` qubit=`比特`*
## 泡利X
+ `比特`=0
**> quantum_x circuit=`self` qubit=`比特`**
*> quantum_x circuit=`self` qubit=`比特`*
## 泡利Y
+ `比特`=0
**> quantum_y circuit=`self` qubit=`比特`**
*> quantum_y circuit=`self` qubit=`比特`*
## 泡利Z
+ `比特`=0
**> quantum_z circuit=`self` qubit=`比特`**
*> quantum_z circuit=`self` qubit=`比特`*
## 相位S
+ `比特`=0
**> quantum_s circuit=`self` qubit=`比特`**
*> quantum_s circuit=`self` qubit=`比特`*
## 相位T
+ `比特`=0
**> quantum_t circuit=`self` qubit=`比特`**
*> quantum_t circuit=`self` qubit=`比特`*
## 单位
+ `比特`=0
**> quantum_i circuit=`self` qubit=`比特`**
*> quantum_i circuit=`self` qubit=`比特`*
## 绕X
+ `比特`=0
+ `参数`
**> quantum_rx circuit=`self` qubit=`比特` theta=`参数`**
*> quantum_rx circuit=`self` qubit=`比特` theta=`参数`*
## 绕Y
+ `比特`=0
+ `参数`
**> quantum_ry circuit=`self` qubit=`比特` theta=`参数`**
*> quantum_ry circuit=`self` qubit=`比特` theta=`参数`*
## 绕Z
+ `比特`=0
+ `参数`
**> quantum_rz circuit=`self` qubit=`比特` theta=`参数`**
*> quantum_rz circuit=`self` qubit=`比特` theta=`参数`*
## 控非
+ `控制`=0
+ `目标`=1
**> quantum_cx circuit=`self` control=`控制` target=`目标`**
*> quantum_cx circuit=`self` control=`控制` target=`目标`*
## 控相
+ `控制`=0
+ `目标`=1
**> quantum_cz circuit=`self` control=`控制` target=`目标`**
*> quantum_cz circuit=`self` control=`控制` target=`目标`*
## 交换
+ `比特甲`=0
+ `比特乙`=1
**> quantum_swap circuit=`self` a=`比特甲` b=`比特乙`**
*> quantum_swap circuit=`self` a=`比特甲` b=`比特乙`*
## 屏障
仅可视化分隔(不改态)。
**> quantum_barrier circuit=`self`**
*> quantum_barrier circuit=`self`*
## 测量
+ `比特`=None
标记计算基读出(空 = 全部比特)。影响 `运行` 报告哪些位。
**> quantum_measure circuit=`self` qubits=`比特`**
*> quantum_measure circuit=`self` qubits=`比特`*
## 追加
+ `操作`
追加另一电路的 ops,或 `{gate,qubits}` 操作表。
**> quantum_append circuit=`self` op=`操作`**
*> quantum_append circuit=`self` op=`操作`*
## 施加
+ `门`
@@ -149,7 +149,7 @@ import json:lib/json.mq.md
将门句柄(具名或 `矩阵=` 自定义)施加到 `比特`(整数或列表)。
**> quantum_apply circuit=`self` gate=`门` qubits=`比特`**
*> quantum_apply circuit=`self` gate=`门` qubits=`比特`*
## 噪声
+ `种类`
@@ -157,25 +157,25 @@ import json:lib/json.mq.md
教学噪声,供 `运行` 轨迹使用(`bitflip` / `depolarizing` / `amplitude_damping`,或中文:比特翻转 / 退极化 / 振幅阻尼)。`模拟` / `概率` 忽略。
**> quantum_noise circuit=`self` kind=`种类` p=`概率`**
*> quantum_noise circuit=`self` kind=`种类` p=`概率`*
## 模拟
返回态矢量振幅 `{re,im}`(理想;无噪声)。
**> quantum_simulate circuit=`self`**
*> quantum_simulate circuit=`self`*
## 态
理想态矢量(与 `模拟` 相同振幅)。
**> quantum_state circuit=`self`**
*> quantum_state circuit=`self`*
## 概率
基矢标签 → 概率(qubit 0 为最右侧比特)。理想;忽略噪声。
**> quantum_probabilities circuit=`self`**
*> quantum_probabilities circuit=`self`*
## 运行
+ `次数`=1024
@@ -183,7 +183,7 @@ import json:lib/json.mq.md
计算基采样(`种子=` 可复现)。若设置了电路噪声则启用。
**> quantum_run circuit=`self` shots=`次数` seed=`种子`**
*> quantum_run circuit=`self` shots=`次数` seed=`种子`*
## 绘图
+ `路径`=None
@@ -193,27 +193,27 @@ import json:lib/json.mq.md
电路轨线 / 概率条 / 布洛赫 / 高级态图(种类 circuit、probs、bloch、hinton、city、density、paulivec、qsphere、multibloch)。主题 dark(默认科技感)/ light / bw。经 record_plot 进入 view/CLI plots。
**> quantum_draw_circuit circuit=`self` path=`路径` kind=`种类` qubit=`比特` theme=`主题`**
*> quantum_draw_circuit circuit=`self` path=`路径` kind=`种类` qubit=`比特` theme=`主题`*
## 密度
理想模拟后的纯态密度矩阵 ρ=|ψ⟩⟨ψ|。
**> 密度 态=`self`**
*> 密度 态=`self`*
## 期望
+ `可观测量`
Pauli 串(左端=高比特)或矩阵期望值。
**> quantum_density_expect density=`self` obs=`可观测量`**
*> quantum_density_expect density=`self` obs=`可观测量`*
## 施密特
+ `分割`=1
二分施密特分解(`分割`=子系统 A 的比特数,低位)。
**> quantum_schmidt state=`self` cut=`分割`**
*> quantum_schmidt state=`self` cut=`分割`*
# 门
+ `名`=None
@@ -223,17 +223,17 @@ Pauli 串(左端=高比特)或矩阵期望值。
具名内置门(`名=H`)或由 `矩阵=`(嵌套 list 或公式矩阵围栏)定义的自定义酉门。自定义门可选 `名=`(默认 `U`)。
> 确保插件
**> quantum_gate_new name=`名` theta=`参数` matrix=`矩阵`**
*> quantum_gate_new name=`名` theta=`参数` matrix=`矩阵`*
## 矩阵
**> quantum_gate_matrix gate=`self`**
*> quantum_gate_matrix gate=`self`*
## 匹配矩阵
+ `矩阵`
+ `容差`=0.000000001
**> quantum_gate_matches_matrix gate=`self` matrix=`矩阵` tol=`容差`**
*> quantum_gate_matches_matrix gate=`self` matrix=`矩阵` tol=`容差`*
## 绘图
+ `路径`=None
@@ -241,7 +241,7 @@ Pauli 串(左端=高比特)或矩阵期望值。
门符号或复矩阵热力图(`种类=gate|matrix`)。经 `record_plot` 记录。
**> quantum_gate_draw gate=`self` path=`路径` kind=`种类`**
*> quantum_gate_draw gate=`self` path=`路径` kind=`种类`*
# 密度
+ `态`=None
@@ -251,37 +251,37 @@ Pauli 串(左端=高比特)或矩阵期望值。
> 确保插件
1. `矩阵`
**> quantum_density_from_matrix matrix=`矩阵`**
*> quantum_density_from_matrix matrix=`矩阵`*
2. *
**> quantum_density_from_state state=`态`**
*> quantum_density_from_state state=`态`*
## 矩阵
**> quantum_density_matrix density=`self`**
*> quantum_density_matrix density=`self`*
## 纯度
Tr(ρ²)。
**> quantum_density_purity density=`self`**
*> quantum_density_purity density=`self`*
## 部分迹
+ `保留`
保留所列比特(LSB=0),对其余求迹。
**> quantum_density_partial_trace density=`self` keep=`保留`**
*> quantum_density_partial_trace density=`self` keep=`保留`*
## 本征
厄米谱 → `{eigenvalues, eigenvectors}`。
**> quantum_density_eig density=`self`**
*> quantum_density_eig density=`self`*
## 期望
+ `可观测量`
**> quantum_density_expect density=`self` obs=`可观测量`**
*> quantum_density_expect density=`self` obs=`可观测量`*
## 绘图
+ `路径`=None
@@ -289,4 +289,4 @@ Tr(ρ²)。
Hinton / 城市 / 密度格 / 泡利向量 SVG(`种类=hinton` 或 city / density / paulivec)。
**> quantum_density_draw density=`self` path=`路径` kind=`种类`**
*> quantum_density_draw density=`self` path=`路径` kind=`种类`*
+187 -187
View File
@@ -10,7 +10,7 @@ import table:lib/table.mq.md
Load the ABI v2 `web` plugin once.
*p = > plugin.native_path name="web"*
**p = > plugin.native_path name="web"**
1. `p`
> plugin.load path=`p`
2. *
@@ -36,7 +36,7 @@ For complex themes prefer `page.css` (raw string, no table eval) or an external
them into CSS — 样式即数据、装配即函数.
> ensure_plugin
**> web_style name=`name` table=`table` strict=`strict`**
*> web_style name=`name` table=`table` strict=`strict`*
## make_images
+ `table`
@@ -47,7 +47,7 @@ Assemble a GFM image table into an HTML fragment (`div.mq-images` of
`链接`/`宽度`/`高度`/`加载`/`图注`). Images stay as data — 图片即数据、装配即函数.
> ensure_plugin
**> web_images table=`table`**
*> web_images table=`table`*
## make_head
+ `table`
@@ -56,7 +56,7 @@ Assemble a Head resource table into HTML (`<link>` / `<script>`). Useful for
preview; prefer `page.head` to attach resources to a page.
> ensure_plugin
**> web_head table=`table`**
*> web_head table=`table`*
## client_embed
+ `bridge`="/static/marqdo-bridge.js"
@@ -65,16 +65,16 @@ preview; prefer `page.head` to attach resources to a page.
+ `boot`=True
Return an HTML snippet that loads the official browser Marqdo bridge (route C/D).
With `boot` and non-empty `source` (URL path to `.mq.md`), emits `data-mq-wasm` / `data-mq-source-url` so the bridge **auto-mounts** (author zero JS).
With `boot` and non-empty `source` (URL path to `.mq.md`), emits `data-mq-wasm` / `data-mq-source-url` so the bridge auto-mounts (author zero JS).
Run `marqdo wasm build -o static` and `app.static dir=static`. Design: [browser-marqdo-wasm.md](../../doc/design/browser-marqdo-wasm.md) §16.
1. `boot`
1. `source` != ""
**"<script type=\"module\" src=\"" + bridge + "\" data-mq-wasm=\"" + wasm + "\" data-mq-source-url=\"" + source + "\"></script>"**
*"<script type=\"module\" src=\"" + bridge + "\" data-mq-wasm=\"" + wasm + "\" data-mq-source-url=\"" + source + "\"></script>"*
2. *
**"<script type=\"module\" src=\"" + bridge + "\"></script>"**
*"<script type=\"module\" src=\"" + bridge + "\"></script>"*
2. *
**"<script type=\"module\" src=\"" + bridge + "\" data-mq-no-boot=\"1\"></script>"**
*"<script type=\"module\" src=\"" + bridge + "\" data-mq-no-boot=\"1\"></script>"*
## text_patch
+ `sel`
@@ -83,8 +83,8 @@ Run `marqdo wasm build -o static` and `app.static dir=static`. Design: [browser-
Shortcut: build a `set_text` effects map `{ set_text: { sel: text } }` for browser return values.
Prefer authoring with `lib/browser` + GFM tables in client `.mq.md` ([marqdo-dev](../../.cursor/skills/marqdo-dev/SKILL.md)).
*`m` = > table.put in=None at=sel value=text*
**> table.put in=None at="set_text" value=m**
**`m` = > table.put in=None at=sel value=text**
*> table.put in=None at="set_text" value=m*
## dom_patch
+ `set_text`=None
@@ -115,58 +115,58 @@ Prefer authoring with `lib/browser` + GFM tables in client `.mq.md` ([marqdo-dev
Merge browser effect keys into one return map (omit `None`). Route E/F effects included.
*`out` = > table.put in=None at="_mq" value=True*
**`out` = > table.put in=None at="_mq" value=True**
1. `set_text` != None
*`out` = > table.put in=`out` at="set_text" value=set_text*
**`out` = > table.put in=`out` at="set_text" value=set_text**
1. `set_value` != None
*`out` = > table.put in=`out` at="set_value" value=set_value*
**`out` = > table.put in=`out` at="set_value" value=set_value**
1. `set_attr` != None
*`out` = > table.put in=`out` at="set_attr" value=set_attr*
**`out` = > table.put in=`out` at="set_attr" value=set_attr**
1. `set_class` != None
*`out` = > table.put in=`out` at="set_class" value=set_class*
**`out` = > table.put in=`out` at="set_class" value=set_class**
1. `toggle_class` != None
*`out` = > table.put in=`out` at="toggle_class" value=toggle_class*
**`out` = > table.put in=`out` at="toggle_class" value=toggle_class**
1. `set_style` != None
*`out` = > table.put in=`out` at="set_style" value=set_style*
**`out` = > table.put in=`out` at="set_style" value=set_style**
1. `set_html` != None
*`out` = > table.put in=`out` at="set_html" value=set_html*
**`out` = > table.put in=`out` at="set_html" value=set_html**
1. `render_list` != None
*`out` = > table.put in=`out` at="render_list" value=render_list*
**`out` = > table.put in=`out` at="render_list" value=render_list**
1. `navigate` != None
*`out` = > table.put in=`out` at="navigate" value=navigate*
**`out` = > table.put in=`out` at="navigate" value=navigate**
1. `storage` != None
*`out` = > table.put in=`out` at="storage" value=storage*
**`out` = > table.put in=`out` at="storage" value=storage**
1. `ws` != None
*`out` = > table.put in=`out` at="ws" value=ws*
**`out` = > table.put in=`out` at="ws" value=ws**
1. `fetch` != None
*`out` = > table.put in=`out` at="fetch" value=fetch*
**`out` = > table.put in=`out` at="fetch" value=fetch**
1. `fetch_all` != None
*`out` = > table.put in=`out` at="fetch_all" value=fetch_all*
**`out` = > table.put in=`out` at="fetch_all" value=fetch_all**
1. `after` != None
*`out` = > table.put in=`out` at="after" value=after*
**`out` = > table.put in=`out` at="after" value=after**
1. `interval` != None
*`out` = > table.put in=`out` at="interval" value=interval*
**`out` = > table.put in=`out` at="interval" value=interval**
1. `clear_interval` != None
*`out` = > table.put in=`out` at="clear_interval" value=clear_interval*
**`out` = > table.put in=`out` at="clear_interval" value=clear_interval**
1. `focus` != None
*`out` = > table.put in=`out` at="focus" value=focus*
**`out` = > table.put in=`out` at="focus" value=focus**
1. `blur` != None
*`out` = > table.put in=`out` at="blur" value=blur*
**`out` = > table.put in=`out` at="blur" value=blur**
1. `scroll_into` != None
*`out` = > table.put in=`out` at="scroll_into" value=scroll_into*
**`out` = > table.put in=`out` at="scroll_into" value=scroll_into**
1. `canvas` != None
*`out` = > table.put in=`out` at="canvas" value=canvas*
**`out` = > table.put in=`out` at="canvas" value=canvas**
1. `audio` != None
*`out` = > table.put in=`out` at="audio" value=audio*
**`out` = > table.put in=`out` at="audio" value=audio**
1. `read_file` != None
*`out` = > table.put in=`out` at="read_file" value=read_file*
**`out` = > table.put in=`out` at="read_file" value=read_file**
1. `observe` != None
*`out` = > table.put in=`out` at="observe" value=observe*
**`out` = > table.put in=`out` at="observe" value=observe**
1. `unobserve` != None
*`out` = > table.put in=`out` at="unobserve" value=unobserve*
**`out` = > table.put in=`out` at="unobserve" value=unobserve**
1. `wire` != None
*`out` = > table.put in=`out` at="wire" value=wire*
**out**
**`out` = > table.put in=`out` at="wire" value=wire**
*out*
## list_html
+ `sel`
@@ -175,10 +175,10 @@ Merge browser effect keys into one return map (omit `None`). Route E/F effects i
Build a `render_list` effect: `{ render_list: { sel: { tag, items } } }`.
*`spec` = > table.put in=None at="tag" value=tag*
*`spec` = > table.put in=`spec` at="items" value=items*
*`m` = > table.put in=None at=sel value=spec*
**> table.put in=None at="render_list" value=m**
**`spec` = > table.put in=None at="tag" value=tag**
**`spec` = > table.put in=`spec` at="items" value=items**
**`m` = > table.put in=None at=sel value=spec**
*> table.put in=None at="render_list" value=m*
# page
+ `title`="Marqdo Web"
@@ -188,31 +188,31 @@ Build a `render_list` effect: `{ render_list: { sel: { tag, items } } }`.
+ `asset_version`=None
> ensure_plugin
**> web_page_new title=`title` intro=`intro` shell_css=`shell_css` layout=`layout` asset_version=`asset_version`**
*> web_page_new title=`title` intro=`intro` shell_css=`shell_css` layout=`layout` asset_version=`asset_version`*
## shell_css
+ `mode`=full
Framework shell CSS mode for this page: `full` (default), `minimal` (vars only), or `off`/`none`.
*`out` = > table.put in=`self` at="shell_css" value=mode*
**out**
**`out` = > table.put in=`self` at="shell_css" value=mode**
*out*
## layout
+ `layout`=sidebar
Page chrome layout: `sidebar` (default when a side slot exists), `stacked` (single column; no `has-sidebar` grid), `bare` (main only), or `rail`.
*`out` = > table.put in=`self` at="layout" value=layout*
**out**
**`out` = > table.put in=`self` at="layout" value=layout**
*out*
## asset_version
+ `version`=""
Default `?v=` bump for head scripts/styles that omit a per-row `version` column.
*`out` = > table.put in=`self` at="asset_version" value=version*
**out**
**`out` = > table.put in=`self` at="asset_version" value=version**
*out*
## compose_components
+ `components`
@@ -221,14 +221,14 @@ Assemble nav / sidebar / footer from a page table (`|组件|样式|` or `|src|st
Nav bind tables may include optional `媒体`/`media` (responsive show) and `当`/`when`
(`auth` / `guest` / `hide`) columns — see C4 conditional nav.
**> web_compose_components page=`self` components=`components`**
*> web_compose_components page=`self` components=`components`*
## compose_main
+ `main`
Assemble main from a bind table (`|属性|值|样式|` or `|front|back|css|`).
**> web_compose_main page=`self` main=`main`**
*> web_compose_main page=`self` main=`main`*
## query
+ `query`
@@ -236,14 +236,14 @@ Assemble main from a bind table (`|属性|值|样式|` or `|front|back|css|`).
Attach a DB where-condition map for the main bind. Values may contain `{param}`
placeholders that are resolved from dynamic-route params (e.g. `/post/{slug}`).
**> web_page_query page=`self` query=`query`**
*> web_page_query page=`self` query=`query`*
## order
+ `order`
Set a default `ORDER BY` for the main bind (e.g. `-created_at` for newest first).
**> web_page_order page=`self` order=`order`**
*> web_page_order page=`self` order=`order`*
## link_prefix
+ `prefix`
@@ -251,16 +251,16 @@ Set a default `ORDER BY` for the main bind (e.g. `-created_at` for newest first)
Prefix for card links in the main bind (default `/post/`). Cards whose bind has
an `href`/`链接` field become `<a href="{prefix}{href}">`.
**> web_page_link_prefix page=`self` prefix=`prefix`**
*> web_page_link_prefix page=`self` prefix=`prefix`*
## css
+ `css`
Append a **raw** CSS string to the page's stylesheet (`styles_css`). Skips table-cell
Append a *raw* CSS string to the page's stylesheet (`styles_css`). Skips table-cell
expression evaluation — use for themes with `/`, `@keyframes`, or long media queries.
Hand-written theme alongside the assembled shell; or link `static/theme.css` via `head`.
**> web_page_css page=`self` css=`css`**
*> web_page_css page=`self` css=`css`*
## detail
+ `detail`=True
@@ -268,7 +268,7 @@ Hand-written theme alongside the assembled shell; or link `static/theme.css` via
Render the main bind's first row as a full article (title/meta/tags/body) instead
of a list of cards. Set on the dynamic post page so `/post/{slug}` shows one post.
**> web_page_detail page=`self` detail=`detail`**
*> web_page_detail page=`self` detail=`detail`*
## chrome
+ `nav_html`=""
@@ -277,28 +277,28 @@ of a list of cards. Set on the dynamic post page so `/post/{slug}` shows one pos
Override default header/footer list chrome with raw HTML (site navbar / footer). Optional `body_class` is appended to `<body class>`.
**> web_page_chrome page=`self` nav_html=`nav_html` footer_html=`footer_html` body_class=`body_class`**
*> web_page_chrome page=`self` nav_html=`nav_html` footer_html=`footer_html` body_class=`body_class`*
## meta
+ `meta`
SEO / OpenGraph metadata as a data table (`|key|value|`). Keys such as `title`, `description`, `canonical`, `og:type` become `<head>` tags at render time. Special keys `icon` / `favicon` / `apple-touch-icon` emit `<link rel="…">` (not `<meta name>`).
**> web_page_meta page=`self` meta=`meta`**
*> web_page_meta page=`self` meta=`meta`*
## head
+ `table`
Assemble `<head>` resources from a GFM table (`|rel|href|type|sizes|media|as|crossorigin|defer|async|version|` or ZH `|关系|地址|…|推迟|异步|版本|`). `rel=script` / `module` become `<script>`; other rows become `<link>`. Classic scripts emit `defer` / `async` only when those columns are true (compat: missing `defer` stays synchronous). Non-empty `version` appends `?v=`; else page/app `asset_version` is used. Merges with any existing `head` on the page.
**> web_page_head page=`self` table=`table`**
*> web_page_head page=`self` table=`table`*
## images
+ `table`
Assemble an image table (`|src|alt|title|class|href|width|height|loading|caption|`) into HTML and attach it as `images_html` (rendered in main before intro). Same table shape as module-level `make_images`.
**> web_page_images page=`self` table=`table`**
*> web_page_images page=`self` table=`table`*
## paginate
+ `offset`=0
@@ -307,16 +307,16 @@ Assemble an image table (`|src|alt|title|class|href|width|height|loading|caption
List pagination for the main bind: sets DB `limit`/`offset` and renders previous/next navigation.
**> web_page_paginate page=`self` offset=`offset` limit=`limit` path=`path`**
*> web_page_paginate page=`self` offset=`offset` limit=`limit` path=`path`*
## compose_form
+ `form`
+ `id`
+ `target`=None
Embed a form into the page main slot. Optional `target` / `form_slot` (CSS id, e.g. `#qd-note-form-mount`) injects the form **inside** that element in `intro` HTML instead of a sibling `.site-form` after `.main-intro` (GAP-11). Missing mount falls back to sibling. `listen` auto-registers `GET|POST /_form/{id}` from page/route forms (optional `app.mount_form`).
Embed a form into the page main slot. Optional `target` / `form_slot` (CSS id, e.g. `#qd-note-form-mount`) injects the form inside that element in `intro` HTML instead of a sibling `.site-form` after `.main-intro` (GAP-11). Missing mount falls back to sibling. `listen` auto-registers `GET|POST /_form/{id}` from page/route forms (optional `app.mount_form`).
**> web_compose_form page=`self` form=`form` id=`id` target=`target`**
*> web_compose_form page=`self` form=`form` id=`id` target=`target`*
## render
+ `db`=None
@@ -324,24 +324,24 @@ Embed a form into the page main slot. Optional `target` / `form_slot` (CSS id, e
Offline HTML for tests / previews.
1. `db`
*url = db[^url]*
**> web_render page=`self` url=`url`**
**url = db[^url]**
*> web_render page=`self` url=`url`*
2. *
**> web_render page=`self`**
*> web_render page=`self`*
# style
+ `name`=""
Style tables live as `##` exports in site style modules; compose resolves them by path.
**self**
*self*
## process
+ `style`=None
+ `name`=None
+ `path`=None
**self**
*self*
# db
+ `url`="sqlite:site.db"
@@ -349,7 +349,7 @@ Style tables live as `##` exports in site style modules; compose resolves them b
Open a database handle. URL schemes: `sqlite:path` (default), `postgres://…` / `postgresql://…` (same CRUD methods).
> ensure_plugin
**> web_db_new url=`url`**
*> web_db_new url=`url`*
## init
+ `name`
@@ -357,16 +357,16 @@ Open a database handle. URL schemes: `sqlite:path` (default), `postgres://…` /
Create a table from a schema table. Optional columns: `唯一`/`unique`, `索引`/`index` (creates UNIQUE / INDEX), `外键`/`fk`/`references` (e.g. `posts.id` or `posts(id)`). Columns named `created_at` / `updated_at` are filled automatically on insert/update when present.
*url = self[^url]*
**> web_db_init url=`url` name=`name` fields=`fields`**
**url = self[^url]**
*> web_db_init url=`url` name=`name` fields=`fields`*
## insert
+ `table`
+ `rows`
+ `txn`=None
*url = self[^url]*
**> web_db_insert url=`url` table=`table` rows=`rows` txn=`txn`**
**url = self[^url]**
*> web_db_insert url=`url` table=`table` rows=`rows` txn=`txn`*
## select
+ `table`
@@ -377,9 +377,9 @@ Create a table from a schema table. Optional columns: `唯一`/`unique`, `索引
Simple filters: one-row map of column→value (AND `=`), or rows `|字段|操作|值|` (`=` `!=` `>` `>=` `<` `<=` `like` `in` `between` `is null`; add `|或|` = `是` to join a row with `OR`). `order` is a column name with optional `-` prefix for descending (`"created_at"`, `"-created_at"`), comma-separated for multiple keys. Pass `txn` to read inside an open transaction. For pages (with a total), use `paginate`.
*url = self[^url]*
*r = > web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=None txn=`txn`*
**r[^rows]**
**url = self[^url]**
**r = > web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=None txn=`txn`**
*r[^rows]*
## paginate
+ `table`
@@ -391,16 +391,16 @@ Simple filters: one-row map of column→value (AND `=`), or rows `|字段|操作
Like `select` but returns `{ rows, total }` — the total counts rows matching `where` regardless of `limit`/`跳过`, so you can render `上一页 / 下一页`. Set `跳过` to the number of rows to skip (e.g. page 2 with 10 per page ⇒ `跳过`=10).
*url = self[^url]*
**> web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=`跳过` txn=`txn`**
**url = self[^url]**
*> web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=`跳过` txn=`txn`*
## get
+ `table`
+ `id`
+ `txn`=None
*url = self[^url]*
**> web_db_get url=`url` table=`table` id=`id` txn=`txn`**
**url = self[^url]**
*> web_db_get url=`url` table=`table` id=`id` txn=`txn`*
## update
+ `table`
@@ -408,24 +408,24 @@ Like `select` but returns `{ rows, total }` — the total counts rows matching `
+ `row`
+ `txn`=None
*url = self[^url]*
**> web_db_update url=`url` table=`table` id=`id` row=`row` txn=`txn`**
**url = self[^url]**
*> web_db_update url=`url` table=`table` id=`id` row=`row` txn=`txn`*
## delete
+ `table`
+ `id`
+ `txn`=None
*url = self[^url]*
**> web_db_delete url=`url` table=`table` id=`id` txn=`txn`**
**url = self[^url]**
*> web_db_delete url=`url` table=`table` id=`id` txn=`txn`*
## exec
+ `sql`
+ `args`=None
+ `txn`=None
*url = self[^url]*
**> web_db_exec url=`url` sql=`sql` args=`args` txn=`txn`**
**url = self[^url]**
*> web_db_exec url=`url` sql=`sql` args=`args` txn=`txn`*
## query
+ `sql`
@@ -434,8 +434,8 @@ Like `select` but returns `{ rows, total }` — the total counts rows matching `
Run bare SQL and return the result set — count / join / group / subqueries. Returns `{ rows, count }`.
*url = self[^url]*
**> web_db_query url=`url` sql=`sql` args=`args` txn=`txn`**
**url = self[^url]**
*> web_db_query url=`url` sql=`sql` args=`args` txn=`txn`*
## count
+ `table`
@@ -444,17 +444,17 @@ Run bare SQL and return the result set — count / join / group / subqueries. Re
Count rows matching a `where` filter (same syntax as `select`). Returns a number.
*url = self[^url]*
*r = > web_db_count url=`url` table=`table` where=`where` txn=`txn`*
**r[^count]**
**url = self[^url]**
**r = > web_db_count url=`url` table=`table` where=`where` txn=`txn`**
*r[^count]*
## migrate
+ `steps`
Apply versioned SQL migrations. `steps` is a `|version|sql|` / `|版本|SQL|` table. Applied versions are recorded in `_marqdo_migrations`. Re-running is a no-op for already-applied versions. SQLite only.
*url = self[^url]*
**> web_db_migrate url=`url` steps=`steps`**
**url = self[^url]**
*> web_db_migrate url=`url` steps=`steps`*
## fts
+ `table`
@@ -463,8 +463,8 @@ Apply versioned SQL migrations. `steps` is a `|version|sql|` / `|版本|SQL|` ta
Create an FTS5 index on `table` for the listed content columns (CSV string or list). Default FTS name is `{table}_fts`. Keeps the index in sync via triggers. Requires integer `id` PK. SQLite only.
*url = self[^url]*
**> web_db_fts_create url=`url` table=`table` columns=`columns` name=`name`**
**url = self[^url]**
*> web_db_fts_create url=`url` table=`table` columns=`columns` name=`name`*
## search
+ `table`
@@ -474,8 +474,8 @@ Create an FTS5 index on `table` for the listed content columns (CSV string or li
Full-text search (`MATCH`) against the FTS5 index from `fts`. Returns `{ rows, count }` with a `rank` column (bm25). SQLite only.
*url = self[^url]*
**> web_db_search url=`url` table=`table` q=`q` limit=`limit` name=`name`**
**url = self[^url]**
*> web_db_search url=`url` table=`table` q=`q` limit=`limit` name=`name`*
## 事务
@@ -483,8 +483,8 @@ Begin a transaction: borrows the pooled connection exclusively and returns a
`txn` handle. Write inside it, then `提交` (commit) or `回滚` (roll back).
Every statement runs on the same connection, so a batch is atomic.
*url = self[^url]*
**> web_db_begin url=`url`**
**url = self[^url]**
*> web_db_begin url=`url`*
# txn
+ `txn`
@@ -493,15 +493,15 @@ Every statement runs on the same connection, so a batch is atomic.
A transaction handle from `db.事务`. All CRUD here runs on the transaction's
connection; finish with `提交` or `回滚`.
**self**
*self*
## insert
+ `table`
+ `rows`
*url = self[^url]*
*txn = self[^txn]*
**> web_db_insert url=`url` table=`table` rows=`rows` txn=`txn`**
**url = self[^url]**
**txn = self[^txn]**
*> web_db_insert url=`url` table=`table` rows=`rows` txn=`txn`*
## select
+ `table`
@@ -511,57 +511,57 @@ connection; finish with `提交` or `回滚`.
Same filters as `db.select`; runs inside the transaction.
*url = self[^url]*
*txn = self[^txn]*
*r = > web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=None txn=`txn`*
**r[^rows]**
**url = self[^url]**
**txn = self[^txn]**
**r = > web_db_select url=`url` table=`table` where=`where` limit=`limit` order=`order` offset=None txn=`txn`**
*r[^rows]*
## get
+ `table`
+ `id`
*url = self[^url]*
*txn = self[^txn]*
**> web_db_get url=`url` table=`table` id=`id` txn=`txn`**
**url = self[^url]**
**txn = self[^txn]**
*> web_db_get url=`url` table=`table` id=`id` txn=`txn`*
## update
+ `table`
+ `id`
+ `row`
*url = self[^url]*
*txn = self[^txn]*
**> web_db_update url=`url` table=`table` id=`id` row=`row` txn=`txn`**
**url = self[^url]**
**txn = self[^txn]**
*> web_db_update url=`url` table=`table` id=`id` row=`row` txn=`txn`*
## delete
+ `table`
+ `id`
*url = self[^url]*
*txn = self[^txn]*
**> web_db_delete url=`url` table=`table` id=`id` txn=`txn`**
**url = self[^url]**
**txn = self[^txn]**
*> web_db_delete url=`url` table=`table` id=`id` txn=`txn`*
## exec
+ `sql`
+ `args`=None
*url = self[^url]*
*txn = self[^txn]*
**> web_db_exec url=`url` sql=`sql` args=`args` txn=`txn`**
**url = self[^url]**
**txn = self[^txn]**
*> web_db_exec url=`url` sql=`sql` args=`args` txn=`txn`*
## 提交
Commit the transaction and return its connection to the pool.
*txn = self[^txn]*
**> web_db_commit txn=`txn`**
**txn = self[^txn]**
*> web_db_commit txn=`txn`*
## 回滚
Roll the transaction back (undo every write) and return its connection.
*txn = self[^txn]*
**> web_db_rollback txn=`txn`**
**txn = self[^txn]**
*> web_db_rollback txn=`txn`*
# form
+ `table`=None
@@ -571,37 +571,37 @@ Roll the transaction back (undo every write) and return its connection.
Field table + rules table; submit writes through `# db`.
> ensure_plugin
**> web_form_new table=`table` action=`action` id=`id`**
*> web_form_new table=`table` action=`action` id=`id`*
## fields
+ `fields`
**> web_form_fields form=`self` fields=`fields`**
*> web_form_fields form=`self` fields=`fields`*
## rules
+ `rules`
**> web_form_rules form=`self` rules=`rules`**
*> web_form_rules form=`self` rules=`rules`*
## validate
+ `rules`=None
+ `data`
**> web_form_validate form=`self` rules=`rules` data=`data`**
*> web_form_validate form=`self` rules=`rules` data=`data`*
## render
+ `id`=form
+ `data`=None
+ `errors`=None
**> web_form_render form=`self` id=`id` data=`data` errors=`errors`**
*> web_form_render form=`self` id=`id` data=`data` errors=`errors`*
## submit
+ `data`
+ `db`
*url = db[^url]*
**> web_form_submit form=`self` data=`data` url=`url`**
**url = db[^url]**
*> web_form_submit form=`self` data=`data` url=`url`*
# app
+ `page`
@@ -616,10 +616,10 @@ Field table + rules table; submit writes through `# db`.
+ `layout`=None
+ `asset_version`=None
Construct an app. `admin=True` mounts the built-in CRUD UI under `admin_prefix` (default `/admin`). When `admin=False`, that prefix is **not** reserved — you may `route` your own pages there. Optional `login_redirect` / `logout_redirect` override post-auth landing. Optional `shell_css` / `layout` / `asset_version` become defaults for pages that do not set their own (see `page.shell_css` / `page.layout` / `page.asset_version`).
Construct an app. `admin=True` mounts the built-in CRUD UI under `admin_prefix` (default `/admin`). When `admin=False`, that prefix is not reserved — you may `route` your own pages there. Optional `login_redirect` / `logout_redirect` override post-auth landing. Optional `shell_css` / `layout` / `asset_version` become defaults for pages that do not set their own (see `page.shell_css` / `page.layout` / `page.asset_version`).
> ensure_plugin
**> web_app_new page=`page` db=`db` admin=`admin` host=`host` port=`port` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` shell_css=`shell_css` layout=`layout` asset_version=`asset_version`**
*> web_app_new page=`page` db=`db` admin=`admin` host=`host` port=`port` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` shell_css=`shell_css` layout=`layout` asset_version=`asset_version`*
## route
+ `path`
@@ -627,7 +627,7 @@ Construct an app. `admin=True` mounts the built-in CRUD UI under `admin_prefix`
Mount an assembled page at `path` (e.g. `/about`). `/` is the home `page=`.
**> web_app_route app=`self` path=`path` page=`page`**
*> web_app_route app=`self` path=`path` page=`page`*
## mount_form
+ `id`
@@ -635,7 +635,7 @@ Mount an assembled page at `path` (e.g. `/about`). `/` is the home `page=`.
Register `GET|POST /_form/{id}` for listen when the form is not already embedded via `page.compose_form`.
**> web_app_mount_form app=`self` id=`id` form=`form`**
*> web_app_mount_form app=`self` id=`id` form=`form`*
## static
+ `dir`
@@ -643,7 +643,7 @@ Register `GET|POST /_form/{id}` for listen when the form is not already embedded
Serve files from `dir` under `mount` (default `/static`). Path is resolved from the process working directory at listen time. If `dir` contains `favicon.ico` / `favicon.png` / `favicon.svg` and `icons` was not set, listen also serves `GET /favicon.ico` and injects a default `<link rel="icon">` on every page.
**> web_app_static app=`self` dir=`dir` mount=`mount`**
*> web_app_static app=`self` dir=`dir` mount=`mount`*
## icons
+ `table`
@@ -653,7 +653,7 @@ Register site icons from a GFM table (`|path|rel|type|sizes|url|` or ZH
`/favicon.ico` for `.ico` icons, else `/icons/{filename}`), and injects matching
`<link>` tags into every page via `site_head`. See [web-assets-and-images.md](../../doc/design/web-assets-and-images.md).
**> web_app_icons app=`self` table=`table`**
*> web_app_icons app=`self` table=`table`*
## configure
+ `cors`=None
@@ -670,7 +670,7 @@ Each capability is declared as a data table and assembled at listen time. The `c
Tables stay as data; `configure` assembles them. 配置即数据、装配即函数.
**> web_app_middleware app=`self` cors=`cors` security=`security` compress=`compress` body_limit=`body_limit` json_routes=`json` access_log=`access_log` cache_control=`cache_control` proxy=`proxy` invoke=`invoke`**
*> web_app_middleware app=`self` cors=`cors` security=`security` compress=`compress` body_limit=`body_limit` json_routes=`json` access_log=`access_log` cache_control=`cache_control` proxy=`proxy` invoke=`invoke`*
## proxy
+ `path`
@@ -683,7 +683,7 @@ Tables stay as data; `configure` assembles them. 配置即数据、装配即函
Same-origin reverse proxy to an upstream HTTP(S) URL. When `stream` is True (default), the response body — including `text/event-stream` SSE — is piped without buffering the full payload, and responses include `Cache-Control: no-cache, no-transform` plus `X-Accel-Buffering: no` for Nginx/CDN. `upstream` may contain `$ENV` / `${ENV}`. `headers_from_env` is `ENV=Header-Name` (comma-separated); secrets stay on the server. Prefer this over a side Python LLM proxy.
**> web_app_proxy app=`self` path=`path` upstream=`upstream` stream=`stream` strip_prefix=`strip_prefix` methods=`methods` headers_from_env=`headers_from_env` timeout_ms=`timeout_ms`**
*> web_app_proxy app=`self` path=`path` upstream=`upstream` stream=`stream` strip_prefix=`strip_prefix` methods=`methods` headers_from_env=`headers_from_env` timeout_ms=`timeout_ms`*
## invoke
+ `path`
@@ -694,13 +694,13 @@ Same-origin reverse proxy to an upstream HTTP(S) URL. When `stream` is True (def
Call a user `##` on each HTTP request. `fn` must be `lib.member` imported on the entry module. `body` is `json` / `form` / `query` / `raw`; object keys map to named params (plus `payload`). Returns JSON by default.
**> web_app_invoke app=`self` path=`path` method=`method` fn=`fn` body=`body` return=`return`**
*> web_app_invoke app=`self` path=`path` method=`method` fn=`fn` body=`body` return=`return`*
## listen
Serve `/`, routed pages, `/_part/{id}` (home) and `{path}/_part/{id}` (routes), `/_form/{id}` (from mounts + page embeds), optional `/static` (or custom mount), optional `/admin`, upload/download/WebSocket/RSS/sitemap/robots routes, redirects, proxy/invoke routes, and a custom 404 fallback. Production HTTPS should terminate at a reverse proxy; set `cookie_secure=True` when serving over TLS.
**> web_listen app=`self`**
*> web_listen app=`self`*
## route_ws
+ `path`
@@ -709,7 +709,7 @@ Serve `/`, routed pages, `/_part/{id}` (home) and `{path}/_part/{id}` (routes),
Register a WebSocket endpoint at `path` (e.g. `/live`). `mode` is `echo` (default), `broadcast` (fan-out text to all sockets on this path), or `drain`. Legacy `echo=False` maps to `drain`. Connect from a client with `web.ws.connect`.
**> web_app_route_ws app=`self` path=`path` echo=`echo` mode=`mode`**
*> web_app_route_ws app=`self` path=`path` echo=`echo` mode=`mode`*
## auth
+ `users`
@@ -719,9 +719,9 @@ Register a WebSocket endpoint at `path` (e.g. `/live`). `mode` is `echo` (defaul
+ `logout_redirect`=None
+ `login_path`=None
Keep the app's `admin=True`, and gate `{admin_prefix}` (segment-boundary prefix) behind a login page (default `/admin`). Unauthenticated requests **redirect** to `login_path` (default `{admin_prefix}/login`, auto-excluded). Does **not** match `/admin-publish`-style siblings.
Keep the app's `admin=True`, and gate `{admin_prefix}` (segment-boundary prefix) behind a login page (default `/admin`). Unauthenticated requests redirect to `login_path` (default `{admin_prefix}/login`, auto-excluded). Does not match `/admin-publish`-style siblings.
**> web_app_auth app=`self` users=`users` session_ttl=`session_ttl` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` login_path=`login_path`**
*> web_app_auth app=`self` users=`users` session_ttl=`session_ttl` admin_prefix=`admin_prefix` login_redirect=`login_redirect` logout_redirect=`logout_redirect` login_path=`login_path`*
## gate
+ `path`
@@ -732,7 +732,7 @@ Keep the app's `admin=True`, and gate `{admin_prefix}` (segment-boundary prefix)
Require one of `roles` (CSV) for `path`. `match=prefix` uses segment boundaries; `exact` is equality. Trailing `*` on `path` means prefix. `on_deny=redirect` sends visitors to `login_path` (with `?next=`); `forbid` returns 403. `exclude` is CSV or list of open paths.
**> web_app_gate app=`self` path=`path` roles=`roles` match=`match` on_deny=`on_deny` exclude=`exclude`**
*> web_app_gate app=`self` path=`path` roles=`roles` match=`match` on_deny=`on_deny` exclude=`exclude`*
## gallery
+ `path`=/gallery
@@ -743,7 +743,7 @@ Require one of `roles` (CSV) for `path`. `match=prefix` uses segment boundaries;
Serve an HTML media gallery listing objects under `prefix` in `storage`, linking through `download_base`.
**> web_app_gallery app=`self` path=`path` storage=`storage` prefix=`prefix` title=`title` download_base=`download_base`**
*> web_app_gallery app=`self` path=`path` storage=`storage` prefix=`prefix` title=`title` download_base=`download_base`*
## route_rss
+ `path`
@@ -756,7 +756,7 @@ Serve an HTML media gallery listing objects under `prefix` in `storage`, linking
Register an RSS 2.0 feed at `path` (e.g. `/feed.xml`) backed by a DB table.
**> web_app_route_rss app=`self` path=`path` table=`table` limit=`limit` order=`order` title=`title` link=`link` description=`description`**
*> web_app_route_rss app=`self` path=`path` table=`table` limit=`limit` order=`order` title=`title` link=`link` description=`description`*
## redirect
+ `from`
@@ -765,7 +765,7 @@ Register an RSS 2.0 feed at `path` (e.g. `/feed.xml`) backed by a DB table.
Register a redirect from `from` to `to`. `permanent=True` issues HTTP 301; otherwise 307.
**> web_app_redirect app=`self` from=`from` to=`to` permanent=`permanent`**
*> web_app_redirect app=`self` from=`from` to=`to` permanent=`permanent`*
## error_page
+ `status`=404
@@ -773,7 +773,7 @@ Register a redirect from `from` to `to`. `permanent=True` issues HTTP 301; other
Bind an assembled page for HTTP `404` or `500` responses.
**> web_app_error_page app=`self` status=`status` page=`page`**
*> web_app_error_page app=`self` status=`status` page=`page`*
## sitemap
+ `path`=/sitemap.xml
@@ -785,7 +785,7 @@ Bind an assembled page for HTTP `404` or `500` responses.
Serve `sitemap.xml`. Prefer `table` + `loc` column from the DB, or pass an `items` table with `loc`/`路径` rows.
**> web_app_sitemap app=`self` path=`path` base=`base` table=`table` loc=`loc` limit=`limit` items=`items`**
*> web_app_sitemap app=`self` path=`path` base=`base` table=`table` loc=`loc` limit=`limit` items=`items`*
## robots
+ `body`=None
@@ -793,7 +793,7 @@ Serve `sitemap.xml`. Prefer `table` + `loc` column from the DB, or pass an `item
Serve `/robots.txt`. Omit `body` to emit a default Allow-all file, optionally with a `Sitemap:` line.
**> web_app_robots app=`self` body=`body` sitemap=`sitemap`**
*> web_app_robots app=`self` body=`body` sitemap=`sitemap`*
## upload
+ `path`=/_upload
@@ -805,7 +805,7 @@ Serve `/robots.txt`. Omit `body` to emit a default Allow-all file, optionally wi
Mount `POST path` for multipart file upload. `storage` is a `# storage` handle or `file:…` / `s3://…` URL. Optional `types` is a `|type|ext|` / `|类型|扩展名|` allowlist (or a MIME CSV string). Success returns JSON `{ok,key,size,content_type}`.
**> web_app_upload app=`self` path=`path` field=`field` storage=`storage` prefix=`prefix` max_bytes=`max_bytes` types=`types`**
*> web_app_upload app=`self` path=`path` field=`field` storage=`storage` prefix=`prefix` max_bytes=`max_bytes` types=`types`*
## download
+ `path`=/_media/{*key}
@@ -814,7 +814,7 @@ Mount `POST path` for multipart file upload. `storage` is a `# storage` handle o
Mount `GET path` to stream an object. Path must capture `key` (use `{*key}` for nested keys). `disposition` is `attachment` or `inline`.
**> web_app_download app=`self` path=`path` storage=`storage` disposition=`disposition`**
*> web_app_download app=`self` path=`path` storage=`storage` disposition=`disposition`*
# auth
+ `users`
@@ -823,7 +823,7 @@ Mount `GET path` to stream an object. Path must capture `key` (use `{*key}` for
Session/auth helper. Constructs a config object; `login` validates against the users table. To gate `/admin` on this app, use `app.auth users=…` instead.
> ensure_plugin
**> web_auth_new users=`users` session_ttl=`session_ttl`**
*> web_auth_new users=`users` session_ttl=`session_ttl`*
## login
+ `username`
@@ -831,30 +831,30 @@ Session/auth helper. Constructs a config object; `login` validates against the u
Validate credentials against the users table and create a session. Returns `{ok, session_id, username, role}`.
*users = self[^users]*
*ttl = self[^session_ttl]*
**> web_auth_login username=`username` password=`password` users=`users` session_ttl=`ttl`**
**users = self[^users]**
**ttl = self[^session_ttl]**
*> web_auth_login username=`username` password=`password` users=`users` session_ttl=`ttl`*
## check
+ `session_id`
Returns `{ok, username, role}` when the session is valid.
**> web_auth_check session_id=`session_id`**
*> web_auth_check session_id=`session_id`*
## logout
+ `session_id`
Destroy the session.
**> web_auth_logout session_id=`session_id`**
*> web_auth_logout session_id=`session_id`*
## hash_password
+ `password`
Hash a plaintext password for storage in admin user tables (argon2id). Store the returned `hash` in the `password` column; login verifies automatically.
**> web_password_hash password=`password`**
*> web_password_hash password=`password`*
# cache
+ `url`="memory:"
@@ -862,13 +862,13 @@ Hash a plaintext password for storage in admin user tables (argon2id). Store the
Key–value cache. Use `memory:` for in-process (tests / single process) or `redis://host:6379/0` for Redis.
> ensure_plugin
**> web_cache_new url=`url`**
*> web_cache_new url=`url`*
## get
+ `key`
*url = self[^url]*
**> web_cache_get url=`url` key=`key`**
**url = self[^url]**
*> web_cache_get url=`url` key=`key`*
## set
+ `key`
@@ -877,26 +877,26 @@ Key–value cache. Use `memory:` for in-process (tests / single process) or `red
Optional `ttl` is seconds until expiry.
*url = self[^url]*
**> web_cache_set url=`url` key=`key` value=`value` ttl=`ttl`**
**url = self[^url]**
*> web_cache_set url=`url` key=`key` value=`value` ttl=`ttl`*
## del
+ `key`
*url = self[^url]*
**> web_cache_del url=`url` key=`key`**
**url = self[^url]**
*> web_cache_del url=`url` key=`key`*
## exists
+ `key`
*url = self[^url]*
**> web_cache_exists url=`url` key=`key`**
**url = self[^url]**
*> web_cache_exists url=`url` key=`key`*
## ttl
+ `key`
*url = self[^url]*
**> web_cache_ttl url=`url` key=`key`**
**url = self[^url]**
*> web_cache_ttl url=`url` key=`key`*
# storage
+ `url`="file:data/blobs"
@@ -904,7 +904,7 @@ Optional `ttl` is seconds until expiry.
Object storage. `file:dir` stores blobs on disk (offline / gold). `s3://bucket?endpoint=http://127.0.0.1:9000&access_key=…&secret_key=…` talks to MinIO / S3.
> ensure_plugin
**> web_storage_new url=`url`**
*> web_storage_new url=`url`*
## put
+ `key`
@@ -914,26 +914,26 @@ Object storage. `file:dir` stores blobs on disk (offline / gold). `s3://bucket?e
Provide either `body` (text) or `path` (local file to upload).
*url = self[^url]*
**> web_storage_put url=`url` key=`key` body=`body` path=`path` content_type=`content_type`**
**url = self[^url]**
*> web_storage_put url=`url` key=`key` body=`body` path=`path` content_type=`content_type`*
## get
+ `key`
*url = self[^url]*
**> web_storage_get url=`url` key=`key`**
**url = self[^url]**
*> web_storage_get url=`url` key=`key`*
## delete
+ `key`
*url = self[^url]*
**> web_storage_delete url=`url` key=`key`**
**url = self[^url]**
*> web_storage_delete url=`url` key=`key`*
## list
+ `prefix`=""
*url = self[^url]*
**> web_storage_list url=`url` prefix=`prefix`**
**url = self[^url]**
*> web_storage_list url=`url` prefix=`prefix`*
# media
+ `storage`=None
@@ -941,7 +941,7 @@ Provide either `body` (text) or `path` (local file to upload).
Offline helpers for upload validation and saving into `# storage` (also used by HTTP `app.upload`).
> ensure_plugin
**> web_media_new storage=`storage`**
*> web_media_new storage=`storage`*
## validate
+ `filename`
@@ -950,7 +950,7 @@ Offline helpers for upload validation and saving into `# storage` (also used by
+ `max_bytes`=5242880
+ `types`=None
**> web_upload_validate filename=`filename` content_type=`content_type` size=`size` max_bytes=`max_bytes` types=`types`**
*> web_upload_validate filename=`filename` content_type=`content_type` size=`size` max_bytes=`max_bytes` types=`types`*
## save
+ `path`
@@ -959,12 +959,12 @@ Offline helpers for upload validation and saving into `# storage` (also used by
+ `prefix`=uploads/
+ `storage`=None
*st = storage*
**st = storage**
1. `st` == None
*st = self[^storage]*
**st = self[^storage]**
2. *
**> web_upload_save storage=`st` path=`path` key=`key` content_type=`content_type` prefix=`prefix`**
*> web_upload_save storage=`st` path=`path` key=`key` content_type=`content_type` prefix=`prefix`*
# ws
+ `timeout_sec`=30
@@ -978,7 +978,7 @@ WebSocket client helper.
|-------------|-------|
| `timeout_sec` | ws |
**out**
*out*
## connect
+ `url`
@@ -987,5 +987,5 @@ WebSocket client helper.
Single request–response: connect to `url`, send `message`, collect all server text replies, close. Returns `{ok, messages}`.
*timeout = self[^timeout_sec]*
**> web_ws_connect url=`url` message=`message` headers=`headers` timeout_sec=`timeout`**
**timeout = self[^timeout_sec]**
*> web_ws_connect url=`url` message=`message` headers=`headers` timeout_sec=`timeout`*
+186 -186
View File
@@ -10,7 +10,7 @@ import table:lib/table.mq.md
加载 ABI v2 `web` 插件。
*p = > plugin.native_path name="web"*
**p = > plugin.native_path name="web"**
1. `p`
> plugin.load path=`p`
2. *
@@ -33,7 +33,7 @@ import table:lib/table.mq.md
样式即数据、装配即函数 —— 主题模块据此把样式表拼成完整样式表。
> 确保插件
**> web_style name=`名` table=`表` strict=`严格`**
*> web_style name=`名` table=`表` strict=`严格`*
## 图片装配
+ `表`
@@ -43,7 +43,7 @@ import table:lib/table.mq.md
图片即数据、装配即函数。
> 确保插件
**> web_images table=`表`**
*> web_images table=`表`*
## 头资源装配
+ `表`
@@ -51,7 +51,7 @@ import table:lib/table.mq.md
把 Head 资源表装配成 HTML(`<link>` / `<script>`)。预览用;挂到页面请用 `页面.头装配`。
> 确保插件
**> web_head table=`表`**
*> web_head table=`表`*
## 客户端挂载
+ `桥`="/static/marqdo-bridge.js"
@@ -59,16 +59,16 @@ import table:lib/table.mq.md
+ `源`=""
+ `启动`=True
返回挂载浏览器 Marqdo(路线 C/D)的 HTML。`启动` 且 `源` 非空(客户端 `.mq.md` URL)时写入 `data-mq-wasm` / `data-mq-source-url`,官方 bridge **自动 mount**(作者零业务 JS)。
返回挂载浏览器 Marqdo(路线 C/D)的 HTML。`启动` 且 `源` 非空(客户端 `.mq.md` URL)时写入 `data-mq-wasm` / `data-mq-source-url`,官方 bridge 自动 mount(作者零业务 JS)。
请先 `marqdo wasm build -o static`,并用 `app.静态` 提供该目录。设计见 [browser-marqdo-wasm.md](../../doc/design/browser-marqdo-wasm.md) §16。
1. `启动`
1. `源` != ""
**"<script type=\"module\" src=\"" + 桥 + "\" data-mq-wasm=\"" + wasm + "\" data-mq-source-url=\"" + 源 + "\"></script>"**
*"<script type=\"module\" src=\"" + 桥 + "\" data-mq-wasm=\"" + wasm + "\" data-mq-source-url=\"" + 源 + "\"></script>"*
2. *
**"<script type=\"module\" src=\"" + 桥 + "\"></script>"**
*"<script type=\"module\" src=\"" + 桥 + "\"></script>"*
2. *
**"<script type=\"module\" src=\"" + 桥 + "\" data-mq-no-boot=\"1\"></script>"**
*"<script type=\"module\" src=\"" + 桥 + "\" data-mq-no-boot=\"1\"></script>"*
## 文本补丁
+ `选择器`
@@ -76,8 +76,8 @@ import table:lib/table.mq.md
快捷构造 `set_text` 效应表。客户端优先 `lib/浏览器` + GFM 表格。
*`m` = > table.put in=None at=选择器 value=文本*
**> table.put in=None at="set_text" value=m**
**`m` = > table.put in=None at=选择器 value=文本**
*> table.put in=None at="set_text" value=m*
## DOM补丁
+ `set_text`=None
@@ -108,58 +108,58 @@ import table:lib/table.mq.md
合并浏览器效应键(含路线 E/F)为一张返回表(跳过 `None`)。
*`out` = > table.put in=None at="_mq" value=True*
**`out` = > table.put in=None at="_mq" value=True**
1. `set_text` != None
*`out` = > table.put in=`out` at="set_text" value=set_text*
**`out` = > table.put in=`out` at="set_text" value=set_text**
1. `set_value` != None
*`out` = > table.put in=`out` at="set_value" value=set_value*
**`out` = > table.put in=`out` at="set_value" value=set_value**
1. `set_attr` != None
*`out` = > table.put in=`out` at="set_attr" value=set_attr*
**`out` = > table.put in=`out` at="set_attr" value=set_attr**
1. `set_class` != None
*`out` = > table.put in=`out` at="set_class" value=set_class*
**`out` = > table.put in=`out` at="set_class" value=set_class**
1. `toggle_class` != None
*`out` = > table.put in=`out` at="toggle_class" value=toggle_class*
**`out` = > table.put in=`out` at="toggle_class" value=toggle_class**
1. `set_style` != None
*`out` = > table.put in=`out` at="set_style" value=set_style*
**`out` = > table.put in=`out` at="set_style" value=set_style**
1. `set_html` != None
*`out` = > table.put in=`out` at="set_html" value=set_html*
**`out` = > table.put in=`out` at="set_html" value=set_html**
1. `render_list` != None
*`out` = > table.put in=`out` at="render_list" value=render_list*
**`out` = > table.put in=`out` at="render_list" value=render_list**
1. `navigate` != None
*`out` = > table.put in=`out` at="navigate" value=navigate*
**`out` = > table.put in=`out` at="navigate" value=navigate**
1. `storage` != None
*`out` = > table.put in=`out` at="storage" value=storage*
**`out` = > table.put in=`out` at="storage" value=storage**
1. `ws` != None
*`out` = > table.put in=`out` at="ws" value=ws*
**`out` = > table.put in=`out` at="ws" value=ws**
1. `fetch` != None
*`out` = > table.put in=`out` at="fetch" value=fetch*
**`out` = > table.put in=`out` at="fetch" value=fetch**
1. `fetch_all` != None
*`out` = > table.put in=`out` at="fetch_all" value=fetch_all*
**`out` = > table.put in=`out` at="fetch_all" value=fetch_all**
1. `after` != None
*`out` = > table.put in=`out` at="after" value=after*
**`out` = > table.put in=`out` at="after" value=after**
1. `interval` != None
*`out` = > table.put in=`out` at="interval" value=interval*
**`out` = > table.put in=`out` at="interval" value=interval**
1. `clear_interval` != None
*`out` = > table.put in=`out` at="clear_interval" value=clear_interval*
**`out` = > table.put in=`out` at="clear_interval" value=clear_interval**
1. `focus` != None
*`out` = > table.put in=`out` at="focus" value=focus*
**`out` = > table.put in=`out` at="focus" value=focus**
1. `blur` != None
*`out` = > table.put in=`out` at="blur" value=blur*
**`out` = > table.put in=`out` at="blur" value=blur**
1. `scroll_into` != None
*`out` = > table.put in=`out` at="scroll_into" value=scroll_into*
**`out` = > table.put in=`out` at="scroll_into" value=scroll_into**
1. `canvas` != None
*`out` = > table.put in=`out` at="canvas" value=canvas*
**`out` = > table.put in=`out` at="canvas" value=canvas**
1. `audio` != None
*`out` = > table.put in=`out` at="audio" value=audio*
**`out` = > table.put in=`out` at="audio" value=audio**
1. `read_file` != None
*`out` = > table.put in=`out` at="read_file" value=read_file*
**`out` = > table.put in=`out` at="read_file" value=read_file**
1. `observe` != None
*`out` = > table.put in=`out` at="observe" value=observe*
**`out` = > table.put in=`out` at="observe" value=observe**
1. `unobserve` != None
*`out` = > table.put in=`out` at="unobserve" value=unobserve*
**`out` = > table.put in=`out` at="unobserve" value=unobserve**
1. `wire` != None
*`out` = > table.put in=`out` at="wire" value=wire*
**out**
**`out` = > table.put in=`out` at="wire" value=wire**
*out*
## 列表HTML
+ `选择器`
@@ -168,10 +168,10 @@ import table:lib/table.mq.md
构造 `render_list` 效应。
*`spec` = > table.put in=None at="tag" value=标签*
*`spec` = > table.put in=`spec` at="items" value=项*
*`m` = > table.put in=None at=选择器 value=spec*
**> table.put in=None at="render_list" value=m**
**`spec` = > table.put in=None at="tag" value=标签**
**`spec` = > table.put in=`spec` at="items" value=项**
**`m` = > table.put in=None at=选择器 value=spec**
*> table.put in=None at="render_list" value=m*
# 页面
+ `标题`="站点"
@@ -181,76 +181,76 @@ import table:lib/table.mq.md
+ `资源版本`=None
> 确保插件
**> web_page_new title=`标题` intro=`引言` shell_css=`壳样式` layout=`布局` asset_version=`资源版本`**
*> web_page_new title=`标题` intro=`引言` shell_css=`壳样式` layout=`布局` asset_version=`资源版本`*
## 壳样式
+ `模式`=full
框架壳 CSS:`full`(默认)/ `minimal`(仅变量)/ `off`。
*`out` = > table.put in=`自` at="shell_css" value=模式*
**out**
**`out` = > table.put in=`自` at="shell_css" value=模式**
*out*
## 布局
+ `布局`=sidebar
页面壳:`sidebar`(有侧栏时默认双列)/ `stacked`(单列、不加 has-sidebar)/ `bare`(仅 main)/ `rail`。
*`out` = > table.put in=`自` at="layout" value=布局*
**out**
**`out` = > table.put in=`自` at="layout" value=布局**
*out*
## 资源版本
+ `版本`=""
为未写 `版本` 列的 head 脚本/样式统一追加 `?v=`。
*`out` = > table.put in=`自` at="asset_version" value=版本*
**out**
**`out` = > table.put in=`自` at="asset_version" value=版本**
*out*
## 组件装配
+ `组件`
**> web_compose_components page=`self` components=`组件`**
*> web_compose_components page=`self` components=`组件`*
## 主体装配
+ `主体`
**> web_compose_main page=`self` main=`主体`**
*> web_compose_main page=`self` main=`主体`*
## 查询条件
+ `条件`
为主主体绑定附加 DB 条件映射。值可含 `{参数}` 占位符,由动态路由参数替换(如 `/post/{slug}`)。
**> web_page_query page=`self` query=`条件`**
*> web_page_query page=`self` query=`条件`*
## 排序
+ `排序`
设置主主体绑定的默认 `ORDER BY`(如 `-created_at` 表示最新在前)。
**> web_page_order page=`self` order=`排序`**
*> web_page_order page=`self` order=`排序`*
## 链接前缀
+ `前缀`
卡片链接前缀(默认 `/post/`)。主体绑定中含 `链接`/`href` 字段时,卡片标题会包成 `<a href="{前缀}{值}">`。
**> web_page_link_prefix page=`self` prefix=`前缀`**
*> web_page_link_prefix page=`self` prefix=`前缀`*
## 样式
+ `样式`
把一段**原始** CSS 字符串追加到页面样式表(`styles_css`),不经表单元格表达式求值——适合含 `/`、`@keyframes` 或长 media 的主题。也可外链 `static/theme.css` 再经 `头装配`。
把一段原始 CSS 字符串追加到页面样式表(`styles_css`),不经表单元格表达式求值——适合含 `/`、`@keyframes` 或长 media 的主题。也可外链 `static/theme.css` 再经 `头装配`。
**> web_page_css page=`self` css=`样式`**
*> web_page_css page=`self` css=`样式`*
## 详情
+ `详情`=True
把主体绑定的首行渲染成完整文章(标题/日期/标签/正文)而非卡片列表。用于动态文章页 `/post/{slug}`。
**> web_page_detail page=`self` detail=`详情`**
*> web_page_detail page=`self` detail=`详情`*
## 壳HTML
+ `导航`=""
@@ -259,28 +259,28 @@ import table:lib/table.mq.md
覆盖默认 `<header>` / `<footer>` 列表渲染,改为原站级原始 HTML(如 Django navbar / site_footer)。可选 `体类` 追加到 `<body class>`。
**> web_page_chrome page=`self` nav_html=`导航` footer_html=`页脚` body_class=`体类`**
*> web_page_chrome page=`self` nav_html=`导航` footer_html=`页脚` body_class=`体类`*
## 元数据
+ `元数据`
SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`canonical`、`og:type` 等会在渲染时写入 `<head>`。特殊键 `icon` / `favicon` / `apple-touch-icon` 会写成 `<link rel="…">`(不会误写成 `<meta name>`)。
**> web_page_meta page=`self` meta=`元数据`**
*> web_page_meta page=`self` meta=`元数据`*
## 头装配
+ `表`
把 Head 资源表(`|关系|地址|类型|尺寸|媒体|作为|跨域|推迟|异步|版本|`)挂到页面的 `head`。`关系=script` / `module` 生成 `<script>`,其余生成 `<link>`。经典脚本仅在 `推迟`/`异步` 为真时输出对应属性(缺省仍同步,兼容旧站)。非空 `版本` 追加 `?v=`,否则用页面/应用的 `资源版本`。与已有 `head` 合并。
**> web_page_head page=`self` table=`表`**
*> web_page_head page=`self` table=`表`*
## 图片装配
+ `表`
把图片表装配为 HTML,写入 `images_html`(渲染时插在主区引言之前)。表形与模块级 `网页.图片装配` 相同。
**> web_page_images page=`self` table=`表`**
*> web_page_images page=`self` table=`表`*
## 分页
+ `偏移`=0
@@ -289,7 +289,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
为主体列表绑定设置 DB 分页(`limit`/`offset`),并渲染上一页/下一页导航。
**> web_page_paginate page=`self` offset=`偏移` limit=`上限` path=`路径`**
*> web_page_paginate page=`self` offset=`偏移` limit=`上限` path=`路径`*
## 表单装配
+ `表单`
@@ -298,28 +298,28 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
将表单嵌入页面主区。可选 `表单插槽`(元素 id,如 `#qd-note-form-mount`):把表单注入引言 HTML 内该节点,而不是 `.main-intro` 后的兄弟 `.site-form`(GAP-11)。插槽缺失时回退为兄弟节点。`listen` 会从页面/路由上的表单自动挂载 `GET|POST /_form/{id}`(可选再 `挂载表单`)。
**> web_compose_form page=`self` form=`表单` id=`id` target=`表单插槽`**
*> web_compose_form page=`self` form=`表单` id=`id` target=`表单插槽`*
## 渲染
+ `数据库`=None
1. `数据库`
*url = 数据库[^url]*
**> web_render page=`self` url=`url`**
**url = 数据库[^url]**
*> web_render page=`self` url=`url`*
2. *
**> web_render page=`self`**
*> web_render page=`self`*
# 样式
+ `名`=""
**self**
*self*
## 样式处理
+ `样式`=None
+ `名`=None
+ `路径`=None
**self**
*self*
# 数据库
+ `地址`="sqlite:site.db"
@@ -327,7 +327,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
打开数据库句柄。URL 方案:`sqlite:路径`(默认)、`postgres://…` / `postgresql://…`(CRUD 方法相同)。
> 确保插件
**> web_db_new url=`地址`**
*> web_db_new url=`地址`*
## 初始化
+ `名`
@@ -335,16 +335,16 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
从表结构创建表。可选列:`唯一`/`unique`、`索引`/`index`、`外键`/`fk`/`references`(如 `posts.id`)。若存在 `created_at` / `updated_at` 列,插入/更新时自动写入。
*url = self[^url]*
**> web_db_init url=`url` name=`名` fields=`字段`**
**url = self[^url]**
*> web_db_init url=`url` name=`名` fields=`字段`*
## 插入
+ `表`
+ `行`
+ `事务`=None
*url = self[^url]*
**> web_db_insert url=`url` table=`表` rows=`行` txn=`事务`**
**url = self[^url]**
*> web_db_insert url=`url` table=`表` rows=`行` txn=`事务`*
## 查询
+ `表`
@@ -355,9 +355,9 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
简单条件:单行列→值映射(AND `=`),或 `|字段|操作|值|` 表(`=` `!=` `>` `>=` `<` `<=` `like` `in` `between` `is null`;加 `|或|` 为 `是` 可让该行与前一行用 `OR` 连接)。`排序` 是列名,`-` 前缀表示倒序(`"created_at"`、`"-created_at"`),可逗号分隔多列。传入 `事务` 可在已开启的事务内读取。要分页(带总数)用 `分页`。
*url = self[^url]*
*r = > web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=None txn=`事务`*
**r[^rows]**
**url = self[^url]**
**r = > web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=None txn=`事务`**
*r[^rows]*
## 分页
+ `表`
@@ -369,16 +369,16 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
同 `查询`,但返回 `{ rows, total }`——`total` 是满足 `条件` 的行数(不受 `上限`/`跳过` 影响),供渲染 `上一页 / 下一页`。`跳过` 为要跳过的行数(如每页 10 条的第 2 页 ⇒ `跳过`=10)。
*url = self[^url]*
**> web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=`跳过` txn=`事务`**
**url = self[^url]**
*> web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=`跳过` txn=`事务`*
## 获取
+ `表`
+ `id`
+ `事务`=None
*url = self[^url]*
**> web_db_get url=`url` table=`表` id=`id` txn=`事务`**
**url = self[^url]**
*> web_db_get url=`url` table=`表` id=`id` txn=`事务`*
## 更新
+ `表`
@@ -386,24 +386,24 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `行`
+ `事务`=None
*url = self[^url]*
**> web_db_update url=`url` table=`表` id=`id` row=`行` txn=`事务`**
**url = self[^url]**
*> web_db_update url=`url` table=`表` id=`id` row=`行` txn=`事务`*
## 删除
+ `表`
+ `id`
+ `事务`=None
*url = self[^url]*
**> web_db_delete url=`url` table=`表` id=`id` txn=`事务`**
**url = self[^url]**
*> web_db_delete url=`url` table=`表` id=`id` txn=`事务`*
## 执行
+ `sql`
+ `参数`=None
+ `事务`=None
*url = self[^url]*
**> web_db_exec url=`url` sql=`sql` args=`参数` txn=`事务`**
**url = self[^url]**
*> web_db_exec url=`url` sql=`sql` args=`参数` txn=`事务`*
## 原生查询
+ `sql`
@@ -412,8 +412,8 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
执行裸 SQL 并返回结果集——count / join / group / 子查询都行。返回 `{ rows, count }`。
*url = self[^url]*
**> web_db_query url=`url` sql=`sql` args=`参数` txn=`事务`**
**url = self[^url]**
*> web_db_query url=`url` sql=`sql` args=`参数` txn=`事务`*
## 计数
+ `表`
@@ -422,17 +422,17 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
统计满足 `条件` 的行数(语法同 `查询`)。返回数字。
*url = self[^url]*
*r = > web_db_count url=`url` table=`表` where=`条件` txn=`事务`*
**r[^count]**
**url = self[^url]**
**r = > web_db_count url=`url` table=`表` where=`条件` txn=`事务`**
*r[^count]*
## 迁移
+ `步骤`
按版本执行 SQL 迁移。`步骤` 为 `|版本|SQL|` 表;已应用版本记入 `_marqdo_migrations`。重复执行对已应用版本是空操作。仅 SQLite。
*url = self[^url]*
**> web_db_migrate url=`url` steps=`步骤`**
**url = self[^url]**
*> web_db_migrate url=`url` steps=`步骤`*
## 全文
+ `表`
@@ -441,8 +441,8 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
为 `表` 的内容列创建 FTS5 索引(CSV 或列表)。默认索引名 `{表}_fts`,用触发器保持同步。需要整数 `id` 主键。仅 SQLite。
*url = self[^url]*
**> web_db_fts_create url=`url` table=`表` columns=`列` name=`名`**
**url = self[^url]**
*> web_db_fts_create url=`url` table=`表` columns=`列` name=`名`*
## 搜索
+ `表`
@@ -452,15 +452,15 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
对 `全文` 建立的索引做 `MATCH` 检索。返回 `{ rows, count }`,含 `rank`(bm25)。仅 SQLite。
*url = self[^url]*
**> web_db_search url=`url` table=`表` q=`关键词` limit=`上限` name=`名`**
**url = self[^url]**
*> web_db_search url=`url` table=`表` q=`关键词` limit=`上限` name=`名`*
## 事务
开启一个事务:从连接池独占借用连接,返回 `事务` 句柄。在事务内写入,然后 `提交` 或 `回滚`。所有语句在同一连接上执行,整批写入是原子的。
*url = self[^url]*
**> web_db_begin url=`url`**
**url = self[^url]**
*> web_db_begin url=`url`*
# 事务
+ `事务`
@@ -468,15 +468,15 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
数据库.事务 返回的句柄。这里的所有 CRUD 都在该事务连接上执行;结束时 提交 或 回滚。
**self**
*self*
## 插入
+ `表`
+ `行`
*url = self[^地址]*
*txn = self[^事务]*
**> web_db_insert url=`url` table=`表` rows=`行` txn=`txn`**
**url = self[^地址]**
**txn = self[^事务]**
*> web_db_insert url=`url` table=`表` rows=`行` txn=`txn`*
## 查询
+ `表`
@@ -486,57 +486,57 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
筛选语法同 `数据库.查询`;在事务内执行。
*url = self[^地址]*
*txn = self[^事务]*
*r = > web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=None txn=`txn`*
**r[^rows]**
**url = self[^地址]**
**txn = self[^事务]**
**r = > web_db_select url=`url` table=`表` where=`条件` limit=`上限` order=`排序` offset=None txn=`txn`**
*r[^rows]*
## 获取
+ `表`
+ `id`
*url = self[^地址]*
*txn = self[^事务]*
**> web_db_get url=`url` table=`表` id=`id` txn=`txn`**
**url = self[^地址]**
**txn = self[^事务]**
*> web_db_get url=`url` table=`表` id=`id` txn=`txn`*
## 更新
+ `表`
+ `id`
+ `行`
*url = self[^地址]*
*txn = self[^事务]*
**> web_db_update url=`url` table=`表` id=`id` row=`行` txn=`txn`**
**url = self[^地址]**
**txn = self[^事务]**
*> web_db_update url=`url` table=`表` id=`id` row=`行` txn=`txn`*
## 删除
+ `表`
+ `id`
*url = self[^地址]*
*txn = self[^事务]*
**> web_db_delete url=`url` table=`表` id=`id` txn=`txn`**
**url = self[^地址]**
**txn = self[^事务]**
*> web_db_delete url=`url` table=`表` id=`id` txn=`txn`*
## 执行
+ `sql`
+ `参数`=None
*url = self[^地址]*
*txn = self[^事务]*
**> web_db_exec url=`url` sql=`sql` args=`参数` txn=`txn`**
**url = self[^地址]**
**txn = self[^事务]**
*> web_db_exec url=`url` sql=`sql` args=`参数` txn=`txn`*
## 提交
提交事务,并把连接归还连接池。
*txn = self[^事务]*
**> web_db_commit txn=`txn`**
**txn = self[^事务]**
*> web_db_commit txn=`txn`*
## 回滚
回滚事务(撤销所有写入),并归还连接。
*txn = self[^事务]*
**> web_db_rollback txn=`txn`**
**txn = self[^事务]**
*> web_db_rollback txn=`txn`*
# 表单
+ `表`=None
@@ -546,37 +546,37 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
字段表 + 校验表;提交经 `# 数据库` 写入。
> 确保插件
**> web_form_new table=`表` action=`动作` id=`id`**
*> web_form_new table=`表` action=`动作` id=`id`*
## 字段
+ `字段`
**> web_form_fields form=`self` fields=`字段`**
*> web_form_fields form=`self` fields=`字段`*
## 规则
+ `规则`
**> web_form_rules form=`self` rules=`规则`**
*> web_form_rules form=`self` rules=`规则`*
## 校验
+ `规则`=None
+ `数据`
**> web_form_validate form=`self` rules=`规则` data=`数据`**
*> web_form_validate form=`self` rules=`规则` data=`数据`*
## 渲染
+ `id`=form
+ `数据`=None
+ `错误`=None
**> web_form_render form=`self` id=`id` data=`数据` errors=`错误`**
*> web_form_render form=`self` id=`id` data=`数据` errors=`错误`*
## 提交
+ `数据`
+ `数据库`
*url = 数据库[^url]*
**> web_form_submit form=`self` data=`数据` url=`url`**
**url = 数据库[^url]**
*> web_form_submit form=`self` data=`数据` url=`url`*
# 应用
+ `页面`
@@ -591,10 +591,10 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `布局`=None
+ `资源版本`=None
构造应用。`后台=真` 时在 `后台前缀`(默认 `/admin`)挂载内置 CRUD。`后台=假` 时该前缀**不再保留**,可自行 `路由` 到 `/admin…`。可选 `登录回跳` / `登出回跳`。可选 `壳样式` / `布局` / `资源版本` 作为未自设页面的默认(见 `页面.壳样式` / `页面.布局` / `页面.资源版本`)。
构造应用。`后台=真` 时在 `后台前缀`(默认 `/admin`)挂载内置 CRUD。`后台=假` 时该前缀不再保留,可自行 `路由` 到 `/admin…`。可选 `登录回跳` / `登出回跳`。可选 `壳样式` / `布局` / `资源版本` 作为未自设页面的默认(见 `页面.壳样式` / `页面.布局` / `页面.资源版本`)。
> 确保插件
**> web_app_new page=`页面` db=`数据库` admin=`后台` host=`主机` port=`端口` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` shell_css=`壳样式` layout=`布局` asset_version=`资源版本`**
*> web_app_new page=`页面` db=`数据库` admin=`后台` host=`主机` port=`端口` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` shell_css=`壳样式` layout=`布局` asset_version=`资源版本`*
## 路由
+ `路径`
@@ -602,13 +602,13 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
将已装配页面挂到 `路径`(如 `/about`)。`/` 由首页 `页面=` 提供。
**> web_app_route app=`self` path=`路径` page=`页面`**
*> web_app_route app=`self` path=`路径` page=`页面`*
## 挂载表单
+ `id`
+ `表单`
**> web_app_mount_form app=`self` id=`id` form=`表单`**
*> web_app_mount_form app=`self` id=`id` form=`表单`*
## 静态
+ `目录`
@@ -616,14 +616,14 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
将 `目录` 下的文件挂到 `挂载`(默认 `/static`)。路径在 `监听` 时相对进程工作目录解析。若目录内有 `favicon.ico` / `favicon.png` / `favicon.svg` 且未配置 `图标`,则额外提供 `GET /favicon.ico` 并为每页注入默认 `<link rel="icon">`。
**> web_app_static app=`self` dir=`目录` mount=`挂载`**
*> web_app_static app=`self` dir=`目录` mount=`挂载`*
## 图标
+ `表`
用 GFM 表注册站点图标(`|路径|关系|类型|尺寸|地址|`)。`监听` 时按 `地址` 提供文件(`.ico` 默认 `/favicon.ico`,否则 `/icons/{文件名}`),并通过 `site_head` 向全站页面注入对应 `<link>`。设计见 [web-assets-and-images.md](../../doc/design/web-assets-and-images.md)。
**> web_app_icons app=`self` table=`表`**
*> web_app_icons app=`self` table=`表`*
## 装配
+ `跨域`=None
@@ -640,7 +640,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
表仍是数据,`装配` 把它们变成能力。配置即数据、装配即函数。
**> web_app_middleware app=`self` cors=`跨域` security=`安全` compress=`压缩` body_limit=`请求体上限` json_routes=`接口` access_log=`访问日志` cache_control=`缓存控制` proxy=`代理` invoke=`调用`**
*> web_app_middleware app=`self` cors=`跨域` security=`安全` compress=`压缩` body_limit=`请求体上限` json_routes=`接口` access_log=`访问日志` cache_control=`缓存控制` proxy=`代理` invoke=`调用`*
## 代理
+ `路径`
@@ -653,7 +653,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
同域反向代理到上游 HTTP(S)。`流式` 为真(默认)时管道转发响应体(含 `text/event-stream`),不整段缓冲。`上游` 可含 `$ENV` / `${ENV}`。`环境头` 为 `ENV=Header-Name`(逗号分隔),密钥留在服务端。
**> web_app_proxy app=`self` path=`路径` upstream=`上游` stream=`流式` strip_prefix=`去前缀` methods=`方法` headers_from_env=`环境头` timeout_ms=`超时`**
*> web_app_proxy app=`self` path=`路径` upstream=`上游` stream=`流式` strip_prefix=`去前缀` methods=`方法` headers_from_env=`环境头` timeout_ms=`超时`*
## 调用
+ `路径`
@@ -664,13 +664,13 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
每个 HTTP 请求调用用户 `##`。`函数` 必须是入口模块已 `导入` 的 `库.成员`。`正文` 为 `json` / `form` / `query` / `raw`;对象键映射为具名形参(另有 `payload`)。默认返回 JSON。
**> web_app_invoke app=`self` path=`路径` method=`方法` fn=`函数` body=`正文` return=`返回`**
*> web_app_invoke app=`self` path=`路径` method=`方法` fn=`函数` body=`正文` return=`返回`*
## 监听
提供 `/`、路由页、首页 `/_part/{id}`、路由 `{路径}/_part/{id}`、`/_form/{id}`、可选静态目录、可选 `/admin`,上传/下载/WebSocket/RSS/sitemap/robots、重定向、代理/调用路由,以及自定义 404。生产 HTTPS 请在反向代理终止;启用 TLS 时设 `cookie_secure`。
**> web_listen app=`self`**
*> web_listen app=`self`*
## 路由实时
+ `路径`
@@ -679,7 +679,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
在 `路径`(如 `/live`)注册 WebSocket 端点。`模式` 为 `echo`(默认)、`broadcast`(同路径全体广播)或 `drain`。旧参数 `回显=假` 等价于 `drain`。客户端用 `网页.实时` 的 `连接` 接入。
**> web_app_route_ws app=`self` path=`路径` echo=`回显` mode=`模式`**
*> web_app_route_ws app=`self` path=`路径` echo=`回显` mode=`模式`*
## 鉴权
+ `用户表`
@@ -689,9 +689,9 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `登出回跳`=None
+ `登录路径`=None
在保持 `后台=真` 的同时,为 `{后台前缀}` 加**段边界**前缀门禁(默认 `/admin`)。未登录 **重定向** 到 `登录路径`(默认 `{前缀}/login`,自动排除)。不会匹配 `/admin-publish` 这类旁系路径。
在保持 `后台=真` 的同时,为 `{后台前缀}` 加段边界前缀门禁(默认 `/admin`)。未登录 重定向 到 `登录路径`(默认 `{前缀}/login`,自动排除)。不会匹配 `/admin-publish` 这类旁系路径。
**> web_app_auth app=`self` users=`用户表` session_ttl=`会话时长` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` login_path=`登录路径`**
*> web_app_auth app=`self` users=`用户表` session_ttl=`会话时长` admin_prefix=`后台前缀` login_redirect=`登录回跳` logout_redirect=`登出回跳` login_path=`登录路径`*
## 门禁
+ `路径`
@@ -702,7 +702,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
要求会话角色落在 `角色`(CSV)之一。`匹配=prefix` 为段边界前缀;`exact` 为精确路径。路径末尾 `*` 亦表示前缀。`拒绝=redirect` 时访客跳转登录页(带 `?next=`);`forbid` 返回 403。`排除` 为 CSV/列表(如登录页)。
**> web_app_gate app=`self` path=`路径` roles=`角色` match=`匹配` on_deny=`拒绝` exclude=`排除`**
*> web_app_gate app=`self` path=`路径` roles=`角色` match=`匹配` on_deny=`拒绝` exclude=`排除`*
## 相册
+ `路径`=/gallery
@@ -713,7 +713,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
列出 `存储` 下 `前缀` 对象,生成 HTML 相册页,链接走 `下载基址`。
**> web_app_gallery app=`self` path=`路径` storage=`存储` prefix=`前缀` title=`标题` download_base=`下载基址`**
*> web_app_gallery app=`self` path=`路径` storage=`存储` prefix=`前缀` title=`标题` download_base=`下载基址`*
## 路由订阅
+ `路径`
@@ -726,7 +726,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
在 `路径`(如 `/feed.xml`)注册 RSS 2.0 订阅源,数据来自数据库表。
**> web_app_route_rss app=`self` path=`路径` table=`表` limit=`上限` order=`排序` title=`标题` link=`链接` description=`描述`**
*> web_app_route_rss app=`self` path=`路径` table=`表` limit=`上限` order=`排序` title=`标题` link=`链接` description=`描述`*
## 重定向
+ `来源`
@@ -735,7 +735,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
将 `来源` 重定向到 `目标`。`永久=真` 返回 301,否则 307。
**> web_app_redirect app=`self` from=`来源` to=`目标` permanent=`永久`**
*> web_app_redirect app=`self` from=`来源` to=`目标` permanent=`永久`*
## 错误页
+ `状态`=404
@@ -743,7 +743,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
为 HTTP `404` 或 `500` 绑定已装配页面。
**> web_app_error_page app=`self` status=`状态` page=`页面`**
*> web_app_error_page app=`self` status=`状态` page=`页面`*
## 站点地图
+ `路径`=/sitemap.xml
@@ -755,7 +755,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
提供 sitemap.xml。优先用数据库 `表` + `定位列`,或传入带 `loc`/`路径` 的 `条目` 表。
**> web_app_sitemap app=`self` path=`路径` base=`基址` table=`表` loc=`定位列` limit=`上限` items=`条目`**
*> web_app_sitemap app=`self` path=`路径` base=`基址` table=`表` loc=`定位列` limit=`上限` items=`条目`*
## 爬虫协议
+ `正文`=None
@@ -763,7 +763,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
提供 `/robots.txt`。省略 `正文` 时生成默认 Allow-all,可附带 `Sitemap:` 行。
**> web_app_robots app=`self` body=`正文` sitemap=`站点地图`**
*> web_app_robots app=`self` body=`正文` sitemap=`站点地图`*
## 上传
+ `路径`=/_upload
@@ -775,7 +775,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
挂载 `POST 路径` 接收 multipart 文件。`存储` 为 `# 存储` 句柄或 `file:…` / `s3://…` URL。可选 `类型` 为 `|类型|扩展名|` 允许表(或 MIME CSV)。成功返回 JSON `{ok,key,size,content_type}`。
**> web_app_upload app=`self` path=`路径` field=`字段` storage=`存储` prefix=`前缀` max_bytes=`最大字节` types=`类型`**
*> web_app_upload app=`self` path=`路径` field=`字段` storage=`存储` prefix=`前缀` max_bytes=`最大字节` types=`类型`*
## 下载
+ `路径`=/_media/{*key}
@@ -784,7 +784,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
挂载 `GET 路径` 流式返回对象。路径须捕获 `key`(嵌套键用 `{*key}`)。`处置` 为 `attachment` 或 `inline`。
**> web_app_download app=`self` path=`路径` storage=`存储` disposition=`处置`**
*> web_app_download app=`self` path=`路径` storage=`存储` disposition=`处置`*
# 鉴权
+ `用户表`
@@ -793,7 +793,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
会话/登录工具类。`登录` 用 `用户表` 校验。要给应用加 `/admin` 门禁,用 `应用` 的 `鉴权` 方法。
> 确保插件
**> web_auth_new users=`用户表` session_ttl=`会话时长`**
*> web_auth_new users=`用户表` session_ttl=`会话时长`*
## 登录
+ `用户名`
@@ -801,30 +801,30 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
用用户表校验并创建会话。返回 `{ok, session_id, username}`。
*users = self[^users]*
*ttl = self[^session_ttl]*
**> web_auth_login username=`用户名` password=`密码` users=`users` session_ttl=`ttl`**
**users = self[^users]**
**ttl = self[^session_ttl]**
*> web_auth_login username=`用户名` password=`密码` users=`users` session_ttl=`ttl`*
## 校验
+ `会话id`
会话有效时返回 `{ok, username}`。
**> web_auth_check session_id=`会话id`**
*> web_auth_check session_id=`会话id`*
## 登出
+ `会话id`
销毁会话。
**> web_auth_logout session_id=`会话id`**
*> web_auth_logout session_id=`会话id`*
## 哈希密码
+ `密码`
将明文口令哈希为 argon2id 字符串,写入用户表的 `密码` 列;登录时自动校验。
**> web_password_hash password=`密码`**
*> web_password_hash password=`密码`*
# 缓存
+ `地址`="memory:"
@@ -832,13 +832,13 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
键值缓存。`memory:` 为进程内(测试 / 单进程);`redis://主机:6379/0` 连 Redis。
> 确保插件
**> web_cache_new url=`地址`**
*> web_cache_new url=`地址`*
## 获取
+ `键`
*url = self[^url]*
**> web_cache_get url=`url` key=`键`**
**url = self[^url]**
*> web_cache_get url=`url` key=`键`*
## 设置
+ `键`
@@ -847,26 +847,26 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
过期时间为秒;省略则不过期。
*url = self[^url]*
**> web_cache_set url=`url` key=`键` value=`值` ttl=`过期`**
**url = self[^url]**
*> web_cache_set url=`url` key=`键` value=`值` ttl=`过期`*
## 删除
+ `键`
*url = self[^url]*
**> web_cache_del url=`url` key=`键`**
**url = self[^url]**
*> web_cache_del url=`url` key=`键`*
## 存在
+ `键`
*url = self[^url]*
**> web_cache_exists url=`url` key=`键`**
**url = self[^url]**
*> web_cache_exists url=`url` key=`键`*
## 剩余时间
+ `键`
*url = self[^url]*
**> web_cache_ttl url=`url` key=`键`**
**url = self[^url]**
*> web_cache_ttl url=`url` key=`键`*
# 存储
+ `地址`="file:data/blobs"
@@ -874,7 +874,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
对象存储。`file:目录` 落本地盘(离线 / 金样);`s3://桶?endpoint=http://127.0.0.1:9000&access_key=…&secret_key=…` 连 MinIO / S3。
> 确保插件
**> web_storage_new url=`地址`**
*> web_storage_new url=`地址`*
## 上传
+ `键`
@@ -884,26 +884,26 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
正文(文本)与路径(本地文件)二选一。
*url = self[^url]*
**> web_storage_put url=`url` key=`键` body=`正文` path=`路径` content_type=`类型`**
**url = self[^url]**
*> web_storage_put url=`url` key=`键` body=`正文` path=`路径` content_type=`类型`*
## 下载
+ `键`
*url = self[^url]*
**> web_storage_get url=`url` key=`键`**
**url = self[^url]**
*> web_storage_get url=`url` key=`键`*
## 删除对象
+ `键`
*url = self[^url]*
**> web_storage_delete url=`url` key=`键`**
**url = self[^url]**
*> web_storage_delete url=`url` key=`键`*
## 列出
+ `前缀`=""
*url = self[^url]*
**> web_storage_list url=`url` prefix=`前缀`**
**url = self[^url]**
*> web_storage_list url=`url` prefix=`前缀`*
# 媒体
+ `存储`=None
@@ -911,7 +911,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
上传校验与落盘辅助(HTTP `应用.上传` 亦用同一套规则)。
> 确保插件
**> web_media_new storage=`存储`**
*> web_media_new storage=`存储`*
## 校验
+ `文件名`
@@ -920,7 +920,7 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `最大字节`=5242880
+ `允许`=None
**> web_upload_validate filename=`文件名` content_type=`类型` size=`大小` max_bytes=`最大字节` types=`允许`**
*> web_upload_validate filename=`文件名` content_type=`类型` size=`大小` max_bytes=`最大字节` types=`允许`*
## 保存
+ `路径`
@@ -929,12 +929,12 @@ SEO / OpenGraph 元数据表(`|键|值|`)。如 `title`、`description`、`c
+ `前缀`=uploads/
+ `存储`=None
*st = 存储*
**st = 存储**
1. `st` == None
*st = self[^storage]*
**st = self[^storage]**
2. *
**> web_upload_save storage=`st` path=`路径` key=`键` content_type=`类型` prefix=`前缀`**
*> web_upload_save storage=`st` path=`路径` key=`键` content_type=`类型` prefix=`前缀`*
# 实时
+ `超时秒`=30
@@ -948,7 +948,7 @@ WebSocket 客户端工具。
|-------------|-------|
| `超时秒` | ws |
**out**
*out*
## 连接
+ `地址`
@@ -957,5 +957,5 @@ WebSocket 客户端工具。
单次请求-响应:连接 `地址`,发送 `消息`,收集服务器全部文本回复后关闭。返回 `{ok, messages}`。
*timeout = self[^timeout_sec]*
**> web_ws_connect url=`地址` message=`消息` headers=`headers` timeout_sec=`timeout`**
**timeout = self[^timeout_sec]**
*> web_ws_connect url=`地址` message=`消息` headers=`headers` timeout_sec=`timeout`*
+1 -1
View File
@@ -107,6 +107,6 @@ Exact FIND→REPLACE once in a UTF-8 text file. `find` must match exactly once.
Apply plan-style triple-angle FIND/REPLACE blocks from `text` to `path`.
Also accepts fenced find/replace pairs and minimal Begin Patch hunks.
When `soft=True`, *only* “FIND not found” returns `0` (run continues). Empty FIND, multi-match, parse errors, and whole-file FIND still abort — whole-file rewrite is forbidden.
When `soft=True`, only “FIND not found” returns `0` (run continues). Empty FIND, multi-match, parse errors, and whole-file FIND still abort — whole-file rewrite is forbidden.
*> host_apply_patch_blocks path=`path` text=`text` soft=`soft`*
+4 -4
View File
@@ -17,7 +17,7 @@ level is debug / info / warn / error.
**line = > host_log_line level="debug" text=`text` fields=`fields`**
1. `line`
> print text=`line`
2. **
2. *
****
## info
@@ -27,7 +27,7 @@ level is debug / info / warn / error.
**line = > host_log_line level="info" text=`text` fields=`fields`**
1. `line`
> print text=`line`
2. **
2. *
****
## warn
@@ -37,7 +37,7 @@ level is debug / info / warn / error.
**line = > host_log_line level="warn" text=`text` fields=`fields`**
1. `line`
> print text=`line`
2. **
2. *
****
## error
@@ -47,5 +47,5 @@ level is debug / info / warn / error.
**line = > host_log_line level="error" text=`text` fields=`fields`**
1. `line`
> print text=`line`
2. **
2. *
****
+1 -1
View File
@@ -10,7 +10,7 @@ description: >-
+ `at`
+ `value`
Directly update one element. `at=` is a text key, a *1-based* list index, or a list path of keys/indices (same nesting as footnotes).
Directly update one element. `at=` is a text key, a 1-based list index, or a list path of keys/indices (same nesting as footnotes).
*> host_collection_put in=`in` at=`at` value=`value`*
+1 -1
View File
@@ -9,7 +9,7 @@ description: Persist run output in .mq.md (Jupyter-style writeback)
+ `key`=None
+ `line`=None
Write `value` to `<!-- marqdo-out … -->` in the entry file. Default: insert or replace the block immediately below the call; `at_end=true` replaces the unkeyed EOF block. With `key=` (e.g. `ok` / `error`), replace or create that *named* slot only — slots do not overwrite each other. Optional `line=` anchors the block under that source line (needed when writing from a subtask).
Write `value` to `<!-- marqdo-out … -->` in the entry file. Default: insert or replace the block immediately below the call; `at_end=true` replaces the unkeyed EOF block. With `key=` (e.g. `ok` / `error`), replace or create that named slot only — slots do not overwrite each other. Optional `line=` anchors the block under that source line (needed when writing from a subtask).
*> host_writeback_record value=`value` at_end=`at_end` key=`key` line=`line`*
+4 -4
View File
@@ -17,7 +17,7 @@ description: 按级别过滤的一行日志(中层 M6 + Mid2 M10 字段)。
**line = > host_log_line level="debug" text=`内容` fields=`字段`**
1. `line`
> 打印 内容=`line`
2. **
2. *
****
## 信息
@@ -27,7 +27,7 @@ description: 按级别过滤的一行日志(中层 M6 + Mid2 M10 字段)。
**line = > host_log_line level="info" text=`内容` fields=`字段`**
1. `line`
> 打印 内容=`line`
2. **
2. *
****
## 警告
@@ -37,7 +37,7 @@ description: 按级别过滤的一行日志(中层 M6 + Mid2 M10 字段)。
**line = > host_log_line level="warn" text=`内容` fields=`字段`**
1. `line`
> 打印 内容=`line`
2. **
2. *
****
## 错误
@@ -47,5 +47,5 @@ description: 按级别过滤的一行日志(中层 M6 + Mid2 M10 字段)。
**line = > host_log_line level="error" text=`内容` fields=`字段`**
1. `line`
> 打印 内容=`line`
2. **
2. *
****
+1 -1
View File
@@ -10,7 +10,7 @@ description: >-
+ `于`
+ `值`
直接改某一元。`于=` 为文本键、*1-based* 下标,或键/下标组成的路径列表(与脚注嵌套同构)。
直接改某一元。`于=` 为文本键、1-based 下标,或键/下标组成的路径列表(与脚注嵌套同构)。
*> host_collection_put in=`入` at=`于` value=`值`*
+6 -6
View File
@@ -9,17 +9,17 @@ import fs:lib/fs.mq.md
# main
*`goal`=> input "你想完成什么任务?"*
**`goal`=> input "你想完成什么任务?"**
> llm.load_env path=.env
*`model` = > llm.llm *
*`tools` = > json.parse text=[] *
*`助手` = > agent.agent model=`model` tools=`tools` standing=You are a Marqdo agent-development master. Prefer DONE when the workbook already satisfies the goal. *
**`model` = > llm.llm **
**`tools` = > json.parse text=[] **
**`助手` = > agent.agent model=`model` tools=`tools` standing=You are a Marqdo agent-development master. Prefer DONE when the workbook already satisfies the goal. **
流式开在 plan 上:非命中先 plan:decompose(父分解增量),再 plan:await(子 quiet),然后父修订轮。
*`out` = > `助手`.plan goal=`goal` max_rounds=3 writeback=False stream=True echo=True force=True *
**`out` = > `助手`.plan goal=`goal` max_rounds=3 writeback=False stream=True echo=True force=True **
*`result` = > json.get value=`out` key=result *
**`result` = > json.get value=`out` key=result **
> print text=`result`
+2 -2
View File
@@ -5,8 +5,8 @@ description: AI禁止更改
# main
*`a` = True*
*`b` = False*
**`a` = True**
**`b` = False**
1. `a` and not `b`
> print text=ok
+1 -1
View File
@@ -7,6 +7,6 @@ description: AI禁止更改
测试输入
*`name`=> input "你叫什么名字\n"*
**`name`=> input "你叫什么名字\n"**
> print `name`
+4 -4
View File
@@ -16,18 +16,18 @@ $$
x^2 - 2
$$
*`ty` = > type `f` *
**`ty` = > type `f` **
> print text=`ty`
*`df` = > math.diff formula=`f` var=x *
**`df` = > math.diff formula=`f` var=x **
> print text=`df`
*`roots` = > math.solve formula=`f` var=x *
**`roots` = > math.solve formula=`f` var=x **
> print text=`roots`
*`y` = > math.eval formula=`f` var=x value=3 *
**`y` = > math.eval formula=`f` var=x value=3 **
> print text=`y`
+1 -1
View File
@@ -8,7 +8,7 @@ import writeback:lib/writeback.mq.md
测试写回库
*`name`=>input "你叫什么名字?\n"*
**`name`=>input "你叫什么名字?\n"**
> writeback.record `name`
<!-- marqdo-out
+1 -1
View File
@@ -7,7 +7,7 @@ description: AI禁止更改
测试循环语句语句
*`n`=0*
**`n`=0**
- `n` < 42
`n`=`n`+1
+121 -2
View File
@@ -7,6 +7,7 @@ import (
"github.com/marqdo/marqdo/plugins/web/internal/assets"
"github.com/marqdo/marqdo/plugins/web/internal/db"
"github.com/marqdo/marqdo/plugins/web/internal/form"
"github.com/marqdo/marqdo/plugins/web/internal/table"
)
@@ -681,10 +682,128 @@ func renderPagination(page map[string]any, total int64, itemCount int) string {
return s.String()
}
func formMountID(target string) string {
t := strings.TrimSpace(strings.TrimPrefix(strings.TrimSpace(target), "#"))
if t == "" {
return ""
}
for _, c := range t {
if c == ' ' || c == '\t' || c == '\n' || c == '"' || c == '\'' || c == '<' || c == '>' {
return ""
}
}
return t
}
// injectHTMLIntoID puts payload inside the first element with id="…" / id='…'.
func injectHTMLIntoID(haystack, id, payload string) (string, bool) {
id = formMountID(id)
if id == "" {
return "", false
}
patterns := []string{`id="` + id + `"`, `id='` + id + `'`}
for _, pat := range patterns {
idx := strings.Index(haystack, pat)
if idx < 0 {
continue
}
tagStart := strings.LastIndex(haystack[:idx], "<")
if tagStart < 0 {
continue
}
if tagStart+1 >= len(haystack) {
continue
}
afterLt := haystack[tagStart+1]
if afterLt == '/' || afterLt == '!' {
continue
}
nameEnd := tagStart + 1
for nameEnd < len(haystack) {
c := haystack[nameEnd]
if c == ' ' || c == '\t' || c == '\n' || c == '>' || c == '/' {
break
}
nameEnd++
}
tagName := strings.TrimSpace(haystack[tagStart+1 : nameEnd])
if tagName == "" {
continue
}
afterID := idx + len(pat)
rel := strings.IndexByte(haystack[afterID:], '>')
if rel < 0 {
continue
}
openGt := afterID + rel
if openGt > 0 && haystack[openGt-1] == '/' {
continue
}
close := "</" + tagName + ">"
rest := haystack[openGt+1:]
closeRel := strings.Index(strings.ToLower(rest), strings.ToLower(close))
if closeRel < 0 {
continue
}
closeIdx := openGt + 1 + closeRel
var out strings.Builder
out.Grow(len(haystack) + len(payload))
out.WriteString(haystack[:openGt+1])
out.WriteString(payload)
out.WriteString(haystack[closeIdx:])
return out.String(), true
}
return "", false
}
func pageFormHTML(page map[string]any) (formID string, html string) {
if page == nil {
return "", ""
}
id, _ := page["form_id"].(string)
id = strings.TrimSpace(id)
if id == "" {
return "", ""
}
frm, ok := page["form"].(map[string]any)
if !ok || frm == nil {
return "", ""
}
return id, form.RenderBody(frm, id, nil, nil, "")
}
func pushIntro(buf *strings.Builder, intro string) {
pushIntroAndForm(buf, intro, nil)
}
// pushIntroAndForm writes intro and optional composed form (GAP-11 form_target inject).
func pushIntroAndForm(buf *strings.Builder, intro string, page map[string]any) {
formID, formHTML := pageFormHTML(page)
target := ""
if page != nil {
if t, ok := page["form_target"].(string); ok {
target = t
} else if t, ok := page["target"].(string); ok {
target = t
} else if t, ok := page["form_slot"].(string); ok {
target = t
} else if t, ok := page["表单插槽"].(string); ok {
target = t
}
}
if formHTML != "" && target != "" && intro != "" {
if injected, ok := injectHTMLIntoID(intro, target, formHTML); ok {
buf.WriteString(fmt.Sprintf(`<div class="main-intro">%s</div>`, injected))
return
}
}
if intro != "" {
buf.WriteString(fmt.Sprintf(`<div class="main-intro">%s</div>`, intro))
}
if formHTML != "" {
buf.WriteString(formHTML)
_ = formID
}
}
func renderFragment(page map[string]any, dbURL, slot string) string {
@@ -711,7 +830,7 @@ func renderFragment(page map[string]any, dbURL, slot string) string {
default:
intro, items, _ := resolveMain(page, dbURL)
var body strings.Builder
pushIntro(&body, intro)
pushIntroAndForm(&body, intro, page)
if len(items) > 0 {
isDetail, _ := page["detail"].(bool)
if isDetail {
@@ -815,7 +934,7 @@ func RenderPage(page map[string]any, dbURL string, partID string) string {
if images, ok := page["images_html"].(string); ok && images != "" {
mainHTML.WriteString(images)
}
pushIntro(&mainHTML, intro)
pushIntroAndForm(&mainHTML, intro, page)
if len(items) > 0 {
isDetail, _ := page["detail"].(bool)
if isDetail {
+2 -2
View File
@@ -7,7 +7,7 @@ import foreign:lib/foreign.mq.md
# main
Hi — thanks for reading this far. I am Marqdo’s developer. Marqdo is a language where **code is documentation, and documentation is code**: Markdown markers are the program structure, so what you read is what runs.
Hi — thanks for reading this far. I am Marqdo’s developer. Marqdo is a language where *code is documentation, and documentation is code*: Markdown markers are the program structure, so what you read is what runs.
AI already prefers Markdown-shaped output. The idea was: why keep docs and code as two separate worlds? So Marqdo was born as a “docs are code” language. To keep every source renderable as Markdown, files use the `.mq.md` suffix. From early on we aimed for richer tooling — auto-generated YAML for OKF-style knowledge bases, even auto-generated slides — those are later goals. Happily, it already works well as a blogging tool: yes, this site is generated by Marqdo. And when AI writes Marqdo, you tend to burn fewer tokens — wallets everywhere thank you.
@@ -41,7 +41,7 @@ $$
Then plot it:
*`_svg` = > math.plot formula=`f` var="x" min=-3 max=3*
**`_svg` = > math.plot formula=`f` var="x" min=-3 max=3**
The foreign library lets you call external code, for example:
+2 -2
View File
@@ -7,7 +7,7 @@ description: 用户文档首页 — 代码即文档(中文版)
# main
阅读到这里的朋友你好!我是 Marqdo 的开发者。Marqdo 是一门**代码即文档,文档即代码**的语言:Markdown 标记就是程序结构,你读到的就是能跑的程序。
阅读到这里的朋友你好!我是 Marqdo 的开发者。Marqdo 是一门*代码即文档,文档即代码*的语言:Markdown 标记就是程序结构,你读到的就是能跑的程序。
AI 偏爱 Markdown结构的输出。作者的念头是:何必再把文档和代码拆成两套?我们来实现一个文档即代码的语言,所以marqdo应运而生,为了确保代码一定可以被渲染,marqdo的文件后缀定义为了`.mq.md`。在开发之处我们就尝试希望更丰富的支持,自动生成一个yaml文件使得 OKF 式知识库便捷的自动配置,乃至自动生成ppt,自然这都是以后的目标了。不过相当不错的是,至少这会成为一个不错的博客工具——对,这个站点就是 Marqdo 生成的,而且AI输出的时候会节约不少token,你知道的,token烧的太多,钱包会可怜的饿瘦的。
@@ -41,7 +41,7 @@ $$
之后让我们画个图像吧!
*`_svg` = > 数学.绘图 formula=`f` var="x" min=-3 max=3*
**`_svg` = > 数学.绘图 formula=`f` var="x" min=-3 max=3**
外联库则允许你调用外部代码,例如:
+1 -1
View File
@@ -34,7 +34,7 @@ ext/llm — OpenAI-compatible chat. Design: doc/design/ext-llm.md
ext/agent — agent framework + native plugin. Design: doc/design/ext-agent.md
ext/web — HTTP / SQLite·Postgres site helpers + native plugin (default **Go libweb**, v0.4.0). **W0–W7 + P3 + W8** + **customization C0–C4**; acceptance example `examples/anlian-mq/`. **Browser embed (routes D/E/F, v0.3.4)**: `web.client_embed` auto-mounts WASM — zero author JS; `lib/browser` + GFM tables; build with `marqdo wasm build`; examples: browser-hello · browser-app · browser-media · web-client-site. Design: doc/design/ext-web.md · WASM: doc/adr/0002-browser-marqdo-wasm.md · roadmaps D/E/F.
ext/web — HTTP / SQLite·Postgres site helpers + native plugin (default *Go libweb*, v0.4.0). **W0–W7 + P3 + W8** + **customization C0–C4**; acceptance example `examples/anlian-mq/`. **Browser embed (routes D/E/F, v0.3.4)**: `web.client_embed` auto-mounts WASM — zero author JS; `lib/browser` + GFM tables; build with `marqdo wasm build`; examples: browser-hello · browser-app · browser-media · web-client-site. Design: doc/design/ext-web.md · WASM: doc/adr/0002-browser-marqdo-wasm.md · roadmaps D/E/F.
ext/quantum — circuits, draw, noise, formula matrix custom gates, Q7 density/viz, Q8 themed SVG (`theme=dark|light|bw`). Design: doc/design/ext-quantum.md · doc/design/ext-quantum-viz-style.md
+1 -1
View File
@@ -34,7 +34,7 @@ ext/llm(大模型)— OpenAI 兼容聊天。设计:doc/design/ext-llm.md
ext/agent(智能体)— 智能体框架 + 原生插件。设计:doc/design/ext-agent.md
ext/web(网页)— HTTP / SQLite 站点助手 + 原生插件(默认 **Go libweb**,v0.4.0)。**W0–W7 + P3 + W8** + **定制 C0–C4**;验收示例 `examples/anlian-mq/`。**浏览器挂载(路线 D/E/F,v0.3.4)**:`网页.客户端挂载` / `web.client_embed` 自动 mount(作者零业务 JS);`lib/浏览器` + GFM;先 `marqdo wasm build`;示例 examples/browser-hello/ · examples/browser-app/ · examples/browser-media/ · examples/web-client-site/。设计:doc/design/ext-web.md · WASM:doc/adr/0002-browser-marqdo-wasm.md · 路线 D/E/F:doc/roadmap/browser-wasm-*.md
ext/web(网页)— HTTP / SQLite 站点助手 + 原生插件(默认 *Go libweb*,v0.4.0)。**W0–W7 + P3 + W8** + **定制 C0–C4**;验收示例 `examples/anlian-mq/`。**浏览器挂载(路线 D/E/F,v0.3.4)**:`网页.客户端挂载` / `web.client_embed` 自动 mount(作者零业务 JS);`lib/浏览器` + GFM;先 `marqdo wasm build`;示例 examples/browser-hello/ · examples/browser-app/ · examples/browser-media/ · examples/web-client-site/。设计:doc/design/ext-web.md · WASM:doc/adr/0002-browser-marqdo-wasm.md · 路线 D/E/F:doc/roadmap/browser-wasm-*.md
ext/quantum(量子)— 电路、绘图、噪声、公式矩阵自定义门、Q7 密度/高级图、Q8 主题 SVG(`主题=dark|light|bw`)。设计:doc/design/ext-quantum.md · doc/design/ext-quantum-viz-style.md
+5 -5
View File
@@ -22,11 +22,11 @@ Q8: `draw theme="dark"|"light"|"bw"` (default dark lab look) on circuit / probs
| 2 | CX | 0,1 |
| 3 | CX | 0,2 |
*`qc` = > quantum.circuit qubits=3 steps=`steps`*
*`p` = > `qc`.probabilities*
*`_` = > `qc`.draw kind="probs" theme="dark"*
*`H` = > quantum.gate name="H"*
*`__` = > `H`.draw kind="matrix"*
**`qc` = > quantum.circuit qubits=3 steps=`steps`**
**`p` = > `qc`.probabilities**
**`_` = > `qc`.draw kind="probs" theme="dark"**
**`H` = > quantum.gate name="H"**
**`__` = > `H`.draw kind="matrix"**
> print text=`p`
> print text=quantum-feature-ok
+5 -5
View File
@@ -22,11 +22,11 @@ Q8:`绘图 主题="dark"|"light"|"bw"`(默认 dark 科技感)作用于电
| 2 | CX | 0,1 |
| 3 | CX | 0,2 |
*`qc` = > 量子.电路 比特数=3 步骤=`步骤`*
*`p` = > `qc`.概率*
*`_` = > `qc`.绘图 种类="probs" 主题="dark"*
*`H` = > 量子.门 名="H"*
*`__` = > `H`.绘图 种类="matrix"*
**`qc` = > 量子.电路 比特数=3 步骤=`步骤`**
**`p` = > `qc`.概率**
**`_` = > `qc`.绘图 种类="probs" 主题="dark"**
**`H` = > 量子.门 名="H"**
**`__` = > `H`.绘图 种类="matrix"**
> 打印 内容=`p`
> 打印 内容=量子特性-ok
+6 -6
View File
@@ -8,7 +8,7 @@ import la:ext/linalg/linalg.mq.md
Not stdlib. Install: `marqdo ext add linalg` (or build `marqdo_plugin_linalg`).
**Idea:** if the `.mq.md` runs and the asserted form matches, the identity holds under the library rules. Algebra reads like a lecture; `factorize` / `lstsq` / `draw` stay explicit calculation steps.
*Idea:* if the `.mq.md` runs and the asserted form matches, the identity holds under the library rules. Algebra reads like a lecture; `factorize` / `lstsq` / `draw` stay explicit calculation steps.
# main
@@ -21,11 +21,11 @@ Declare symbols in a table, multiply, transpose — `T_ascii` is one-step displa
| 1 | A | 2 | 3 |
| 2 | B | 3 | 2 |
*`env` = > la.declare table=`shapes`*
*`A` = env[^A]*
*`B` = env[^B]*
*`P` = `A` * `B`*
*`t` = > `P`.T_ascii*
**`env` = > la.declare table=`shapes`**
**`A` = env[^A]**
**`B` = env[^B]**
**`P` = `A` * `B`**
**`t` = > `P`.T_ascii**
> print text=`t`
1. `t` == "B^T*A^T"
> print text=formula-doc-ok
+6 -6
View File
@@ -8,7 +8,7 @@ description: ext/linalg 公式文档面 — 声明、中缀、跑通即正确
可选扩展(非 stdlib)。安装:`marqdo ext add linalg`(中文 id:`线性代数`)。
**思想:** `.mq.md` 能跑通且断言的规范形一致,则在库规则下该恒等式成立。代数叙述像讲义;`分解` / `最小二乘` / `绘图` 才是显式计算步骤。
*思想:* `.mq.md` 能跑通且断言的规范形一致,则在库规则下该恒等式成立。代数叙述像讲义;`分解` / `最小二乘` / `绘图` 才是显式计算步骤。
# main
@@ -21,11 +21,11 @@ description: ext/linalg 公式文档面 — 声明、中缀、跑通即正确
| 1 | A | 2 | 3 |
| 2 | B | 3 | 2 |
*`环境` = > la.声明 表=`形状`*
*`A` = 环境[^A]*
*`B` = 环境[^B]*
*`P` = `A` * `B`*
*`t` = > `P`.转置文本*
**`环境` = > la.声明 表=`形状`**
**`A` = 环境[^A]**
**`B` = 环境[^B]**
**`P` = `A` * `B`**
**`t` = > `P`.转置文本**
> 打印 内容=`t`
1. `t` == "B^T*A^T"
> 打印 内容=formula-doc-ok
+3 -3
View File
@@ -11,9 +11,9 @@ Mid-tier stdlib: everyday primitives stay in `lib/`, not ABI plugins.
# main
*`ok` = > re.is_match text="user@example.com" pattern="^[^@]+@[^@]+$"*
*`tok` = > enc.base64_encode text="marqdo"*
*`hex` = > enc.hex_encode text="ok"*
**`ok` = > re.is_match text="user@example.com" pattern="^[^@]+@[^@]+$"**
**`tok` = > enc.base64_encode text="marqdo"**
**`hex` = > enc.hex_encode text="ok"**
> print text=`ok`
> print text=`tok`
> print text=`hex`
+3 -3
View File
@@ -11,9 +11,9 @@ description: lib/正则 + lib/编码,无需插件(中层 M1)
# main
*`ok` = > 正则.匹配 内容="user@example.com" 模式="^[^@]+@[^@]+$"*
*`tok` = > 编码.基64编码 内容="marqdo"*
*`hex` = > 编码.十六进制编码 内容="ok"*
**`ok` = > 正则.匹配 内容="user@example.com" 模式="^[^@]+@[^@]+$"**
**`tok` = > 编码.基64编码 内容="marqdo"**
**`hex` = > 编码.十六进制编码 内容="ok"**
> 打印 内容=`ok`
> 打印 内容=`tok`
> 打印 内容=`hex`
+3 -3
View File
@@ -11,11 +11,11 @@ Join and normalize without plugins; copy/move stay sandboxed under the program d
# main
*`p` = > path.join a="out" b="demo.txt"*
*`n` = > path.normalize path="out/./x/../demo.txt"*
**`p` = > path.join a="out" b="demo.txt"**
**`n` = > path.normalize path="out/./x/../demo.txt"**
> fs.write_text path=`p` text="path-m2"
> fs.copy_file src=`p` dest="out/demo-copy.txt"
*`body` = > fs.read_text path="out/demo-copy.txt"*
**`body` = > fs.read_text path="out/demo-copy.txt"**
> print text=`p`
> print text=`n`
> print text=`body`
+3 -3
View File
@@ -11,11 +11,11 @@ description: lib/路径 + 文件复制/移动/临时(中层 M2)
# main
*`p` = > 路径.拼接 甲="out" 乙="demo.txt"*
*`n` = > 路径.规范化 路径="out/./x/../demo.txt"*
**`p` = > 路径.拼接 甲="out" 乙="demo.txt"**
**`n` = > 路径.规范化 路径="out/./x/../demo.txt"**
> 文件.写文本 路径=`p` 内容="path-m2"
> 文件.复制文件 源=`p` 目标="out/demo-copy.txt"
*`body` = > 文件.读文本 路径="out/demo-copy.txt"*
**`body` = > 文件.读文本 路径="out/demo-copy.txt"**
> 打印 内容=`p`
> 打印 内容=`n`
> 打印 内容=`body`
Loaded 100 of 324 files, more files were not shown because too many files have changed in this diff. Show more