编辑政策
DuckDB Lab 致力于为中文技术社区提供准确、实用、可复现的 DuckDB 技术内容。
内容标准
1. 技术准确性
- 所有技术文章基于 DuckDB 官方文档和实际测试编写
- 涉及代码示例的文章，会在测试环境中验证可执行性
- DuckDB 版本信息明确标注在文章底部
2. 版本标注
每篇技术文章底部会注明：
本文信息
DuckDB 版本：v1.x / v2.x (Alpha/Preview/Release)
最后验证：YYYY-MM-DD
测试环境：OS / CPU / RAM / Storage
代码仓库：GitHub（如有）
官方文档：https://duckdb.org/docs/
3. Benchmark 标准
涉及性能测试的文章遵循以下规范：
| 项目 | 要求 |
|---|---|
| DuckDB 版本 | 必须明确标注 |
| 测试环境 | CPU、RAM、OS、Storage 必须说明 |
| 数据集 | 数据来源、大小、行数必须说明 |
| 测试方法 | 查询语句、运行次数、缓存状态必须说明 |
| 结果报告 | 中位数、P95、基准对比必须报告 |
| 可复现性 | 提供 GitHub 代码仓库链接（如适用） |
4. Alpha/Beta 功能标注
- DuckDB v2.0 Alpha/Preview 功能明确标注为实验性功能
- 不提供已验证的生产环境代码示例
- 不将 Alpha 功能描述为已稳定发布的能力
内容分类
| 类型 | 说明 | 标注要求 |
|---|---|---|
| 技术教程 | 官方文档为基础 + 实际示例 | 需标注 DuckDB 版本 |
| 性能测试 | 有基准测试数据 | 需完整环境说明 + GitHub |
| 实战案例 | 生产环境经验总结 | 需说明适用场景和限制 |
| 新闻解读 | 官方公告的技术解读 | 需引用官方来源 |
| 商业推测 | 基于技术趋势的商业分析 | 明确标注为作者观点 |
原创性与引用
- 原创内容优先：基于本人实际测试和经验
- 引用官方文档：明确标注来源链接
- 引用他人成果：注明出处和作者
- 测试数据：如有公开数据集，提供生成脚本
更正机制
如发现文章中的错误，请参阅更正政策。
联系我们
如有编辑相关的问题或建议，请通过 GitHub Issues 或邮箱 [email protected] 联系我们。
本政策最后更新：2026-09-12