- 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。
30 lines
1.1 KiB
Markdown
Executable File
30 lines
1.1 KiB
Markdown
Executable File
---
|
|
markup: occlusion
|
|
title: 标准库工程实践
|
|
import:
|
|
practice: index.mq.md
|
|
---
|
|
|
|
本工程把文件整理、CSV 数据处理和文档维护连为真实工作流。
|
|
中文入口复用同一份实现,避免双语版本逐渐分叉。准备一个可丢弃目录,
|
|
把其绝对路径设为 MQ_WORK,再执行下面的工具;成功后会清理自己的临时子目录。
|
|
返回值包含真实的文件结果、CSV 报表及修改后文档,不以一个通过标志代替验收。
|
|
|
|
```sh
|
|
marqdo call examples/stdlib-handbook/索引.mq.md 演示 --fs-root "$MQ_WORK" --effects fs.write --json
|
|
```
|
|
|
|
生产使用时先阅读[同源实现](index.mq.md),选择文件清单、汇总报表或更新章节。
|
|
读取失败以每文件错误记录保留;CSV 字段先显式转换类型;章节替换保留周围叙述,
|
|
写入前检查来源摘要。根目录、失败结果和并发写入限制都在真实函数旁说明。
|
|
|
|
## 演示
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|---|---|---|
|
|
| result | map | 三项真实工作流的结果 |
|
|
|
|
执行同源工程,保留所有实际返回数据和失败行为。
|
|
|
|
完成上述步骤后,返回*practice.demo()*。
|