🇨🇳中文介绍

项目目录地图构建器

为指定目录范围生成或增量更新高信噪比的目录说明文档。

核心规则

• 必须让用户指定要扫描的文件夹范围，禁止默认全仓库扫描。
• 若范围过大，提醒上下文风险并让用户确认或缩小范围。
• 输出语言必须与用户当前语言一致。
• 文档文件名固定：PROJECT_MAP.md。
• 若输出位置已存在 PROJECT_MAP.md，进入更新模式（仅增量更新）。
• 若不存在，进入主动引导模式（先确认范围再新建）。

输出位置规则

• 单目录：将 PROJECT_MAP.md 写在该目录根。
• 多目录：
  • 先询问：生成一个合并文档，还是每个目录各生成一个。
  • 合并：写到项目根目录。
  • 分开：各目录根各写一份 PROJECT_MAP.md。

最少需要询问用户的问题

• 要扫描哪些文件夹？
• 如果是多个文件夹：合并成一个文档，还是分别生成多个？
• 若范围大或不明确：是否确认范围？

工作流

A) 主动引导模式（不存在 PROJECT_MAP.md）

1. 确认扫描范围与输出策略。
2. 快速列出指定目录的文件清单。
3. 识别入口与关键文件（如 manifest、主入口、服务线程、UI、配置、存储、测试、文档）。
4. 只打开“关键文件”用于解释职责与关系，避免全量读取。
5. 按结构模板生成 PROJECT_MAP.md。
6. 不确定处必须显式标注（如“假设”“未确认”）。

B) 更新模式（已存在 PROJECT_MAP.md）

1. 读取既有 PROJECT_MAP.md。
2. 仅重新扫描用户指定的目录范围。
3. 结合“当前对话上下文”与文件清单差异，定位需更新的段落。
4. 只做增量补丁更新，不进行全量重写。
5. 添加“本次更新”小节（日期 + 范围 + 变更点）。

扫描规则

• 优先使用快速文件列表命令（如 或 ）。