本仓库已使用 codebase-memory-mcp 建立本地代码知识图谱。当前索引项目名为
Volumes-e99bb7e794b5-project-MusicBleController。
对代码进行修改、重构、性能优化或缺陷排查前：
- 先调用
list_projects，并用index_status确认当前仓库索引可用。 - 索引不存在、状态异常或结果明显陈旧时，调用
index_repository，对当前仓库执行完整索引；除非用户明确要求，不生成仓库内持久化图谱文件。 - 使用
get_architecture或search_graph定位模块、类型和符号。 - 涉及调用关系、数据流或影响范围时，使用
trace_path和detect_changes。 - 使用
get_code_snippet获取精确符号位置，然后必须读取真实源文件再编辑。
- 图谱用于结构化发现，不是编译器或测试结果的替代品。
- 反射、依赖注入、系统回调、动态分派和生成代码可能无法完整建图；重要结论必须用源码、
rg、构建和测试验证。 - 字符串、错误信息、配置、脚本和非代码文件可直接使用
rg/文件读取工具搜索。 - 不得仅凭空结果断言“没有调用者”“未使用”或“无影响”；这类结论必须补充源码搜索。
- 编辑后使用
detect_changes检查结构影响，并运行与改动相关的测试或构建。 - 如果编辑后的图谱结果仍显示旧代码，重新运行
index_repository后再继续分析。