- 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。
5.8 KiB
Executable File
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=事件)*。