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.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=扩展名)*。