Files
marqdo/CHANGELOG.md
T

20 KiB
Raw Blame History

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/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.