Lance 工程规范全景从文件格式兼容性到测试、文档与审查的实战指南【免费下载链接】lanceOpen Lakehouse Format for Multimodal AI. Convert from Parquet in 2 lines of code for 100x faster random access, vector index, and data versioning. Compatible with Pandas, DuckDB, Polars, Pyarrow, and PyTorch with more integrations coming..项目地址: https://gitcode.com/GitHub_Trending/la/lance本文基于 Lance 仓库根目录的 AGENTS.mdCLAUDE.md是它的符号链接系统讲解这套项目级工程规范包括文件格式的稳定/不稳定兼容契约、日常开发命令矩阵、跨语言绑定约定、测试标准与 Issue/PR 流程。读完后你可以准确理解 Lance 为什么能在多语言生态Rust/Python/Java下保持核心逻辑集中、格式演进与向后兼容可控并按规范完成一次合格的贡献流程。一、规范文档的定位一棵“根规范 子目录规范”的体系AGENTS.md 开篇即给出项目定位Lance is a modern columnar data format optimized for ML workflows and datasets, providing high-performance random access, vector search, zero-copy automatic versioning, and ecosystem integrations. The vision is to become the de facto standard columnar data format for machine learning and large language models.文档同时声明自己是“跨语言通用层”并把语言/目录专属的规则下放到各子目录的指南中rust/AGENTS.md — Rust 代码风格、并发spawn_cpu、错误处理等python/AGENTS.md — Python 环境与uv run make lint等工作流java/AGENTS.md — Java 侧规范protos/AGENTS.md — protobuf 文件规范docs/src/format/AGENTS.md — 格式文档规范从仓库结构看这个“根规范 子目录规范”的写法与多语言仓库的布局一一对应Rust 核心在 rust/lance、lance-file、lance-index、lance-io等 20 余个 cratePython 绑定在 python/含pyproject.toml、uv.lockJava 绑定在 java/含java/lance-jni的 JNI 层。规范的分层正是为了避免一份巨型文档里混杂各语言工具链细节。二、文件格式稳定性与兼容契约这是 Lance 作为“列式数据格式”最核心的工程约束AGENTS.md 将其拆为两部分。2.1 稳定格式 持久兼容契约不稳定格式 可随意丢弃凡被标记为stable的文件格式都是持久兼容契约任何改动必须同时保持向后与向前兼容凡被标记为unstable的文件格式视为一次性产物允许自由变更不要为旧的不稳定版本添加兼容代码、迁移、回退或测试兼容性的基准是“最新已发布的稳定版本”同时继续遵守所有稳定格式契约只存在于当前分支或main上的改动不构成兼容约束——不要为了迁就这些中间态而牺牲更干净、更完整的设计。2.2 遗留兼容边界Legacy Compatibility Boundaries当前 writer 已不再产出的格式与代码路径视为冻结的兼容面保留其现有读取行为但不参与新特性设计除非明确要求遗留支持新特性只实现在当前格式与写入路径上——不扩展遗留 writer、不往遗留 reader 里塞新能力、不把遗留实现当作新代码的基础特性开发中避免重构遗留代码若共享边界使遗留改动不可避免则隔离改动、保留既有行为并使用“已发布的历史 fixture”补充针对性回归覆盖。最后一条在仓库里有直接印证test_data/ 目录按版本归档了历史数据集如 test_data/v0.10.15/、test_data/v0.36.0/ 等每个版本目录都带一个datagen.py用于可复现地生成该版本数据——这正是“已发布历史 fixture”的落地形态。三、开发命令矩阵RustAGENTS.md 给出了一套固定的 Rust 命令约定全部基于仓库根目录执行用途命令类型检查cargo check --workspace --tests --benches全量测试cargo test --workspace单包单测cargo test -p package test_nameLintcargo clippy --all --tests --benches -- -D warnings格式化cargo fmt --all分支覆盖率cargo nightly llvm-cov -q -p crate --branch覆盖率 HTMLcargo nightly llvm-cov -q -p crate --branch --html单文件覆盖率python ci/coverage.py -p crate -f file_path配套三条 profile 使用规则使用仓库定义的 Cargo profile而不是临时拼 LTO 参数。根 Cargo.toml 中确实定义了[profile.bench]opt-level 3、debug true与[profile.ci]line-tables-only调试信息、禁用增量编译并对非 workspace 成员依赖关闭 debug 信息以改善缓存复用等仓库级 profile。基准测试与性能分析使用release-with-debug优化构建同时保留调试符号无需为 profile 重新编译。Python 侧构建文档 python/DEVELOPMENT.md 中给出了实际用法uv run maturin develop --uv --profile release-with-debug --extras benchmarks --features datagen。release-no-lto仅用于本地调试、IO 瓶颈基准、以及“编译时间本身是被测对象”且 LTO 不影响瓶颈测量结论的场景。单文件覆盖率脚本对应仓库内真实文件 ci/coverage.py可直接配合上面的命令使用。四、语言专属环境契约规范用一整节AGENTS.md约束“在哪个目录就用哪套环境”做语言相关任务前必须先读对应子目录指南如python/任务读 python/AGENTS.md中的环境与命令规则不要因为某条命令“看起来缺失、不可用或太慢”就擅自换环境管理器或工具链如果命令在文档规定的工作流之外失败首先视为环境用法错误先修正用法、按规范命令重跑最后才能下结论“依赖/工具不可用”。对 Agent 自动化流程这一节的价值在于防止“工具链漂移”——例如在python/下绕过uv直接用系统 pip 安装依赖就会与uv.lock锁定的环境不一致。五、编码标准5.1 通用原则代码、示例、注释一律使用英文代码为可读性而写只写有信息量的注释与测试注释解释非显然的“为什么”而不是复述代码做了什么合并前移除调试打印println!、dbg!、print()改用tracing或日志框架——这与子指南 rust/AGENTS.md 中“按受众选择日志级别debug!/info!/warn!”的细则衔接克制新增 helper只有当它实质降低认知负担或消除大量重复时才引入禁止只做改名/转发的薄封装保持 PR 聚焦禁止顺手重构、重排格式等“搭车改动”注意内存避免把RecordBatch流全部收集进内存行选择用RoaringBitmap而不是HashSetu32——子指南中进一步要求用RowAddress/RowAddrTreeMap而不是裸VecRangeu64表示物理行选择见 rust/AGENTS.md。5.2 跨语言绑定Rust / Python / Java这是多语言仓库最有价值的一组约束Python 与 Java 绑定保持“薄封装”——校验与核心逻辑集中在 Rust 核心仓库结构印证了这一点python/src/ 与 java/lance-jni/src/ 下的.rs文件如dataset.rs、scanner.rs、transaction.rs都是 FFI 转发层真正实现在rust/下各 crate参数名在所有绑定中保持一致——要么全部改要么都不改绝不破坏公开 API 签名用#[deprecated]/deprecated标记旧 API 并新增方法互相排斥的布尔 flag 应合并为单个 enum/模式参数。5.3 命名变量按值“是什么”命名partition_id而不是mask——精确命名即内联文档结构体/模块已隐含领域语义时去掉冗余前缀全 API 与文档统一用indices而非indexes——仓库里可以印证Python 绑定源码目录即为 python/python/indices/API 名使用存储无关术语如base而不是bucket重命名类型/结构体/枚举时同步更新所有引用方法、字段、变量、测试名。5.4 错误处理在 API 边界校验输入并以描述性错误拒绝非法值绝不静默 clamp/修正builder/配置中互相排斥的选项必须校验同时设置时抛出明确错误错误信息带完整上下文变量名、值、大小、类型。子指南 rust/AGENTS.md 将这些细化到了 Rust 层面库代码中禁止.unwrap()/panic!()按根因匹配错误变体invalid_input/corrupt_file/not_found/io计数与 ID 用checked_add/checked_mul而非wrapping_*等。5.5 依赖管理优先用标准库或 workspace 已有依赖实现功能再考虑新增外部 crateCargo.lock的变更必须是有意的回退不相关的依赖升版坏掉的依赖用注释 上游 issue 链接的方式固定版本三个锁文件规则仓库有根Cargo.lock、python/Cargo.lock、java/lance-jni/Cargo.lock 三个锁文件后两者不在 workspace 内。修改workspace.dependencies后必须同步全部三个——用cargo check --manifest-path python/Cargo.toml和cargo check --manifest-path java/lance-jni/Cargo.toml刷新后提交cargo-lock-sync预提交钩子负责离线兜底可选/领域相关的依赖放在 Cargo feature flag 后面领域功能geo、NLP优先独立成 crate——仓库中lance-geo、lance-tokenizer等独立 crate 即为这种组织方式的体现。六、测试标准AGENTS.md 的测试标准可以概括为一条铁律加若干量化约定所有 bugfix 与特性必须带测试不写测试不合并单测 1 秒预算每个用例在典型开发机上应 1 秒内跑完用最小的 fixture/模型保持断言行为不允许为赶时间放宽断言、覆盖率或 recall 阈值参数化测试Rust 用rstestPython 用pytest.mark.parametrizeRust 侧用#[case::{name}(...)]给可读的用例名测试中的print()必须换成assert——打印抓不到回归扩展已有测试而不是新增重叠用例跳过测试必须链接 issue——禁止裸pytest.mark.skip或Ignore数据集操作读、索引、扫描必须覆盖多 fragment 场景索引测试必须覆盖 NULL 边界null 元素、全 null 集合、空集合、null 列向量索引测试必须断言 recall 指标0.5 阈值而不是只验证“创建成功”向后兼容测试使用 test_data/ 中检入的旧版本数据集配套datagen.py需断言所用 Lance 版本读取用copy_test_data_to_tmp——该工具在 rust/lance/src/dataset/tests/dataset_versioning.rs 等测试中实际使用测试工具函数可用#[cfg_attr(coverage, coverage(off))]跳过覆盖率统计。6.1 doctest 的正确写法规范明确要求不要在 doctest 中用ignore而是写成“可编译的函数包裹”/// /// # use lance::{Dataset, Result}; /// # async fn test(dataset: Dataset) - Result() { /// dataset.delete(id 25).await?; /// # Ok(()) /// # } /// 这样 doctest 在cargo test中真实编译并校验类型签名而不是被跳过。七、文档标准所有公开 API 必须有带示例的文档并链接到相关结构体与方法层级结构编码层、文件格式、存储布局用ASCII 树形图表达文档示例必须与实际 API 签名保持同步——重构时同步更新MkDocs admonition!!! note等下的内容用 4 空格缩进——这与 docs/ 使用 MkDocs 的站点结构一致见 docs/mkdocs.yml提交前校对注释与文档的拼写。八、Issue 与 PR 流程8.1 提交 Issue通过gh issue create或 API 创建 issue 时必须显式带标签--label bug/--label feature/--label performance。因为 API 路径绕过了.github/ISSUE_TEMPLATE表单标签不会自动打上标题前缀与标签保持一致bug: ...、feature: ...、perf: ...。内容型 labeler.github/workflows/issue-labeler.yml只把它当作兜底信号显式--label才是可靠路径。8.2 创建 PR建 PR 前先搜索相似 PR、检查 issue 关联的 PR避免重复劳动PR 标题必须遵循 Conventional Commits因为 .github/workflows/pr-title.yml 会用 commitlint 校验标题与正文前缀为feat:、fix:、docs:、perf:、ci:、test:、build:、style:、chore:必要时加 scope建/更新 PR 前对每个被触碰的语言面都跑 lint即使开销大Rust 改动跑cargo fmt --all和cargo clippy --all --tests --benches -- -D warningsPython 改动按 python/AGENTS.md 的环境工作流在python/下执行uv run make lint无法运行某项检查时必须在 PR 摘要中显式说明阻塞原因。九、审查指南少即是多AGENTS.md 把审查者/维护者的注意力视为“最昂贵的资源”并给出三条极简原则简洁清晰只聚焦P0/P1 问题严重 bug、性能劣化、安全关切不复述已经改清楚的细节不重复夸奖已做好的部分常规检查面命名一致性、错误处理模式、测试覆盖。十、速查规范要点与仓库证据对照规范主题关键规则仓库证据格式兼容stable 格式双向兼容unstable 可随意变AGENTS.md遗留代码冻结兼容面新特性走当前写路径test_data/ 历史 fixture开发命令固定 cargo 命令 仓库 profileCargo.toml、ci/coverage.py跨语言绑定薄封装、参数名一致、API 不破坏python/src/、java/lance-jni/src/依赖锁文件三个 lockfile 必须同步python/Cargo.lock、java/lance-jni/Cargo.lock测试1 秒预算、recall 0.5、多 fragment、NULL 边界test_data/ 各版本datagen.pyIssue/PR显式 label、Conventional Commits 标题.github/workflows/issue-labeler.yml、.github/workflows/pr-title.yml这套规范的可读之处在于它把“格式项目最难的兼容性问题”第二、六节和“多语言协作最容易失序的问题”第四、五节都变成了可执行的检查项并且每条规则都能在仓库中找到对应的命令、脚本、fixture 或 CI 工作流作为落点。对照本文表格逐条执行基本就是一次符合 Lance 社区标准的贡献流程。【免费下载链接】lanceOpen Lakehouse Format for Multimodal AI. Convert from Parquet in 2 lines of code for 100x faster random access, vector index, and data versioning. Compatible with Pandas, DuckDB, Polars, Pyarrow, and PyTorch with more integrations coming..项目地址: https://gitcode.com/GitHub_Trending/la/lance创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Lance 工程规范全景：从文件格式兼容性到测试、文档与审查的实战指南
Lance 工程规范全景从文件格式兼容性到测试、文档与审查的实战指南【免费下载链接】lanceOpen Lakehouse Format for Multimodal AI. Convert from Parquet in 2 lines of code for 100x faster random access, vector index, and data versioning. Compatible with Pandas, DuckDB, Polars, Pyarrow, and PyTorch with more integrations coming..项目地址: https://gitcode.com/GitHub_Trending/la/lance本文基于 Lance 仓库根目录的 AGENTS.mdCLAUDE.md是它的符号链接系统讲解这套项目级工程规范包括文件格式的稳定/不稳定兼容契约、日常开发命令矩阵、跨语言绑定约定、测试标准与 Issue/PR 流程。读完后你可以准确理解 Lance 为什么能在多语言生态Rust/Python/Java下保持核心逻辑集中、格式演进与向后兼容可控并按规范完成一次合格的贡献流程。一、规范文档的定位一棵“根规范 子目录规范”的体系AGENTS.md 开篇即给出项目定位Lance is a modern columnar data format optimized for ML workflows and datasets, providing high-performance random access, vector search, zero-copy automatic versioning, and ecosystem integrations. The vision is to become the de facto standard columnar data format for machine learning and large language models.文档同时声明自己是“跨语言通用层”并把语言/目录专属的规则下放到各子目录的指南中rust/AGENTS.md — Rust 代码风格、并发spawn_cpu、错误处理等python/AGENTS.md — Python 环境与uv run make lint等工作流java/AGENTS.md — Java 侧规范protos/AGENTS.md — protobuf 文件规范docs/src/format/AGENTS.md — 格式文档规范从仓库结构看这个“根规范 子目录规范”的写法与多语言仓库的布局一一对应Rust 核心在 rust/lance、lance-file、lance-index、lance-io等 20 余个 cratePython 绑定在 python/含pyproject.toml、uv.lockJava 绑定在 java/含java/lance-jni的 JNI 层。规范的分层正是为了避免一份巨型文档里混杂各语言工具链细节。二、文件格式稳定性与兼容契约这是 Lance 作为“列式数据格式”最核心的工程约束AGENTS.md 将其拆为两部分。2.1 稳定格式 持久兼容契约不稳定格式 可随意丢弃凡被标记为stable的文件格式都是持久兼容契约任何改动必须同时保持向后与向前兼容凡被标记为unstable的文件格式视为一次性产物允许自由变更不要为旧的不稳定版本添加兼容代码、迁移、回退或测试兼容性的基准是“最新已发布的稳定版本”同时继续遵守所有稳定格式契约只存在于当前分支或main上的改动不构成兼容约束——不要为了迁就这些中间态而牺牲更干净、更完整的设计。2.2 遗留兼容边界Legacy Compatibility Boundaries当前 writer 已不再产出的格式与代码路径视为冻结的兼容面保留其现有读取行为但不参与新特性设计除非明确要求遗留支持新特性只实现在当前格式与写入路径上——不扩展遗留 writer、不往遗留 reader 里塞新能力、不把遗留实现当作新代码的基础特性开发中避免重构遗留代码若共享边界使遗留改动不可避免则隔离改动、保留既有行为并使用“已发布的历史 fixture”补充针对性回归覆盖。最后一条在仓库里有直接印证test_data/ 目录按版本归档了历史数据集如 test_data/v0.10.15/、test_data/v0.36.0/ 等每个版本目录都带一个datagen.py用于可复现地生成该版本数据——这正是“已发布历史 fixture”的落地形态。三、开发命令矩阵RustAGENTS.md 给出了一套固定的 Rust 命令约定全部基于仓库根目录执行用途命令类型检查cargo check --workspace --tests --benches全量测试cargo test --workspace单包单测cargo test -p package test_nameLintcargo clippy --all --tests --benches -- -D warnings格式化cargo fmt --all分支覆盖率cargo nightly llvm-cov -q -p crate --branch覆盖率 HTMLcargo nightly llvm-cov -q -p crate --branch --html单文件覆盖率python ci/coverage.py -p crate -f file_path配套三条 profile 使用规则使用仓库定义的 Cargo profile而不是临时拼 LTO 参数。根 Cargo.toml 中确实定义了[profile.bench]opt-level 3、debug true与[profile.ci]line-tables-only调试信息、禁用增量编译并对非 workspace 成员依赖关闭 debug 信息以改善缓存复用等仓库级 profile。基准测试与性能分析使用release-with-debug优化构建同时保留调试符号无需为 profile 重新编译。Python 侧构建文档 python/DEVELOPMENT.md 中给出了实际用法uv run maturin develop --uv --profile release-with-debug --extras benchmarks --features datagen。release-no-lto仅用于本地调试、IO 瓶颈基准、以及“编译时间本身是被测对象”且 LTO 不影响瓶颈测量结论的场景。单文件覆盖率脚本对应仓库内真实文件 ci/coverage.py可直接配合上面的命令使用。四、语言专属环境契约规范用一整节AGENTS.md约束“在哪个目录就用哪套环境”做语言相关任务前必须先读对应子目录指南如python/任务读 python/AGENTS.md中的环境与命令规则不要因为某条命令“看起来缺失、不可用或太慢”就擅自换环境管理器或工具链如果命令在文档规定的工作流之外失败首先视为环境用法错误先修正用法、按规范命令重跑最后才能下结论“依赖/工具不可用”。对 Agent 自动化流程这一节的价值在于防止“工具链漂移”——例如在python/下绕过uv直接用系统 pip 安装依赖就会与uv.lock锁定的环境不一致。五、编码标准5.1 通用原则代码、示例、注释一律使用英文代码为可读性而写只写有信息量的注释与测试注释解释非显然的“为什么”而不是复述代码做了什么合并前移除调试打印println!、dbg!、print()改用tracing或日志框架——这与子指南 rust/AGENTS.md 中“按受众选择日志级别debug!/info!/warn!”的细则衔接克制新增 helper只有当它实质降低认知负担或消除大量重复时才引入禁止只做改名/转发的薄封装保持 PR 聚焦禁止顺手重构、重排格式等“搭车改动”注意内存避免把RecordBatch流全部收集进内存行选择用RoaringBitmap而不是HashSetu32——子指南中进一步要求用RowAddress/RowAddrTreeMap而不是裸VecRangeu64表示物理行选择见 rust/AGENTS.md。5.2 跨语言绑定Rust / Python / Java这是多语言仓库最有价值的一组约束Python 与 Java 绑定保持“薄封装”——校验与核心逻辑集中在 Rust 核心仓库结构印证了这一点python/src/ 与 java/lance-jni/src/ 下的.rs文件如dataset.rs、scanner.rs、transaction.rs都是 FFI 转发层真正实现在rust/下各 crate参数名在所有绑定中保持一致——要么全部改要么都不改绝不破坏公开 API 签名用#[deprecated]/deprecated标记旧 API 并新增方法互相排斥的布尔 flag 应合并为单个 enum/模式参数。5.3 命名变量按值“是什么”命名partition_id而不是mask——精确命名即内联文档结构体/模块已隐含领域语义时去掉冗余前缀全 API 与文档统一用indices而非indexes——仓库里可以印证Python 绑定源码目录即为 python/python/indices/API 名使用存储无关术语如base而不是bucket重命名类型/结构体/枚举时同步更新所有引用方法、字段、变量、测试名。5.4 错误处理在 API 边界校验输入并以描述性错误拒绝非法值绝不静默 clamp/修正builder/配置中互相排斥的选项必须校验同时设置时抛出明确错误错误信息带完整上下文变量名、值、大小、类型。子指南 rust/AGENTS.md 将这些细化到了 Rust 层面库代码中禁止.unwrap()/panic!()按根因匹配错误变体invalid_input/corrupt_file/not_found/io计数与 ID 用checked_add/checked_mul而非wrapping_*等。5.5 依赖管理优先用标准库或 workspace 已有依赖实现功能再考虑新增外部 crateCargo.lock的变更必须是有意的回退不相关的依赖升版坏掉的依赖用注释 上游 issue 链接的方式固定版本三个锁文件规则仓库有根Cargo.lock、python/Cargo.lock、java/lance-jni/Cargo.lock 三个锁文件后两者不在 workspace 内。修改workspace.dependencies后必须同步全部三个——用cargo check --manifest-path python/Cargo.toml和cargo check --manifest-path java/lance-jni/Cargo.toml刷新后提交cargo-lock-sync预提交钩子负责离线兜底可选/领域相关的依赖放在 Cargo feature flag 后面领域功能geo、NLP优先独立成 crate——仓库中lance-geo、lance-tokenizer等独立 crate 即为这种组织方式的体现。六、测试标准AGENTS.md 的测试标准可以概括为一条铁律加若干量化约定所有 bugfix 与特性必须带测试不写测试不合并单测 1 秒预算每个用例在典型开发机上应 1 秒内跑完用最小的 fixture/模型保持断言行为不允许为赶时间放宽断言、覆盖率或 recall 阈值参数化测试Rust 用rstestPython 用pytest.mark.parametrizeRust 侧用#[case::{name}(...)]给可读的用例名测试中的print()必须换成assert——打印抓不到回归扩展已有测试而不是新增重叠用例跳过测试必须链接 issue——禁止裸pytest.mark.skip或Ignore数据集操作读、索引、扫描必须覆盖多 fragment 场景索引测试必须覆盖 NULL 边界null 元素、全 null 集合、空集合、null 列向量索引测试必须断言 recall 指标0.5 阈值而不是只验证“创建成功”向后兼容测试使用 test_data/ 中检入的旧版本数据集配套datagen.py需断言所用 Lance 版本读取用copy_test_data_to_tmp——该工具在 rust/lance/src/dataset/tests/dataset_versioning.rs 等测试中实际使用测试工具函数可用#[cfg_attr(coverage, coverage(off))]跳过覆盖率统计。6.1 doctest 的正确写法规范明确要求不要在 doctest 中用ignore而是写成“可编译的函数包裹”/// /// # use lance::{Dataset, Result}; /// # async fn test(dataset: Dataset) - Result() { /// dataset.delete(id 25).await?; /// # Ok(()) /// # } /// 这样 doctest 在cargo test中真实编译并校验类型签名而不是被跳过。七、文档标准所有公开 API 必须有带示例的文档并链接到相关结构体与方法层级结构编码层、文件格式、存储布局用ASCII 树形图表达文档示例必须与实际 API 签名保持同步——重构时同步更新MkDocs admonition!!! note等下的内容用 4 空格缩进——这与 docs/ 使用 MkDocs 的站点结构一致见 docs/mkdocs.yml提交前校对注释与文档的拼写。八、Issue 与 PR 流程8.1 提交 Issue通过gh issue create或 API 创建 issue 时必须显式带标签--label bug/--label feature/--label performance。因为 API 路径绕过了.github/ISSUE_TEMPLATE表单标签不会自动打上标题前缀与标签保持一致bug: ...、feature: ...、perf: ...。内容型 labeler.github/workflows/issue-labeler.yml只把它当作兜底信号显式--label才是可靠路径。8.2 创建 PR建 PR 前先搜索相似 PR、检查 issue 关联的 PR避免重复劳动PR 标题必须遵循 Conventional Commits因为 .github/workflows/pr-title.yml 会用 commitlint 校验标题与正文前缀为feat:、fix:、docs:、perf:、ci:、test:、build:、style:、chore:必要时加 scope建/更新 PR 前对每个被触碰的语言面都跑 lint即使开销大Rust 改动跑cargo fmt --all和cargo clippy --all --tests --benches -- -D warningsPython 改动按 python/AGENTS.md 的环境工作流在python/下执行uv run make lint无法运行某项检查时必须在 PR 摘要中显式说明阻塞原因。九、审查指南少即是多AGENTS.md 把审查者/维护者的注意力视为“最昂贵的资源”并给出三条极简原则简洁清晰只聚焦P0/P1 问题严重 bug、性能劣化、安全关切不复述已经改清楚的细节不重复夸奖已做好的部分常规检查面命名一致性、错误处理模式、测试覆盖。十、速查规范要点与仓库证据对照规范主题关键规则仓库证据格式兼容stable 格式双向兼容unstable 可随意变AGENTS.md遗留代码冻结兼容面新特性走当前写路径test_data/ 历史 fixture开发命令固定 cargo 命令 仓库 profileCargo.toml、ci/coverage.py跨语言绑定薄封装、参数名一致、API 不破坏python/src/、java/lance-jni/src/依赖锁文件三个 lockfile 必须同步python/Cargo.lock、java/lance-jni/Cargo.lock测试1 秒预算、recall 0.5、多 fragment、NULL 边界test_data/ 各版本datagen.pyIssue/PR显式 label、Conventional Commits 标题.github/workflows/issue-labeler.yml、.github/workflows/pr-title.yml这套规范的可读之处在于它把“格式项目最难的兼容性问题”第二、六节和“多语言协作最容易失序的问题”第四、五节都变成了可执行的检查项并且每条规则都能在仓库中找到对应的命令、脚本、fixture 或 CI 工作流作为落点。对照本文表格逐条执行基本就是一次符合 Lance 社区标准的贡献流程。【免费下载链接】lanceOpen Lakehouse Format for Multimodal AI. Convert from Parquet in 2 lines of code for 100x faster random access, vector index, and data versioning. Compatible with Pandas, DuckDB, Polars, Pyarrow, and PyTorch with more integrations coming..项目地址: https://gitcode.com/GitHub_Trending/la/lance创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考