--- 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()*。