release(ext-2.8.1): AI durable workflow pack with Windows packaging fixes

This commit is contained in:
cflmy committed 2026-11-18 13:37:02 +08:00
1 parent e5580d9640
commit 8db699191e
6 files changed
+26 -139

No files matched your search

+10 -10
View File
@@ -2,17 +2,18 @@
## Unreleased
## Ext pack v2.8.3 — 2026-11-18
## Ext pack v2.8.1 — 2026-11-18
### Highlights
**AI native durable workflow + Windows pack CI fix(CLI 仍为 v2.8.0)**:能力同 2.8.1;
修复 Windows engineering root,以及 Git Bash 下误用 GNU `tar` 导致 zip 失败——改用
`C:\Windows\System32\tar.exe`。详见 [双语发布说明](doc/releases/ext-2.8.3.md)。
**AI native durable workflow(CLI 仍为 v2.8.0)**:`ext/ai` 以插件侧步骤机交付持久化
工作流(`workflow`/`flow`/`context`/`recovery`),含有界模型选择、作用域上下文、
只读失败恢复、`inspect`/`list` 与可隔离 `resume_dir`。Windows 打包使用 `path.join`
根路径与 `System32\tar.exe`。详见 [双语发布说明](doc/releases/ext-2.8.1.md)。
```bash
marqdo ext add agent # CDN latest → 2.8.3
# 或:MARQDO_EXT_VERSION=2.8.3 marqdo ext add agent
marqdo ext add agent # CDN latest → 2.8.1
# 或:MARQDO_EXT_VERSION=2.8.1 marqdo ext add agent
```
**核心表面 Δ(Core surface Δ)**:**无增删**——仅 Extension / Agent Runtime。
@@ -35,13 +36,12 @@ marqdo ext add agent # CDN latest → 2.8.3
`run --effects` flag, using `MARQDO_AGENT_PLUGIN` instead.
- Atomic checkpoint/effect temp names no longer collide under parallel writes;
resume tests no longer race on process-wide cwd.
- Windows `extension-release`:engineering root 使用 `path.join` / cwd 回退,
`packs.ci` 传入绝对 checkout,并授予 `fs.read`。
- Windows ZIP 编码显式调用 `System32\tar.exe`(bsdtar),避免 Git Bash GNU tar。
- Windows `extension-release`:engineering root 使用 `path.join` / cwd 回退;
ZIP 显式调用 `System32\tar.exe`(bsdtar);`packs.ci` 授予 `fs.read`。
### Changed
- 扩展包 SemVer **2.8.3**(`ext/VERSION`);与 CLI **v2.8.0** 可独立安装。
- 扩展包 SemVer **2.8.1**(`ext/VERSION`);与 CLI **v2.8.0** 可独立安装。
- 分支已合并 v2.8.0 依赖锁后的 AI 工作流增量,不再从 2.7.1 基线分叉。
## v2.8.0 — 2026-11-17
+3 -3
View File
@@ -117,7 +117,7 @@ marqdo view examples/procurement --no-open
Agent Skills already support scripts; Marqdo's claim is **one document-native language surface** for authoring, inspecting, executing and reusing functions. This is **not** a claim of full formal verification, zero-delay execution, or OS-level isolation of all plugin/process behavior.
**Resources:** [Release v2.8.0](https://github.com/cflmy/marqdo/releases/tag/v2.8.0) · [Ext pack 2.8.3](https://github.com/cflmy/marqdo/releases/tag/ext-v2.8.3) · [Procurement example](examples/procurement/index.mq.md) · [Executable library authoring](doc/library-development.mq.md) · [Function calling](public/features/22-函数调用.mq.md) · [Link syntax](doc/design/link-syntax.md) · [Website](https://www.marqdo.com/)
**Resources:** [Release v2.8.0](https://github.com/cflmy/marqdo/releases/tag/v2.8.0) · [Ext pack 2.8.1](https://github.com/cflmy/marqdo/releases/tag/ext-v2.8.1) · [Procurement example](examples/procurement/index.mq.md) · [Executable library authoring](doc/library-development.mq.md) · [Function calling](public/features/22-函数调用.mq.md) · [Link syntax](doc/design/link-syntax.md) · [Website](https://www.marqdo.com/)
---
@@ -128,11 +128,11 @@ Agent Skills already support scripts; Marqdo's claim is **one document-native la
当前 CLI **2.8.0** 新增 `marqdo prove`:知识文件的定理表编译为 Lean 4 并自动判定真假——没有 Lean 工具链也能离线符号执行(诚实降级,绝不冒充证明),有 Lean 时全链路证明并给出反例见证。参见[发布说明](doc/releases/v2.8.0.md)。
独立拓展包 **2.8.3**(CLI 仍为 2.8.0):`ext/ai` 插件侧持久化工作流(选择 / 作用域上下文 / 只读失败恢复 / `inspect`)。`marqdo ext add agent` → CDN latest。参见[拓展包说明](doc/releases/ext-2.8.3.md)。
独立拓展包 **2.8.1**(CLI 仍为 2.8.0):`ext/ai` 插件侧持久化工作流(选择 / 作用域上下文 / 只读失败恢复 / `inspect`)。`marqdo ext add agent` → CDN latest。参见[拓展包说明](doc/releases/ext-2.8.1.md)。
CLI **2.8.0** adds `marqdo prove`: theorem tables in knowledge files compile to Lean 4 and are judged automatically — offline symbolic execution without a toolchain (honest degradation, never impersonating a proof), full proofs with counterexample witnesses when Lean is available.
Ext pack **2.8.3** (CLI remains 2.8.0): plugin-only durable AI workflows with bounded choice, scoped context, failed-only read-only recovery and `inspect`.
Ext pack **2.8.1** (CLI remains 2.8.0): plugin-only durable AI workflows with bounded choice, scoped context, failed-only read-only recovery and `inspect`.
## 核心优势:可执行知识(Executable Knowledge)
+12 -7
View File
@@ -2,14 +2,18 @@
## 1. 一句话
独立拓展包 **2.8.1**(CLI 仍为 **2.8.0**):`ext/ai` 交付插件侧持久化工作流——显式 `open/next/commit/cancel`、
有界模型选择、作用域上下文、只读失败恢复,以及 `inspect/list` 与可隔离的 `resume_dir`。
不改解释器栈挂起语义,也不宣称外部写的 exactly-once。
独立拓展包 **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`. No interpreter-stack suspension and no exactly-once external-write claim.
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)
@@ -21,6 +25,7 @@ context packing, failed-only read-only recovery, plus `inspect/list` and isolata
| 作用域上下文 | 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](../design/native-agent-flow-v3.md)。
-58
View File
@@ -1,58 +0,0 @@
# Ext pack v2.8.2 发布说明 · Release Notes(AI native flow)
## 1. 一句话
独立拓展包 **2.8.2**(CLI 仍为 **2.8.0**):在 2.8.1 的 AI 持久化工作流之上,修复 Windows
`extension-release` 打包根路径(`root does not exist`),使双平台 ZIP 可发布。
`ext-v2.8.1` 标签保留但未形成完整 Release 资产。
Independent extension pack **2.8.2** (CLI remains **2.8.0**): AI durable workflows from
2.8.1, plus a Windows `extension-release` checkout-root fix (`root does not exist`) so
both-platform ZIPs can publish. Tag `ext-v2.8.1` remains but did not complete assets.
## 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` |
设计契约:[native-agent-flow-v3.md](../design/native-agent-flow-v3.md)。
## 3. 安装(Install)
```bash
marqdo ext add agent # CDN / Releases → 2.8.2
# 或:MARQDO_EXT_VERSION=2.8.2 marqdo ext add agent
marqdo ext add llm
```
产物:`marqdo-2.8.2-ext.zip` 与双平台 native ZIP(含 agent / llm 等既有原生库)。
## 4. 验证(Validation)
```bash
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.2`)。
## 5. 已知限制(Known limitations)
- 输入闸门保存的是**步骤边界**,不是任意字节码解释器帧;回复后须显式进入下一 Marqdo 函数。
- 作用域选择依赖 Markdown 标题约定,不是编译器已解析的 AST 符号表。
- 调用方提供的 principal/session/source revision 须由已认证宿主证明,不能来自模型文本。
- 并行复用 `subtask.run_many`;跨进程子任务租约与已在跑外部进程的取消传播仍待专项注入验证。
- 实时大模型与目标 1B 本地模型评测仍开放;写效应自动重试仍被拒绝,直至 EffectLedger 对账完成。
**核心表面 Δ**:无增删——19 个核心构造不变;本包为 Extension / Agent Runtime。
-60
View File
@@ -1,60 +0,0 @@
# Ext pack v2.8.3 发布说明 · Release Notes(AI native flow)
## 1. 一句话
独立拓展包 **2.8.3**(CLI 仍为 **2.8.0**):交付 `ext/ai` 插件侧持久化工作流,并修复
Windows `extension-release` 打包(engineering root + 强制使用 `System32\tar.exe`
bsdtar)。`ext-v2.8.1` / `ext-v2.8.2` 标签保留但未形成完整 Release 资产。
Independent extension pack **2.8.3** (CLI remains **2.8.0**): ships `ext/ai` plugin-only
durable workflows and fixes Windows `extension-release` packaging (engineering root
plus explicit `System32\tar.exe` bsdtar). Tags `ext-v2.8.1` / `ext-v2.8.2` remain
without complete release assets.
## 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 | `path.join` 根路径;`C:\Windows\System32\tar.exe --format=zip` |
设计契约:[native-agent-flow-v3.md](../design/native-agent-flow-v3.md)。
## 3. 安装(Install)
```bash
marqdo ext add agent # CDN / Releases → 2.8.3
# 或:MARQDO_EXT_VERSION=2.8.3 marqdo ext add agent
marqdo ext add llm
```
产物:`marqdo-2.8.3-ext.zip` 与双平台 native ZIP(含 agent / llm 等既有原生库)。
## 4. 验证(Validation)
```bash
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.3`)。
## 5. 已知限制(Known limitations)
- 输入闸门保存的是**步骤边界**,不是任意字节码解释器帧;回复后须显式进入下一 Marqdo 函数。
- 作用域选择依赖 Markdown 标题约定,不是编译器已解析的 AST 符号表。
- 调用方提供的 principal/session/source revision 须由已认证宿主证明,不能来自模型文本。
- 并行复用 `subtask.run_many`;跨进程子任务租约与已在跑外部进程的取消传播仍待专项注入验证。
- 实时大模型与目标 1B 本地模型评测仍开放;写效应自动重试仍被拒绝,直至 EffectLedger 对账完成。
**核心表面 Δ**:无增删——19 个核心构造不变;本包为 Extension / Agent Runtime。
+1 -1
View File
@@ -1 +1 @@
2.8.3
2.8.1