从代码生成技术文档

请阅读我提供的代码/目录，生成面向新同事的技术文档（Markdown）。

项目名：{name} 代码：

{粘贴或说明路径}

文档需包含：

1. 一句话说明 + 适用场景
2. 快速开始（安装、最小可运行示例）
3. 架构概览（核心模块与数据流，可用 mermaid）
4. 配置项说明表
5. 公共 API / 关键函数说明（参数、返回值、副作用）
6. 常见错误与排查
7. 贡献指南要点（如何跑测试、提 PR）

要求：与代码一致；不确定处标注「待确认」。