20 KiB
Changelog
Unreleased
Added
Fixed
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.