用途：指导开发者用 C++ 为 Kate 编辑器编写插件，基于 KTextEditor 框架、KDE Frameworks 与 Qt。
主要能力：给出插件基类实现（继承 KTextEditor::Plugin，含 createConfigWidget、readConfig、writeConfig、addView、removeView 等），使用 K_PLUGIN_FACTORY_WITH_JSON 注册并配套 metadata.json（含 ServiceTypes、Category、X-KTextEditor APIVersion）。系统插件目录 /usr/share/kate/plugins/，用户目录 ~/.local/share/kate/plugins/。
API 与用法：通过 KTextEditor/Document、View、Range、Cursor 操作文档与视图，如 insertText、replaceText、searchText、cursorPosition、selectionText、toggleFolding。CMake 使用 ECM、KF5（CoreAddons、Config、KTextEditor、WidgetsAddons）及 kcoreaddons_add_plugin，安装到 ${KDE_INSTALL_KTPLUGINDIR}。配置用 KSharedConfig/KConfigGroup 读写，并提供 ConfigMigrator 迁移；含 JsonThreadStorage、MemoryThreadStorage 的接口式存储，以及基于 QThread、QMutex、QWaitCondition、QMutexLocker 的任务队列与智能体循环。权限部分包含 PermissionManager 与 DocumentAccessController。测试用 QTest、QTEST_APPLESS_MAIN/QTEST_MAIN，并可 qt5_add_tests 或 add_test 集成。
适用场景：需要为 Kate 添加语言、编辑或自动化功能，并处理配置、线程与权限的 C++ 插件项目。
限制：资料仅覆盖上述技术内容，未提供具体依赖版本兼容范围、平台支持、许可证细节之外的发布或分发方式；示例代码以 Qt5/KF5 为主，Qt6 适配暂未提供。