适配CloudShell ≥8.1的cloudshell-shell及core包版本选择咨询

Hey there! 针对你开发兼容CloudShell 8.1及以上版本的CloudShell Shell需求，我整理了cloudshell-shell和cloudshell-shell-core两个包的版本选择建议，还有通用的版本匹配方案，帮你顺畅推进开发：

一、适配CloudShell ≥8.1的具体包版本 #

根据Quali官方的兼容规则，针对CloudShell 8.1及以上版本，你可以直接参考以下版本范围：

• cloudshell-shell-core：选择2020.1.0及以上版本。这个系列开始全面适配CloudShell 8.1+，后续的小版本（比如2020.1.1、2021.x.x等）也都保持向下兼容，建议优先选和目标CloudShell大版本匹配的包系列（比如CloudShell 9.x对应2021.x.x系列）
• cloudshell-shell：选择和cloudshell-shell-core完全一致的版本即可，比如前者用2020.1.3，后者也必须用2020.1.3——两者是配套设计的，版本不一致会引发依赖冲突或功能异常

二、通用版本选择方案 #

为了确保你的Shell和任意CloudShell版本完美兼容，建议遵循这几个核心原则：

1. 大版本号对齐：cloudshell-shell和cloudshell-shell-core的大版本号（比如2020.x.x、2021.x.x）要和CloudShell的大版本对应，对应关系大致是：
   • CloudShell 8.1 → 包版本2020.1.x
   • CloudShell 9.x → 包版本2021.x.x
   • CloudShell 10.x → 包版本2022.x.x
2. 双版本严格一致：务必保证cloudshell-shell和cloudshell-shell-core的版本完全相同，它们的API是深度耦合的，哪怕小版本差一位都可能导致奇怪的报错
3. 优先选最新稳定小版本：每个大版本下的最新稳定小版本通常修复了已知的兼容性bug，比如选2020.1.3而非2020.1.0，能减少踩坑概率
4. 特殊版本查兼容矩阵：如果你的目标CloudShell是带补丁的特殊版本，可以查看Quali官方提供的兼容矩阵，确认包的具体兼容版本（不过你需求是≥8.1，前面的版本范围已经完全覆盖）

小提示：开发时可以用这条命令安装指定版本的包，确保版本一致：

pip install cloudshell-shell==2020.1.3 cloudshell-shell-core==2020.1.3

内容的提问来源于stack exchange，提问作者shmir