Python 参考

本目录提供 Python 绑定的用户入口和 AI 可读参考。

当前入口

from x_api_rs.web import Client, WebProfile

Python 包名是 x-api-rs，导入模块名是 x_api_rs。公开 Web 能力必须通过 x_api_rs.web 命名空间访问。

不要使用旧入口：

• 根级 Client
• 根级功能模块
• Twitter facade
• src/python 或旧单 crate 目录结构

AI 参考文件

• llms.txt：Python 绑定精简入口索引。
• llms-full.txt：Python 绑定完整方法签名、示例和注意事项。

维护规则

新增、删除或修改 Python 公开 API 时，必须同步检查：

• src/py/src/**
• python/x_api_rs/x_api_rs.pyi
• python/x_api_rs/**/__init__.py
• docs/python/llms.txt
• docs/python/llms-full.txt

类型桩 python/x_api_rs/x_api_rs.pyi 是 Python 用户、IDE 和 AI 代码生成看到的公开 API 契约。