用途：在编写 PyQGIS 脚本、访问要素、编辑图层或执行几何运算时提供语法与模式参考，帮助避免编辑会话违规、线程崩溃等问题。
主要能力：区分 Python 控制台、独立脚本、处理脚本与插件四种运行上下文及其初始化要求；整理 QgsFeature、QgsFeatureRequest、QgsGeometry、QgsSpatialIndex、QgsTask、QgsMessageLog、QgsMessageBar 等核心类；说明 QgsPointXY 与 QgsPoint 的选用；给出要素编辑、空间查询、后台任务、字段添加、椭球测量、坐标转换与基础符号化的决策树和示例模式。
必要用法：独立脚本需 QgsApplication([], False) 加 initQgis()，结束调用 exitQgis()；编辑要素须在 with edit(layer): 或 startEditing()/commitChanges() 内进行；后台任务不得访问 iface、QgsProject 或 Qt 控件，异常须内部捕获并返回 False；检查要素存在用 getFeatures() 加 setLimit(1)，不用 featureCount()；多线程中改用 QgsMessageLog 而非 print()；几何操作前检查 isNull()；地理坐标系测量用 QgsDistanceArea；增删字段后调用 layer.updateFields()；QgsProcessingContext 与 QgsProcessingFeedback 须在任务期间保持存活。
适用场景：QGIS 插件开发、批处理与 CLI 工具、地理处理算法、交互式编辑与空间查询。
限制：资料未提供具体版本兼容性、性能基准或安装步骤，相关细节暂未提供。