Skip to content

Releases

v2.9.1

Choose a tag to compare

@github-actions github-actions released this 18 Nov 11:31

Marqdo v2.9.1 · Library Feature-Gate Fix / 库可选特性修复

核心更新 · Highlights

Marqdo 2.9.1 修复 2.9.0 引入的库构建回归:sema::ir 在输出 proof-index.json 与 proof-obligations.json 时无条件使用 knowledge 模块,而该模块此前只在 cli 特性下编译,导致以 default-features = false 依赖本库的下游工程出现 E0433: could not find knowledge in the crate root。

EN: Marqdo 2.9.1 fixes a library-build regression introduced in 2.9.0. sema::ir unconditionally emits proof-index.json and proof-obligations.json through the knowledge module, but that module was gated on the cli feature, so downstream crates depending on the library with default-features = false failed with E0433: could not find knowledge in the crate root.

  • knowledge 现在是核心编译器的一部分,不再由 cli 特性门控;CLI 二进制仍由 required-features = ["cli"] 约束。
  • 新增 feature-matrix CI:分别用无默认特性、仅 cli、默认特性检查库构建,防止特性门控再次回归。
  • 没有运行时语义、文稿格式、插件 ABI(v2)或证明证书格式的变化。

兼容性 · Compatibility

  • 2.9.0 的 .mq.md 文稿、原生插件(ABI v2)和知识证明证书保持兼容,无需迁移。
  • 下游库可继续使用 default-features = false;2.9.0 期间为绕过该回归而启用的 cli 特性可以撤销。
  • 不可变标签 v2.9.0 保持不变,本次是同一主线的补丁版本。

验证 · Verification

  • cargo check --locked --lib --no-default-features、--no-default-features --features cli 与默认特性三种配置均通过。
  • cargo test --locked 全量通过(Linux x86_64 本地环境)。
  • 下游验证:qdagent 原生插件恢复 default-features = false 后重新编译通过,cargo test 17 项通过。
  • 限制:Windows 与 Linux 发布产物由标签触发的 Release 流水线构建;本地验证不代表其他平台已通过,最终以实际流水线结果和资产校验为准。

完整发行产物 · Full distribution

The v2.9.1 full packaging workflow produces:

  • Windows x86_64 native CLI (standalone EXE and bundled ZIP);
  • Linux x86_64 CLI+libraries bundle;
  • standard library ZIP, source ZIP and static user-site ZIP;
  • editor marqdo-2.9.1.vsix from the independent editor branch;
  • both Windows and Linux official native plugin packs, plus the versioned extension source pack when ext/VERSION matches 2.9.1.

v2.9.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 09:31
180a111

Marqdo v2.9.0 · Full Release / 正式完整版本

核心更新 · Highlights

Marqdo 2.9.0 将 Markdown 原生可执行知识库推进为 可验证知识编译器(Verified Knowledge Compiler)。这不是全语言自动证明工具:Lean 4 仅证明明确支持的逻辑模型,系统继续保存来源、信任边界与失效原因。

  • 统一模块契约:knowledge compose 支持静态纯函数的形参、整数表达式、连续赋值、穷尽分支、多次函数调用和多级模块调用 DAG。
  • 独立 Lean 模块证明:每个受支持函数由源码生成可检查模块;调用方导入被调方定理,而不是将定理声明自动当成公理。
  • 知识锚点:带标记步骤和定理声明具有稳定身份;[]() 用于可寻址引用,绝不自动赋予执行权。
  • 可信证据:model_proved、proved、tested、assumed、unknown、refuted、stale 严格区分;证明收据绑定源码与依赖闭包,支持失效检测和独立重放。
  • 兼容性:旧版 marqdo prove、marqdo call、知识视图和旧式简单组合证书继续兼容,Rust 与 Lean 差分测试保护语义边界。

EN: Marqdo 2.9.0 introduces a Verified Knowledge Compiler for native Markdown knowledge artifacts, stable anchors, source-derived bounded assume/guarantee composition, and independently replayable Lean 4 certificates. The implementation does not claim universal program correctness: supported Lean Int theorems are labeled model_proved until a runtime semantic correspondence is established.

可信边界 · Verification boundaries

Lean 自动组合仅适用于源码可精确翻译的无副作用、静态纯整数模型片段;有界整数溢出、动态 number / Formula、插件效应、未知异常、循环和递归不会自动升级为已证明。前置条件未证明、源码漂移、证书篡改、Lean 不可用或超出支持范围时,必须拒绝出证或明确返回未验证状态。

Formal logic proves properties of the declared model, not empirical facts or the entire runtime. External API responses, quantum hardware measurements and agent behavior require explicit experiment/test/provenance evidence. See design decision.

使用 · Usage

marqdo knowledge .
marqdo knowledge compose --strict --json .
marqdo knowledge proof-deps --verify --json .
marqdo knowledge replay <path/to/composition-certificate.json> --json .

A model_proved certificate is not an unconditional authorization to call plugins or execute side effects.

完整发行产物 · Full distribution

The v2.9.0 full packaging workflow produces:

  • Windows x86_64 native CLI (standalone EXE and bundled ZIP);
  • Linux x86_64 CLI+libraries bundle;
  • standard library ZIP, source ZIP and static user-site ZIP;
  • editor marqdo-2.9.0.vsix from the independent editor branch;
  • both Windows and Linux official native plugin packs, plus the versioned extension source pack when ext/VERSION matches 2.9.0.

Release completion is determined by actual CI artifacts and publication evidence, not by this note. In addition to GitHub assets the repository's release handbook requires CDN/R2 byte parity and Ubuntu PPA publication/apt verification. Missing credentials, failed cross-platform builds or unverified publication channels must be reported as incomplete; never invent hashes or success.

质量验收 · Quality gates

  • modular-proof-smoke — actual Lean kernel-checkable intermodule source contracts, negative/stale replay tests.
  • knowledge-proof-full-gate — knowledge, semantic-IR, proof corpus and interpreter/Lean differential tests.
  • executable-knowledge — backward compatibility and knowledge execution tests.
  • Release — verify both platform assets were built from the exact immutable tag.
  • release-v2.9 gate — verify metadata, build/test on main and create the immutable tag only when checks pass.

Version 2.9.0 is a scoped Verified Knowledge Compiler, not a theorem that every program or scientific experiment is automatically correct.

v2.8.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 03:15

v2.8.0 发布说明 · Release Notes(prove)

1. 一句话

marqdo prove 正式发布:知识文件的定理表 → Lean 4 证明 → 自动判定。
没有 Lean 工具链也能跑(离线符号执行,诚实降级);有 Lean 时全链路证明,
假定理给出路径见证反例,离线与 Lean 分歧时显式报错永不落绿。

marqdo prove ships: theorem tables in knowledge files compile to Lean 4
and are judged automatically. It runs without a Lean toolchain (offline
symbolic execution, honest degradation); with Lean, fake theorems get
counterexamples and any offline/Lean divergence fails loudly.

2. 亮点(Highlights)

定理表 `
六段管线 装载 → 降级 → 定型 → 生成(Lean 4.35)→ 判定(离线先行 + Lean 复核)→ 证书
离线判定 F1–F5 片段符号执行:路径枚举、轨迹形状、构造器结构、自由原子二分、区间字面重述与反例见证(毫秒级)
单调性护栏 离线 checked 但 Lean 证不出(或反例被证出)→ error[proof.divergence] 退 1——绝不让离线判定比 Lean 更乐观
诚实状态 proved > checked > unverified > rejected > unproved > error;checked ≠ proved;无 Lean 时状态如实降级(咨询性退 0),--require-lean CI 严格模式退 2
反例 假定理给出区间端点见证(如 金额 = 10001)并指回定理表行号
证书缓存 复合键(源码⊕计划⊕库⊕Lean 版本⊕CLI 版本),.marqdo/prove/,命中跳过判定;--no-cache 绕过
目录模式 prove --all 目录(--max-files 默认 200):逐文件出证,整体取最差,聚合 JSON
差分一致性 T4 语料:解释器求值 == Lean 语义(算术/中文标识符/分支/拼接/i64 边界/结构字段)
工具链 --lean 显式指定 → MARQDO_PROOF_LEAN → PATH;内嵌判定库按内容哈希缓存构建,无需 lake/elan

3. 使用(Usage)

marqdo prove 审批.mq.md --json        # 判定 + 单个 JSON 报告
marqdo prove emit 审批.mq.md          # 只生成 Lean 模块 + plan.json
marqdo prove audit 审批.mq.md         # 只审查可证子集(不写盘)
marqdo prove --all skills/ --json     # 目录聚合(整体取最差)
marqdo prove clean                    # 清空 .marqdo/prove

测试:cargo test --test prove(无 Lean 全绿)·
MARQDO_PROOF_LEAN=<lean> cargo test --test prove_lean --test prove_corpus --test conformance(有 Lean 全链路 + 40 夹具单调性 + T4 一致性)。

详见 design/prove-cli.md(命令面、可证子集与判定管线)与
skill-proof-theory.md(库形式化说明)。

4. 已知限制(Known limitations)

  • foreach 维持 proof.foreach_pending(可证子集无循环;fold 编码 → 2.9)。
  • 跨模块调用 = 不透明操作;assume-guarantee 后置条件复用 → 2.9(依赖假设表 T3)。
  • 除零/模零:解释器为运行时错误,判定库模型返回 .int 0(已记录偏差)。
  • 分支条件暂不支持字段访问(解析器文法限制;prove 侧已就绪,放开即生效)。
  • i64 溢出:解释器报运行时错误;判定库 Int 无界(语料只测界内值)。

ext-v2.8.1

Choose a tag to compare

@github-actions github-actions released this 18 Nov 07:06

Ext pack v2.8.1 发布说明 · Release Notes(AI native flow)

1. 一句话

独立拓展包 2.8.1(CLI 仍为 2.8.0):ext/ai 交付插件侧持久化工作流——显式
open/next/commit/cancel、有界模型选择、作用域上下文、只读失败恢复,以及
inspect/list 与可隔离的 resume_dir。Windows extension-release 使用原生
path.join 根路径与 C:\Windows\System32\tar.exe(bsdtar)打包。不改解释器栈
挂起语义,也不宣称外部写的 exactly-once。

Independent extension pack 2.8.1 (CLI remains 2.8.0): ext/ai ships a
plugin-only durable workflow — explicit open/next/commit/cancel, bounded model
choice, scoped context packing, failed-only read-only recovery, plus
inspect/list and isolatable resume_dir. Windows extension-release packs
with native path.join roots and C:\Windows\System32\tar.exe (bsdtar). No
interpreter-stack suspension and no exactly-once external-write claim.

2. 亮点(Highlights)

持久步骤机 plugins/agent workflow:open/next/commit/cancel/retry_*,CheckpointV2,逐步提交边界
作者面 ext/ai/workflow · flow · context · recovery;tick 单步执行,等待输入不阻塞解释器线程
选择解析 精确 / 编号 / 标签 / 短中英句 / JSON 信封;歧义与未知路径失败关闭
作用域上下文 Markdown 感知的 file/class/function 摘录;歧义拒绝;不把整库 import 塞进提示
安全并行恢复 保留成功兄弟结果;仅重试已分类为只读的失败子任务;写/未知效应不自动派发
可观测性 inspect/list 只读进度;测试与调用方可传入 host-relative resume_dir
Windows CI engineering root 用 path.join;ZIP 用 System32\tar.exe --format=zip

设计契约:native-agent-flow-v3.md。

3. 安装(Install)

marqdo ext add agent   # CDN / Releases → 2.8.1
# 或:MARQDO_EXT_VERSION=2.8.1 marqdo ext add agent
marqdo ext add llm

产物:marqdo-2.8.1-ext.zip 与双平台 native ZIP(含 agent / llm 等既有原生库)。

4. 验证(Validation)

cargo test -p marqdo_plugin_agent --locked
cargo run --locked -- check ext/ai/flow.mq.md
cargo run --locked -- check ext/ai/context.mq.md
cargo run --locked -- check ext/ai/recovery.mq.md
cargo run --locked -- check ext/ai/workflow.mq.md
cargo run --locked -- run tests/ext/ai-native-flow.mq.md
cargo run --locked -- run tests/ext/ai-native-workflow.mq.md

CI:.github/workflows/native-ai-flow.yml 与 extension-release.yml(ext-v2.8.1)。

5. 已知限制(Known limitations)

  • 输入闸门保存的是步骤边界,不是任意字节码解释器帧;回复后须显式进入下一 Marqdo 函数。
  • 作用域选择依赖 Markdown 标题约定,不是编译器已解析的 AST 符号表。
  • 调用方提供的 principal/session/source revision 须由已认证宿主证明,不能来自模型文本。
  • 并行复用 subtask.run_many;跨进程子任务租约与已在跑外部进程的取消传播仍待专项注入验证。
  • 实时大模型与目标 1B 本地模型评测仍开放;写效应自动重试仍被拒绝,直至 EffectLedger 对账完成。

核心表面 Δ:无增删——19 个核心构造不变;本包为 Extension / Agent Runtime。

v2.7.1

Choose a tag to compare

@github-actions github-actions released this 10 Nov 17:01

Marqdo 2.7.1

本次为 CLI 修复发布,重点修复 View 中“实际逻辑”展开后立即折叠的问题,并完成描述链接的细节排版。官方拓展库继续使用 2.7.0,不发布新的独立拓展包,也不移动 CDN VERSION。

This CLI release fixes implementation disclosures that collapsed immediately after opening and improves typed details for descriptive links. Official extension packs remain at 2.7.0; no independent extension assets or CDN VERSION update are included.

修复与改进 / Fixes and improvements

  • View 布局只记录自己的自动开合,不再覆盖用户选择;鼠标、键盘、窗口变化、嵌套原始写法及同一文档的运行结果刷新均保留手动状态。
  • Disclosure choices survive layout, resize and live DOM replacement. Layout-generated toggle events do not become user intent or trigger another reset loop.
  • 函数调用按函数名、命名参数和嵌套调用排版;本页函数可以定位到定义。链接在正文及侧注中保留跳转,相对 mq.md 链接适配实时和离线页面。
  • Lists, records and prose have typed presentation with optional original source. Empty payloads remain explicit placeholders; reading details never runs payloads.
  • 手机详情按整行排列,展开卡片不再撑高相邻卡片。新增可执行阅读示例 examples/view-details.mq.md。

核心表面与范围 / Core surface and scope

核心构造仍为 19 个,没有新增语法、标准库接口或插件 ABI。变更属于 CLI 内嵌 View 前端、只读渲染与发布产物选择。浏览器不会因查看详情而执行实现或自动抓取链接预览。

The core surface stays at 19 constructs. Standard-library and extension APIs are unchanged. CLI and WASM manifest versions are 2.7.1; extension source packs stay 2.7.0. The matching VS Code package is built from its separate source branch. This release does not deploy gh-pages.

下载与安装 / Downloads and installation

产物 / Asset 内容 / Contents
marqdo-2.7.1-x86_64-pc-windows-msvc.exe Windows CLI,内嵌标准库 / CLI with embedded standard library
marqdo-2.7.1-x86_64-pc-windows-msvc.zip Windows CLI 与配套库及原生插件 / complete Windows bundle
marqdo-2.7.1-x86_64-unknown-linux-gnu.zip Linux CLI 与配套库及原生插件 / complete Linux bundle
marqdo-2.7.1-stdlib.zip 标准库源码,API 未变 / standard-library sources with unchanged APIs
marqdo-2.7.1-source.zip 本标签源码 / tagged source snapshot
marqdo-2.7.1.vsix 独立编辑器分支构建 / editor extension from its separate branch
marqdo-2.7.1-public.zip 使用修复后的 View 导出的用户文档 / public docs exported with the fixed View

下载并解压对应平台 ZIP,使用其中的 CLI;独立 Windows EXE 内嵌标准库。Ubuntu noble 用户可使用 ppa:cflmy/marqdo 安装或升级,实际包可用性由发版最终验证单独检查。旧的静态导出需用新 CLI 重新执行 marqdo view output,才能包含修复后的前端。

Unpack the matching platform bundle, or use the standalone Windows executable. The maintained Ubuntu noble installation route is ppa:cflmy/marqdo. Regenerate older static exports with marqdo view output to include the fixed reader script. A CLI-only release keeps the existing official extension installation version.

验证范围 / Validation

本地全量 Rust 验收为 1039 通过、0 失败、2 个原有忽略项;用户文档成功导出 102 页。本地验收覆盖真实详情点击、键盘开合、原始写法、反复布局、窗口变化、实时 DOM 替换,以及静态/实时页面、桌面/手机和无脚本阅读。另验证只读导出不会触发逻辑、现有运行标注与连线、文档间跳转和示例函数调用。

Windows and Linux builds, exact-commit Release/EK jobs, archive contents and hashes, and Ubuntu source/build/apt availability are independent final release gates. Local browser tests do not establish Windows build success, and upload acceptance does not establish apt availability.

v2.7.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 10:50

Marqdo 2.7.0

本次 full 发布把源码手册落到实际开发与用户站点:文件操作、开发检查、构建与发版阶段可通过 marqdo call 执行;站点以递归组件、普通 Markdown 和明确的原生资源表达页面与行为。

This full release makes executable source handbooks practical for development and user sites. Native file tools and callable development/release tasks replace generated orchestration programs. Recursive View components preserve ordinary Markdown content and explicit runtime resources.

亮点 / Highlights

  • 开发与发版 SKILL 路由到可执行 .mq.md 手册;文件读取、审阅、摘要校验和写入使用固有标准库。工程插件承担有界进程、私密认证、压缩格式和实际编译器检查边界,流程不依赖 Python 编排。
  • Literal JSON file/stdin CLI arguments preserve quotes, newlines and dollar-prefixed text. --require-ok makes a failed Result stop external automation; saved call sessions retain literal argument semantics.
  • 中英文网络站点与完整用户站点改为递归 View 布局、Markdown 内容、当前数据查询、表单、真实会话导航与鉴权资源。原有配色、字体、布局、文章详情和管理功能保留。
  • Pure document_head resources carry SEO and resource links into the actual head. Request-time query/form/navigation resources preserve the existing five-column View schema, source context and explicit effect boundaries. Prepared-app inspection follows the real registrar without executing handlers.
  • 原生 SQLite 初始化按实际站点授权根定位,保留已有业务记录;嵌套 Document 与 Endpoint 使用一致的站点根。修复表单校验重试中的 CSRF、成功跳转以及嵌套片段选择与路由检查。
  • The browser bridge supports typed nested list/control records. The maintained browser-app demonstrates duplicate-safe identities, literal text, truthful storage/network feedback, real history and local WebSocket echo with no authored business JavaScript.
  • 移除与语言仓库无关的暗恋工程及过时的独立浏览器演示;底层 WASM 冒烟夹具与公共回归保留。维护入口收敛到实际可运行的工程。

核心表面与兼容边界 / Core surface and boundaries

核心构造仍为 19 个,没有新增 Markdown 标记。改动集中在已有标记解析、CLI 参数传送、Runtime / Document 资源及工程工具;原生插件仍具有调用用户的操作系统权限,--fs-root 不把外部进程变成沙箱。显式 raw HTML 兼容出口不等同于不可信内容清理。编译检查与叙述比例检查不能单独证明运行或视觉正确。

The core surface remains 19 constructs. Native-only filesystem, process and authenticated service capabilities do not become browser WASM capabilities. Atomic file replacement is not a multi-file transaction, and digest preflight is not a kernel compare-and-swap. Deployment credentials remain in private stores.

下载 / Downloads

产物 / Asset 内容 / Contents
marqdo-2.7.0-x86_64-pc-windows-msvc.exe Windows CLI,内嵌标准库 / CLI with embedded standard library
marqdo-2.7.0-x86_64-pc-windows-msvc.zip Windows CLI、标准库、拓展源码与原生插件 / complete Windows bundle
marqdo-2.7.0-x86_64-unknown-linux-gnu.zip Linux CLI、标准库、拓展源码与原生插件 / complete Linux bundle
marqdo-2.7.0-stdlib.zip 可读标准库源码 / readable standard-library sources
marqdo-2.7.0-ext.zip 官方拓展库源码 / official extension sources
marqdo-2.7.0-native-x86_64-pc-windows-msvc.zip Windows web、agent、quantum、linalg、llm、engineering 插件
marqdo-2.7.0-native-x86_64-unknown-linux-gnu.zip Linux web、agent、quantum、linalg、llm、engineering 插件
marqdo-2.7.0-source.zip 本标签的源码快照 / tagged source snapshot
marqdo-2.7.0.vsix VS Code / Cursor 扩展,源码独立分支 / separate editor-source branch
marqdo-2.7.0-public.zip 由实际 .mq.md 导出的静态用户站点 / exported public documentation

安装与使用 / Installation and use

下载对应平台的完整 ZIP,解压后使用其中的 CLI 与 lib/ext。已有 CLI 可通过 marqdo ext add 安装官方拓展;具体调用从标准库单文件或拓展库 index.mq.md 的参数与返回表开始。Linux 用户也可使用项目现有 Ubuntu noble PPA 安装路径;实际 apt 可用性以发布验证结果为准。

Download and unpack the matching platform bundle. Start from each standard-library source or extension index.mq.md. Development tools live in skills/marqdo-dev/index.mq.md; release tasks live in skills/marqdo-release/index.mq.md. A callable task preserves actual failures and grants only its declared effects. See README for the maintained install routes.

验证 / Validation

本地全量 Rust 验收为 1031 通过、0 失败、2 个原有模型实验忽略项;Go 网络插件完整测试通过。清理后重跑的 21 项 CLI/发版/WASM 测试以及 7 项真实浏览器用例通过,实际用户文档成功导出 102 页。源码审查单独检查标题下契约与超过一半的叙述;普通测试、人工夹具和历史兼容样例保留既有用途。

Windows and Linux release builds run in CI for this exact source tag. Final release verification separately checks those jobs, all artifact contents and hashes, GitHub/R2 byte parity and VERSION ordering, and Ubuntu source/build/apt publication. A local Linux test is not evidence of Windows execution or completed package publication. Public documentation export is packaged here; gh-pages deployment is separate.

v2.6.0

Choose a tag to compare

@github-actions github-actions released this 08 Nov 16:06

Marqdo v2.6.0

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 个原有忽略项;发布提交与打包产物另行复核。
  • Release CI(Windows + Linux)与 executable-knowledge 均通过 / Both release and executable-knowledge gates passed.
  • GitHub 10 项资源通过 SHA256 与压缩包完整性检查;R2 六个下载地址与 GitHub 原始资源哈希一致,干净环境安装与 Bell 实验通过 / Asset integrity, CDN parity and clean-install smoke verified.
  • Ubuntu noble PPA build 成功,实际 deb 版本核验为 2.6.0 / PPA build passed and its packaged CLI reports 2.6.0.
  • 实际 wasm32 产物通过 ABI、桥接、双语集合与 32 位边界验收。
  • Chromium 验证七种宽度、实时与静态页面、无脚本回退、源码定位、曲线、帧切换与重新运行。

Install / 安装

Ubuntu: sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo

Windows and non-apt Linux: select the platform bundle below. Standard libraries are embedded in the CLI; bundles also include their readable sources and optional extension/native files.

Official extension sources and native packs are published to GitHub and https://ext.marqdo.com. Use marqdo ext add web, agent, quantum, linalg or llm.

VS Code / Cursor source remains on the vscode-extension branch; install the 2.6.0 VSIX asset.

Assets / 下载

Asset Contents
marqdo-2.6.0-x86_64-pc-windows-msvc.exe CLI with embedded standard libraries
marqdo-2.6.0-x86_64-pc-windows-msvc.zip Windows CLI, libraries, extensions and native DLLs
marqdo-2.6.0-x86_64-unknown-linux-gnu.zip Linux CLI, libraries, extensions and native shared libraries
marqdo-2.6.0-stdlib.zip Readable standard-library sources
marqdo-2.6.0-ext.zip Official extension sources
marqdo-2.6.0-native-*.zip Platform native plugins
marqdo-2.6.0-source.zip Tagged source snapshot
marqdo-2.6.0.vsix VS Code / Cursor extension
marqdo-2.6.0-public.zip Offline user documentation

macOS builds from source. WASM is built through the existing marqdo wasm build flow.

CHANGELOG · README

Marqdo v2.5.1

Choose a tag to compare

@github-actions github-actions released this 07 Nov 07:33

Marqdo v2.5.1

亮点 / Highlights

  • 连线精确对应源码:执行标注携带源码行与字节区间,跨调用帧与循环轮次仍连接到实际代码片段。 / Exact source anchors: annotations retain source line and byte spans across call frames and loop iterations.
  • 连续 S 形曲线:移除水平长线,采用柔和金绿过渡、曲线避让和相邻线间距。 / Flowing S-curves: replace long straight rails with gently colored curves that avoid text and neighboring connections.
  • 更自然的标注排布:标注靠近正文,左右与上下错落;密集区域及窄屏保留文内展示。 / Staggered margin notes: notes sit closer to prose with inline fallback for dense or narrow layouts.
  • 工具栏文字标签:刷新、设置、运行、清理、更多,深浅色配色保持一致。 / Labeled toolbar: refresh, settings, run, clear and more; existing light/dark palettes are preserved.
  • CLI、WASM、扩展包和 VS Code / Cursor 扩展同步 2.5.1。 / CLI, WASM, extension packs and the editor extension share version 2.5.1.

兼容性 / Compatibility

无核心 Markdown 语法或插件 ABI 变更;扩展包功能沿用 v2.5.0。 / No core Markdown syntax or plugin ABI changes; extension functionality is unchanged from v2.5.0.

安装 / Install

Ubuntu:

sudo add-apt-repository ppa:cflmy/marqdo
sudo apt update
sudo apt install marqdo

Windows / Linux: download the matching CLI bundle below. The executable embeds the official standard library; bundles also include extension sources and native plugins.

marqdo --version
marqdo view public
marqdo view output public -o site

From source:

git clone https://github.com/cflmy/marqdo.git
cd marqdo
git checkout v2.5.1
cargo build --release

下载 / Downloads

Asset 内容 / Contents
marqdo-2.5.1-x86_64-pc-windows-msvc.exe Windows CLI,内置标准库 / embedded stdlib
marqdo-2.5.1-x86_64-pc-windows-msvc.zip Windows CLI + lib + ext + native DLLs
marqdo-2.5.1-x86_64-unknown-linux-gnu.zip Linux CLI + lib + ext + native libraries
marqdo-2.5.1-native-*.zip Windows / Linux 原生插件 / native plugins
marqdo-2.5.1-stdlib.zip 标准库 / standard library
marqdo-2.5.1-ext.zip 官方扩展源码 / official extension sources
marqdo-2.5.1-source.zip 发布源码 / tagged source
marqdo-2.5.1.vsix VS Code / Cursor extension
marqdo-2.5.1-public.zip 静态用户文档站 / static docs

CHANGELOG · README · Extension CDN · Ubuntu PPA

v2.5.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 02:18

Marqdo v2.5.0

亮点 / Highlights

  • 文档阅读界面重构:暖白金色排版、新 Marqdo Logo、花枝与羽毛装饰;支持深色阅读。 / Redesigned document reader: warm paper typography, a new Marqdo logo, botanical artwork, and an optional dark theme.
  • 执行信息左右引出:真实变量、返回值和控制流结果沿宽屏页边显示;窄屏与密集区域自动回到正文下方,保留调用帧与循环轮次选择。 / Margin execution notes: real captured values and control flow alongside prose, with inline fallback and preserved call/loop frame selection.
  • 导航与交互:文档、函数、变量、执行快照、搜索、阅读设置和悬浮运行工具栏。 / Navigation and controls: document/function/variable navigation, captured execution report, search, reading settings, and floating execution tools.
  • 即时查看与静态导出同源:公式、字体、Logo 与装饰内嵌,断网可阅读;普通文档重跑使用同一次捕获刷新正文与执行标注。 / Live/static parity: embedded math, fonts and artwork work offline; document reruns refresh prose and notes from the same capture.
  • CLI、WASM、扩展包与 VS Code / Cursor 扩展同步 2.5.0。 / CLI, WASM, extension packs and VS Code / Cursor extension share version 2.5.0.

兼容性 / Compatibility

核心 Markdown 表面无增删,仍为 19 个构造;无插件 ABI 变更。扩展包功能沿用 v2.4.0。 / No core Markdown construct or plugin ABI changes. Extension-pack functionality is unchanged from v2.4.0.

安装 / Install

Ubuntu:

sudo add-apt-repository ppa:cflmy/marqdo
sudo apt update
sudo apt install marqdo

Windows / Linux: download the CLI bundle for your platform below. The executable embeds the official standard library; the bundle also includes ext sources and native plugins.

marqdo --version
marqdo view public
marqdo view output public -o site
marqdo ext add web

From source:

git clone https://github.com/cflmy/marqdo.git
cd marqdo
git checkout v2.5.0
cargo build --release

下载 / Downloads

Asset 内容 / Contents
marqdo-2.5.0-x86_64-pc-windows-msvc.exe Windows CLI,内置标准库 / embedded stdlib
marqdo-2.5.0-x86_64-pc-windows-msvc.zip Windows CLI + lib + ext + native DLLs
marqdo-2.5.0-x86_64-unknown-linux-gnu.zip Linux CLI + lib + ext + native libraries
marqdo-2.5.0-native-*.zip Windows / Linux 原生插件 / native plugins
marqdo-2.5.0-stdlib.zip 标准库 / standard library
marqdo-2.5.0-ext.zip 官方扩展源码 / official extension sources
marqdo-2.5.0-source.zip 发布源码 / tagged source
marqdo-2.5.0.vsix VS Code / Cursor extension
marqdo-2.5.0-public.zip 新版静态用户文档站 / redesigned static docs

链接 / Links

CHANGELOG · README · Extension CDN · Ubuntu PPA

v2.4.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 07:17

Marqdo v2.4.0

亮点 / Highlights

  • Oracle journal 作语言值 / Oracle journal as language values:foreign.oracle_journal / foreign.replay_check 暴露为普通 Marqdo 值(非仅 notebook API);handle/code 不得入 journal。
  • 实现硬化 / Hardening:bytecode / frontend / foreign session 模块化;applications 金样例;verification/replay-policy Lean。
  • MSRV 1.81:notebook OnceLock 初始化等待不再依赖 ≥1.84 的 wait。
  • 扩展包 / Ext pack:同步 2.4.0。

核心表面 Δ / Core surface Δ:无增删(仍 19 个构造)。

安装 / Install

git clone https://github.com/cflmy/marqdo.git && cd marqdo
git checkout v2.4.0
cargo build --release
./target/release/marqdo version

cargo build --release -p marqdo_plugin_web -p marqdo_plugin_agent -p marqdo_plugin_quantum -p marqdo_plugin_linalg
marqdo ext add web && marqdo ext add agent && marqdo ext add quantum

Ubuntu PPA

sudo add-apt-repository ppa:cflmy/marqdo && sudo apt update && sudo apt install marqdo

浏览器 WASM / Browser WASM

marqdo wasm build
# → dist/wasm/marqdo_wasm_bg.wasm + marqdo-bridge.js

破坏性变更 / Breaking changes

  • 无 / None(行为对齐既有 Strong 契约;journal 为新增宿主表面)。

下载 / Downloads

Asset 内容 / Contents
marqdo-*-windows-msvc.exe CLI(内置 stdlib)
marqdo-*-windows-msvc.zip exe + lib/ + ext/(含 native)
marqdo-*-unknown-linux-gnu.zip Linux CLI + lib/ + ext/ + .so
marqdo-*-native-*.zip 预编译插件(Win + Linux 必出)
marqdo-*-stdlib.zip 仅 lib/
marqdo-*-ext.zip 官方 ext/
marqdo-*-source.zip 源码快照
marqdo-*.vsix VS Code / Cursor 扩展
marqdo-*-public.zip 用户文档站

扩展源码分支 / Extension branch: vscode-extension.

CDN: https://ext.marqdo.com

链接 / Links