Files
marqdo/doc/design/stdlib-subtask.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

2.0 KiB
Executable File
Raw Blame History

子任务标准库(subtask)

状态 v2
库 lib/subtask.mq.md · lib/子任务.mq.md

定位

并发执行单元。spawn 四选一:

参数 执行方式 join / wait 返回值
path= marqdo run <file> --emit-result <tmp> 子进程 map { code, value, stdout?, stderr? }(# main 返回值;quiet 时 piped 捕获 I/O 尾部,不 inherit TTY)
fn= + 可选 args= 当前入口模块中的函数(进程内线程) 函数返回值 Value
code= 外联代码块(Value::Code)子进程 stdout Text
lang= + source= 外联源码子进程 stdout Text

args=:文件子任务为 List(命令行参数);函数子任务为 Map(形参绑定)或 List(按 arg0… 命名)。

quiet= / 静默=(默认 True):仅影响 文件 子任务的 TTY。默认 piped 捕获 stdout/stderr(父终端不被污染,wait map 带截断后的 stdout/stderr 供父智能体观察);False 时继承父进程 stdout/stderr(map 中 I/O 字段为空)。答案载荷仍以 # main 返回值为主(经 --emit-result 旁路)。外联子任务仍经管道收集 stdout 供 join 返回,不受此参数影响。

事件转发(文件子任务):spawn 时设置 MARQDO_EVENT_FORWARD=<临时 ndjson>;子进程内 EventBus.publish 追加写入该文件;父在 wait 阻塞期间 tail 并 republish(加 source=child)。这样子 LLM stream=True 的 token 能进 marqdo view SSE,而不破坏 quiet TTY 契约。函数子任务在同进程内,本来就共享 EventBus。

父进程结束(含 panic)时 KillOnDrop 终止所有文件/外联子进程;函数线程标记为 killed 并 detach(无法强杀 OS 线程)。

poll → { status: running | done | failed, … };函数 done 时含 value,进程/外联 failed 时含 code 或 error。

Host:host_subtask_*(src/host/subtask.rs)。