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:
1 parent
bfb10d172b
commit
b5c07385e9
324 files changed
+4572
-4339
No files matched your search
+17
-17
@@ -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 双模式。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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"
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -35,7 +35,7 @@ description: 暗恋见君壳层 — head 资源表、导航 HTML、页脚 HTML
|
||||
| script | "/static/js/feed_board.js" | 真 |
|
||||
| script | "/static/js/index.js" | 真 |
|
||||
|
||||
**`头`**
|
||||
*`头`*
|
||||
|
||||
## 导航HTML
|
||||
|
||||
|
||||
@@ -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>"*
|
||||
@@ -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 行=`行`*
|
||||
@@ -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=""*
|
||||
@@ -15,4 +15,4 @@
|
||||
| 登录 | /admin/login | | | guest |
|
||||
| 后台 | /admin | | | auth |
|
||||
|
||||
**`导航`**
|
||||
*`导航`*
|
||||
@@ -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>" + 底 + 鉴权脚本*
|
||||
@@ -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*
|
||||
@@ -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`*
|
||||
@@ -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
@@ -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 <token></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 <token></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"**
|
||||
> `应用`.监听
|
||||
@@ -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. *
|
||||
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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"*
|
||||
@@ -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"*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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`
|
||||
|
||||
@@ -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
|
||||
@@ -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
|
||||
|
||||
@@ -10,4 +10,4 @@
|
||||
| 关于 | /about | |
|
||||
| 后台 | /admin | |
|
||||
|
||||
**`页脚`**
|
||||
*`页脚`*
|
||||
@@ -12,4 +12,4 @@
|
||||
| 关于 | /about | |
|
||||
| 后台 | /admin | |
|
||||
|
||||
**`导航`**
|
||||
*`导航`*
|
||||
@@ -12,4 +12,4 @@
|
||||
| 发布文章 | /admin/new | |
|
||||
| 实时终端 | /#live | |
|
||||
|
||||
**`侧栏`**
|
||||
*`侧栏`*
|
||||
@@ -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*
|
||||
@@ -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`*
|
||||
@@ -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`*
|
||||
@@ -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`.监听
|
||||
@@ -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*
|
||||
@@ -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`
|
||||
@@ -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`
|
||||
|
||||
@@ -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`
|
||||
@@ -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
|
||||
@@ -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 | |
|
||||
|
||||
**`侧栏`**
|
||||
*`侧栏`*
|
||||
@@ -8,7 +8,7 @@
|
||||
| title | text | false |
|
||||
| body | text | true |
|
||||
|
||||
**`字段`**
|
||||
*`字段`*
|
||||
|
||||
## 种子
|
||||
|
||||
@@ -20,4 +20,4 @@
|
||||
| 2 | 登录门禁后台 | /admin 页面需要 session 会话。 |
|
||||
| 3 | WebSocket 实时 | /live 端点会把你的消息实时回显。 |
|
||||
|
||||
**`行`**
|
||||
*`行`*
|
||||
@@ -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*
|
||||
@@ -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`.监听
|
||||
@@ -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 |
|
||||
|
||||
**`卡片正文`**
|
||||
*`卡片正文`*
|
||||
@@ -7,4 +7,4 @@
|
||||
| Marqdo web-net example | https://github.com | |
|
||||
| Docs | /tools | |
|
||||
|
||||
**`foot`**
|
||||
*`foot`*
|
||||
@@ -12,4 +12,4 @@ Site top navigation. The Admin tab points at the login-gated admin page.
|
||||
| Tools | /tools | |
|
||||
| Admin | /admin | |
|
||||
|
||||
**`nav`**
|
||||
*`nav`*
|
||||
@@ -12,4 +12,4 @@ Sidebar index of what this example demonstrates.
|
||||
| Forms | /new | |
|
||||
| net lib | /tools | |
|
||||
|
||||
**`side`**
|
||||
*`side`*
|
||||
@@ -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`*
|
||||
@@ -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*
|
||||
@@ -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
|
||||
@@ -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`*
|
||||
@@ -6,4 +6,4 @@
|
||||
|------|-----|------|
|
||||
| Marqdo | https://github.com | |
|
||||
|
||||
**`foot`**
|
||||
*`foot`*
|
||||
@@ -9,4 +9,4 @@
|
||||
| 写文章 | /new | |
|
||||
| 后台 | /admin | |
|
||||
|
||||
**`nav`**
|
||||
*`nav`*
|
||||
@@ -7,4 +7,4 @@
|
||||
| 笔记 | / | |
|
||||
| 文档 | https://github.com | |
|
||||
|
||||
**`side`**
|
||||
*`side`*
|
||||
@@ -8,7 +8,7 @@
|
||||
| title | text | false |
|
||||
| body | text | true |
|
||||
|
||||
**`fields`**
|
||||
*`fields`*
|
||||
|
||||
## seed
|
||||
|
||||
@@ -19,4 +19,4 @@
|
||||
| 1 | 你好 Marqdo | 第一篇来自 GFM 表格。 |
|
||||
| 2 | 代码即文档 | 页面表就是程序。 |
|
||||
|
||||
**`rows`**
|
||||
*`rows`*
|
||||
@@ -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*
|
||||
@@ -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`.监听
|
||||
@@ -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`*
|
||||
@@ -6,4 +6,4 @@
|
||||
|------|-----|------|
|
||||
| Marqdo | https://github.com | |
|
||||
|
||||
**`foot`**
|
||||
*`foot`*
|
||||
@@ -11,4 +11,4 @@ Static top links for the shell.
|
||||
| New | /new | |
|
||||
| Admin | /admin | |
|
||||
|
||||
**`nav`**
|
||||
*`nav`*
|
||||
@@ -7,4 +7,4 @@
|
||||
| Notes | / | |
|
||||
| Docs | https://github.com | |
|
||||
|
||||
**`side`**
|
||||
*`side`*
|
||||
@@ -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`*
|
||||
@@ -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*
|
||||
@@ -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
|
||||
@@ -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
File diff suppressed because it is too large.
Load diff
+28
-28
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -10,7 +10,7 @@ description: >-
|
||||
+ `于`
|
||||
+ `值`
|
||||
|
||||
直接改某一元。`于=` 为文本键、*1-based* 下标,或键/下标组成的路径列表(与脚注嵌套同构)。
|
||||
直接改某一元。`于=` 为文本键、1-based 下标,或键/下标组成的路径列表(与脚注嵌套同构)。
|
||||
|
||||
*> host_collection_put in=`入` at=`于` value=`值`*
|
||||
|
||||
|
||||
@@ -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`
|
||||
@@ -5,8 +5,8 @@ description: AI禁止更改
|
||||
|
||||
# main
|
||||
|
||||
*`a` = True*
|
||||
*`b` = False*
|
||||
**`a` = True**
|
||||
**`b` = False**
|
||||
|
||||
1. `a` and not `b`
|
||||
> print text=ok
|
||||
|
||||
@@ -7,6 +7,6 @@ description: AI禁止更改
|
||||
|
||||
测试输入
|
||||
|
||||
*`name`=> input "你叫什么名字\n"*
|
||||
**`name`=> input "你叫什么名字\n"**
|
||||
|
||||
> print `name`
|
||||
@@ -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`
|
||||
@@ -8,7 +8,7 @@ import writeback:lib/writeback.mq.md
|
||||
|
||||
测试写回库
|
||||
|
||||
*`name`=>input "你叫什么名字?\n"*
|
||||
**`name`=>input "你叫什么名字?\n"**
|
||||
|
||||
> writeback.record `name`
|
||||
<!-- marqdo-out
|
||||
|
||||
@@ -7,7 +7,7 @@ description: AI禁止更改
|
||||
|
||||
测试循环语句语句
|
||||
|
||||
*`n`=0*
|
||||
**`n`=0**
|
||||
|
||||
- `n` < 42
|
||||
`n`=`n`+1
|
||||
|
||||
@@ -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 {
|
||||
|
||||
@@ -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
@@ -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**
|
||||
|
||||
外联库则允许你调用外部代码,例如:
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
@@ -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
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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
Reference in new issue
Block a user