用途：在 Python 中连接 TiDB 并使用 pytidb（基于 SQLAlchemy）定义表、执行 CRUD 与原生 SQL、事务，并在其上构建向量检索、全文检索、混合检索等搜索与 AI 功能。适合希望在 TiDB 上获得类 ORM 体验、或需要高层 API 实现搜索能力的场景，也提供可改造的可运行入门模板。若需先开通 TiDB Cloud 集群，可改用 tidbx（TiDB X）获取集群生命周期指引。
主要能力与资料：包含自包含指南，如 quickstart（单文件“连接→建表→插入→向量检索”）、search（向量/全文/混合检索的选择与注意事项）、demos（向量/混合/图像示例）、agent-apps（RAG/记忆/text2sql）、troubleshooting（连接、TLS、嵌入与索引/搜索问题）、custom-embedding（自定义嵌入函数，示例 BGE-M3）。模板包括 quickstart.py、crud.py、auto_embedding.py、vector_search.py、hybrid_search.py、image_search.py 及其数据加载器、custom_embedding_function.py、custom_embedding.py、rag.py、memory_lib.py、memory.py、text2sql.py；脚本有 validate_connection.py 用于连接与 SELECT 1 冒烟测试（支持参数或 DATABASE_URL）。
用法与规则：不要硬编码凭据，使用环境变量（.env）并说明所需变量；推荐 python -m venv .venv 并固定依赖以保证可复现；编辑 requirements.txt 时不要臆造 pytidb 版本，默认使用未固定版本，除非用户明确要求且版本已确认存在；示例保持最小可运行，除用户要求外避免绑定特定框架；动态值使用参数化 SQL 以防注入；交互环境中用 extend_existing、open_table 或 rows()==0 等模式避免“表已定义”错误。
限制：资料未提供具体定价、性能指标、支持平台、pytidb 具体版本号及完整安装命令，相关内容暂未提供。