用途：在使用 SpecklePy 编写 Python 代码以发送、接收或查询 Speckle 数据时提供实现参考，规避认证令牌、传输配置和几何对象处理中的常见错误。
主要能力：涵盖安装（pip install specklepy，要求 Python 3.10+ 并使用虚拟环境）、核心导入、SpeckleClient 构造与令牌/账户认证、资源模块（project、model、version、active_user、server、subscription、workspace 等）、operations 的 send/receive/serialize/deserialize、ServerTransport 三种认证路径、Base 对象模型与自定义对象、几何对象、可分离与分块属性、本地数据路径、错误处理与数据遍历策略。
必要用法与限制：令牌必须来自环境变量或密钥管理，禁止硬编码；几何对象须包裹在 Base 容器中否则不会出现在 3D 视图；避免在循环中调用 get_id()；ServerTransport.get_object() 未实现，应使用 operations.receive()；send() 不可同时 transports=None 且 use_default_cache=False；访问接收对象属性前先用 hasattr() 检查；术语使用 project/model/version，但 ServerTransport 仍用 stream_id 参数传项目 ID。
适用场景：Speckle 数据的 Python 端上传、下载、查询与遍历，BIM 数据处理等。
限制：资料未提供收费、价格、平台支持范围及效果保证等信息。