用途:该技能面向 Contentstack Management Python SDK 的开发与维护,适用于实现或修改 Client、Stack 及资源模块(条目、资产、Webhook 等),更新 README.md 或公开导出以反映用户可见行为,以及评估构造函数、方法或导出变更的 semver 影响。
主要能力与结构:主入口为 contentstack.py 中的 contentstack_management.Client,负责根据 region/host/scheme 构建 CMA 端点,合并 headers(authtoken、management_token、early_access),构造 _APIClient,并可选配置 oauth_config 与 OAuthHandler。Stack 位于 contentstack_management/stack/stack.py,管理栈级资源(内容类型、条目、资产、分支、Webhook 等);组织与用户相关模块位于 organizations/、users/、user_session/;资源包遵循既有模式;OAuth 相关代码在 oauth/oauth_handler.py 与 oauth/oauth_interceptor.py,需与 _APIClient 请求路径保持一致。
使用方式:扩展时在相应资源类上添加方法,路径与载荷结构需与 CMA 文档对齐;HTTP 请求优先通过 _APIClient 路由,以获得一致的超时、max_retries 重试与 OAuth 处理。_APIClient._call_request 是方法、URL、JSON、文件的集中处理点。
文档与版本:导出的 Client、Region 及 stack 辅助函数应与 README 和 contentstack_management.init.py 保持一致;对有意引入的破坏性变更需记录迁移说明。
限制:资料未提供具体安装命令、价格、平台支持范围或效果数据,暂未提供。