From aa0c4d0f55a3c33a8600a1d2862433bd4b577d12 Mon Sep 17 00:00:00 2001 From: cflmy Date: Sun, 8 Nov 2026 23:30:17 +0800 Subject: [PATCH] =?UTF-8?q?release:=20v2.6.0=20=E2=80=94=20executable=20li?= =?UTF-8?q?brary=20handbooks=20and=20readable=20actions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/release.yml | 61 ++++---------------------- CHANGELOG.md | 47 ++++++++++++++++++++ Cargo.lock | 4 +- Cargo.toml | 2 +- README.md | 12 +++-- crates/marqdo-wasm/Cargo.toml | 2 +- debian/changelog | 8 ++++ ext/VERSION | 2 +- public/features/03-view-and-docs.mq.md | 6 ++- public/features/03-view与文档.mq.md | 6 ++- public/stdlib/00-overview.mq.md | 10 ++++- public/stdlib/00-索引.mq.md | 10 ++++- scripts/build-public.sh | 0 13 files changed, 102 insertions(+), 68 deletions(-) mode change 100644 => 100755 scripts/build-public.sh diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 916fb1b..fbb3de6 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -126,59 +126,14 @@ jobs: ## Marqdo ${{ github.ref_name }} ### 亮点 / Highlights - - **v2.5.1**:View 连线优化——真实源码锚点、连续 S 形曲线、错落与避让;工具栏文字标签;保留深浅色配色 - - **v2.5.1**: View annotation refinement — exact source anchors, flowing S-curves, staggered notes and collision avoidance; labeled toolbar; preserved themes - - **v2.5.1 ext**:扩展包同步 2.5.1 / Ext pack 2.5.1 - - **v2.5.0**:View 阅读界面重构——暖白金色主题、新 Logo、左右执行标注、导航搜索与悬浮工具栏;离线公式;重跑同次捕获刷新 - - **v2.5.0**: View reader redesign — warm paper theme, new logo, margin execution notes, navigation/search and floating controls; offline math; same-capture live refresh - - **v2.5.0 ext**:扩展包同步 2.5.0 / Ext pack 2.5.0 - - **v2.4.0**:Oracle journal 作语言值——`foreign.oracle_journal`/`replay_check`;bytecode/frontend 硬化;MSRV 1.81 - - **v2.4.0**: Oracle journal as language values — foreign.oracle_journal/replay_check; bytecode/frontend hardening; MSRV 1.81 - - **v2.4.0 ext**:扩展包同步 2.4.0 / Ext pack 2.4.0 - - **v2.3.0**:Foreign Strong——不透明 `handle`、仿射 close、`replay_check`/oracle journal、表 arity refuse、Ω∈V_safe - - **v2.3.0**: Foreign Strong — opaque handle, affine close, replay_check/oracle journal, table arity refuse, Ω∈V_safe - - **v2.3.0 ext**:扩展包同步 2.3.0 / Ext pack 2.3.0 - - **v2.2.1**:view / 静态导出——修复 occlusion 与中等宽度下大纲侧栏掉到正文下方 - - **v2.2.1**: view / static export — fix outline rail nested under document (occlusion + mid-width layout) - - **v2.2.1 ext**:扩展包同步 2.2.1 / Ext pack 2.2.1 - - **v2.2.0**:函数级调用 `marqdo call`——同一份 .mq.md 就是文档、知识和工具;Tree/Bytecode 执行被点名的函数;外部调用默认只跑纯函数 - - **v2.2.0**: `marqdo call` runs one function in any .mq.md — the file is the document, the knowledge and the tool; Tree and Bytecode execute that function; external calls stay pure - - **v2.2.0 ext**:扩展包同步 2.2.0 / Ext pack 2.2.0 - - **v2.1.5**:Agent 可靠工作台——ResourceView / ToolSpec / CheckpointV2 / EffectLedger · EKC ir.json 暖机 · Web 短读槽隔离 - - **v2.1.5**: Agent reliability workbench — ResourceView / ToolSpec / CheckpointV2 / EffectLedger, EKC ir.json warm-load, web short/read lane isolation - - **v2.1.5 ext**:扩展包同步 2.1.5 / Ext pack 2.1.5 - - **v2.1.4**:默认隔离 HTTP execute(ADR 0009)——worker 池 / `--call-lib-path` · `/_runtime/*` · MR-01 双流金样例 · `runtime.isolated_execution=1` - - **v2.1.4**: Default isolated HTTP execute (ADR 0009) — worker pool / `--call-lib-path`, `/_runtime/*`, MR-01 dual-stream gold, `runtime.isolated_execution=1` - - **v2.1.3**:知识工作台运行时——ModelSelection/RunContext/usage · view document 只读嵌入 · LLM selection/messages/cancel · agent selection e2e - - **v2.1.3**: Workbench runtime — ModelSelection/RunContext/usage, view document read-only embed, LLM selection/messages/cancel, agent selection e2e - - **v2.1.1**:可执行知识主链——BoundCall · NarrativeRef · 来源/适用期 · patch/extract · 整代 CURRENT + closure · 发票示例 113 - - **v2.1.1**: Executable-knowledge spine — BoundCall, NarrativeRef, sources, patch/extract, generation CURRENT + closure, invoice example 113 - - **v1.5.2**:外联 v3 P0/P1——raw stdin + 每 cell 输入 · plan API · snapshot · `view capture` · Persist - - **v1.5.2**: Foreign v3 P0/P1 — raw stdin + per-cell inputs, plan API, snapshot export/import/replay, `view capture`, Persist - - **v1.5.2 ext**:扩展包同步 1.5.2 / Ext pack 1.5.2 - - **v1.5.1**:view 静态/动态统一 + 外联值传递——共用执行路径 · 构建时运行注入 stdout · `foreign.session` 值传递 · cell stdin - - **v1.5.1**: View static/live unified + foreign value passing — shared execution path, build-time run with stdout injection, `foreign.session` value passing, cell stdin - - **v1.5.0**:外联 v2 + 文档原生 Notebook——invoke/JSON call/并行/持久 Python·Node/状态桥 · cell 单步 · 高对比 view - - **v1.5.0**: Foreign v2 + document-native notebooks — invoke, JSON calls, fan-out, persistent Python/Node, state bridge, cell stepping, high-contrast view - - **v1.5.0 ext**:扩展包同步 1.5.0 / Ext pack 1.5.0 - - **v1.4.6**:裸自增升参——首次粗体赋值左值即声明;`n = n + 1` 无反引号也是必选形参 - - **v1.4.6**: Bare self-increment is a required parameter — first bold assignment LHS is a declaration - - **v1.4.5**:Streamable HTTP MCP + web invoke Bearer/401 · openai/agent json.get 硬化 - - **v1.4.5**: Streamable HTTP MCP + web invoke Bearer/401; openai/agent json.get hardening - - **v1.4.2**:Agent/LLM 优化 O1–O5——sandbox trial · promote proof · step_route/EFI/cost · lint · quarantine - - **v1.4.2**: Agent/LLM optimize O1–O5 — sandbox trial, promote proof, step_route/EFI/cost, lint, quarantine - - **v1.4.1**:view 标注连线——SVG mid→mid(underline 底中 → chip 顶中)· 帧 chip id 对齐 · L→R 密度 - - **v1.4.1**: View annot leaders — SVG mid→mid (mark bottom-center → chip top-center), frame chip id unify, L→R density - - **v1.4.0**:叙述统一——`% marqdo: var=` · 臂/循环体叙述 · foreach 中英糖 · 图片自写回 · view 推断形参 - - **v1.4.0**: Prose-unified control flow — formula meta bind, arm/loop narrative, foreach sugar, image writeback, inferred-param view - - **v1.3.3**:view 文档面 Structure——叙述保真 · 标记面 · 调用/循环帧 · `#mq-view-trace` · 静态站同源 - - **v1.3.3**: Browse document-surface Structure — narration, markers, call/loop frames, `#mq-view-trace`, static site parity - - **v1.3.0**:Engineering Knowledge Compiler——L0–L4 · `reuse`/`find`/`duplicate` · Agent preflight(REUSE→ADAPT→CREATE) - - **v1.3.0**: Engineering Knowledge Compiler — L0–L4 catalog, reuse/find/duplicate, Agent preflight (REUSE→ADAPT→CREATE) - - **v1.2.0**:Web Artifact(ADR 0007)——Document/Endpoint · `web.serve`/`render`/`inspect` · `ext/data|security|net` · 移除 `compose_*`/`configure` - - **v1.2.0**: Web Artifact (ADR 0007) — Document/Endpoint, web.serve/render/inspect, ext/data|security|net, compose_*/configure removed - - **Linux 包必出**:`*-native-x86_64-unknown-linux-gnu.zip` + Linux CLI bundle - - Details: [CHANGELOG](https://github.com/cflmy/marqdo/blob/main/CHANGELOG.md) · [ext-ai-optimize](https://github.com/cflmy/marqdo/blob/main/doc/roadmap/ext-ai-optimize.md) + - **2.6.0**:标准库与拓展库成为可执行手册;650 个公开标准库函数,标题下契约、叙述形参与句中调用。 + - **2.6.0**: Executable library handbooks, 650 public standard-library functions, inline actions and source contracts. + - 文件/字节/集合/Result/文档/HTTP/任务/TOML/时区工程能力;Quantum 实验与 Web 递归 Markdown 布局。 + - File, binary, collection, document and task workflows; executable Quantum experiments and recursive Web layouts. + - View 正文读动作,左右侧注看逻辑;空逻辑明确提示;知识区按输入、返回和依据组织。 + - View keeps action text in prose, implementation in margin notes, and readable knowledge facts separate from execution. + - CLI · wasm · ext · VS Code extension: **2.6.0**. Core surface unchanged: **19 constructs**. + - Linux CLI and native plugin zips are required; see CHANGELOG for exact platform/effect boundaries. ### Downloads diff --git a/CHANGELOG.md b/CHANGELOG.md index 004be8e..b5b2c27 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,53 @@ ### Changed +## v2.6.0 — 2026-11-08 + +### Highlights / 亮点 + +标准库、拓展库与阅读界面共同围绕“源码即手册,文档即 SKILL,函数即工具”完成更新。 +CLI、WASM、扩展包与 VS Code 扩展统一为 2.6.0。 + +- 标准库新增完整文件整理、二进制与分块、集合处理、结构化数据、文档修改、HTTP、子任务与时区能力。 +- 61 份公开标准库提供 650 个函数,保持单文件自述;多文件拓展库通过 index 组织真实工作流。 +- Quantum 提供可执行实验与会话句柄;Web 明确从区域树递归拆到 Markdown 叶子的工程方式。 +- View 正文只呈现动作说明,实际逻辑进入左右侧注,空括号明确提示待补逻辑;知识区按输入输出与依据组织。 +- Standard libraries add practical file, binary, collection, structured-data, document, HTTP, task and timezone workflows. +- Libraries are executable handbooks with contracts, narrative parameters and readable inline operations; View separates action text, implementation and observed results. + +**核心表面 Δ(Core surface Δ)**:无增删,仍为 19 个核心构造。新增能力属于 Runtime / Document; +行内遮蔽边界与 GFM 转义修复沿用既有标记,不引入另一套语法或 Skill 编译器。 + +### Added + +- 文件:查找、行读写、JSON/CSV 读写、二进制字节和分块操作、临时资源、单文件原子写、摘要检查、目录批处理与可选 ZIP。 +- 集合:范围、枚举、投影、筛选、首项/任一/全部判断、分组汇总、连接、集合运算、模式校验及 key/value 行记录构造。 +- 数据与工程:Result、完整 TOML、IANA 时区/DST、结构化 HTTP 结果与下载、子任务超时/并发/取消、保留周围叙述的受控文档修改。 +- 标准库单文件手册、开发指南、真实工程示例,以及数据、安全、网络、线性代数、AI 的工程入口与安装依赖。 +- Quantum 任务导航、实验与双语门面;Web 递归布局、普通 Markdown 叶子和双语参考站点;call 会话中传递实际资源句柄。 +- View 核心语法阅读指南、实现侧注、可读知识卡片、最终绑定与调用记录,以及静态/实时/无脚本浏览器验收。 + +### Fixed + +- 修复中文智能体单步被说明中的斜体 map 提前返回、事务构造器返回未绑定 self、策略说明标题被误识别为对象等旧问题。 +- 修复行内遮蔽中标签星号和载荷乘法的结束边界,以及 GFM 单元格的转义竖线。 +- 修复整句遮蔽只处理首个链接、改写叙述的问题;普通导航与文字字面量不冒充可执行逻辑。 +- 单文件 View 只分析实际依赖闭包,避免无关同目录模块重名使知识说明整体不可用。 +- 修复回放策略 wire 命令与 agent smoke 工具注册,保持可执行知识门禁可复现。 + +### Changed + +- 标准库和拓展库的参数与返回表紧接标题;移除库源码中的旧加号形参,使用叙述形参与句中赋值、调用、返回。 +- 每个库单元叙述超过 50%;行内代码和绑定数据表仍计作代码,避免以模板或排版替代说明。 +- 知识区将身份和摘要折叠为技术详情,分别呈现静态检查、测试、来源与领域审阅;阅读操作不会执行代码。 +- 既有可用接口、默认值和副作用边界保持兼容。原生专属能力不宣称在 WASM 可用,目录批处理不宣称事务,摘要写入不宣称内核 CAS。 + +### Validation + +- 本地全量回归 984 通过、0 失败、2 个原有忽略项;发布提交与打包产物另行复核。 +- 实际 wasm32 产物通过 ABI、桥接、双语集合与 32 位边界验收。 +- Chromium 验证七种宽度、实时与静态页面、无脚本回退、源码定位、曲线、帧切换与重新运行。 + ## v2.5.1 — 2026-11-07 ### Highlights diff --git a/Cargo.lock b/Cargo.lock index 8f2de45..c1e5446 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -615,7 +615,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad" [[package]] name = "marqdo" -version = "2.5.1" +version = "2.6.0" dependencies = [ "anyhow", "assert_cmd", @@ -656,7 +656,7 @@ dependencies = [ [[package]] name = "marqdo-wasm" -version = "2.5.1" +version = "2.6.0" dependencies = [ "marqdo", "serde_json", diff --git a/Cargo.toml b/Cargo.toml index 28d9716..833724e 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo" -version = "2.5.1" +version = "2.6.0" edition = "2021" license = "Apache-2.0" description = "Marqdo — Markdown markers as an interpreted programming language" diff --git a/README.md b/README.md index a5a5172..f0896f0 100644 --- a/README.md +++ b/README.md @@ -288,7 +288,11 @@ marqdo catalog public -o .marqdo --- -## 现状(v2.5.1) +## 现状(v2.6.0) + +- **标准库与拓展库手册(v2.6.0)**:61 份公开标准库、650 个函数;源码内参数/返回契约、叙述形参、句中遮蔽调用与真实工程。新增文件/字节/集合/Result/文档/HTTP/任务/TOML/时区工作流;多文件拓展库以 index 组织。 +- **View 可读动作与知识(v2.6.0)**:正文读动作,侧注看实现,运行标注看实际结果;空逻辑明确提示待补。知识说明先看输入、返回、依赖和依据,技术身份按需展开。 +- **Quantum / Web 工程实践(v2.6.0)**:可执行实验、会话句柄与双语门面;网页先递归拆布局,直到叶子可以直接用 Markdown 表达。CLI · wasm · ext · VS Code 扩展同步 **2.6.0**。 - **View 连线与工具栏(v2.5.1)**:真实源码锚点、连续 S 形曲线、错落标注与连线避让;底部工具栏增加文字标签。深浅色配色保持一致。CLI · wasm · ext 同步 **2.5.1**。 @@ -341,7 +345,7 @@ marqdo catalog public -o .marqdo - **浏览器 Marqdo(WASM)**:`marqdo wasm build` + 官方 bridge 自启(作者零业务 JS;桥内可含列表/路由/storage/ws/文件/Canvas/音频/Observer/拖放);`lib/browser` + GFM;`web.client_embed`;示例 [browser-hello](examples/browser-hello/) · [browser-app](examples/browser-app/) · [browser-media](examples/browser-media/) · [web-client-site](examples/web-client-site/)([ADR 0002](doc/adr/0002-browser-marqdo-wasm.md) · [D](doc/roadmap/browser-wasm-d.md) · [E](doc/roadmap/browser-wasm-e.md) · [F](doc/roadmap/browser-wasm-f.md)) - 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) · [ADR 0002 — 浏览器 WASM](doc/adr/0002-browser-marqdo-wasm.md)(C0–C5 完结,见 [roadmap/browser-wasm.md](doc/roadmap/browser-wasm.md))· [ADR 0003 — 异步效应](doc/adr/0003-browser-async-effects.md) -### 如何使用最新 Marqdo(v2.5.1) +### 如何使用最新 Marqdo(v2.6.0) **安装解释器(任选其一)** @@ -356,7 +360,7 @@ marqdo catalog public -o .marqdo ```bash # 1) 源码安装(跟 tag 或 main) git clone https://github.com/cflmy/marqdo.git && cd marqdo -git checkout v2.5.1 # 或留在 main +git checkout v2.6.0 # 或留在 main cargo build --release export PATH="$PWD/target/release:$PATH" marqdo version @@ -397,7 +401,7 @@ marqdo wasm build # → dist/wasm/ … 见 examples/browser-hello/ # 6) Releases:Windows exe/zip/vsix;Linux CLI zip + native `.so` zip -# https://github.com/cflmy/marqdo/releases/tag/v2.5.1 +# https://github.com/cflmy/marqdo/releases/tag/v2.6.0 ``` 开发期也可用 `cargo run -- …` 代替已安装的 `marqdo`: diff --git a/crates/marqdo-wasm/Cargo.toml b/crates/marqdo-wasm/Cargo.toml index 5f34e59..466fd5c 100644 --- a/crates/marqdo-wasm/Cargo.toml +++ b/crates/marqdo-wasm/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo-wasm" -version = "2.5.1" +version = "2.6.0" edition = "2021" license = "Apache-2.0" description = "Marqdo interpreter as WebAssembly (browser host bridge)" diff --git a/debian/changelog b/debian/changelog index dc23790..13c6093 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,11 @@ +marqdo (2.6.0-1ppa1) noble; urgency=medium + + * Executable standard/extension handbooks and practical file/data/task tools. + * Readable View action notes, knowledge contracts and offline reader support. + * Preserve effect, platform and source compatibility boundaries. + + -- Marqdo Maintainers Sun, 08 Nov 2026 23:01:35 +0800 + marqdo (2.5.1-1ppa1) noble; urgency=medium * Marqdo 2.5.1: exact source anchors, flowing annotation curves, diff --git a/ext/VERSION b/ext/VERSION index 73462a5..e70b452 100644 --- a/ext/VERSION +++ b/ext/VERSION @@ -1 +1 @@ -2.5.1 +2.6.0 diff --git a/public/features/03-view-and-docs.mq.md b/public/features/03-view-and-docs.mq.md index 1f5dbd0..a323b2f 100644 --- a/public/features/03-view-and-docs.mq.md +++ b/public/features/03-view-and-docs.mq.md @@ -6,7 +6,11 @@ description: Local browse and static export from the interpreter # main -Version 2.5.1: `marqdo view` and `view output` share a warm paper reader with a new +Version 2.6.0 keeps action descriptions in the sentence and moves their implementation to side notes. Empty parentheses explicitly mark missing logic. Multiple actions and returns keep their original prose, while ordinary links remain navigation. On compact screens, native disclosures keep the implementation readable even without JavaScript. + +Executable knowledge now presents inputs, returns, effects, dependencies and separate verification facts. Technical identities and digests stay folded. Source explanations are distinct from captured results; a pure effect summary or linked source is not proof that a program ran or its content was verified. + +The reader introduced in 2.5.1: `marqdo view` and `view output` share a warm paper reader with a new Marqdo logo, serif document text, botanical ornaments, navigation, search and a floating action toolbar. Wide screens place real execution notes in the margins; compact screens keep them below the corresponding paragraph. Click a note to diff --git a/public/features/03-view与文档.mq.md b/public/features/03-view与文档.mq.md index a79aad7..6325734 100644 --- a/public/features/03-view与文档.mq.md +++ b/public/features/03-view与文档.mq.md @@ -6,7 +6,11 @@ description: 本地浏览与静态导出由解释器生成 # main -版本 2.5.1:`marqdo view` 与 `view output` 共用暖白金色阅读界面,新 Marqdo 标志、 +版本 2.6.0 将动作说明留在句子里,实际实现引到侧注;空圆括号明确提示待补逻辑。同一句话可以保留多个调用与返回,普通链接仍是导航。窄屏使用原生可展开详情,没有 JavaScript 也能查看实现。 + +可执行知识先展示输入、返回、调用边界、依赖和分别列出的验证依据,技术身份与摘要按需展开。源码说明与运行捕获有不同含义;pure、来源关联或构造配置都不能被当作已运行或内容已验证的证据。 + +沿用 2.5.1 的阅读底座:`marqdo view` 与 `view output` 共用暖白金色阅读界面,新 Marqdo 标志、 衬线正文、花枝装饰、导航搜索与底部悬浮工具栏。宽屏将真实执行结果沿左右页边引出, 窄屏将标注放回对应段落下方;点击标注可查看完整捕获值,调用帧和循环轮次仍可切换。 diff --git a/public/stdlib/00-overview.mq.md b/public/stdlib/00-overview.mq.md index 07288f4..dadcd42 100644 --- a/public/stdlib/00-overview.mq.md +++ b/public/stdlib/00-overview.mq.md @@ -6,11 +6,17 @@ description: How to import official lib modules # main -Official libraries live under lib/ (alias std/). Import them in YAML frontmatter with a greater-than line, for example lib/text.mq.md or lib/fs.mq.md. +Version 2.6.0: each standard library is normally one lib/name.mq.md source file, which is its own handbook. No extra index is required. Read the parameter/default and return tables below its headings to call it; multi-file extensions use indexes to organize modules. The 61 public sources provide 650 functions. + +Import with a nested YAML import mapping. File, network and process effects still need authorization at the execution entry. marqdo call defaults to pure functions; file operations require explicit --effects and --fs-root. Contract documentation never grants permission. + +New bytes, archive, Result, document and collection workflows retain explicit platform limits. Check one-based paths versus legacy zero-based indexes before using arrays. Real workflows live in examples/stdlib-handbook; the development guide is doc/library-development.mq.md. + +Official libraries live under lib/ (alias std/). Use a nested import mapping in YAML frontmatter, for example a module alias mapped to lib/text.mq.md or lib/fs.mq.md. English-named files export English APIs; Chinese-named files export Chinese APIs. JSON is special: only lib/json.mq.md (shared by both languages). -No extra allow flags: importing a module means you intend to use it. Under marqdo view or static export, exit soft-fails and long sleeps are clamped so the console stays up. +Importing selects the module; it does not replace effect authorization at the execution entry. Under marqdo view or static export, exit soft-fails and long sleeps are clamped so the console stays up. Modules: text (text / 文本), table (table / 表), files (fs / 文件), time (time / 时间), system (sys / 系统), json (json only), net (net / 网络), math (math / 数学), foreign (foreign / 外联), plugin (plugin / 插件), writeback (writeback / 自写回), subtask (subtask / 子任务). Foreign v2 adds structured invoke records, JSON calls, parallel fan-out, persistent Python/Node kernels, an explicit state bridge and document-native view cells — see stdlib/foreign.mq.md and features/19-foreign-view-cells.mq.md. diff --git a/public/stdlib/00-索引.mq.md b/public/stdlib/00-索引.mq.md index 40e9424..568c202 100644 --- a/public/stdlib/00-索引.mq.md +++ b/public/stdlib/00-索引.mq.md @@ -6,11 +6,17 @@ description: 如何导入官方 lib 模块 # main -官方库在仓库 lib/(别名 std/)。在 YAML frontmatter 用大于号行导入,例如 lib/文本.mq.md 或 lib/文件.mq.md。 +版本 2.6.0:标准库通常是单个 lib/名称.mq.md 文件,源码本身就是手册,不要求额外 index。直接阅读标题下的参数、默认值和返回表即可调用;多文件拓展库才通过 index 组织模块。当前 61 份公开标准库包含 650 个函数。 + +使用 YAML 的 import(或导入)映射导入模块。文件、网络、进程等副作用仍由运行入口授权;marqdo call 默认只运行纯函数,文件调用要明确 --effects 与 --fs-root。文档契约不会自动授予权限。 + +新增字节、归档、Result、文档操作及集合工作流;数组读写要注意一基路径与旧零基接口的区别。更完整的标准库源码在 lib/,真实工程在 examples/stdlib-handbook,开发规范见 doc/library-development.mq.md。 + +官方库在仓库 lib/(别名 std/)。在 YAML frontmatter 的 import 或导入映射中填写模块别名与路径,例如 lib/文本.mq.md 或 lib/文件.mq.md。 拉丁文件名导出英文 API;中文文件名导出中文 API。JSON 特例:只有 lib/json.mq.md(中英共用)。 -导入即表示要用对应能力,无需再加允许旗标。marqdo view 或静态导出里,退出会软失败、长睡眠会被钳制,以免拖垮控制台。 +导入只选择模块,不替代实际运行入口的副作用授权。marqdo view 或静态导出里,退出会软失败、长睡眠会被钳制,以免拖垮控制台。 模块:文本(text / 文本)、表(table / 表)、文件(fs / 文件)、时间(time / 时间)、系统(sys / 系统)、json(仅 json)、网络(net / 网络)、数学(math / 数学)、外联(foreign / 外联)、插件(plugin / 插件)、自写回(writeback / 自写回)、子任务(subtask / 子任务)。外联 v2 新增结构化执行记录、JSON 调用、并行扇出、Python/Node 持久内核、显式状态桥与文档原生 view 单元 — 见 stdlib/外联.mq.md 与 features/19-外联视图单元.mq.md。 diff --git a/scripts/build-public.sh b/scripts/build-public.sh old mode 100644 new mode 100755