用途:调查任意代码库,自动检测数据流、文件 I/O 与脚本依赖,并产出结构化注释计划供人工完善。适用于熟悉陌生代码库、在无 PUT 注释的项目中启动 putior 集成、审计数据管道或为 annotate-source-files 做准备。
主要能力:通过 put_auto() 检测输入、输出与依赖;用 list_supported_languages()、get_supported_extensions()、get_detection_patterns() 查看语言与模式覆盖;用 put_diagram() 生成 Mermaid 流程图;用 put_generate() 生成注释建议。
使用方式:先调查仓库结构与语言覆盖,再运行 put_auto("./src/", detect_inputs=TRUE, detect_outputs=TRUE, detect_dependencies=TRUE),可加 exclude 排除构建或测试文件;随后用 put_diagram(workflow, theme="github") 可视化,用 put_generate("./src/", style="single") 生成建议,并整理注释计划。
限制:自动检测仅识别文件 I/O 与库调用,不覆盖业务逻辑,典型覆盖率约 40-60%;非标准扩展名可能无法识别;大型仓库建议按模块分析;若结果为空可尝试 log_level="DEBUG"。具体收费、平台与效果暂未提供。