尚无译文的页面会以英语打开,并标注为英语。
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
C++、Python、TypeScript、Go、Rust、Java 和基础设施代码的代码智能
Loom 的代码索引回答编码 agent 在仓库所含各种语言中提出的结构问题:符号在哪里定义、谁调用了它,以及一次改动会影响什么。需要先添加仓库,并设置 LOOM_CODE_INGEST_ENABLED=true。每种语言都有快速层级,使用 tree-sitter 语法或手写扫描器解析;C/C++、Python、TypeScript 和 Go 还可以增加编译器层级,按编译器的方式解析名称。完整的扩展名和边列表见语言支持表,编译器层级的设置见代码索引运维。
每个答案都会标明其背后的层级(编译器层级为 tier: "scip",快速层级为 "treesitter"),code.coverage 会按语言和层级报告命名空间中包含的内容。对于你尚未在 Loom 中使用过的语言,在信任 code.callers 或 code.impact 的答案之前,请先查看它。
C 和 C++
符号、调用、include、继承和重写来自快速层级;编译器层级(scip-clang)根据项目的构建解析重载、模板和命名空间,因此对 DB::IMergeTreeDataPart::getBytesOnDisk 这样的限定名使用带 uses_brief: true 的 code.symbol,会返回唯一的定义、其调用点数量,以及主要调用点及其所在函数,每一项都标记为 tier: "scip"。编译器层级需要项目的 CMake 构建配置。
Python
调用、导入、继承和重写来自快速层级,其中包括 notebook 的代码单元;编译器层级(scip-python)可跨模块解析名称。在 Loom 自己的仓库中,对 writer_actor 使用 code.symbol,会在编译器层级返回其在 server/memory/app/provenance.py 中的定义,以及签名和文档字符串,加上 uses_brief: true 还会返回它的调用点。
TypeScript 和 JavaScript
调用(包括 new)、导入、继承和重写来自快速层级,Vue、Svelte 和 Astro 组件的脚本块也是如此;Angular 的 .component.html 模板会与其组件作为一个单元建立索引。编译器层级(scip-typescript)通过项目的 tsconfig.json、jsconfig.json 或 package.json 解析名称。
Go
调用、接口嵌入和结构化实现来自快速层级,Go 字符串中的 SQL 会变成表引用;编译器层级(scip-go)可跨包解析名称,包括 monorepo。
Rust 和 Java
Rust 支持调用、use 导入和 trait 实现;Java 支持调用(导入会绑定名称)以及 Java 字符串中的 SQL。两者都只有快速层级:在同一文件内绑定的调用置信度为 1.0,通过所在类绑定的为 0.8,通过全仓库名称匹配绑定的为 0.6,无法绑定的调用会被舍弃而不是猜测,并且 code.impact 会在文件级别补充映射的测试和共同变更的伙伴文件。
SQL 和迁移
默认情况下,.sql 文件会被索引用于搜索和 grep。开启 LOOM_CODE_SQL_STATEMENT_RECORDS 后,每条语句都会成为带有表引用的记录,这样 agent 就可以询问哪些迁移和查询读取或写入了某张表。对已建立索引的命名空间开启该选项,需要对这些 SQL 文件运行 loom code backfill --paths-file(开关)。
基础设施即代码
Terraform 和 HCL、Kubernetes 清单、Helm chart 和 Go 模板、Jsonnet、CMake、Protocol Buffers 以及 shell 脚本都会连同其引用、include 和调用一起建立索引,因此 agent 可以从 Helm 的 include 找到它的 define,或从 Terraform 引用找到它所指向的对象。开启 LOOM_CODE_HOST_ISLANDS 后,Dockerfile、Makefile、Jenkinsfile 和 CI YAML 作业会成为符号;如果命名空间已建立索引,则需要先对这些文件进行 backfill。
开始
- 为仓库建立索引。为其运行哪些编译器层级,见代码索引运维。
- 在
coding工具集上连接编码 agent。 - 提出结构问题;针对你所依赖的语言查看
code.coverage。