Trusted Effects
Taskflow 1.0.0 文档。 以下命令固定使用 1.0.0 包版本。发布状态见 GitHub Releases,已验证范围与限制见验收账本。Control Plane 与 WebUI 已实现,Control 命令随
taskflow-mcp-core交付。
Trusted Effects 把阶段的副作用写进合同。模型可以提出内容,但对于已准入的已声明文件目标,resources transaction 是唯一最终提交者。
Vertical slice
仓库内的 examples/trusted-effects-write.json 声明了一个对 out/report.md 的 fs.write effect。无 LLM fixture 会执行同一条受 resources 控制的路径:
pnpm exec node --conditions=development --experimental-strip-types --test \
packages/taskflow-core/test/effects-e2e-fixture.test.ts合同
| 概念 | 含义 |
|---|---|
EffectIR | 由 flow/phase 合同携带的封闭 effect 词汇 |
PathRef | 类型化的 workspace-relative 目标,不提供裸字符串 authority |
SecretRef / ServiceRef | 在绑定真实后端前失败关闭的类型化句柄 |
| Labels | 跨 phase DAG 的固定 confidentiality/integrity 检查 |
| Resource transaction | Durable snapshot → lease → intent/permit → stage → commit 或 restore/reject |
why-effect | 只读、ledger-backed 的授权与生命周期解释 |
它不声称什么
- 它不是 FileBroker,也不是完整 OS sandbox。
- Resolve-only 宿主无法阻止所有对未声明路径的写入。
- 这一版没有 SecretRef vault 后端。
- 这一版没有 ServiceRef live network adapter。
- ControlHost 已通过 Unix UDS 和 files-only store 实现经认证的准入、持久审批/Receipt、协调与 WebUI。Control 命令随公共 MCP 包交付;Windows pipes 仍非 GA。
接下来阅读
Last updated on