- take the 2.8.0 crate versions, Cargo.lock dependency graph and release workflows - keep the native workflow inspect/list, resume_dir isolation and repeatable fixtures - satisfy the 2.8.0 library narrative gate for workflow.tick - resolve CHANGELOG ordering with the v2.8.0 release entry
102 KiB
Changelog
Unreleased
Added
ext/ai/workflownow exposes read-onlyinspect/list, a host-relativeresume_diron every operation, and repeatable offline workflow fixtures.- Agent ABI registers
agent_workflow_inspectandagent_workflow_list. - AI 工作流拓展库新增只读
inspect/list、各操作的resume_dir隔离, 离线集成夹具改为按时间戳生成运行 ID,可重复执行。
Fixed
flow.chooseno longer leaks a branch-localparsedvalue into the function contract; the repaired-choice path is fully scoped.- CI builds the agent cdylib and runs offline integration without the removed
run --effectsflag, usingMARQDO_AGENT_PLUGINinstead.
Changed
- 分支已合并 v2.8.0:
Cargo.toml/Cargo.lock、发布工作流与全部拓展包 统一到 2.8.0 依赖锁,后续发版不再从 2.7.1 基线分叉。 - The branch now includes v2.8.0, so its crate versions, lockfile and release workflows match the current release line instead of the 2.7.1 baseline.
v2.8.0 — 2026-11-17
marqdo prove 正式发布:定理表 → Lean 4 证明 → 自动判定。离线符号执行(F1–F5)无工具链可用,checked 永远弱于 proved;单调性护栏让判定器缺陷显式失败;假定理给出反例见证;证书缓存与目录模式面向智能体批量出证。
marqdo prove ships: theorem tables compile to Lean 4 and are judged automatically. Offline symbolic execution works without a toolchain, monotonicity guardrails fail loudly on judger defects, fake theorems get counterexample witnesses, and certificate caching plus directory mode support agent-scale proving.
详见 双语发布说明。
v2.7.1 — 2026-11-11
CLI 修复发布:View 实际逻辑的手动开合不再被布局重排或运行结果刷新覆盖;函数、链接、列表和记录按内容排版,手机详情整行展示。核心仍为 19 个构造;拓展库保留 2.7.0。
CLI fix release: implementation disclosures retain mouse/keyboard choices across resize, nested source reading and live replacement. Typed call/link/value details preserve real navigation and read-only inspection. Independent extension packs remain 2.7.0.
详见 双语发布说明。旧静态站点需要用新 CLI 重新导出。
v2.7.0 — 2026-11-10
Highlights / 亮点
源码手册进入真实开发与用户站点:原生文件操作、可调用开发/发版流程、递归 View 站点及当前请求资源。CLI、WASM、拓展包与编辑器版本统一为 2.7.0。详见 完整双语发布说明。
Executable source handbooks now drive actual development and user sites: native file operations, callable release tasks, recursive View Documents and current request resources. CLI, WASM, extension packs and editor version are 2.7.0.
核心表面 Δ / Core surface Δ:无增删,仍为 19 个核心构造;沿用既有 Markdown 标记与插件 ABI。
Added
- Native development and release handbooks, bounded engineering plugin boundaries, literal CLI JSON file/stdin arguments and --require-ok failure propagation.
- 原生文档表读取与保留正文的修改;纯 head 资源,以及当前请求的数据查询、表单与会话导航资源。
- Both-language recursive user sites, source-aware route inspection, retained theme declarations and actual browser acceptance.
- Structured nested list/control records in the official bridge, documented in EN/ZH browser libraries and the callable browser-app.
Fixed
- Occlusion receivers, nested and hyphenated-path calls, prose literal defaults and exact CLI argument/session replay semantics.
- 授权站点根下的文件/SQLite 定位;嵌套 Document 与 Endpoint 回调上下文;表单重试 CSRF、成功跳转、管理入口与片段选择。
- Browser duplicate-item deletion, literal content rendering, Back/Forward history and asynchronous outcome reporting.
Changed
- SKILL discovery delegates to executable handbooks; ordinary file IO and orchestration use Marqdo instead of Python release scripts.
- 中英文用户站点保留原始主题、当前文章与管理能力;移除无关的暗恋工程和过时独立浏览器演示,保留底层测试夹具。
- Native packs include the engineering plugin. Main excludes editor sources; immutable tags, both-platform builds and independent GitHub/CDN/Ubuntu verification remain release obligations.
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
View 标注连线与工具栏优化 / View annotation and toolbar refinement:执行标注精确绑定源码行与字节区间;连续 S 形曲线取代水平长线,标注贴近正文错落排布,并避让正文和相邻连线;浮动工具栏增加文字说明。CLI · wasm · ext 2.5.1。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造);无 Markdown 语法或插件 ABI 变更。
Fixed
- 执行标注从实际源码片段引出并连接标注标题,不再从正文边缘引出;多调用帧与循环轮次共用准确的源码区间,避免按类型猜测锚点。
- 处理源码换行、重跑、窗口变化与字体加载后的连线定位;保留密集区域和窄屏的文内降级。
- 连线连续弯曲、柔和金绿过渡,并为相邻曲线保留间距;宽屏标注更靠近正文,横纵方向错落排布。
Changed
- 底部工具栏显示“刷新、设置、运行、清理、更多”,保留深浅色配色与原有操作行为。
- 新增七种屏宽、曲率、连线交叉、两端定位及共享源码帧绑定的浏览器回归。
- CLI、WASM、扩展包和 VS Code / Cursor 扩展同步 2.5.1;扩展包功能沿用 v2.5.0。
v2.5.0 — 2026-11-07
Highlights
View 文档阅读界面重构 / View reader redesign:暖白金色排版、新 Marqdo 标志与花枝羽毛素材;宽屏执行信息左右引出,窄屏回到正文下方;导航、搜索与悬浮工具栏;实时 view 与静态导出同源,公式和素材离线可用。CLI · wasm · ext 2.5.0。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)。本次变更集中于 view 展示与普通文档执行结果刷新;无 Markdown 语法或插件 ABI 变更。
marqdo view public
marqdo view output public -o site
Added
- 暖白/深色阅读主题、新 Logo、透明花枝与羽毛;顶部导航、正文/函数/文件搜索、阅读设置和悬浮工具栏。
- 宽屏执行标注左右排布与避让,点击查看完整捕获值;窄屏、密集段落和打印采用正文内标注。
- 内嵌 KaTeX 0.16.22、字体和装饰素材,静态页面断网仍可渲染公式。
- 六种屏宽的 live/static 浏览器回归与普通文档重跑结果一致性回归。
Fixed
- 普通文档重跑后,从同一次执行捕获刷新正文、变量与轨迹,避免为更新标注重复执行。
- 移除重复的正文
id="structure",确保刷新定位到实际正文;修复搜索框 Escape 关闭与隐藏目录焦点行为。
Changed
- 函数和变量面板按需打开;调用帧与循环轮次选择保留;高级 notebook 操作从工具菜单进入。
- CLI、WASM、扩展包和 VS Code / Cursor 扩展同步为 2.5.0;扩展包功能沿用 v2.4.0 已发布内容。
v2.4.0 — 2026-11-06
Highlights
Oracle journal 作语言值:foreign.oracle_journal / foreign.replay_check 把观测与纯比较暴露为普通 Marqdo 值(非仅 notebook API);handle/code 不得入 journal;copy 拒绝 code。Bytecode / frontend / foreign session 模块化与 applications 金样例;verification/replay-policy Lean 策略身份。CLI · wasm · ext 2.4.0。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——变更在 lib/foreign 宿主表面与实现结构,不增 Markdown 标记。
Added
foreign.oracle_journal/foreign.replay_check:文档级观测列表与纯 journal 比较(doc/design/oracle-journal-values.md)。- 回归:
foreign-oracle-{journal,names,failure}、foreign-{,session-}copy-code-refuse、tests/oracle_journal.rs、applications 四场景、verification/replay-policy。 - 文档:
oracle-journal-values.md;frontend-call / foreign-library 方向笔记。
Fixed
- view notebook API:
OnceLock初始化等待兼容 MSRV 1.81(不再调用 ≥1.84 的wait)。 - JSON
float_roundtrip特征,减少外联浮点往返失真。
Changed
- Bytecode compile/VM、foreign_doc/session、sema resolution、notebook interrupt 路径拆模块(行为对齐既有 Strong 契约)。
v2.3.0 — 2026-11-01
Highlights
Foreign Strong(session / value / replay):会话句柄改为不透明 handle(不可 JSON 过桥、禁止 text 伪造);close 仿射消费(双 close / use-after-close 故障);replay_check 对照 oracle journal(旧 replay_snapshot 仅重跑保留);GFM 表行 arity 与列长映射拒绝静默补空;Ω 返回域外整数故障。对齐 PLDI Strong 叙事与 Lean SessionReg / (V_{\mathsf{safe}})。CLI · wasm · ext 2.3.0。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——破坏面在宿主 foreign/session/JSON 与表解析纪律,不增 Markdown 标记。
Added
Value::Handle:session_open返回句柄;session 操作拒绝 text 伪造。DocumentSession::replay_check+ API/api/session/snapshot/replay_check;snapshot 录音字段 +oracle_journal(与 execution journal 分名)。- API
/api/session/oracle_journal。 - 文档:
doc/design/foreign-strong-correspondence.md;v-safe-json.md补 Handle / 列 arity / Ω 门。 - 回归:
foreign-session-{use-before-open,use-after-close,double-close,cold-replay-empty,isolation,handle-no-serialize,result-vsafe-refuse};tests/errors/table-arity.mq.md。
Fixed
- 不等宽 GFM 表不再静默补空单元格;解析报
table row arity mismatch。 - Py/Node session bootstrap:Ω 结果 OOD 整数不再
default=str偷渡,宿主升级为故障。
Changed
session_close:未知 / 已关闭句柄 → 故障(不再返回False)。session_list:id字段为handle。- Snapshot export 含
ok/code/stdout/result/source_hash与oracle_journal。
v2.2.2 — 2026-11-01
Highlights
(V_{\mathsf{safe}}) JSON 整数契约落地:外联 / json.parse / json.stringify / session_set 等共用映射对齐 Lean ForeignJSON——|n| > 2^{53}-1 的 JSON 整数显式拒绝(错误前缀 json: integer outside V_safe),禁止 Node 路径静默扭曲;宽整数仍用十进制字符串 + 对端 BigInt。CLI · wasm · ext 2.2.2。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——宿主 JSON 契约与测试,不改 Markdown 标记。
Added
doc/design/v-safe-json.md:宿主 ↔ Lean (V_{\mathsf{safe}}) 契约锁定(MAX_SAFE、encode/decode refuse、嵌套、float 为宿主扩展)。- 回归:
tests/lib/json-vsafe-*、foreign-vsafe-*、foreign-session-vsafe-refuse(含算术后越界 refuse)。
Fixed
src/host/json.rs:对域外整数与u64 > i64::MAX显式失败;不再经f64/Text静默降级。doc/design/foreign-kernel.md:Int→number 仅当|n| ≤ 2^{53}-1;宽整数走 string 桥。
Changed
- 外联 JSON 桥与
lib/json行为:OOD 整数从「可能静默失真」改为「诊断失败」。
v2.2.1 — 2026-10-30
Highlights
view / 静态导出大纲侧栏修复:带遮蔽(occlusion)语句的文档页里,Functions / Variables 右侧栏会掉到正文下面;中等窗口宽度下也会被错误叠成单列。CLI · wasm · ext 2.2.1。
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——布局与 HTML 闭合修复,不改 Markdown 标记。
Fixed
marqdo view/view output:occlusion 行提前返回时未关闭.doc-block,把#outline-rail嵌进document-surface,侧栏排到文档下方;现已闭合并保留标注带。- view 壳 CSS:大纲折叠改为按主栏
@container mq-panel宽度(32rem),不再用视口960px媒体查询把右侧栏压到正文下;极窄时大纲上移到文档上方。
v2.2.0 — 2026-10-30
Highlights
函数级调用 marqdo call:同一份 .mq.md 已经是文档、知识和程序。这一版补上从外部调用其中某个函数的入口。人继续读这一页;开发者、测试和 Agent 用同一条命令传入参数并执行。知识复用、把函数当工具、逐个函数做测试、改完再跑,都是这一入口的用法,不是另一套 Skill 系统。CLI · wasm · ext 2.2.0。
marqdo call examples/calculator.mq.md 计算器.加法 a=2 b=3
# 5
marqdo call examples/calculator.mq.md 计算器.加法 a=2 b=3 --json
作用:最小可执行单位从「整份文件」扩展到「文件里的一个函数」。不必为了试一个函数再写 # main、打印和包装程序。
价值:说明和实现仍在同一页。Agent 读函数旁边的叙述,定位函数,传入参数,得到可检查的结果。正式发布和权限仍走已有的项目验证;call 默认不开放写文件、进程、网络和插件。
说明页:public/features/22-函数调用.mq.md · public/features/22-call.mq.md
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——新增的是 CLI 入口,不新增 Markdown 标记。**…** 仍是语句,*…* 仍是返回。
Added
marqdo call <文件.mq.md> <函数> [名字=值 ...]:加载该文件及其 import,按显示路径、SymbolId 或唯一短名定位函数,用现有签名和契约绑定参数,再用现有运行时执行。--json:成功{"ok":true,"result":...},失败{"ok":false,"error":...},错误带诊断code。--backend tree|bytecode与marqdo run相同;指定函数时两个后端都不会改去跑# main。- 默认纯函数:效应含写入、网络、进程或插件时,执行前返回
artifact.effect_denied,副作用不会发生。 - 参照文档
examples/calculator.mq.md,以及用户说明页public/features/22-*。
Fixed
- 官方语法说明与 Agent 语法卡的标记极性与解析器对齐:粗体是语句,斜体是返回。同步测试会实际运行说明里的调用示例。
- Bytecode 的
marqdo run --call-lib-path执行被点名的导入函数,不再忽略该参数去跑入口。 - 隔离运行时冒烟测试补上
InvokeContext.fs_root,--tests可以编过。
Changed
- CLI / wasm /
ext/VERSION同步 2.2.0。扩展包版本号对齐;这一版的新能力在 CLI。
v2.1.5 — 2026-10-27
Highlights
Agent 可靠工作台 + EKC 热路径:ResourceView(JSON/CSV/PDF/image blob_ref、locator 页/行)· ToolSpec 授权先于调用 · CheckpointV2 / EffectLedger / ContextPackV2 · EKC ir.json 暖机与 --refresh · Web 短读/控制面与 execute 槽隔离。CLI · wasm · ext 2.1.5。
git checkout v2.1.5 && cargo build --release
marqdo ext add web # CDN / Releases → 2.1.5
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——工作台协议与 Agent 运行时合同,不新增 Markdown 标记。
Added
- ResourceView v1:有界 JSON/CSV 渲染;PDF/image
blob_ref;locator.page/ 行定位;CSVtext供 TablePreview。 - Agent 合同:ToolSpec 注册与 authorize-before-call;CheckpointV2 原子 resume;AgentErrorV1;输出通道;ContextPackV2;EffectLedger(含 mutating
run_tool水印)。 - Workbench fixtures/schemas:
tests/workbench_contracts协议金样例。 - EKC
ir.json快照:marqdo knowledge写入.marqdo/ekc/graph/ir.json;查询命令暖机热加载,免全量重编译。 --refresh:knowledge preflight/find/reuse/impact/conflicts/stale/duplicate/verify可强制重编译。
Fixed
- 工程预检热路径:
knowledge preflight(及 find/reuse 等)默认不再每次ensure_compiled全量 compile,修复聊天「工程预检」墙钟过长。 - Web 槽隔离:
short/read/control不再填满 execute 槽;disconnect≠cancel。 - CSV ResourceView:去掉尾部空行伪影。
Changed
- 查询类 knowledge CLI:缺投影才 compile;CI / 源变更请先
marqdo knowledge或--refresh。 - CLI / wasm /
ext/VERSION同步 2.1.5。
v2.1.4 — 2026-10-26
Highlights
默认隔离 HTTP execute(ADR 0009):class=execute / sse-live / stream:true 经 Supervisor worker 池(marqdo run --call-lib-path),父进程不再 CallLibPath 占 INVOKE_LOCK;短读 / 未声明非流式仍 legacy_serial(ADR 0008)。/_runtime/* 控制面;runtime.isolated_execution=1;MR-01 双 60s 假 SSE + 短读金样例。CLI · wasm · ext 2.1.4。
git checkout v2.1.4 && cargo build --release
marqdo ext add web # CDN / Releases → 2.1.4
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——隔离运行时与 Web execute 路径,不新增 Markdown 标记。
Added
- 默认隔离 execute(ADR 0009):HTTP
execute/sse-live/stream:true经 Supervisor worker 池(marqdo run --call-lib-path),父进程不再CallLibPath占INVOKE_LOCK;可选 routeclass;/_runtime/*控制面;runtime.isolated_execution=1。 - MR-01 金样例:
tests/isolated_execute_mr01.rs+tests/ext/isolated-execute-site/(双 60s 假 SSE + 短读并行;槽满拒绝);接入executable-knowledgeworkflow。 - Worker CLI:
marqdo run --call-lib-path/--fs-root/--args-json/--emit-result;hostruntimeadmit/dispatch/cancel/events。
Fixed
Changed
- compile 1000 门禁:executable-knowledge / workbench 路径恢复与能力探测诚实(isolated 默认开启)。
- CLI / wasm /
ext/VERSION同步 2.1.4。
v2.1.3 — 2026-10-25
Highlights
知识工作台运行时合同(M00–M06):ModelSelectionV1 / RunContextV1 / ModelCallUsageV1 / DocumentViewV1 / locator / snapshot;严格 selection;usage null≠0;view document 只读嵌入;LLM messages + cancel;agent.step selection 继承假模型 e2e;USTC 兼容 live smoke(env 注入)。CLI · wasm · ext 2.1.3。设计证据仍为 Partial(原生适配器 unavailable;完整宿主 F12 留给应用)。
git checkout v2.1.3 && cargo build --release
marqdo ext add llm # CDN / Releases → 2.1.3
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)——工作台合同与 View/LLM/Agent 扩展面,不新增 Markdown 标记。
Added
- Workbench M00–M06:capabilities / selection / RunContext / usage / DocumentView / locator / SnapshotManifest;
tests/workbench_contracts(含 F02 agent.step+resume、F14 并发);marqdo view document --out只读 HTML 嵌入。 - LLM:
messages=/selection=/strict_selection;cancel token;reasoning_content 回退;双端点隔离门禁。 - Live:
tests/workbench_live(OPENAI_*env only;MARQDO_EXT指向仓内ext/)。 - Agent skeleton:子工作簿禁
llm.llm,从 env selectionllm.create。
Fixed
llm.ask升参:hoistp避免缺参missing argument for parameter p;避免~/.marqdo/ext陈旧包遮蔽仓内ext/(测试强制MARQDO_EXT)。
Changed
- CLI / wasm /
ext/VERSION同步 2.1.3。
v2.0.0 — 2026-10-22
Highlights
遮蔽语法(Occlusion)落地:[描述](实现) —— 方括号是给人读的描述(永不执行),圆括号是唯一执行体。配套 () 内调用、access 取元、遍历 遮蔽循环、labels 两级检索与债务棘轮、migrate labels 迁移;view 把描述渲染为正文、实现渲染为代码片、空载荷给「桩」徽章。全仓 80 个语料文件 / 256 处取元 / 23 处循环 已迁移(M7),语义零漂移。
git checkout v2.0.0 && cargo build --release
marqdo ext add web # CDN → 2.0.0
核心表面 Δ(Core surface Δ):无增删(仍 19 个构造)—— 遮蔽是既有 [键](集合) 与 - [项](集合) 形状在 markup: occlusion 文件中的第二种读法,默认 classic 语义不变;access 是宿主函数(id 212),不是新标记。
Added
- M2 遮蔽语法:
[描述](实现);[]为自由文本、永不执行,()为唯一执行体;支持嵌套;空载荷()值为None(桩)。frontmattermarkup: occlusion按文件启用,MARQDO_MARKUP=occlusion可作进程默认。 - M1
()内调用:加(1)/加(1, 2)/加(加(1 2), 10)/加一 号(31)(callee 可含空格,解决 D8)/txt.str_trim(" x ");)是参数终止符,逗号可选,支持嵌套;括号形参数按表达式解析,空格形(> f k=v)仍按文本。 - M3
access与遮蔽循环:新增宿主函数access(集合, 键)(别名取/取值),与旧取元逐字等价;- [描述](遍历 集合 为 变量)遮蔽循环,接受遍历/for与为/as/in。 - M2.5 / M4 遮蔽诊断:
label.missing(空描述,error)、label.empty_payload(空载荷,warning)、label.ref_dangling(描述里的反引号实体不可解析,error);由marqdo check一并输出。 - M5 隐式遮蔽:
marqdo check --implicit-labels把>调用上方的叙述当作描述(默认关闭,不改变既有输出)。 - M6 T1 会话内陈旧检测:MLSP
repair_apply前后对照 payload 并返回变更的遮蔽点;新增session.summary会话末一次性汇总。 - M7 迁移与版本门:frontmatter
markup:按文件切换解析模式(同进程可混载 classic / occlusion,imports 亦然);marqdo migrate labels(多路径、--write、--json)把[键](集合)改写为[键](access(集合, "键"))、- [项](集合)改写为遍历形。 - M8 债务棘轮与呈现:
marqdo labels --baseline FILE记欠据、--fail-on-increase只许降不许升;view浏览 / 卡片 / 静态导出一致呈现遮蔽:描述为正文、实现为代码片、空载荷「桩」徽章。 - M9 两级词表检索:
marqdo labels(默认pending口径 /--grep自定义词 /--group/--also-builtin/--count/--json,支持多路径);MLSPlabels.search;兼容文档写法labels pending/labels search。 - M10 工程化落点:
ext/ai提示词加入「接不了就申报」;README「工程习惯」;空载荷一律 warning。 - 示例与教程:
examples/syntax-tour一页跑通全部现行语法;examples/oa2026-showcase;doc/tutorial/15-常见陷阱.md(D1–D10 实测)。
Fixed
- D9 未闭合引号:不再静默吞掉后续行——分类层与解析层双层修复,直接报错并给出原始行。
加(31):曾被解析成unknown function 加(31(末个位置实参吞掉))。- view 解析模式回归:带
markup: occlusion的文档在view结构区报expected ')' after link-index collection;新增load::parse_source_auto统一五处解析点。
Changed
- HostFn 单表:五张分派表合一为
HOST_FN_TABLE(src/host/dispatch.rs−404 行),203 项逐字节一致,行为零变化。 - 插件 ABI 共享 crate:新增
marqdo-plugin-sdk,5 个原生插件共用同一份 ABI 前言;ABI 不变(include/marqdo_abi.h/ 符号与布局不变)。 - 精简:删除归档的 Rust web 插件
plugins/web-rust-archive/(14,235 行,非 workspace 成员,已由 Golibweb取代);删除无调用点死代码,收拢as_text18 处重复、catalog 助手与 view 路由 34 臂,AST 遍历器合流。 - 语料迁移(M7):
public/ext/tests/examples/doc/等语料加markup: occlusion,改写 80 个语料文件 / 256 处取元 / 23 处循环;新增tests/ratchet锁定标签债务。 - 文档:遮蔽语法总纲 + M0–M10 变更记录、标签新鲜度 / 修复回路、函数作为值 6 篇评估、代码体量审计;
doc/design/code-volume-audit.md记 53k 行构成。
v2.1.0 — 2026-10-23
Highlights
文件级可执行知识语义:标准库、扩展库、示例与公开文档全部采用显式 markup: occlusion;[描述](实现) 成为默认链接语义,access 与 遍历 承担原有取元与循环职责。迁移工具可离线证明语法形状等价,Tree 与 Bytecode 均完成全量回归。
git checkout v2.1.0 && cargo build --release
marqdo ext add web
核心表面 Δ:默认链接语义从 Classic 切换到 Occlusion。未迁移的旧 [键](集合) 仅可用 markup: classic 或一个版本周期内的 marqdo run --legacy-markup / check --legacy-markup 执行。
Added
- 文件级新语义迁移:
marqdo migrate labels --mark可把整个库/目录迁移到显式markup: occlusion,即使文件没有旧式索引也不再依赖进程默认值。迁移验证为语法级、无导入解析依赖,并在写入前比较 Classic 与 Occlusion AST 形状。 - 显式过渡入口:
marqdo run --legacy-markup与marqdo check --legacy-markup可在一个版本周期内审阅未迁移的旧文件;环境变量不再改变语法。
Fixed
- 标准库、扩展库、示例、公开文档与可解析测试夹具迁移为文件级 Occlusion;旧的
[键](集合)和- [项](集合)分别改为access与遍历。
Changed
- 未标注源码默认采用 Occlusion。Classic 仅能通过明确的 frontmatter 或
--legacy-markup进入,避免同一文档因进程配置而静默改变含义。
Unreleased
Added
Fixed
Changed
v2.1.2 — 2026-10-24
Highlights
可执行知识生产消费链 + View 阅读体验发版门槛:证据摘要进闭包/句柄;artifact.verify / knowledge adjudicate 结构化裁决;artifact.reuse_execute 与 agent_eng_bind_execute / publish_gate 实际复用(非 n-gram);document.extract 文本/Markdown + PDF/OCR 显式失败;View KnowledgePresentation、说明锚点、SSE page_token 过期包拒绝;上传 max_bytes;门禁 45 项(含 100/1000 单元)。CLI · wasm · ext 2.1.2。
git checkout v2.1.2 && cargo build --release
marqdo ext add web
cargo test --offline --locked --test executable_knowledge
核心表面 Δ(Core surface Δ):无增删关键词——语义/MLSP/View/Agent 宿主扩展;不改变默认 Occlusion 链接读法与表几何。
Added
- 证据与闭包(F0/M02):来源 digests 进入 artifact/evidence/closure;business handle 改/删来源失效;锚点/可读性诊断。
- 验证裁决(F0/M03):
artifact.verify结构化may_bind/may_publish;policy 枚举;knowledge adjudicate;CLI--fail。 - 语法 Skill(F0/M05):CORE SYNTAX 置顶;
migration-classic.md;skill_core_card与预算截断防护。 - 绑定执行(F1/M04):
artifact.reuse_execute;agent_eng_bind_execute+eng_publish_gate(candidate_only/ product gate);host_querymlsp;tests/ext/agent-eng-bind-gate.mq.md。 - 发布与来源(F2/M06–M07):统一
EXCLUDED_DIRS;publish_manifest.json;function_sources函数级来源覆盖。 - 文档提取(F3/M01):
document.extractDocumentSource→ExtractedDocument;PDF/DOCX/OCR 显式failed;超限截断partial;Web 上传MaxBytesReader/LimitReader。 - View V0–V3(子集):正文优先;no-exec;
KnowledgePresentation(semantic_generation/page_token/local_deps);SSE 过期包拒绝与帧选择保留;print/响应式;1000 单元 compile smoke。 - 故事门禁(M08):建库→复用→来源变更失效→修复重绑。
Fixed
- View 说明链接 raw-string 截断;skill_brief / CORE SYNTAX 预算不被冲突旧规则吃掉。
- 上传体积限制在 multipart 解析前生效(不再只靠内存 form 预算)。
Changed
- CLI / wasm /
ext/VERSION同步 2.1.2。 tests/executable_knowledge门禁扩至 45 项;README 切片进度表与发版子集对齐。
v2.1.1 — 2026-10-23
Highlights
可执行知识主链落地(S0–S6):BoundCall 双后端共享解析、正文 NarrativeRef、来源/适用期、digest 保护补丁与纯表达式提取、整代 CURRENT 投影与闭包摘要;订单发票示例双后端输出 113;离线门禁含 100 单元语料与 CLI 冒烟。
git checkout v2.1.1 && cargo build --release
marqdo ext add web
marqdo run examples/executable-knowledge/docs/invoice-answer.mq.md
核心表面 Δ:无增删关键词——同模块 Type.member 纳入 BoundCall;语义投影新增 bound_calls / dynamic_calls / hashes.closure / NarrativeRef 步骤;不改变默认 Occlusion 链接读法。
Added
- BoundCall / DynamicCall:
sema::bind::resolve_for_exec;Tree 与 Bytecode 静态路径对齐;bound_calls.json/dynamic_calls.json;同模块定义树路径绑定。 - NarrativeRef:注释行 Markdown 链接 →
narrate/navigation步骤;围栏与行内代码不计步骤。 - 来源与适用性:frontmatter
sources/valid_until→evidence=sourced|expired|missing_source;artifact.bind policy=business。 - 局部编辑与提取:MLSP
artifact.patch(digest + wording 回滚);artifact.extract_pure纯表达式预览。 - 整代与闭包:
generations/<id>/+CURRENT;hashes.closure随依赖变化;锁报告classes。 - 门禁:
tests/executable_knowledge(含 100 单元);CI.github/workflows/executable-knowledge.yml;项目扫描 depth/size/count 上限。 - 示例:
examples/executable-knowledge发票含税链可运行;负知识文档。
Fixed
- Bytecode 裸名解析不再跨 import scope 误连同名函数;同模块
Type.member写入 path_index 供兄弟调用。
Changed
- Agent / reuse 发现结果标记
discovery_only+bind_required/bind_targets,不可把打分结果直接当可执行目标。
v1.5.2 — 2026-10-18
Highlights
外联 v3 P0/P1:session eval 支持 raw stdin(Python/Node 持久内核);每 cell 独立 stdin 与 Interrupt;plan generation/add/remove/value API;snapshot export/import/replay;view capture / view output --snapshot 捕获实时快照;显式 Persist 按钮。CLI · wasm · ext 1.5.2。
git checkout v1.5.2 && cargo build --release
marqdo ext add web # CDN → 1.5.2
核心表面 Δ(Core surface Δ):无增删——外联 v3 扩展 lib/foreign 库 API;不改 MQ 关键词 / 表几何。
Added
- raw stdin + 每 cell 输入:session eval 支持 raw stdin;
foreign.session inputs=每 cell 独立 stdin;view 增加每卡 stdin 字段与 Interrupt 按钮。 - plan API:plan generation/add/remove/value;运行时 plan 更新与 generation。
- snapshot:snapshot export/import/replay;
view capture/view output --snapshot捕获 live 快照用于静态导出。 - 显式 Persist:Persist 按钮 +
/api/session/cell/persist。 - 嵌套 plan 边界:显式 persist 与嵌套 plan 边界;foreign 拒绝嵌套 view plans。
Fixed
session_listarity:保持空 arity。
Changed
- CLI / wasm /
ext/VERSION同步 1.5.2。
v1.5.1 — 2026-10-18
Highlights
view 静态/动态统一 + 外联值传递:静态导出与 live view 共用同一套 foreign_doc 执行路径;构建时实际运行代码单元并注入 stdout;foreign.session 可把 Marqdo 值传入多内核会话;cell stdin 支持 live/static/持久内核三种模式。CLI · wasm · ext 1.5.1。
git checkout v1.5.1 && cargo build --release
marqdo ext add web # CDN → 1.5.1
核心表面 Δ(Core surface Δ):无增删——view 执行路径统一 + 外联值传递;不改 MQ 关键词 / 表几何。
Added
- 外联值传递:
foreign.session kernels= cells=可把 Marqdo 值传入多内核 view 会话;view只消费会话绑定,不再识别内核表/会话表保留名。 - Cell stdin:view 增加
Cell stdin / input输入框;Run/Step/Run All 都会传给外联 cells;无状态 cell 使用 raw stdin,持久内核使用marqdo_input;静态导出使用 frontmatterstdin作为构建时输入。 - 静态导出真实执行:构建时实际执行代码单元并把 stdout/stderr 注入代码卡;静态示例通过代码 fallback 或 frontmatter
stdin提供输入。 - 可运行外联写回示例:新增
examples/foreign-writeback/index.mq.md,用foreign.run+writeback.record将结果写入.mq.md的 keyed 槽位。 - 写回块分组与主题:view 对写回块按目标分组并统一主题样式。
Fixed
- code 卡控制恢复:恢复每个代码卡的内核切换下拉与 Clean 按钮;Clean 清除单个 cell 输出/记录,不重启内核。
- 导入函数返回锚定:导入函数的返回值锚定在调用位置。
- 静态导出自包含:静态示例不再依赖空 stdin 或外部内核状态。
- Execution 输出清除:view 清除 Execution 输出从 view 表面。
- 文档表不再变 call chips:view 不再把文档表转为 call chips。
- 写回表标签:写回表标签保持为行内代码。
Changed
- 静态/动态统一执行路径:static 与 live cells 使用同一
foreign_docrun_all路径;移除In []/Out []与 Notebook 品牌。 - 静态按钮行为:静态页面执行按钮点击显示"静态页面无法真实执行",不伪造成功。
- 低层会话评估可见:文档展示低层 session evaluation 为代码围栏。
- CLI / wasm /
ext/VERSION同步 1.5.1。
v1.5.0 — 2026-10-18
Highlights
外联 v2 / 文档原生 Notebook:lib/foreign 从“运行一段代码”升级为完整外联内核:结构化 invoke 记录、JSON 进出的 call / call_many、并行扇出、Python/Node 持久内核、显式状态桥,以及用绑定表声明的 Notebook 单元。view 增加 cell 单步、Run All、内核切换、journal、状态面板、浅/深主题与可调高度代码区;高对比度 token 修复了代码和 STRUCTURE 文字与背景区分度不足的问题。CLI · wasm · ext 1.5.0。
git checkout v1.5.0 && cargo build --release
核心表面 Δ(Core surface Δ):无增删——外联 v2 只扩展 lib/foreign 的库 API;Notebook 的 内核表 / 会话表 是既有绑定表;没有新增 Markdown 标记。
Added
- 用户静态站(外联 / OKF / EKC):新增中英双语
features/19-foreign-view-cells与features/20-okf-ekc,重写stdlib/foreign,首页加入「一份文件三个面」、外联 Python 运行、Notebook 表、OKF/EKC 与 preflight 说明。 lib/foreignF0/F1:invoke结构化记录(ok/code/stdout/stderr/ms/timed_out/truncated/result);run/run_lang新增env/cwd/timeout/args/max_output;15 个语言预设;probe/register/unset/load_config;.marqdo/foreign.toml。lib/foreignF2:JSON 进 / JSON 出call;并行run_many/call_many(有序、单项隔离、并发上限);invoke的input/output/result/result_error。lib/foreignF3/F3.5:Python / Node 持久会话session_open/session_eval/session_close/session_list;状态桥session_set/session_get/session_names;会话超时即杀、崩溃隔离、drop 清理。- Notebook D1/D2:
内核表/会话表文档原生语法;DocumentSession(cell index / 命名内核 / journal / value store);view Notebook 工具栏(Run All / Restart & Run All / Step / State / Journal / Reload)、状态徽标、内核下拉、Push/Pull 状态表单;POST /api/session/*。 - Notebook D3:
reload重新解析并保留内核,源码变更的 cell 标为dirty;Journal/Reload/Debug 按钮;Debug 打开同一 view 服务的语句级单步页(/debug+/api/debug/*);状态桥 Push/Pull。 - 安全与健壮性:所有外联入口检查
exec能力;有界 stdout/stderr 读取与截断标记;stdin 写线程;Unix 进程组 / Windowstaskkill /T超时清理;shell-like argv 切分。
Fixed
- view 文档表面与标注 chip:把旧 view 的
--ink/--fill/--line等 token 映射到当前主题,修复 STRUCTURE 中main、内核表 =、函数名和 annot-chip 深色文字/白色卡片与暗色背景不一致的问题。 - view 代码对比度:移除会互相覆盖的 highlight.js 深/浅两套外链样式,改用内置高对比 token 变量;深色代码正文
#f0f0f0on#1e1e1e(14.6:1),浅色#24292fon#f6f8fa(13.8:1);关键词/字符串/注释均使用可读的对比色。 - view 反向代理兼容:Notebook / Debug 的 API 与 Debug URL 改为相对路径,可在
/marqdo-view/...路径前缀下工作,便于 Docker 内通过 DSH 同源预览。 - 分支内共同局部变量:if/else 各臂都赋值的局部变量不再被误提升为必选形参;修复
# llm构造器无端要求key,恢复 agent/llm/ext 全量测试。新增branch_else_common_local_is_not_a_param回归测试。 - 外联临时脚本路径:入口目录为相对路径时,脚本参数现在使用绝对路径,避免
tests/lib/tests/lib/...双拼接。 - 外联失败可观测:解释器不存在时进入
invoke记录,run仍报错;view 显示 stderr / exit / ms。
Changed
- Notebook view 视觉重做:采用 VS Code Dark 的扁平色板与 Jupyter 的 cell 组织:单一深色底、明确 surface/border 层级、
In [n]/Out [ ]提示、顶部 cell 工具栏、无渐变/无重阴影、暗色代码区与一致的字号/间距;保留并统一原始左侧文件导航、右侧 Functions/Variables 栏与 Execution/Source 区块;支持深色/浅色主题切换(localStorage 记忆)与代码区、输出区纵向拖拽调整高度。 langs现在返回「预设 ∪ 注册 ∪ 配置」的已知语言(原集合是子集)。- 大输出从
Err改为「截断 +truncated=true」;subtask外联输出同步采用该语义。
v1.4.6 — 2026-10-16
Highlights
裸自增升参:粗体首次赋值的左值按设计 §8.2 视为声明。**n = n + 1** 在没有反引号提及时也会把 n 升成必选形参;缺参报 missing argument for parameter,不再是函数体内的 undefined variable。纯局部赋值(**score = 1**)与循环变量不升参。CLI · wasm 1.4.6(扩展包仍为 1.4.5)。
git checkout v1.4.6 && cargo build --release
核心表面 Δ(Core surface Δ):无增删——升参与 §8.2 对齐(赋值左值声明);不改 MQ 关键词 / 表几何。
Fixed
- 升参:
merge_inferred_params纳入首次粗体赋值左值。右值在绑定前读取同名(n = n + 1)时,该名成为必选推断形参。
Changed
- CLI / wasm SemVer 1.4.6。扩展包保持 1.4.5。
v1.4.5 — 2026-10-16
Highlights
Streamable HTTP MCP + web /v1 鉴权硬化:agent_mcp_serve 支持 transport=http(MCP Streamable HTTP 2025-03-26);web invoke 注入 Authorization / X-Api-Key,ok=false+unauthorized → HTTP 401;ext/ai openai/agent 字段访问改 json.get,消除 footnote 硬崩。CLI · Ext · wasm 1.4.5。
git checkout v1.4.5 && cargo build --release
cargo build --release -p marqdo_plugin_agent
# HTTP MCP:
# QDAGENT_MCP_TRANSPORT=http marqdo run cli/求道-mcp.mq.md
marqdo ext add agent # CDN → 1.4.5
核心表面 Δ(Core surface Δ):新增 MCP Streamable HTTP 传输(transport=http|streamable-http);web invoke 契约扩展(header 注入 · 401);无 MQ 关键词 / 表几何变更。
Added
agent_mcp_serveStreamable HTTP:transport=http·host/port/path;POST JSON-RPC + 可选 GET SSE;Mcp-Session-Id。facade:ext/ai/agent## serve。
Fixed
- web invoke:
Authorization/X-Api-Key注入 payload;jsonWrapInvokeValue对unauthorized返回 401;{sse}自动 event-stream。 ext/ai/llm/openai·agent·llm:字段访问改json.get/at,避免[field](x)在非 map 上硬崩。- explore workbook:子任务
stream=False(网关 SSE 524 更稳)。
Changed
- CLI / Ext / wasm SemVer 1.4.5。
- 设计:doc/design/ext-web-artifact.md(sse / bearer)。
v1.4.4 — 2026-10-16
Highlights
LLM 传输软失败 + ext/ai 表优先重构:上游连接拒绝/超时/HTTP≠200 时,Runtime 返回结构化 finish|status=error(不再硬中断 VM);agent / 智能体 / llm/openai 去掉 json.set/json.append 袋胶水。含 CLI host · plugins/llm · Ext pack 1.4.4。
git checkout v1.4.4 && cargo build --release
cargo build --release -p marqdo_plugin_llm
marqdo run tests/ext/agent-llm-transport-soft.mq.md
marqdo ext add agent # CDN → 1.4.4
核心表面 Δ(Core surface Δ):无增删——HTTP 宿主软失败契约 + Extension 风格重构;不改 MQ 关键词 / 表几何。
Fixed
- LLM / Agent 传输软失败:
host_http_post/ SSE ·plugins/llm·ext/ai/llm/openai结构化finish=error;agent.step/plan/run收成status=error。金样tests/ext/agent-llm-transport-soft.mq.md。说明:doc/research/agent-llm-transport-soft-2026-10.md。 agent.run:cache == "soft-hit"引号比较(裸soft-hit曾被解析为减法)。
Changed
ext/ai去 json 胶水:结果 map / 事件用 GFM 表 +table.put/table.append/table.empty_*。SKILL 正面示例:.cursor/skills/marqdo-dev§2 ·marqdo/examples.md§6e。- CLI / Ext / wasm SemVer 1.4.4。
Ext pack v1.4.3 — 2026-10-16
Highlights
Agent cold EFI / resolve 硬崩修复(CLI 仍为 v1.4.2):qdagent 接通 agent.run 时空 OKF 触发 unknown function preflight 与 missing map key llm_free。本包修复 ext/ai/agent facade 与 agent native;金样 tests/ext/agent-run-cold-efi.mq.md。说明:doc/research/agent-run-efi-resolve-bugs-2026-10.md。
marqdo ext add agent # CDN latest → 1.4.3
# 或:MARQDO_EXT_VERSION=1.4.3 marqdo ext add agent
核心表面 Δ(Core surface Δ):无增删——仅 Extension / Agent Runtime 契约修补。
Fixed
agent.run:efi=True改为`self`.preflight(不再裸调全局preflight)。agent_resolvemiss:返回字段对齐命中路径,含llm_free: false;facade 对llm_free/ route 字段改用json.get。
Changed
- 扩展包 SemVer 1.4.3(
ext/VERSION);与 CLI v1.4.2 可独立安装。
v1.4.2 — 2026-10-16
Highlights
Agent/LLM 优化 O1–O5:ext/ai/sandbox CoW 试跑接入 agent.trial / run sandbox=(默认关);promote 强制 sandbox proof;步骤路由 step_route + EFI preflight + usage/token_cost;风格 lint 与 sandbox.report;技能 quarantine 与离线 standing/policy 优化脚本。表优先、少 json 胶水。路线:ext-ai-optimize.md。
git checkout v1.4.2 && cargo build --release
cargo build --release -p marqdo_plugin_agent
marqdo run tests/ext/agent-sandbox-optin.mq.md
marqdo run examples/agent-sandbox-okf/index.mq.md
# Ubuntu: sudo apt update && sudo apt install marqdo
marqdo ext add agent # CDN latest → 1.4.2
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。本版为 Extension / Agent Runtime(ext/ai 沙盒与晋升闸门),不触碰语言标记。
Added
ext/ai/sandbox:CoW 工作区(open/run/diff/commit/discard/inspect/profile/report);经plugins/agentsandbox_*→host_query;默认拒plugin/exec/net。- O1:
agent.trial·run/stepsandbox=· 中文试跑/沙盒=· 示例examples/agent-sandbox-okf/· 金样agent-sandbox-optin。 - O2:
agent_kb_promote默认 sandbox proof;OKFapplies_when/fixtures/sandbox_profile/proof;harness Skill Lift。 - O3:
agent.step_route·ext/ai/policies/step-route.mq.md·run efi=(缺工程知识时软放行)· 结果usage/token_cost。 - O4:
scripts/mq-style-lint.sh·sandbox.reportmarkdown 审阅面。 - O5:
agent_kb_quarantine/agent.quarantine·scripts/optimize-standing-policy.sh。
Fixed
Changed
- CLI / wasm /
ext/VERSION同步 1.4.2。 - Skill:强制表/链接取元、禁同文件混 EN/ZH、点名 sandbox 试跑习惯。
v1.4.1 — 2026-10-15
Highlights
view 叙述标注连线:Browse / view output 中 underline→chip 改为 SVG 正交连线(描述底边中点 → 轨道 → 短竖线 → 值顶边中点);同跨度多帧 chip 共用 annot id;可见 chip 按锚点 L→R;帧切换后重算密度。设计:view-prose-annot-gaps.md。
git checkout v1.4.1 && cargo build --release
marqdo view public/00-welcome.mq.md --no-open
marqdo view output public -o /tmp/mq-public
# Ubuntu: sudo apt update && sudo apt install marqdo
marqdo ext add web # CDN latest → 1.4.1
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。本版为 Runtime / Tooling(view 标注几何与帧 chip 对齐),不触碰语言标记。
Added
- 设计缺口文档 view-prose-annot-gaps.md:叙述 fence 卡、帧感知 chip 密度、L-leader 几何约定。
Fixed
- view L-leader:id 与 mark 错配、chip 逆序交叉、border 无色变黑碎段、横线穿过 chip 文字;现为 mid→mid SVG path。
- 叙述 fence / 代码卡单层渲染;静态页隐藏 Run;主文函数引用 call chip + leader。
Changed
- CLI / wasm /
ext/VERSION同步 1.4.1。
v1.4.0 — 2026-10-15
Highlights
叙述统一 + 公式 meta + 图片自写回:块公式 % marqdo: var=;分支/循环体与函数体同权叙述;foreach 中英糖;自写回图片 (扩展名校验)与 view/静态站同源标记;view 展示推断形参实值;欢迎页迁到 v0.3 叙述面。
git checkout v1.4.0 && cargo build --release
marqdo run tests/markup-v03/formula-meta-var.mq.md
marqdo run tests/markup-v03/foreach-narrative.mq.md
marqdo view tests/view/document-annot-demo.mq.md --no-open
# Ubuntu: sudo apt update && sudo apt install marqdo
marqdo ext add web # CDN latest → 1.4.0
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。Language 层在既有 formula / branch-list / loop-list 上扩展语义(块公式 TeX 注释绑定、臂/循环体叙述、foreach 糖);Runtime:自写回图片形态 + view 推断形参展示。设计:fence-meta-and-control-prose.md · stdlib-writeback.md。
Added
- 块公式 meta 绑定:
$$内% marqdo: var=<ident>(剥离后解析;可无空 RHS);金样tests/markup-v03/formula-meta-var.mq.md。 - 控制流叙述统一:臂/循环体
parse_indented_body与函数体同权;分支条件行支持叙述前缀与行内**…**;foreach 糖- 对…的每一项…/- for each … in …。 - 图片自写回:路径/URL 且扩展名合法 →
;文本仍 HTML 注释;view /view output同源样式卡与<img>。 - view 推断形参实值:Browse 展示 body-inferred 参数绑定值;欢迎页 EN/ZH 迁 v0.3 叙述。
Fixed
ext/net/url.encode:经lib/net包装,不再直接host_*(金样ext_mq_md_never_calls_host)。- PPA 源包:
ppa-build-source.sh本地.orig已在 build-area 时跳过重复cp。 - view:嵌套调用欢迎页与公式/代码卡渲染清理。
Changed
- CLI / wasm /
ext/VERSION同步 1.4.0;词法评论段遇有序分支臂 / 循环头 / 图片自写回标记时断开,避免吞掉控制流行。
v1.3.3 — 2026-10-15
Highlights
view 文档面 Structure:Browse 保真叙述与标记面(变量/语句/返回无源码定界符);表/循环/分支结构块;语句后绑定值、分支命中臂、函数多调用与循环迭代下拉(默认末帧);#mq-view-trace AI JSON。静态 marqdo view output 与 live view 同源渲染(含用户站 public/ → gh-pages)。
git checkout v1.3.3 && cargo build --release
marqdo view tests/view/document-annot-demo.mq.md --no-open
marqdo view output public -o public
# Ubuntu: sudo apt update && sudo apt install marqdo
marqdo ext add web # CDN latest → 1.3.3
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。本版为 Runtime / Tooling(view 文档面 + 帧选择),不触碰语言标记。
Added
- Browse Structure 文档面(
src/view/document.rs·annot.rs):叙述保真、标记面、GFM 表 /doc-loop/doc-branch、CSS L-leader 标注带。 - StmtEvent / CallFrame / LoopFrame 静默轨迹:post-stmt 绑定、分支
call_id、循环分 = 分数表[i] · value;调用/迭代 picker(源码常显,只滤 chip)。 ViewExecutionReportJSON(#mq-view-trace·/api/view-trace· SSEtrace_json)。- 设计:view-document-annotations.md · view-execution-trace.md · view-frame-selection.md;样例
tests/view/document-annot-demo.mq.md。
Fixed
- 多调用分支 taken 混叠;调用切换误藏未执行臂源码;循环头重复 chip。
Changed
- CLI / wasm /
ext/VERSION同步 1.3.3;静态导出与 live view 共用build_file_view→ 文档面。
Ext pack v1.3.2 — 2026-10-13
Highlights
Trailing slash 路由修复(CLI 仍为 v1.3.0):Go ServeMux 精确匹配导致 /post/foo/(带尾部斜杠)落入 404。新增 withStripTrailingSlash 中间件作为最外层 handler wrapper,所有下游中间件(RBAC、Tenant、路由)均看到规范化路径。覆盖静态路由、动态路由、根路径、查询参数保留。
marqdo ext add web # CDN latest → 1.3.2
# 或:MARQDO_EXT_VERSION=1.3.2 marqdo ext add web
Fixed
- web:
/post/foo/trailing slash now routes the same as/post/foo(dynamic and static routes). Root/unchanged. Query strings preserved after normalization.
Ext pack v1.3.1 — 2026-10-08
Highlights
OIDC 路径型 redirect_uri(CLI 仍为 v1.3.0):redirect_uri=/oidc/callback 按请求 Host / X-Forwarded-* 拼绝对回调,写入会话供 token 交换;可选 redirect_origins allowlist。apex / www 多域名无需写死单一绝对 URI。
marqdo ext add web # CDN latest → 1.3.1
# 或:MARQDO_EXT_VERSION=1.3.1 marqdo ext add web
Added
- 路径型 redirect_uri:绝对 URL 行为不变;路径模式解析 public origin,session 键
oidc_redirect_uri。 redirect_origins/回调来源:逗号分隔 origin allowlist(路径模式)。- ABI:
web_app_oidc透传redirect_origins;ext/security/oidc.attach文档同步。
Changed
- 扩展包 SemVer 1.3.1(
ext/VERSION);与 CLI v1.3.0 可独立安装。
v1.3.0 — 2026-09-28
Highlights
Engineering Knowledge Compiler(EKC):把仓库投影为 AI 可查询的工程知识系统——L0–L4 Catalog、Capability / Decision / Constraint / Failure、知识图、Reuse Preflight(REUSE→ADAPT→CREATE)与 Context Pack。本版 CLI 与扩展包 同步为 1.3.0。
- 杀手命令:
marqdo reuse "task"/find/duplicate/impact/conflicts/stale/verify/knowledge - Agent:
agent.preflight·agent_eng_*;plan … eng_preflight=True在造轮子前强制 EFI - 投影:
.marqdo/catalog|knowledge|graph|agent/+engineering.yaml;catalog默认挂钩 EKC - 示例 / 金样:
examples/engineering-knowledge/·tests/engineering/·tests/ext/eng-preflight.mq.md
sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo
git checkout v1.3.0 && cargo build --release
marqdo knowledge . -o .marqdo
marqdo reuse "resolve configuration"
marqdo ext add agent
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。本版为 Runtime / Tooling(知识编译器 + CLI + agent 插件),不触碰语言标记。
Added
src/knowledge/EKC:L0–L4 IR、指纹、能力推导、图边、compile、find/reuse/preflight、impact/lifecycle/duplicate、metrics、policy、learn。- CLI:
knowledge·find·reuse·impact·conflicts·stale·duplicate·verify;catalog/sync默认编译 EKC(--no-knowledge可关)。 - Agent:
agent_eng_preflight/agent_eng_reuse/agent_eng_record;ext/ai## preflight+plan eng_preflight。 - 规范:
doc/design/engineering-knowledge.md;提案叙事doc/next/008.md(已实现标注)。
Fixed
Changed
- OKF type 注册表扩展 Capability/Decision/Constraint/Failure/Context Pack/Policy 等(okf.md)。
- 核心表面 Δ:无增删。
v1.2.0 — 2026-09-28
Highlights
Web Artifact 重写(ADR 0007):Document / Endpoint / Resource 一等公民;type: web|endpoint(ZH 类型: 网页|端点);facade web.page|route|serve|render|inspect|use;DB/auth/ws 拆到 ext/data · ext/security · ext/net。本版 CLI 与扩展包 同步为 1.2.0。
- Document:文件级 Artifact +
data_source/data_order/data_where;正文 Markdown → HTML;列表卡片 / 详情文章由 serve 时加载。 - Endpoint:
# main处理器;请求经run_artifactBinding 注入;response序列化 JSON/text/html。 - 破坏性:删除作者面
compose_*/app.configure/ 作者ensure_plugin;旧 web gold 移除,新金样ext_web_*。 - 示例:
examples/marqdo-blog/Artifact 站(pages/api/db + smoke);web-client-siteserve 扫描。
sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo
git checkout v1.2.0 && cargo build --release
bash scripts/build-web-plugin.sh && marqdo ext add web
marqdo run examples/marqdo-blog/serve.mq.md
核心表面 Δ(Core surface Δ):无增删——复用 Metadata type;装配语义在 ext + plugin。语言标记不变。
Added
- Web Artifact 模型(ADR 0007):
type: web|endpoint(ZH类型: 网页|端点);核心src/artifact/;sys.artifact_kind;无# main时 Result 摘要。 ext/webfacade:page·route·serve·render·inspect·use;子模块 page/route/dom/client/component。ext/data·ext/security·ext/net:从 monolithic web 拆出 Resource。- 统一 View
|type|slot|value|attrs|style|+ ABIweb_render_nodes/web_serve_root/web_inspect/web_app_use。 - 规则:
.cursor/rules/web-artifact-no-degrade.mdc;设计doc/design/ext-web-artifact.md。
Fixed
- Document
data_source/data_wherenow drive list cards and detail articles underweb.serve(ADR 0007 flat metadata).
Changed
- 破坏性:删除作者面
compose_*/app.configure/ 作者ensure_plugin。旧 web gold 已移除;新金样web-artifact-*/ext_web_*。 - 核心表面 Δ:无增删(复用 Metadata
type)。 - 修订
ext-web.mdC1;doc/next/007.mdsuperseded。
v1.1.1 — 2026-09-24
Highlights
AI 栈收口(agent + llm):语义 ask/stream/collect、Artifact Metadata Binding、Skill Compilation + Adaptive Routing、MCP 客户端与 resume 检查点、可选 plugins/llm Transport ABI。
本版 CLI 与扩展包 同步为 1.1.1。
- LLM 原语:
ext/ai/llm从 OpenAI HTTP 客户端提升为ask/stream/collect智能原语(complete保留兼容);LLMResult.tool_calls;可选原生llm_chat_completions(无.so时回退lib/net)。 - Metadata Binding:frontmatter
${env|arg|sys|secret}加载期解析;Phase 2 将绑定键注入入口 env(正文禁止${…});sys.meta/--bind;llm ctor 优先 meta。 - Agent:Skill Compilation(episode → llm_free skills)+ Adaptive Routing(
marqdo/small-llm/llm/auto;jev为small-llm兼容别名);MCP stdio 客户端;resume 检查点;零 LLM 金样路径。 - 度量与后端:
model_turnusage、named handles(fast/reasoning)、type:prompt加载、openai/ollama 分流。
# Ubuntu PPA / 源码
sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo
git checkout v1.1.1 && cargo build --release
marqdo ext add llm && marqdo ext add agent
核心表面 Δ(Core surface Δ):无增删——19 个核心构造不变。本版为 Runtime(Metadata Binding、LLM/agent 插件与扩展)变更,不触碰语言标记。
Added
ext/ai/llm语义表面:ask/stream/collect(complete兼容);LLMResult.tool_calls(OpenAI-shapedchoices[0].message.tool_calls);sys.module_source+ 入口文档prompt_body离线路径。plugins/llmTransport ABI(llm_chat_completions):ext/ai/llm/openai优先原生插件,否则lib/netHTTP/SSE。- Artifact Metadata Binding:frontmatter
${env|arg|sys|secret}→Module.metadata;Secret 掩码;sys.meta/--bind;Phase 2 入口 env 注入(正文拒绝${…};字节码 prologue 同源)。 - Agent Skill Compilation + Adaptive Routing:episode →
maybe_learn→ llm_free skills;路由后端marqdo/small-llm/llm/auto(jev=small-llm兼容别名,不再探测MARQDO_JEV)。 - Agent MCP stdio 客户端(
agent_mcp_client/mcp_connect/mcp_client_list/mcp_client_call)+ Python mock 离线金样。 - Agent resume 检查点(
.marqdo/agent-resume/<id>.json— save/load/clear/list;run可设resume_id=)。 - AI 栈度量与后端:
model_turnusage、named handles(fast/reasoning)、type:prompt加载、openai/ollama 分流、agent-zero-llm 金样。
Fixed
- plan force 不再冲掉已有
resourcesworkbook(保留 llm_free 资源;金样agent-plan-preserve)。 - compiled-skill Marqdo 语法:llm_free await 不再误落到 plan+HTTP。
Changed
- Adaptive Routing:决策面为
router_model(任意 llm handle);jev降为small-llm文档/兼容别名。
v1.1.0 — 2026-09-23
Highlights
AI 原生闭环三件套落地:核心表面守卫(问题一)· 渐进式契约(问题二)· MLSP for AI(问题三)。
marqdo check 静态契约防漂移、marqdo mlsp 让 AI 按需查询语法而非背诵、run --json 统一结构化诊断(错误即数据,供 AI 直接消费)。
本版 CLI 与扩展包 同步为 1.1.0。
- 核心要小(问题一):
doc/design/core-surface.md列出 19 个核心构造 +CORE_CONSTRUCTS守卫测试——任一侧(清单/文档/金样)单边改动 CI 必红;三层架构(Core / Runtime / Document)入doc/design/layers.md。 - 语义校验(问题二):渐进式契约表(
参数/返回/字段/集合)嵌入文档叙述;四边界校验(调用实参 / 返回值 / 表绑定 / 键访问);marqdo check静态防漂移(类型 typo / 参数名漂移 / 重复契约必报)。 - AI 可靠反馈 + 不必学语法(问题三):
marqdo mlsp(MLSP,行分隔 JSON over stdio)提供locate/syntax/validate/repair_targets/repair_apply/schema;syntax卡片机械携带戒律原文 / 样例 / 文档锚点,AI 无需预学语法。修复护栏:有界行编辑、越界必拒(abstain)。 - 验证(P4):锚点消融 anchor 一轮修复率 100%(双模型,plain 85%/90%);契约消融拦截 100% / 误报 0%;防漂移必报 9/9;核心守卫演练 3/3 必红。详见 perf-validation-report-2026-09-23.md。
# Ubuntu PPA / 源码
sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo
git checkout v1.1.0 && cargo build --release
marqdo ext add web
核心表面 Δ(Core surface Δ):无增删——19 个核心构造(heading / bold-code / italic-return / param-list / call-quote / branch-list / loop-list / table-bind / footnote-index / link-index / …)与 v1.0.7 完全一致,未新增标记。本版为 Runtime 层(契约校验 / MLSP / 诊断 JSON) 与 Document 层(core-surface / layers) 变更,不触碰语言核心。
Added
- MLSP(
marqdo mlsp):面向 AI 的语言服务协议(行分隔 JSON over stdio)——locate/syntax/validate/repair_targets/repair_apply/schema;syntax卡片含semantics/rule/sample/doc_quote(自持,机器可读戒律原文)。 marqdo check:静态契约漂移检查(未知类型词 / 参数名漂移 / 返回越约 / 重复契约表 / 错位契约表)。- 渐进式契约(Progressive contracts):文档叙述内嵌契约表(
参数/返回/字段+ 集合字段),四边界校验(调用实参 / 返回值 / 表绑定 / 键访问);被绑定的字段|类型表是数据、永不误判为契约。 marqdo run --json:统一结构化诊断(code/severity/suggestion/doc_anchor/doc_quote/contract_ref),错误即数据。- 修复护栏:
mlsp repair_apply有界行编辑——只允许落在doc_anchor指定范围内的编辑,越界整体拒绝(all-or-nothing / abstain)。 - 守卫与文档:
doc/design/core-surface.md(19 构造)、doc/design/layers.md(三层架构)、tests/core_surface.rs(守卫生效验证)。
Fixed
- 错误链不再扁平化:
src/load.rs以label_error保留结构化Diagnostic("Error Exit Only" 原则),修复契约类错误被降级为字符串的回归。 - 契约 parse 边界:
interp.rs键访问优先给出index_diag(索引/键诊断先于取值),空字段 vs 缺字段语义消歧。
Changed
.cursor/skills/marqdo:由「背诵式压缩操作手册」改为查询式工作流——写码前mlsp syntax/locate,提交前mlsp validate+marqdo check,修复照doc_anchor局部改。- 契约表一经出现即为完整声明(新推断的升参未覆盖 ⇒
contract.param_drift警告,不静默)。 - 取元主推
[键](集合)(link-index);`集合`[^键](footnote-index)保留兼容。
已知未决(诚实标注)
- P4 实验 (b) 盲测未达标:「查询式 vs 全文档背诵」四判据未全立(
deepseek-flash:docs 4/6 vs query 0/3;端点 infra 削样本)。查询机制本身已验证无缺陷,瓶颈在模型自查纪律(不知道自己不知道 ⇒ 不查询)——协议改进(写码前强制自检 / 陌生构造强制查询)列入下一阶段。见 perf-validation-report-2026-09-23.md §3。
Unreleased
v1.0.7 — 2026-09-22
Highlights
WS / 网络边界加固:WebSocket 握手同源校验、broadcast/room 默认需登录(require_auth/需要登录 可显式关闭)、消息 1 MiB × 256 条上限、空 room 回收;HTTP 响应 8 MiB 在读流时截断;url_encode 空格 %20。本版 CLI 与扩展包 同步为 1.0.7。
- 安全默认:浏览器 WS 握手仅同源;有状态 fan-out 端点未登录 401 / 公开直播流显式
require_auth=False - 资源上限:WS 单条 1 MiB、单连接 256 条;HTTP/SSE 8 MiB 读流截断——对端无法借大响应耗尽内存
- 测试:P3 金样对齐 quiet-admin 门禁语义;wasm smoke 以 ESM 加载官方 bridge
# Ubuntu PPA / 源码
sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo
git checkout v1.0.7 && cargo build --release
marqdo ext add web
Fixed
- WS 安全默认:握手改为同源校验(不再放行任意 Origin);
route_ws新增require_auth/需要登录,broadcast/room 默认要求登录会话,公开直播流需显式设假,未认证握手 401。 - WS 资源上限:单条消息 1 MiB、单连接最多收集 256 条回复;传输错误/超时返回
{ok:false, error},不再伪装空成功;空 room 自动回收(防 URL 派生 room 名耗尽内存)。 - HTTP 响应上限:8 MiB 上限在读流时截断(含错误路径与 SSE 错误路径),上游无法借超大响应耗尽内存。
Changed
net.url_encode:空格编码为%20(原+),URL 段语义下与字面+消歧义。web/网页文档同步:route_ws的require_auth/需要登录与ws.connect的收集上限语义。
Unreleased
Added
Fixed
Changed
Ext pack v1.0.6 — 2026-09-18
Highlights
ext/web OIDC、表单删除与安静管理台(CLI 仍为 v1.0.3):OIDC 登录/登出回首页、表单 删除 动作、默认关闭内置 admin/RBAC desk、独立 Redis 会话 URL、Postgres CRUD。安装:
marqdo ext add web # CDN latest → 1.0.6
Added
- OIDC:
auth.oidc/ 网页鉴权 OIDC;登录入口与next回跳。 - 表单删除:
form动作删除/delete(通用 CRUD,无站点特判)。 - 列表/路由:请求上下文、列表装配延续;注销默认回
/避免 IdP 再登录环。
Fixed
- 内置 admin / RBAC desk 默认安静,直至显式
admin/enable_rbac。 - 静态资源缓存与 WASM 启动延迟;会话 CSRF 与 Postgres 方言。
Changed
- 扩展包 SemVer 1.0.6(
ext/VERSION);与 CLI v1.0.3 可独立安装。
Ext pack v1.0.5 — 2026-09-18
Highlights
ext/web 请求上下文与表单来源(CLI 仍为 v1.0.3):字段 来源/source(session / route / now)、server-only 盖戳、页面 列表装配/compose_list;禁止按业务表特判。安装:
marqdo ext add web # CDN latest → 1.0.5
Added
- Request context:表单提交携带
_mq_params/_mq_return;ApplySources从 session/route/now 写入。 - 字段来源列:
client(默认)/session.username/route.NAME/now;非 client 不渲染且覆盖客户端伪造。 - 列表装配:
compose_list/列表装配(副绑定 + 条件/排序/插槽),详情页可同页渲染子列表。 - 设计文:ext-web-request-context.md;金样
ext_web_form_source_live。
Changed
- 扩展包 SemVer 1.0.5(
ext/VERSION);与 CLI v1.0.3 可独立安装。 - 移除评论表名特判(
enrichCommentSubmit)。
Ext pack v1.0.4 — 2026-09-17
Highlights
ext/web 能力面扩展(CLI 仍为 v1.0.3):可配置 RBAC、租户作用域、WS on_message/presence、原生 SPA 内存路由、协同记事本 MVP。安装:
marqdo ext add web # CDN latest → 1.0.4
Added
- RBAC:五表(
web_permissions/web_roles/web_role_permissions/web_users/web_user_roles);app.enable_rbac、app.gate permissions=、rbac.can、注册页、/_rbac/*管理 API/desk。 - Tenant:
app.tenant(path/header/subdomain)+tenant_scope自动过滤/盖戳。 - WebSocket G-WS2:
route_ws支持on_message钩子、动态 room、presence通道。 - Native SPA:内存
store_set/spa_goto与全页 WASM SPA 样站。 - Collab MVP:LWW 文档协议(
DOC\t)双端协同记事本样站。
Changed
- 扩展包 SemVer 1.0.4(
ext/VERSION);与 CLI v1.0.3 可独立安装。
v1.0.3 — 2026-09-17
Highlights
分发渠道齐备:Ubuntu PPA 装 CLI;扩展包走 CDN(ext.marqdo.com)与 GitHub;CLI 与扩展可分开发版。本版 CLI 与扩展包 同步为 1.0.3。
语法:未绑定的 GFM 表格是可丢弃的集合值,不再报 unrecognized statement(文档页可直接写安装表)。
# Ubuntu
sudo add-apt-repository ppa:cflmy/marqdo
sudo apt update && sudo apt install marqdo
marqdo ext add web
# 或源码 / Releases
git checkout v1.0.3 && cargo build --release
Added
- Ubuntu PPA packaging:
debian/+scripts/ppa-ship.sh(一键装工具/打包/dput) +ppa-build-source.sh+ ubuntu-ppa.md. - Extension CDN (
https://ext.marqdo.com/ Cloudflare R2):ext add下载顺序改为 CDN → GitHub → proxy;独立包版本见ext/VERSION与 CDNlatest/VERSION;上传脚本scripts/upload-ext-r2.py(凭据~/.marqdo/r2.env)。设计见 ext-cdn.md。 ext add下载:GitHub 失败后自动回退https://proxy.cflmy.top/github.com/…;可用MARQDO_EXT_DOWNLOAD_BASE指定首选镜像;加长读写超时。- 用户文档(README /
public/00-欢迎/features/05-扩展)标明安装渠道:Ubuntu PPA、GitHub Releases、源码;扩展走 CDN。
Fixed
ext/导入默认搜索~/.marqdo/ext(与marqdo ext add安装根一致),无需再手动export MARQDO_EXT。- PPA/noble:捆绑
third_party/rust(现代 cargo)以构建 Cargo.lock v4;修复首次 Launchpad 构建失败(distro cargo 1.75)。 - 未绑定的 GFM 表格不再报
unrecognized statement:作为集合值求值后丢弃(文档中可写表)。
Changed
- 允许 CLI 与扩展包分开发版:扩展包 SemVer 可与
Cargo.toml不同(MARQDO_EXT_VERSION/ext/VERSION/ CDN latest)。 - 发版 skill:支持
full/cli/ext;扩展必传 R2+GitHub;CLI 走 PPA;需用户操作时打印确切命令。
v1.0.2 — 2026-09-16
Highlights
表驱动页面引言(compose_intro / 引言装配):英雄区用 GFM「属性 / 值 / 样式」表声明,不再手写 HTML 字符串;WWW Demo 样站与后台门禁一并加固。
git checkout v1.0.2
cargo build --release
bash ./scripts/build-web-plugin.sh
# 或:解压 Release 的 marqdo-1.0.2-*-native-*.zip / Linux CLI zip
marqdo run examples/web-site-zh/index.mq.md
Added
- Go
libweb:web_compose_intro— 将引言表装配为.main-introHTML;中英 API页面.引言装配/page.compose_intro(ext/web)。 - 验收样例:
tests/ext/web-intro-compose.mq.md;examples/web-site/web-site-zh升级为表驱动引言 + 文学风壳层 + 卡片→详情路由。
Fixed
- 后台样站:导航/侧栏/页脚槽位与门禁登录挂载对齐;表单字段加宽便于创建。
Changed
- Demo 叙述与种子数据面向 WWW Industry / 可复现演示;作者仍零业务 JS、零手写
.css。
v1.0.1 — 2026-09-15
Highlights
ext/web(Go libweb)回归修复:动态路由查询条件恢复 {param} 代入;详情 SSR + Markdown;样式表数字不再误报。
git checkout v1.0.1
cargo build --release
bash ./scripts/build-web-plugin.sh
# 或:解压 Release 的 marqdo-1.0.1-*-native-*.zip / Linux CLI zip
marqdo run examples/marqdo-blog/index.mq.md
Added
- Go web plugin:详情页正文 Markdown(goldmark GFM),对齐 Rust
pulldown-cmark路径。
Fixed
- 动态路由
{param}未代入查询条件(ext/webGo):selectPageData递归展开query全部字符串叶子;data-slot-src/_route同步替换。examples/marqdo-blog/post/{slug}详情 SSR 恢复。 - 样式表数字单元格误报「可疑
/除法」:cssValueSuspicious不再把合法z-index/opacity等 number 当警告。 - Go 1.22+ ServeMux:
/static/与/static/favicon.svg的 GET/HEAD 注册冲突导致博客启动 panic。 - Rust archive 同步:
resolve_placeholders递归 + CSS number 误报收窄(非默认构建路径)。
v1.0.0 — 2026-09-14
Highlights
Markdown 语法映射 v0.3 成为 1.0 宪法:**粗体** = 代码,*斜体* = 返回,叙述里的 `名` 声明并推断形参。这是相对 v0.4 / 旧 *语句*/**返回** 的破坏性对调。Linux 预编译拓展包与 CLI bundle 为 Release 必出资产。
git checkout v1.0.0
cargo build --release
# Linux:也可直接解压 Release 的 marqdo-1.0.0-x86_64-unknown-linux-gnu.zip
marqdo run tests/markup-v03/inc-prose.mq.md
Added
- Markup v0.3 运行时闭环:粗体=
代码、斜体=返回、叙述`名`声明与形参推断为唯一映射;金样tests/markup-v03/。 - 方括号标记调用与前置修饰语:
礼貌 [问候] x;取元主语法[键](集合)(脚注取元过渡保留)。 - 代码即文档叙述面 G1–G4:模块级
---跳过、装饰性强调、浮点面量、动态键。 - 粗体表达式语句
**n + 1**;--dump-lines标注[decl]/[bold]/[italic];--dump-ast显示 inferred 形参与死绑定。 - Release Linux 包必出:
linuxjob 上传*-native-x86_64-unknown-linux-gnu.zip与 Linux CLI bundle。
Fixed
- 行首
`名`…叙述不再当语句(修复 pages CI:public/features/16-fs-mid2.mq.md)。 - 句中斜体强调(
*very important*/*foo.bar*)不再误收束函数;Decl 名须为标识符;残缺粗体保持 GAP 恢复。 - 胶合
`名`=default …prose为 Decl 而非赋值。
Changed
- 教程 / Skill /
lib/ext/public对齐 v0.3 标记;view 推断形参chip inferred。
v0.4.0 — 2026-09-13
Highlights
历史说明(2026-11-10):本节的 anlian-mq 是当时发布内容记录,现已移出仓库,旧启动命令不适用于当前工作树。当前完整站点见 examples/web-site 与 examples/web-site-zh。
Go libweb 默认落地(W-G0–W-G14):官方网页原生插件改为 Go C ABI;CLI / gold / Release 走 scripts/build-web-plugin.sh;Rust 源码归档。另附 anlian-mq 验收站与表单插槽 / MARQDO_EXT 提示修复。
git checkout v0.4.0
# 构建 web 原生插件(需 Go + cgo):
bash ./scripts/build-web-plugin.sh
marqdo ext add web
marqdo run examples/anlian-mq/index.mq.md
Added
plugins/webGo 全量重写(W-G0–W-G13):C ABI 对等装配/DB/表单/listen/鉴权/上传/SEO/WS/驱动/proxy·invoke/定制壳;scripts/build-web-plugin.sh→libweb.so/web.dll;ADR 0004 · 施工 ext-web-go-rewrite.md。- W-G14 验收:
examples/anlian-mq/(暗恋见君风格论坛:路由/登录/粉玻璃主题/片段 API;SQLite 本地可跑)。 - GAP-11:
compose_form/表单装配支持target/表单插槽(如#id),把表单注入引言 HTML 内的挂载点。
Fixed
- GAP-12:
ext/…import 解析失败且未设置MARQDO_EXT时,错误附带hint: set MARQDO_EXT to the directory that contains web/。 - listen 会话 / CSRF:登录后
IssueCookie不再误设Max-Age=0;页面 ABIs(query/order/link_prefix/css/detail)与web_page_chrome、invoke return=html对齐 anlian 需求。
Changed
- 默认
libweb为 Go:Release / gold /ext add web不再构建 Rustmarqdo_plugin_web;旧 Rust 树移至plugins/web-rust-archive/(非 workspace 成员)。作者面ext/webABI 名保持兼容。
v0.3.9 — 2026-09-09
Highlights
业务联调缺口 GAP-06–10:解析器不再吞掉嵌套反引号/text=[…] 后的函数体;invoke 的 Null 不再伪装成功;sys.exec capture= 可取 stdout;流式 proxy 反缓冲头。
git checkout v0.3.9
Added
sys.exec/系统.执行:可选capture=/捕获=;为真时返回{code, stdout, stderr}(GAP-09)。
Fixed
- GAP-06/07:
*…*分类对反引号/字符串内的*不再误判;错误收尾的赋值行不再吞掉后续##体(>/ 合法*…*可脱出注释段);命名参数边界尊重[…]/{…}。 - GAP-08:
app.invoke对Null/None返回不再伪装成{"ok":true},改为 500 +{"ok":false,"error":"null result"}。 - GAP-10:
app.proxystream=true响应补齐Cache-Control: no-cache, no-transform与X-Accel-Buffering: no。
Changed
v0.3.8 — 2026-09-09
Highlights
中层标准库 Mid2(M7–M10)收口:日历/时区、URL、TOML、HTML 转义、base32、实用 fs、薄统计与日志字段——日常脚本与工具配置不再依赖外联或插件。另修复嵌套插件调用后 GLOBAL_HOST 被清空导致 invoke 失败。
git checkout v0.3.8
# 或下载 Release 的 exe / zip
marqdo run public/features/14-datetime-url.mq.md
marqdo run public/features/17-stats-log.mq.md
Added
- 中层标准库 Mid2 M10:
lib/stats/统计(mean/median/stdev)与log/日志可选fields=;金样与 public17-stats-log。Mid2 M7–M10 收口(zip 跳过)。设计 stdlib-stats-log.md。 - 中层标准库 Mid2 M9:
fs.make_dirs/remove_tree/stat/walk(中英);金样与 public16-fs-mid2。设计 stdlib-fs-mid2.md。 - 中层标准库 Mid2 M8:
lib/toml/配置表(只读子集)、lib/html/超文本(escape/unescape)、encodingbase32;金样与 public15-toml-html-encoding。设计 stdlib-toml.md · stdlib-html.md。 - 中层标准库 Mid2 M7:
lib/datetime/日期时间({unix,zone,iso}· parse/format/add/in_zone)与lib/url/地址(parse · query_parse/stringify);金样与 public14-datetime-url。设计 stdlib-datetime.md · stdlib-url.md。 - 文档:中层标准库 Mid 之后缺口盘点与 Mid2(M7–M10)设计/路线——stdlib-gaps-after-mid.md · stdlib-mid2.md · stdlib-mid2.md。
Fixed
host_query/ GLOBAL_HOST:嵌套call_registered结束后恢复外层宿主指针,不再清空;web_listen多轮invoke(中间再调插件)不再报no active host context。
Changed
v0.3.7 — 2026-09-07
Highlights
宿主集成 H1–H4:浏览器同域 SSE/HTTP 流式中继(app.proxy)、HTTP→用户 ##(app.invoke)、跨模块 db 方法分发、corpus_search 可发现、MCP Server stdio——下游可去掉 Python 旁路。
git checkout v0.3.7
# 或下载 Release 的 exe / zip
marqdo ext add web && marqdo ext add agent
# *app*.proxy / *app*.invoke · agent.mcp_server
Added
- 宿主集成 H1–H4:
ext/webapp.proxy(同域 SSE/HTTP 流式中继)与app.invoke(HTTP→lib.member);跨模块#对象方法查找;agent.corpus_search自动加载插件;agent.mcp_serverstdio。金样web-proxy-invoke-smoke·web-hosting-live·web-db-cross-module-smoke·agent-mcp-server-smoke。设计 ext-hosting-fill.md · ext-hosting.md。 - 文档:宿主集成缺口盘点——ext-hosting-gaps.md。
Fixed
- 方法分发:
find_object_type沿导入树传递查找,跨模块拿到的web.db等句柄可再调方法。
Changed
v0.3.6 — 2026-09-07
Highlights
中层标准库 Mid M1–M6 收口:通用原语沉入 lib/(正则、编解码、路径、哈希、机密、CSV、加厚文本/集合、CLI、日志、UUID),写日常脚本与多数扩展库不再需要原生插件。另含 ext/linalg 公式文档面与 agent/llm 稳健性修复。
git checkout v0.3.6
# 或下载 Release 的 exe / zip
marqdo run public/features/13-log-uuid.mq.md
marqdo ext add linalg # 可选:公式文档 / 线性代数
Added
- 中层标准库 M6:
lib/log/日志(级别过滤的一行日志)与lib/uuid/标识(v4);金样与 public13-log-uuid。设计 stdlib-log-uuid.md。Mid M1–M6 收口。 - 中层标准库 M5:
table/表加厚(sort/sort_by/unique/chunk/zip/flatten)与lib/cli/命令行(parse);金样与 public12-list-cli。设计 stdlib-list-cli.md。 - 中层标准库 M4:
lib/csv/逗号表(parse/stringify)与lib/text/文本加厚(contains/replace/case/pad/…);金样与 public11-csv-text。设计 stdlib-csv.md · stdlib-text-mid.md。 - 中层标准库 M3:
lib/hash/哈希(sha256/sha1/md5/hmac_sha256)与lib/secrets/机密(token_hex/token_urlsafe);金样与 public10-hash-secrets。设计 stdlib-hash.md · stdlib-secrets.md。 - 中层标准库 M2:
lib/path/lib/路径(join/split/normalize/…)与fs/文件加厚(copy_file/move/make_temp);金样与 public09-path-fs。设计 stdlib-path.md · stdlib-fs-mid.md。 - 中层标准库 M1:
lib/re/lib/正则(is_match/find/find_all/replace/split)与lib/encoding/lib/编码(base64/hex);hosthost_re_*+host_encoding_*;金样与 public08-re-encoding。设计 stdlib-mid.md · stdlib-re.md · stdlib-encoding.md。 ext/linalg:L0–L6 + 公式文档面 F1–F3(中缀、declare、展示/explicit默认化简、T_ascii、public「如何写公式文档」);示例linalg-transpose·linalg-svd·linalg-least-squares。设计:ext-linalg-formula-doc.md。
Fixed
ext/agent:写回改走wb.record(避免writeback形参遮蔽模块名),不再直调host_*。ext/llm:stream_result忽略未知 SSE 类型(如reasoning),不再因此退出。
Changed
v0.3.5 — 2026-09-04
Highlights
marqdo ext add 无需本机 Rust:Release 发布预编译 native 插件;CLI 可自动下载 L1(*-ext.zip)与 *-native-*.zip。Windows 便携包内含 ext/native/*.dll。
git checkout v0.3.5
# 或下载 Release 的 exe / zip
marqdo ext add web
marqdo ext add agent
marqdo ext add quantum
Added
- 预编译原生插件资产:
marqdo-*-native-x86_64-pc-windows-msvc.zip、marqdo-*-native-x86_64-unknown-linux-gnu.zip;Windows zip 捆绑ext/+ native DLL。 ext add下载回退:本地无target/时从 GitHub Release 拉取;MARQDO_EXT_NO_DOWNLOAD=1/MARQDO_EXT_VERSION可配置。
Changed
- 文档:ext-cli.md、08-ext-deploy-coupling、README 安装步骤以预编译为默认路径。
- Release workflow:Windows 编插件并上传 native zip;新增 Linux native job。
v0.3.4 — 2026-09-04
Highlights
ext/web 定制波次 C0–C4 收口:可配置 admin 前缀与登录回跳、段边界 gates、shell/layout、样式单元格 strict、脚本 defer/version/asset_version、条件导航 when/media。附智能体 Wave B0 示例与写回遮蔽修复。
git checkout v0.3.4
cargo build --release
cargo build --release -p marqdo_plugin_web
marqdo ext add web
# golds: tests/ext/web-c0-admin-prefix … web-c4-nav-when
Added
- 智能体 Wave B0:宪法优先示例 agent-pong(call_site/源码注入)· agent-okf-flywheel(OKF
cache=hit);调研 agent-framework-2026-09.md;离线 harnessscripts/agent-harness.sh;金样agent-constitution-b0。 .env.example:开发期 OpenAI 兼容网关变量模板(密钥仅本地.env)。
Fixed
agent.step/plan写回:参数名writeback遮蔽lib/writebackimport,导致writeback=True时method receiver must be an object map;改为host_writeback_record。金样agent-writeback-shadow。ext/webC0:admin=False不再挂载/保留/admin*;可配admin_prefix/login_redirect/logout_redirect;金样web-c0-admin-prefix。ext/webC1:门禁段边界匹配(不再误伤/admin-publish);gate支持match/on_deny/exclude;auth默认on_deny=redirect+login_path;金样web-c1-gates。ext/webC2:shell_css=full|minimal|off;layout=sidebar|stacked|bare|rail;full 壳含小屏单列 media;金样web-c2-shell-layout。ext/webC3:样式装配对数字/布尔值单元格告警,strict/strict_css_cells硬错误;page.css作 raw CSS;head 表支持defer/async/version,asset_version统一?v=;金样web-c3-style-head。ext/webC4:导航表当/when(auth/guest/hide)与媒体/media(响应式显隐);listen 注入_logged_in;金样web-c4-nav-when。
Changed
build_step_context:call site 提前到 task 之后;开场白强调 code-as-documentation。- 中文
构建单步上下文委托英文版(含预算 / READ);新增dump_step_context;live 用例改用仓库根.env。 - 文档:ext-web 定制限制 + 解决设计 C0–C4。
v0.3.3 — 2026-09-04
Highlights
浏览器作者零业务 JS(路线 D/E/F):官方 bridge 自启 + 宿主效应补齐(DOM/路由/storage/ws/文件/Canvas/音频/Observer/拖放);lib/browser + GFM 表格写法;新增 marqdo-dev 开发约定。
git checkout v0.3.3
cargo build --release
marqdo wasm build
# examples: browser-hello / browser-app / browser-media / web-client-site
Added
- 路线 D(作者零 JS):roadmap · 设计 §16。官方 bridge
mount/data-mq-*自启;client_embed带wasm/source/boot;DOM 效应;examples/web-client-site/。 - 路线 E(前端补齐):browser-wasm-e.md。多节点 DOM、
add_class/remove_class、cookie、clipboard/download、fetch_all/ws/interval;示例 browser-app。 - 路线 F(媒体/文件,F1–F5):browser-wasm-f.md。
read_file、Canvas 2D、Audio beep、Intersection/ResizeObserver、drag/drop;示例 browser-media。 lib/browser/lib/浏览器:WASM 客户端效应助手(GFM 表格 + named helpers;勿用json.set链)。- Skill
marqdo-dev:代码即文档 / GFM-first / 库开发约定。
Changed
- 浏览器示例(hello / app / media / web-client)改为表格 +
lib/browser;ext/web效应助手改用table.put。 - 标准库模块表收录
browser;路线 F 收口 F1–F5(F6 Service Worker 仍可选)。
v0.3.2 — 2026-09-01
Highlights
浏览器 Marqdo(路线 C)首版完备:wasm-core、marqdo wasm build、会话 ABI、DOM/fetch/after 效应、官方 bridge、体积与冒烟;并修 Admin 长内容布局、ext add 原生插件预检、@keyframes 与样式表 / 比率约定。
git checkout v0.3.2
cargo build --release
marqdo wasm build
marqdo ext add web # 改插件后请重新 add
Added
- 浏览器 Marqdo(路线 C): ADR 0002 · design · roadmap C0–C5。
- C0/C1:
wasm-corefeature 门控;run_source;cratecrates/marqdo-wasm(mq_runABI);示例 examples/browser-hello。 - C2/C3:
marqdo wasm build;会话mq_boot/mq_call;GFM wire 表 +set_textDOM 回写;interact.html 计数器示例。 - C4:ADR 0003 效应表(
fetch/after)+ bridge 续体;fetch.html。 - C5:
release-wasm体积配置;marqdo wasm build报告 KiB 并可选wasm-opt;run_sourcebytecode 单测;会话仍为 tree。 - WASM 收口:规范
crates/marqdo-wasm/js/marqdo-bridge.js;wasm build同时拷贝 bridge;Node 冒烟tests/wasm;web.client_embed/网页.客户端挂载;路线图标 Completed。 - 发版 Skill:
.cursor/skills/marqdo-release/(探测版本 → 用户确认 → 文档/资产/扩展/Release 说明)。
Fixed
- Admin UI:主区取消
max-width:56rem限制,表格外包可横向滚动的.table-wrap,单元格完整展示并自动换行;表单加宽且 textarea 可随内容增高。 marqdo ext add:安装含原生插件的扩展时先定位/自动cargo build再拷贝.mq.md,避免只装上文稿、运行时报native plugin not found;扩大.so搜索路径。web_style/ 样式装配:正确输出@keyframes块(停点为嵌套规则,不再写成0%: opacity: 0)。- 样式表含
/的值:文档明确引号优先("16/9"、"1/5");不引入靠空格消歧的表单元格比率折叠。
v0.3.1 — 2026-08-29
Highlights
W8 站点资源:favicon / Head 资源表 / 图片装配一次补齐;并修复相对入口路径下 entry_dir 双重拼接导致的嵌套目录问题。
git checkout v0.3.1
cargo build --release
marqdo ext add web # 改插件后请重新 add
Added
ext/webW8(站点图标 / Head / 图片装配) (web-assets-and-images.md):app.icons/应用.图标挂GET /favicon.ico;page.head/头装配;make_images/图片装配;meta认icon/favicon/apple-touch-icon;static约定favicon.*;金样web-assets-smoke/web-assets-live;marqdo-blog 接入。
Fixed
host_query("entry_dir"):相对入口脚本(如tests/ext/….mq.md)时对进程 cwd 绝对化,避免与for_run已设的脚本目录 cwd 再次拼接成tests/ext/tests/ext/…。
v0.3.0 — 2026-08-29
Highlights
本版把 ext/web 网络能力(W0–W7 + P3)、ext/quantum Q7/Q8、ext/agent A1–A4 一并收口到正式发布;并修了网页扩展叙述行误解析、补充 ASGI/生产部署说明与 agent 下一波(B0–B5)缺口调研。
如何拿到本版
# 从源码(推荐跟 main / 本 tag)
git clone https://github.com/cflmy/marqdo.git && cd marqdo
git checkout v0.3.0
cargo build --release
./target/release/marqdo version
# 或从 GitHub Releases 下载 Windows 包 / 源码 zip(见 Release 资产)
marqdo version --check
扩展(非 stdlib)
cargo build --release -p marqdo_plugin_web -p marqdo_plugin_agent -p marqdo_plugin_quantum
marqdo ext add web && marqdo ext add agent && marqdo ext add quantum
# 中文 id:网页 / 智能体 / 量子 / 大模型
Added
- 调研:
ext/agentA0–A4 之后缺口 (agent-framework-gaps-after-a4.md):产品化示例、评测 harness、真 MCP、plan resume/HITL、飞轮指标与建议分期 B0–B5;挂到 ext-agent-optimize.md 与 doc/README.md。 - 生产部署调研(ASGI) (web-asgi-servers-and-marqdo.md):不能挂 Daphne/Uvicorn;路径为反向代理 → 嵌入式
listen(axum)。 ext/agentA4(RAG/MCP 证据工具):corpus_search本地语料关键词检索;mcp_list_tools/mcp_call读 JSON fixture;返回authority=workbook。金样agent-tools-rag-a4。ext/agentA3(上下文预算):source_brief/ 加深版skill_brief;build_step_context默认截断并提示READ:source|skill;step支持最多max_reads次加深;父READ:skill。金样agent-context-budget-a3。ext/agentA2(过程可见):plan过程事件默认写入返回 map 的events(SSE 仍仅stream=True);OKF 命中记REUSEdecision;view plan 卡渲染过程时间线。对齐 agent-streaming.md。ext/agentA1(OKF 复用飞轮):agent_kb_list_tasks返回 description/aliases/status/llm_free/hits;plan命中路径暴露match/score(summary 含 match kind);soft_match 策展提示带 status/llm_free/description;view plan 卡显示 match。金样agent-kb-plan-hit。路线 ext-agent-optimize.md。ext/web样式装配(web_style/网页.样式装配): 样式即数据表格 —— GFM 样式表(|选择器|属性|值|,可用|媒体|列分组进@media块)经样式装配函数转成 CSS 文本,再拼装成完整主题。替代"整段手写 CSS 字符串"的写法,贯彻 文档即代码。见 marqdo-blog。- 网络能力调研(
doc/design/web-net-capabilities.md): 盘点ext/web+plugins/web+lib/net现状,对照主流语言网络栈(FastAPI / Express / Flask / axum),给出「开发一个完整 Web 项目」所需能力的差距清单与分波次补强路线(W1–W7 + P3,2026-08-28 已全部落地)。 - AI Skill + 文档(ext/web 完结复核):
skills/marqdo/与.cursor/skills/marqdo/增加 ext/web 动态站 专节(硬规则、API 摘要、§13 最小站点样例);doc/design/web-net-capabilities.md结论/对照表与 W7+P3 实现对齐;doc/design/ai-skill.md更新用途说明。 ext/quantumQ7(高阶线性代数 + 高级可视化): 密度矩阵 / 部分迹 / Hermitian 谱 / Schmidt / Pauli 期望 / 纯度;SVG:hinton、city、density、paulivec、qsphere、multibloch。全部经plugins/quantumABI。设计 ext-quantum-q7.md;金样quantum-linalg-smoke、quantum-viz-advanced-smoke;示例 quantum-entanglement。ext/quantumQ8a/Q8b(可视化美学):draw theme=dark|light|bw(默认 dark);标签芯片 + gutter 消除线穿字;门族分色;probs/bloch 共用令牌;view 对data-theme换图框。设计 ext-quantum-viz-style.md。改插件后须marqdo ext add quantum再开 view。
Fixed
ext/web/网页.mq.md:叙述行勿以反引号开头,避免被解析为语句(examples/marqdo-blog可正常listen)。
Changed
- Frontmatter import syntax:
import bind:target/导入 bind:target(file.mq.mdor short namelib.member). Removed legacy> path.mq.md/> useimports. See module-namespace.md.
v0.2.0 — 2026-08-12
Highlights — official extension libraries
This release centers on ext/: optional packages that are not part of the embedded stdlib. Install them with the CLI; native plugins (.so / .dll) ship beside L1 Markdown APIs.
How to get extensions
# List what the installer knows about
marqdo ext list
# Install from the repo's ./ext (or MARQDO_EXT_SOURCE), into ~/.marqdo/ext (or MARQDO_EXT)
marqdo ext add llm
marqdo ext add agent
marqdo ext add web
marqdo ext add quantum
# Chinese ids work the same (大模型 / 智能体 / 网页 / 量子)
marqdo ext add 量子
marqdo ext remove quantum
Native plugins (agent / web / quantum) must be built once, then ext add copies them into MARQDO_EXT/native/:
cargo build --release -p marqdo_plugin_agent
cargo build --release -p marqdo_plugin_web
cargo build --release -p marqdo_plugin_quantum
marqdo ext add agent
marqdo ext add web
marqdo ext add quantum
Runtime also resolves plugins from CARGO_TARGET_DIR, target/, next to the marqdo binary, or MARQDO_*_PLUGIN env vars. Design: ext-cli.md · ext-abi.md.
| Package | What you get |
|---|---|
| llm | OpenAI-compatible chat — ext-llm.md |
| agent | Agent layout / orchestration helpers + native plugin — ext-agent.md |
| web | HTTP + SQLite site helpers + native plugin — ext-web.md |
| quantum | State-vector circuits, draw, noise, formula matrix= custom gates — ext-quantum.md |
User-facing intro: public/features/05-extensions.mq.md / 05-扩展.mq.md.
Added
- Full ext CLI catalog:
llm,agent,web,quantum(EN/ZH ids). - Quantum (Q0–Q6): gates,
run/steps, draw (circuit/probs/bloch), heatmaps, teaching noise incl. amplitude damping, custom gates from$$/matrix=. - Web extension (listen / render / SQLite) with L1 EN/ZH.
- Agent native plugin path + installer copy into
native/. - View Variables panel: previews + click-to-open rich modal (matrices / KaTeX).
- Formula matrix parse (
pmatrix/[[…]]) for executable gate matrices.
Changed
- Release notes and docs emphasize extensions vs embedded stdlib.
- Highlight.js CDN path for view pages; Variables panel script escaping fixed.
v0.1.2 — 2026-08-07
Added
- Embedded standard library: official
lib/*.mq.mdships inside themarqdobinary; disklib/andMARQDO_LIBstill override. lib/writeback/lib/subtask: Jupyter-style writeback; concurrent subtasks (file / function / foreign).- Surface syntax v0.2:
+ `param`parameters,1.ordered branches, backtick identifiers, quoted strings. marqdo version --check: compare installed CLI with latest GitHub release.- VS Code extension v0.0.6 (branch
vscode-extensiononly): v0.2 grammar, update check — see doc/design/vscode-extension-commit.md
Changed
- Subtask
spawnacceptspath=,fn=,code=, orlang=+source=(not file-only). - Release notes: standalone
.exeincludes stdlib; bundle/stdlib zips remain optional for overrides.
v0.1.1
- v0.2 syntax migration, writeback/subtask v1 (file subprocess only), view input deferral, optional parameters.
v0.1.0
- Initial public releases: tree + bytecode backends,
view/debug/catalog, core stdlib,ext/installer.