注意事项

文件名 vs 键名

_meta.json 中的键名必须与文件名或目录名完全匹配（不含扩展名）。文件名 wsl2-cc.md 对应的键是 wsl2-cc，目录名 hermes-agent 对应的键是 hermes-agent。大小写敏感。

隐藏文档

如果某篇文档不想出现在侧边栏中，有两种方式：

1. 在 frontmatter 中设置 display: hidden
2. 不在 _meta.json 中列出（但这种方式下文档仍可能在其他地方被访问到）

目录和文档同名冲突

如果存在 agent/claude-code.md 文件和 agent/claude-code/ 目录同时存在，构建时会优先保留文档文件，目录会被忽略。避免这种命名冲突。

JSON 格式

_meta.json 必须是合法的 JSON 格式。注意以下常见错误：

• 键名必须用双引号，不能用单引号
• 不能有尾逗号（trailing comma）
• 不能有注释（JSON 不支持注释）