Files
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

5.8 KiB
Executable File
Raw Permalink Blame History

markup, title, description
markup title description
occlusion lib/系统 中文系统包装(加载环境 可选 路径=)

中文系统包装(加载环境 可选 路径=)

读取执行元数据并与宿主系统交互。

能力与边界:元信息与模块源码来自入口文档,不是被导入库。执行进程需要 process.exec;读写环境和读取配置具有独立效应。

本文件就是调用和开发手册:直接导入此文件,或用 marqdo call 按下面的函数标题调用。参数表说明类型和默认值;未填默认值的参数必须提供。返回表是渐进契约,后文说明失败与边界。

实现入口:src/host/sys.rs

开发时保持中英文语义一致,先组合公开库;仅在 OS 或算法边界添加宿主原语并声明效应。修改后运行 marqdo check --narrative-ratio 本文件,并执行 tests/stdlib_tasks.rs 的真实任务。

取环境

参数 类型 默认 说明
名 any 必填 环境变量名
返回 类型 说明
result any 读取环境变量名

这里使用名。

调用效应:environment.read。

读取环境变量名。

完成后返回*[读取环境变量名](> host_env_get name=名)*。

设环境

参数 类型 默认 说明
名 any 必填 环境变量名
值 any 必填 待转换或保存的值;不会就地修改输入
返回 类型 说明
result any 设置环境变量名的值

这里使用名、值。

调用效应:environment.write。

设置环境变量名的值。

完成后返回*[设置环境变量名的值](> host_env_set name=名 value=值)*。

加载环境

参数 类型 默认 说明
路径 any None 授权文件根目录内的路径
返回 类型 说明
result any 加载 .env(可选具名实参 路径=)

这里使用路径=None。

调用效应:environment.write,fs.read。

加载 .env(可选具名实参 路径=)。不覆盖已有进程环境变量。

完成后返回*[加载 .env(可选具名实参 路径=)](> host_dotenv_load path=路径)*。

参数表

返回 类型 说明
result list 进程参数表

调用效应:pure。

进程参数表。

完成后返回*进程参数表*。

工作目录

返回 类型 说明
result text 当前工作目录

调用效应:pure。

当前工作目录。

完成后返回*当前工作目录*。

元信息

返回 类型 说明
result map 入口 .mq.md 已绑定的 Artifact Metadata(映射)

调用效应:pure。

直接调用此函数:

marqdo call lib/系统.mq.md 元信息  --effects none --json

入口 .mq.md 已绑定的 Artifact Metadata(映射)。见 doc/design/binding.md。

完成后返回*入口 .mq.md 已绑定的 Artifact Metadata(映射)*。

取元信息

参数 类型 默认 说明
键 any 必填 要读取、比较或更新的字段名或存储键
返回 类型 说明
result any 按键取一条元信息;缺失 → None

这里使用键。

调用效应:pure。

按键取一条元信息;缺失 → None。

完成后返回*[按键取一条元信息;缺失 → None](> host_meta_get key=键)*。

工件种类

返回 类型 说明
result any 入口 Artifact 分类:web / endpoint / prompt / other;无 type/类型 → None

调用效应:pure。

入口 Artifact 分类:web / endpoint / prompt / other;无 type/类型 → None。ADR 0007。

完成后返回*入口 Artifact 分类:web / endpoint / prompt / other;无 type/类型 → None*。

模块源码

返回 类型 说明
result text 入口 .mq.md 全文(供 document-as-prompt)

调用效应:pure。

入口 .mq.md 全文(供 document-as-prompt)。未设置时为空文本。

完成后返回*入口 .mq.md 全文(供 document-as-prompt)*。

退出

参数 类型 默认 说明
码 any 必填 进程退出码;零表示成功
返回 类型 说明
result any 以代码退出进程

这里使用码。

调用效应:process.control。

以代码退出进程。

完成后返回*[以代码退出进程](> host_exit code=码)*。

执行

参数 类型 默认 说明
命令 any 必填 可执行命令或解释器覆盖配置
参数 any None 传给命令或函数的实参列表
捕获 any False 是否返回命令输出而非直接转发
返回 类型 说明
result any 运行子进程

这里使用命令、参数=None、捕获=False。

调用效应:process.exec。

运行子进程。默认返回退出码(整数)。

捕获=True 时返回映射 {code, stdout, stderr}(过大输出可能截断)。

在 **…** 内优先写裸变量 参数=参数;参数=`参数` 亦可。

完成后返回*[运行子进程](> host_exec cmd=命令 args=参数 capture=捕获)*。

发布流事件

参数 类型 默认 说明
事件 any 必填 发布到当前流的结构化事件
返回 类型 说明
result any 向进程内 EventBus 发布流事件(供 marqdo view SSE)

这里使用事件。

调用效应:output.write。

向进程内 EventBus 发布流事件(供 marqdo view SSE)。无订阅者时为空操作。

完成后返回*[向进程内 EventBus 发布流事件(供 marqdo view SSE)](> host_stream_publish event=事件)*。