From 5272acaea0205c0977245999bf93b0e64e287947 Mon Sep 17 00:00:00 2001 From: cflmy Date: Wed, 23 Sep 2026 13:31:27 +0800 Subject: [PATCH] =?UTF-8?q?release:=20v1.1.0=20=E2=80=94=E2=80=94=20?= =?UTF-8?q?=E6=A0=B8=E5=BF=83=E8=A1=A8=E9=9D=A2=E5=AE=88=E5=8D=AB=20+=20?= =?UTF-8?q?=E6=B8=90=E8=BF=9B=E5=BC=8F=E5=A5=91=E7=BA=A6=20+=20MLSP=20for?= =?UTF-8?q?=20AI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Cargo.toml / marqdo-wasm / ext/VERSION → 1.1.0(CLI 与扩展同步) - CHANGELOG v1.1.0(含核心表面 Δ = 无增删;诚实标注 P4(b) 盲测未达标) - README 现状/安装/示例更新(新命令 check / --json / mlsp) - debian/changelog 1.1.0-1ppa1;release.yml Highlights stub 更新 - 核心表面 Δ:无增删(19 构造不变;本版为 Runtime/Document 层变更) Co-authored-by: Cursor --- .github/workflows/release.yml | 3 ++- CHANGELOG.md | 44 +++++++++++++++++++++++++++++++++++ Cargo.lock | 4 ++-- Cargo.toml | 2 +- README.md | 14 +++++++---- crates/marqdo-wasm/Cargo.toml | 2 +- debian/changelog | 11 +++++++++ ext/VERSION | 2 +- 8 files changed, 72 insertions(+), 10 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index ede7c05..2a39f18 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -124,8 +124,9 @@ jobs: ## Marqdo ${{ github.ref_name }} ### 亮点 / Highlights + - **v1.1.0**:AI 原生闭环三件套——核心表面守卫(问题一)· 渐进式契约 + `marqdo check`(问题二)· **MLSP for AI**(`marqdo mlsp`:locate/syntax/validate/repair_targets/repair_apply/schema,AI 按需查语法而非背诵)(问题三)· `run --json` 结构化诊断 + - **v1.1.0**: AI-native loop — core-surface guard, progressive contracts + `marqdo check`, **MLSP for AI** (`marqdo mlsp`: query syntax on demand instead of memorizing), `run --json` structured diagnostics - **v1.0.7**:WS/网络边界加固(同源握手、require_auth/需要登录、消息上限、HTTP 8 MiB 截断);`url_encode` `%20` - - **v1.0.7**: WS/net boundary hardening (same-origin, require_auth, message caps, 8 MiB HTTP cap); `url_encode` `%20` - **v1.0.3**:Ubuntu PPA + 扩展 CDN(ext.marqdo.com);CLI/扩展可分发;noble 捆绑 Rust 工具链 - **v1.0.3**: Ubuntu PPA + extension CDN; independent CLI/ext packs; bundled Rust for noble - **v1.0.1**:修复 Go `libweb` 动态路由 `{param}` 查询代入、详情 Markdown、CSS 数字误报 diff --git a/CHANGELOG.md b/CHANGELOG.md index 1dfcba8..ed4dcb1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,49 @@ # Changelog +## 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](doc/roadmap/perf-validation-report-2026-09-23.md)。 + +```bash +# 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](doc/roadmap/perf-validation-report-2026-09-23.md) §3。 + +## Unreleased + ## v1.0.7 — 2026-09-22 ### Highlights diff --git a/Cargo.lock b/Cargo.lock index b536d7a..36a3a01 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -572,7 +572,7 @@ checksum = "0ceec5bc11778974d1bcb055b18002eba7f4b3518b6a0081b3af5f21666da9ad" [[package]] name = "marqdo" -version = "1.0.7" +version = "1.1.0" dependencies = [ "anyhow", "assert_cmd", @@ -603,7 +603,7 @@ dependencies = [ [[package]] name = "marqdo-wasm" -version = "1.0.7" +version = "1.1.0" dependencies = [ "marqdo", "serde_json", diff --git a/Cargo.toml b/Cargo.toml index f9d2c1a..d2a40bd 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo" -version = "1.0.7" +version = "1.1.0" edition = "2021" license = "Apache-2.0" description = "Marqdo — Markdown markers as an interpreted programming language" diff --git a/README.md b/README.md index 3a94438..f9b2e1d 100644 --- a/README.md +++ b/README.md @@ -142,8 +142,9 @@ marqdo catalog public -o .marqdo --- -## 现状(v1.0.7) +## 现状(v1.1.0) +- **AI 原生闭环(v1.1.0 新增)**:核心表面守卫(19 构造,单边改动 CI 必红)· **渐进式契约**(文档内嵌 `参数`/`返回`/`字段` 表 + 四边界校验 + `marqdo check` 防漂移)· **MLSP for AI**(`marqdo mlsp`:`locate`/`syntax`/`validate`/`repair_targets`/`repair_apply`/`schema`,AI 按需查语法而非背诵)· **结构化诊断**(`run --json`,错误即数据);验证见 [perf-validation-report-2026-09-23.md](doc/roadmap/perf-validation-report-2026-09-23.md) - 映射与解释器:**v0.3 语法宪法**(`**` 代码 / `*` 返回 / 叙述声明);Phase I 树遍历 + 字节码后端;金样例在 `tests/` 与 `tests/markup-v03/` - **对象**:`#` = 类型/构造,`##`+ = 函数/方法;见 [objects.md](doc/design/objects.md) - **`marqdo view`**:文档浏览器(Structure + 函数大纲/搜索 + Execution + Variables 浮窗) @@ -164,7 +165,7 @@ marqdo catalog public -o .marqdo - **浏览器 Marqdo(WASM)**:`marqdo wasm build` + 官方 bridge 自启(作者零业务 JS;桥内可含列表/路由/storage/ws/文件/Canvas/音频/Observer/拖放);`lib/browser` + GFM;`web.client_embed`;示例 [browser-hello](examples/browser-hello/) · [browser-app](examples/browser-app/) · [browser-media](examples/browser-media/) · [web-client-site](examples/web-client-site/)([ADR 0002](doc/adr/0002-browser-marqdo-wasm.md) · [D](doc/roadmap/browser-wasm-d.md) · [E](doc/roadmap/browser-wasm-e.md) · [F](doc/roadmap/browser-wasm-f.md)) - 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) · [ADR 0002 — 浏览器 WASM](doc/adr/0002-browser-marqdo-wasm.md)(C0–C5 完结,见 [roadmap/browser-wasm.md](doc/roadmap/browser-wasm.md))· [ADR 0003 — 异步效应](doc/adr/0003-browser-async-effects.md) -### 如何使用最新 Marqdo(v1.0.7) +### 如何使用最新 Marqdo(v1.1.0) **安装解释器(任选其一)** @@ -179,7 +180,7 @@ marqdo catalog public -o .marqdo ```bash # 1) 源码安装(跟 tag 或 main) git clone https://github.com/cflmy/marqdo.git && cd marqdo -git checkout v1.0.7 # 或留在 main +git checkout v1.1.0 # 或留在 main cargo build --release export PATH="$PWD/target/release:$PATH" marqdo version @@ -192,6 +193,11 @@ marqdo view public --no-open marqdo debug public --no-open marqdo catalog public -o .marqdo +# 2b) AI 原生闭环(v1.1.0):契约检查 / 结构化诊断 / MLSP 查询 +marqdo check tests/contracts/ok_contract.mq.md # 静态契约防漂移 +marqdo run tests/structure/hello.mq.md --json # 结构化诊断(错误即数据) +printf '{"id":1,"method":"syntax","params":{"query":"返回"}}\n' | marqdo mlsp + # 3) 安装官方扩展(Release / CDN 用户:无需本机 Rust/Go) marqdo ext add web # 或:网页 — 自动下载 L1 + 预编译 native(Go libweb) marqdo ext add agent # 或:智能体 @@ -213,7 +219,7 @@ marqdo wasm build # → dist/wasm/ … 见 examples/browser-hello/ # 6) Releases:Windows exe/zip/vsix;Linux CLI zip + native `.so` zip -# https://github.com/cflmy/marqdo/releases/tag/v1.0.7 +# https://github.com/cflmy/marqdo/releases/tag/v1.1.0 ``` 开发期也可用 `cargo run -- …` 代替已安装的 `marqdo`: diff --git a/crates/marqdo-wasm/Cargo.toml b/crates/marqdo-wasm/Cargo.toml index 965c6d4..27aec97 100644 --- a/crates/marqdo-wasm/Cargo.toml +++ b/crates/marqdo-wasm/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo-wasm" -version = "1.0.7" +version = "1.1.0" edition = "2021" license = "Apache-2.0" description = "Marqdo interpreter as WebAssembly (browser host bridge)" diff --git a/debian/changelog b/debian/changelog index 96319e9..0f4e119 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,14 @@ +marqdo (1.1.0-1ppa1) noble; urgency=medium + + * Marqdo 1.1.0: core surface guard + progressive contracts + MLSP for AI. + New `marqdo check` (static contract drift) and `marqdo mlsp` (language + server for AI: locate/syntax/validate/repair_targets/schema/repair_apply); + `run --json` unified structured diagnostics; contract tables + (参数/返回/字段/集合) with four validation boundaries; anchored repair + guardrails (bounded line edits, out-of-scope refused). + + -- cflmy Wed, 23 Sep 2026 13:30:00 +0800 + marqdo (1.0.7-1ppa1) noble; urgency=medium * Marqdo 1.0.7: WS/net boundary hardening (same-origin handshake, diff --git a/ext/VERSION b/ext/VERSION index 238d6e8..9084fa2 100644 --- a/ext/VERSION +++ b/ext/VERSION @@ -1 +1 @@ -1.0.7 +1.1.0