参与贡献

贡献代码前请阅读 agent-guide.md。本仓库长期有效的 coding、testing 和文档规则都在这里维护。

设置本地 editable 安装：

python3 -m venv .venv
.venv/bin/pip install -e ".[dev,duckdb,trino]"

请使用仓库提供的 entrypoints，不要直接调用裸 Python 工具：

make format
make lint
make typecheck
make test
make examples-check

在这个仓库中，Python 相关命令不要使用裸 python、pytest、mypy 或 ruff。请使用 make entrypoints，或使用明确的 .venv/bin/... 路径。

保持变更范围清晰。行为变化需要同步更新相关用户文档或 API 文档。不要把内部规划 material 当成用户文档发布。