软件开发工具包
Software Development Kit
学到 认得 就够：听到能明白
你可能会说
“示例代码总先导入一个 SDK，我不明白它与 API 的区别；如果换了工具包，为什么同一个服务的调用写法也会变化？”
SDK 是帮助开发者使用某个平台的一组代码、类型和辅助功能，通常包装 API 调用；它方便开发，但不是远程服务本身，也不自动带来访问权限。
使用 AI
科研里的例子
一个 Python 工具包把文献分类请求封装成简单函数；升级后方法名改变，任务逻辑可能没变，但脚本需要对照当前文档调整。
使用 SDK 可以少写网络请求、数据解析和错误处理代码，有些还封装流式响应、结构校验和重试。不同语言或版本的 SDK 可能暴露不同方法，所以不能只复制旧教程的函数名。服务能力仍由实际 API 和账号授权决定，SDK 只是调用方式之一。研究者读代码时先确认工具包名称、版本和请求目标，有助于区分本地报错与远程服务问题。
判断
亲手检查一次
记录所用 SDK 版本与官方文档，先跑最小公开样例；出错时检查是包版本、参数形式、认证还是服务返回问题。
它做不到的
安装 SDK 不等于安装了完整模型，也不等于能够离线使用；第三方包与官方包的维护、数据流和接口支持范围可能不同。
增量，由你来写
读完这张，你的理解变了什么？
留言功能会在后面的版本开放。现在可以先在 X 上 @knowledgedelta 告诉我。