- 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。
2.4 KiB
Executable File
markup, title, import
| markup | title | import | ||||
|---|---|---|---|---|---|---|
| occlusion | Path algebra and isolated native file copying |
|
This page composes native path and filesystem libraries. Call main with fs.write and a disposable --fs-root; the return contains actual observations for a caller or View.
main
| 返回 | 类型 | 说明 |
|---|---|---|
| result | map | Joined/normalized path text and actual copied content |
Joining and normalizing transform path text without granting filesystem access. The illustrative out/demo.txt is not an actual write destination. All real IO uses a unique native temporary directory, so this page neither requires a pre-existing out directory nor overwrites a caller's same-named files.
Grant fs.write and choose a disposable root. Native encoding, path and root checks still apply. Read the copied content before cleaning this run's directory; the returned value should be path-m2. The result contains observations rather than live file paths. An intermediate failure retains its native diagnostic and can leave this run's directory for inspection and caller cleanup.
The complete flow demonstrates text-only path algebra, actual writing, copying, reading and scoped cleanup. A normalized string is not a filesystem permission, and a printed marker alone would not prove what bytes were copied.
We requested = [Join the illustrative output path](path.join(a="out", b="demo.txt")) and normalized = Remove redundant path segments without filesystem IO before the file demonstration.
For actual IO we work = Create a unique directory inside the granted root and original = [Name this run own source file](path.join(a=work, b="demo.txt")) and copied = [Name its isolated copy](path.join(a=work, b="demo-copy.txt")).
We [Write the actual text to copy](fs.write_text(path=original, text="path-m2")) and [Copy only this run own file](fs.copy_file(src=original, dest=copied)).
We copied_text = Observe the actual copied content and then Clean only this run unique directory.
observed =
| requested | normalized | copied_text |
|---|---|---|
requested |
normalized |
copied_text |
After the isolated file operation we return observed. The temporary files have been removed.