Files
marqdo/CHANGELOG.md
T
cflmyandCursor 16f26d7d60 fix(knowledge): warm-load IR for preflight/find/reuse queries
Stop full recompile on every knowledge preflight by writing ekc/graph/ir.json
and loading it unless --refresh or missing projections, cutting chat预检 wall time.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-27 09:18:27 +08:00

82 KiB
Raw Blame History

Changelog

Unreleased

Added

  • 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,修复聊天「工程预检」墙钟过长。

Changed

  • 查询类 knowledge CLI:缺投影才 compile;CI / 源变更请先 marqdo knowledge 或 --refresh。

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;可选 route class;/_runtime/* 控制面;runtime.isolated_execution=1。
  • MR-01 金样例:tests/isolated_execute_mr01.rs + tests/ext/isolated-execute-site/(双 60s 假 SSE + 短读并行;槽满拒绝);接入 executable-knowledge workflow。
  • Worker CLI:marqdo run --call-lib-path / --fs-root / --args-json / --emit-result;host runtime admit/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 selection llm.create。

Fixed

  • llm.ask 升参:hoist p 避免缺参 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(桩)。frontmatter markup: 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,支持多路径);MLSP labels.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 成员,已由 Go libweb 取代);删除无调用点死代码,收拢 as_text 18 处重复、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_query mlsp;tests/ext/agent-eng-bind-gate.mq.md。
  • 发布与来源(F2/M06–M07):统一 EXCLUDED_DIRS;publish_manifest.json;function_sources 函数级来源覆盖。
  • 文档提取(F3/M01):document.extract DocumentSource→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_list arity:保持空 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;静态导出使用 frontmatter stdin 作为构建时输入。
  • 静态导出真实执行:构建时实际执行代码单元并把 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_doc run_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/foreign F0/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/foreign F2:JSON 进 / JSON 出 call;并行 run_many / call_many(有序、单项隔离、并发上限);invoke 的 input / output / result / result_error。
  • lib/foreign F3/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 进程组 / Windows taskkill /T 超时清理;shell-like argv 切分。

Fixed

  • view 文档表面与标注 chip:把旧 view 的 --ink / --fill / --line 等 token 映射到当前主题,修复 STRUCTURE 中 main、内核表 =、函数名和 annot-chip 深色文字/白色卡片与暗色背景不一致的问题。
  • view 代码对比度:移除会互相覆盖的 highlight.js 深/浅两套外链样式,改用内置高对比 token 变量;深色代码正文 #f0f0f0 on #1e1e1e(14.6:1),浅色 #24292f on #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_serve Streamable 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

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_resolve miss:返回字段对齐命中路径,含 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/agent sandbox_* → host_query;默认拒 plugin/exec/net。
  • O1:agent.trial · run/step sandbox= · 中文 试跑/沙盒= · 示例 examples/agent-sandbox-okf/ · 金样 agent-sandbox-optin。
  • O2:agent_kb_promote 默认 sandbox proof;OKF applies_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.report markdown 审阅面。
  • 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

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 中英糖;自写回图片 ![marqdo-out](…)(扩展名校验)与 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 且扩展名合法 → ![marqdo-out](…);文本仍 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)。
  • ViewExecutionReport JSON(#mq-view-trace · /api/view-trace · SSE trace_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_artifact Binding 注入;response 序列化 JSON/text/html。
  • 破坏性:删除作者面 compose_* / app.configure / 作者 ensure_plugin;旧 web gold 移除,新金样 ext_web_*。
  • 示例:examples/marqdo-blog/ Artifact 站(pages/api/db + smoke);web-client-site serve 扫描。
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/web facade: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| + ABI web_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_where now drive list cards and detail articles under web.serve (ADR 0007 flat metadata).

Changed

  • 破坏性:删除作者面 compose_* / app.configure / 作者 ensure_plugin。旧 web gold 已移除;新金样 web-artifact-* / ext_web_*。
  • 核心表面 Δ:无增删(复用 Metadata type)。
  • 修订 ext-web.md C1;doc/next/007.md superseded。

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_turn usage、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-shaped choices[0].message.tool_calls);sys.module_source + 入口文档 prompt_body 离线路径。
  • plugins/llm Transport ABI(llm_chat_completions):ext/ai/llm/openai 优先原生插件,否则 lib/net HTTP/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_turn usage、named handles(fast/reasoning)、type:prompt 加载、openai/ollama 分流、agent-zero-llm 金样。

Fixed

  • plan force 不再冲掉已有 resources workbook(保留 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 与 CDN latest/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-intro HTML;中英 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/web Go):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 包必出:linux job 上传 *-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

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/web Go 全量重写(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 不再构建 Rust marqdo_plugin_web;旧 Rust 树移至 plugins/web-rust-archive/(非 workspace 成员)。作者面 ext/web ABI 名保持兼容。

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.proxy stream=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=;金样与 public 17-stats-log。Mid2 M7–M10 收口(zip 跳过)。设计 stdlib-stats-log.md。
  • 中层标准库 Mid2 M9:fs.make_dirs / remove_tree / stat / walk(中英);金样与 public 16-fs-mid2。设计 stdlib-fs-mid2.md。
  • 中层标准库 Mid2 M8:lib/toml / 配置表(只读子集)、lib/html / 超文本(escape/unescape)、encoding base32;金样与 public 15-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);金样与 public 14-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/web app.proxy(同域 SSE/HTTP 流式中继)与 app.invoke(HTTP→lib.member);跨模块 # 对象方法查找;agent.corpus_search 自动加载插件;agent.mcp_server stdio。金样 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);金样与 public 13-log-uuid。设计 stdlib-log-uuid.md。Mid M1–M6 收口。
  • 中层标准库 M5:table/表 加厚(sort/sort_by/unique/chunk/zip/flatten)与 lib/cli/命令行(parse);金样与 public 12-list-cli。设计 stdlib-list-cli.md。
  • 中层标准库 M4:lib/csv / 逗号表(parse/stringify)与 lib/text / 文本 加厚(contains/replace/case/pad/…);金样与 public 11-csv-text。设计 stdlib-csv.md · stdlib-text-mid.md。
  • 中层标准库 M3:lib/hash / 哈希(sha256/sha1/md5/hmac_sha256)与 lib/secrets / 机密(token_hex/token_urlsafe);金样与 public 10-hash-secrets。设计 stdlib-hash.md · stdlib-secrets.md。
  • 中层标准库 M2:lib/path / lib/路径(join/split/normalize/…)与 fs/文件 加厚(copy_file/move/make_temp);金样与 public 09-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);host host_re_* + host_encoding_*;金样与 public 08-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

Fixed

  • agent.step / plan 写回:参数名 writeback 遮蔽 lib/writeback import,导致 writeback=True 时 method receiver must be an object map;改为 host_writeback_record。金样 agent-writeback-shadow。
  • ext/web C0:admin=False 不再挂载/保留 /admin*;可配 admin_prefix / login_redirect / logout_redirect;金样 web-c0-admin-prefix。
  • ext/web C1:门禁段边界匹配(不再误伤 /admin-publish);gate 支持 match / on_deny / exclude;auth 默认 on_deny=redirect + login_path;金样 web-c1-gates。
  • ext/web C2:shell_css=full|minimal|off;layout=sidebar|stacked|bare|rail;full 壳含小屏单列 media;金样 web-c2-shell-layout。
  • ext/web C3:样式装配对数字/布尔值单元格告警,strict/strict_css_cells 硬错误;page.css 作 raw CSS;head 表支持 defer/async/version,asset_version 统一 ?v=;金样 web-c3-style-head。
  • ext/web C4:导航表 当/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-core feature 门控;run_source;crate crates/marqdo-wasm(mq_run ABI);示例 examples/browser-hello。
  • C2/C3:marqdo wasm build;会话 mq_boot/mq_call;GFM wire 表 + set_text DOM 回写;interact.html 计数器示例。
  • C4:ADR 0003 效应表(fetch / after)+ bridge 续体;fetch.html。
  • C5:release-wasm 体积配置;marqdo wasm build 报告 KiB 并可选 wasm-opt;run_source bytecode 单测;会话仍为 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/web W8(站点图标 / 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/agent A0–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/agent A4(RAG/MCP 证据工具): corpus_search 本地语料关键词检索;mcp_list_tools / mcp_call 读 JSON fixture;返回 authority=workbook。金样 agent-tools-rag-a4。
  • ext/agent A3(上下文预算): source_brief / 加深版 skill_brief;build_step_context 默认截断并提示 READ:source|skill;step 支持最多 max_reads 次加深;父 READ:skill。金样 agent-context-budget-a3。
  • ext/agent A2(过程可见): plan 过程事件默认写入返回 map 的 events(SSE 仍仅 stream=True);OKF 命中记 REUSE decision;view plan 卡渲染过程时间线。对齐 agent-streaming.md。
  • ext/agent A1(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/quantum Q7(高阶线性代数 + 高级可视化): 密度矩阵 / 部分迹 / Hermitian 谱 / Schmidt / Pauli 期望 / 纯度;SVG:hinton、city、density、paulivec、qsphere、multibloch。全部经 plugins/quantum ABI。设计 ext-quantum-q7.md;金样 quantum-linalg-smoke、quantum-viz-advanced-smoke;示例 quantum-entanglement。
  • ext/quantum Q8a/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.md or short name lib.member). Removed legacy > path.mq.md / > use imports. 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.md ships inside the marqdo binary; disk lib/ and MARQDO_LIB still 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-extension only): v0.2 grammar, update check — see doc/design/vscode-extension-commit.md

Changed

  • Subtask spawn accepts path=, fn=, code=, or lang=+source= (not file-only).
  • Release notes: standalone .exe includes 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.