# 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](../design/native-agent-flow-v3.md)。 ## 3. 安装(Install) ```bash 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) ```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.1`)。 ## 5. 已知限制(Known limitations) - 输入闸门保存的是**步骤边界**,不是任意字节码解释器帧;回复后须显式进入下一 Marqdo 函数。 - 作用域选择依赖 Markdown 标题约定,不是编译器已解析的 AST 符号表。 - 调用方提供的 principal/session/source revision 须由已认证宿主证明,不能来自模型文本。 - 并行复用 `subtask.run_many`;跨进程子任务租约与已在跑外部进程的取消传播仍待专项注入验证。 - 实时大模型与目标 1B 本地模型评测仍开放;写效应自动重试仍被拒绝,直至 EffectLedger 对账完成。 **核心表面 Δ**:无增删——19 个核心构造不变;本包为 Extension / Agent Runtime。