Doxygen 交叉引用索引器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/doxygen-cross-reference-indexer。
技能介绍
解决什么问题
在 C/C++ 工程里,Doxygen 会产出 HTML/XML,但真正的交叉引用常常散落在页面、文件和符号表之间。排查一个函数被谁调用、某个类继承自哪里、头文件依赖如何传递时,人工翻页很容易漏掉间接引用。这个技能把已有的 Doxygen XML 输出整理成可搜索索引,让调用图、继承链和包含依赖不再是一次只能看一页的临时排查。
能力与工作路径
- 输入是 Doxygen 生成的 XML 产物,不要求当前项目额外暴露内部编译器数据。
- 使用
doxyparse解析符号与引用关系,把函数、类、头文件作为索引节点。 - 生成可搜索的交叉引用入口,便于按名称定位函数调用图、继承层次和 include dependency chains。
- 使用
doxygen-awesome-css主题组织展示结果,让生成的引用页面更适合在代码库内查阅。 - 适合跨 C/C++ 代码库做依赖回溯,例如确认某个接口的直接调用方、子类体系,以及头文件改动会牵动哪些翻译单元。
适用边界与注意事项
它依赖 Doxygen XML 的完整性;如果文档生成配置关闭了 XML、跳过符号或没有导出引用信息,索引会出现缺口。索引用于导航和审查,不能替代编译器诊断或静态分析对语义冲突的检查。当前资料没有自动抽取到可溯源的安装或使用说明,接入敏感工作流前应先审查上游仓库 https://github.com/1991513ccie-png/skills 的实现与权限边界。
使用场景
- 排查接口改动影响范围时,通过函数调用图确认该接口的所有直接调用方
- 修改公共头文件前,借助包含依赖链确认哪些源文件需要重新编译验证
- 接手 C++ 类库时,从继承层次索引梳理某抽象类的子类体系与继承路径
- 需要给团队提供可搜索符号入口时,把已有 Doxygen XML 输出整理成引用索引
适合人员
- C/C++ 后端工程师,需要在合并改动前确认调用关系和头文件影响范围
- 编译器或框架维护者,想为下游用户提供可搜索的符号文档索引
- 接手遗留 C++ 代码库的工程师,需要快速梳理继承体系与依赖链路
- 文档工具链工程师,负责把 Doxygen XML 产物整理成团队内部导航入口