- 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.0 KiB
Executable File
markup, title, description
| markup | title | description |
|---|---|---|
| occlusion | lib/路径 | 路径代数(中层 M2)。无 I/O;分隔符随宿主 OS。 |
只做路径代数。无 I/O;分隔符随宿主 OS。
不访问磁盘的路径运算。
能力与边界:归一化是词法运算,不代表已获得文件访问权限。真正的 IO 路径由宿主按文件根目录检查。
本文件就是调用和开发手册:直接导入此文件,或用 marqdo call 按下面的函数标题调用。参数表说明类型和默认值;未填默认值的参数必须提供。返回表是渐进契约,后文说明失败与边界。
实现入口:src/host/path.rs、src/host/fs_ops.rs
开发时保持中英文语义一致,先组合公开库;仅在 OS 或算法边界添加宿主原语并声明效应。修改后运行 marqdo check --narrative-ratio 本文件,并执行 tests/stdlib_tasks.rs 的真实任务。
拼接
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 甲 | any | 必填 | 基础路径 |
| 乙 | any | 必填 | 追加到基础路径的路径片段 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 拼接路径段甲与乙 |
这里使用甲、乙。
调用效应:pure。
拼接路径段甲与乙。
调用例:[路径.拼接] 甲="a" 乙="b"
完成后返回*[拼接路径段甲与乙](> host_path_join a=甲 b=乙)*。
拆分
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | list | 把路径拆成各段 |
这里使用路径。
调用效应:pure。
把路径拆成各段。
完成后返回*[把路径拆成各段](> host_path_split path=路径)*。
文件名
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 路径的末段文件名 |
这里使用路径。
调用效应:pure。
路径的末段文件名。
完成后返回*[路径的末段文件名](> host_path_file_name path=路径)*。
父目录
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 路径的父目录 |
这里使用路径。
调用效应:pure。
路径的父目录。
完成后返回*[路径的父目录](> host_path_parent path=路径)*。
扩展名
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 路径的扩展名 |
这里使用路径。
调用效应:pure。
路径的扩展名。
完成后返回*[路径的扩展名](> host_path_extension path=路径)*。
规范化
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 规范化路径(处理点段) |
这里使用路径。
调用效应:pure。
规范化路径(处理点段)。
完成后返回*[规范化路径(处理点段)](> host_path_normalize path=路径)*。
是绝对
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | any | 必填 | 授权文件根目录内的路径 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | bool | 路径是否为绝对路径 |
这里使用路径。
调用效应:pure。
路径是否为绝对路径。
完成后返回*[路径是否为绝对路径](> host_path_is_absolute path=路径)*。
相对路径
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | text | 必填 | 授权文件根目录内的路径 |
| 基准 | text | 必填 | 计算相对路径所用的基础目录 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 计算相对 base 的词法路径;两个参数须同为绝对或相对路径,不访问磁盘。 |
这里使用路径、基准。
调用效应:pure。
计算相对 base 的词法路径;两个参数须同为绝对或相对路径,不访问磁盘。
完成后返回*[计算相对 base 的词法路径;两个参数须同为绝对或相对路径,不访问磁盘](> host_path_relative path=路径 base=基准)*。
换扩展名
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 路径 | text | 必填 | 授权文件根目录内的路径 |
| 扩展名 | text | 必填 | 新扩展名,可带或不带开头的点 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | text | 替换最后的扩展名;空扩展名表示去除。 |
这里使用路径、扩展名。
调用效应:pure。
直接调用此函数:
marqdo call lib/路径.mq.md 换扩展名 '路径="notes/draft.txt"' '扩展名="md"' --effects none --json
替换最后的扩展名;空扩展名表示去除。
完成后返回*[替换最后的扩展名;空扩展名表示去除](> host_path_with_extension path=路径 extension=扩展名)*。