SuperAPI AI 工具集

mapping-codebases

编程与开发

查看项目

更新于 10-16 07:24

技能介绍

用途:该技能原本用于为代码库每个目录生成持久化的 _MAP.md 符号清单文件,扫描一次后可反复读取,用于代码库结构导航与符号查找。

现状:已弃用,官方建议改用 tree-sitting。原因是持久化映射存在固有代价:会过期、需要重新生成、可能被提交进版本库,还必须从其他遍历目录树的工具中排除。而 tree-sitting 在运行时做同样的 AST 提取,解析约 250 个文件的仓库约需 700ms,针对内存中 AST 的查询响应不到 1ms。

替代命令: 设置 TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py 原 codemap.py /path/to/repo 的根目录导航,改为:python3 $TREESIT /path/to/repo 原读取整棵树的 _MAP.md 获取完整清单,改为:python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse 原在 _MAP.md 中 grep 符号做直接查找,改为:python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'

归档版本:最后一个可用版本为 mapping-codebases-v0.8.0(2026-03-31),包含 scripts/codemap.py 和十一个打包的 parsers/*.so 语法文件。该版本存在一个未修复的潜在缺陷:codemap.py:1216 在 try 块中调用未导入的 get_parser(),而该异常被裸 except Exception 吞掉,导致 HTML 内联 JavaScript 的符号提取会静默返回空结果。该问题不会被修复。

限制:功能已被取代,不建议在新工作中使用;资料未提供安装方式、收费或平台信息。