aionclaw需显式配置项目根目录并绑定.git仓库以准确识别目录结构与依赖关系。必须指向含package.json/pyproject.toml/pom.xml或.git的根目录，支持tree命令快照或自然语言锚点描述，并依赖git初始化实现结构感知。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw在执行代码生成、文件整理或自动化脚本任务时无法识别当前项目目录层级、模块依赖关系或配置文件位置，会导致技能报错、路径错误或生成内容与实际结构脱节。这种情况多发生在首次接入新项目、跨仓库协作或本地目录未规范命名时。
确认并显式声明项目根目录
打开AionClaw客户端 → 点击左下角「工具管理」→ 选择「项目上下文配置」→ 在「当前工作区」栏点击「浏览」按钮，【必须指向含package.json / pyproject.toml / pom.xml 或 .git 文件的实际根目录】，不能选父级空文件夹或子模块内部路径。
这一步跳过会导致后续所有文件读写操作默认以用户主目录为起点，极易引发“找不到main.py”“require不识别utils模块”等路径类报错。
手动注入结构描述文本
方法一：在对话框中粘贴结构快照
终端执行：tree -L 3 -I "node_modules|.git|.idea|__pycache__" --dirsfirst（Mac/Linux）或 Get-ChildItem -Path . -Depth 3 -Force | Where-Object {$_.PSIsContainer} | Sort-Object FullName（PowerShell），复制输出结果 → 在AionClaw对话窗口开头粘贴，并加一句：“以上是当前项目的完整目录结构，请据此理解模块关系。”
方法二：用自然语言精准描述关键锚点
例如：“项目根目录下有src/和config/两个文件夹；src里包含api/、core/、utils/三个子目录；所有Python入口文件都在src/core/main.py和src/api/server.py；config/db.yaml和config/app.env是全局配置源。”——比笼统说“这是个Django项目”有效十倍。
绑定.git仓库并启用结构感知
第一步：确保项目已初始化Git仓库（无远程地址也可）
第二步：在AionClaw中进入「安全保护」→「权限管理」→ 找到「文件系统访问」→ 点击「重载项目元数据」按钮
第三步：等待右上角弹出绿色提示“已识别.git，结构索引完成”，此时AionClaw会自动提取.gitignore规则、分支名、最近三次commit涉及的文件路径，用于反推模块权重和依赖流向。
【若项目未初始化git，此功能完全不可用，且不会降级提示】
