Python 库参考构建器

要解决的具体问题

Python 项目常依赖数十甚至上百个第三方库，开发者面临三个典型痛点：文档分散在源码、PyPI 页面与外部博客之间；内置的 help 函数只能查看已导入对象的摘要，无法批量获取全量信息；类型注解和用法示例要么缺失，要么需要人工翻找。这些问题在排查某个函数到底支持哪些参数，或者确认该库有没有现成的递归示例时尤为耗时。

核心能力与关键步骤

该技能使用标准库中的 ast 模块解析包源码结构，通过 importlib 直接读取已安装环境中的元数据，并集成 Sphinx autodoc 的文档生成能力。具体流程包括：

• 扫描目标包的初始化文件与子模块，定位公开接口。
• 提取每个函数或类的文档字符串、参数类型注解和返回值类型。
• 从模块级注释或文档字符串中抓取用法示例片段。
• 生成结构化的 Markdown 或 HTML 参考文档，支持全文搜索。

适用边界与注意点

该工具仅处理已通过标准包管理流程正确安装的包，未安装或仅存在于源码树中的库会被跳过。它依赖包内的文档字符串和类型注解规范，若原始代码未提供，则输出会缺失对应信息。此外，不处理动态生成的接口，例如通过特殊钩子动态创建的属性，这类对象无法被静态解析模块识别。