Repository navigation
ext-v2.8.1
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.mdCI:.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。