# 归档配置

```json
{
  "version": 1,
  "archiveRoot": "docs/archive",
  "defaults": { "onConflict": "skip" },
  "rules": [
    {
      "match": "design/**/*.md",
      "target": "design/{relative}",
      "stripFrontmatter": true,
      "requiredText": ["#"]
    },
    {
      "match": "specs/*.md",
      "target": "reference/{stem}-api.md",
      "section": "API"
    }
  ]
}
```

- `archiveRoot`：相对项目根的归档目录。
- `match`：相对项目根的 glob，只处理普通文件。
- `target`：可用 `{name}`、`{stem}`、`{suffix}`、`{relative}`、`{parent}`。
- `section`：可选 Markdown 标题文本，输出该标题及下属内容。
- `stripFrontmatter`：仅移除开头完整闭合的 Frontmatter。
- `requiredText`：归档前必须出现的文字，用于替代隐式外部校验。
- `onConflict`：`skip`、`overwrite` 或 `append`。

目标不得是绝对路径或逃逸归档根。`append` 仅适合文本文件。