用途：面向 Python 的 Azure Storage File Share SDK，用于在云上管理 SMB 文件共享，适合云原生与迁移上云场景。
安装与环境：pip install azure-storage-file-share。需设置 AZURE_STORAGE_ACCOUNT_URL=https://<account>.file.core.windows.net（Entra ID 认证必需）；若生产环境使用 DefaultAzureCredential，设置 AZURE_TOKEN_CREDENTIALS=prod。
认证与生命周期：优先使用 DefaultAzureCredential，本地与 Azure 均可，无需改代码；避免连接字符串和账户/API 密钥。使用上下文管理器释放资源：同步 with <Client>(...) as client:；异步 async with <Client>(...) as client: 与 async with DefaultAzureCredential()（来自 azure.identity.aio）。
主要能力：共享操作（创建、列出、获取客户端、删除、创建快照）；目录操作（创建含嵌套目录、列出目录与文件、删除）；文件操作（上传字符串/文件/字节、下载为字节/文件/流式分块、获取属性、删除、从 URL 复制、上传与下载范围）；支持异步客户端。客户端类型包括 ShareServiceClient（账户级）、ShareClient（共享）、ShareDirectoryClient（目录）、ShareFileClient（文件）。
最佳实践：同步与异步不可混用，同一调用路径保持一致；始终使用上下文管理器；生产使用 Entra ID 与 RBAC；大文件用 chunks() 流式处理；重大变更前创建快照；设置配额控制成本；用范围做局部更新。参考文档见 references/capabilities.md 与 references/non-hero-scenarios.md。具体定价、平台限制等资料暂未提供。