用途：在改动不熟悉的代码库前，先获取一份“焦点图”，列出架构所依赖的排序符号，每条附 file:line 引用与证据类型，只读它指向的位置。适用于编辑陌生模块前查看调用关系、回答“X 如何工作”“改 Y 的影响”“谁还用了这个函数”、大型重构前列出关键文件，以及已知 diff 或改动文件后评估影响范围。不用于为 wiki 总结项目功能。
用法：obsidian-wiki code-understand --project <dir> [--backend auto|builtin|codegraph] [--changed <file>...] [--since <sha>] [--max-symbols N] [--pretty]。--project 默认当前目录；无 --changed/--since 时扫描全部跟踪文件；--changed 可重复，从指定文件播种；--since 从某 git 引用以来的改动播种；--backend 默认 auto，装有 CodeGraph 则用，否则回退内置提取器，builtin 为无依赖路径，codegraph 强制增强后端；--max-symbols 默认 50。若命令不可用或报错，跳过并回退到常规 grep/read 探索。
读输出：backend 为 codegraph 时条目是真实调用图的结构事实，可直接引用；为 builtin 时 defines/imports/changed-file 是事实，rg-reference 仅为文本匹配证据，需打开文件确认。焦点图只指示读哪里，不含源码正文，须打开所引 file:line 再判断架构，并在自己的输出中保留引用。它是可丢弃的缓存，不应写入 wiki、PR 描述或提交文档。
限制：增强跨文件调用图需安装 CodeGraph（npm install -g @colbymchenry/codegraph，或设置 CODE_UNDERSTANDING_CODEGRAPH_BIN），安装前须征得用户同意；可用 obsidian-wiki doctor --project <dir> 查看 code-understanding.* 能力行。其余平台、收费等信息暂未提供。