65 lines
3.3 KiB
Markdown
65 lines
3.3 KiB
Markdown
# 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。
|