Usage
- 先确认选型问题是否跨语言：数据库、分析、压缩或归档场景读取
references/data-storage.md；Telegram Bot 消息能力选择读取references/telegram-bot-api.md；语言生态库选择则读取对应语言参考文件。 - 引入或替换第三方库时优先使用偏好清单。
- 当工作负载同时具有多种特征、偏好清单未覆盖或与明确需求冲突时，先说明主要工作负载、取舍与建议；结论仍不明确时再向用户确认。
- 新增语言时创建
references/<language>.md；新增跨语言主题时创建聚焦该主题的 reference，避免将无关偏好堆入泛化的 general 文件。
General Preferences
- 哈希与密码派生按用途选择：普通数据校验、内容寻址、去重和缓存键等通用哈希场景默认优先 BLAKE3；用户密码存储与校验、基于密码派生加密密钥等需要抵抗离线暴力破解的场景默认优先 Argon2id。两者不可互换，不使用 BLAKE3、SHA-2 等快速哈希直接存储密码，也不使用 Argon2id 处理普通数据哈希。
- 使用 Argon2id 存储密码时优先采用成熟库的高层密码哈希接口，生成独立随机 salt，并保存包含算法版本、参数、salt 和摘要的 PHC 格式字符串；参数根据部署环境 benchmark，并支持在登录校验成功后检测和升级旧参数。用于密钥派生时保留重新派生所需的 salt 和参数，不直接持久化派生密钥。除非协议或合规要求，不默认选择 Argon2i、Argon2d、bcrypt 或 PBKDF2。
- 压缩算法默认优先在 snappy 与 zstd 之间按场景选择：偏低延迟/高吞吐时优先 snappy，偏更高压缩率与存储/传输成本时优先 zstd。尽量不要选择 gzip，因为它的速度和压缩率相比 snappy/zstd 通常没有显著优势；只有兼容既有协议、文件格式、客户端能力或运维工具链时再使用 gzip。
References
- 跨语言数据存储、分析、压缩与归档：
references/data-storage.md - Telegram Bot API 消息能力选择：
references/telegram-bot-api.md - Python:
references/python.md - Rust:
references/rust.md - Go:
references/go.md