Ⅰ qqbot與圖靈機器人搭建qq機器人（一）
本文檔介紹了一個名為qqbot的工具，它是一個基於Python實現的、用於構建QQ機器人的框架，適用於Linux、Windows和Mac OS X平台。qqbot支持多種擴展方式，包括命令行操作和Python代碼操作。
qqbot的安裝可以通過pip在Python 2.7/3.4+環境下進行，或者通過下載源碼解壓後使用"pip install ."命令。啟動qqbot時，會自動彈出二維碼圖片，用戶需用手機QQ客戶端掃碼並授權登錄。登錄信息會保存在本地文件中，以供下次啟動時嘗試從本地文件中恢復登錄信息。若二維碼自動彈出功能在特定系統下不可用，用戶可以手動打開二維碼圖片進行掃碼。qqbot啟動後，支持命令行操作，提供了list、update、send等命令。用戶可以將Python代碼文件保存為特定格式，載入到qqbot的插件目錄中，實現特定功能。
qqbot的介面提供了一系列功能，包括聯系人查詢、更新、消息發送、群組管理等。使用這些介面時，需遵循一定的規則，如只能向好友、群或討論組發送消息，而不能向群成員或討論組成員發送消息。介面在設計時考慮了非同步操作，如更新聯系人列表。此外，qqbot還支持注冊回調函數，包括初始化、二維碼掃描、啟動完成、周期性任務、插件載入、插件卸載、退出等事件。用戶可以通過注冊這些回調函數來擴展qqbot的功能。
在配置方面，qqbot提供了一個配置文件用於保存用戶自定義配置，包括登錄信息、聯系人列表獲取、自動重啟、後台運行、調試模式、插件配置等。配置文件的使用方法和優先順序也得到了詳細說明。在啟動qqbot時，可以指定工作目錄和不同的命令行參數來改變默認配置。此外，qqbot支持二維碼的四種顯示模式：GUI模式、郵箱模式、伺服器模式和文本模式。
插件是qqbot擴展功能的重要組成部分，用戶可以通過編寫Python模塊來實現特定功能。插件可以是單個Python文件或一個包含多個模塊的Python包。用戶可以通過多種方式載入和卸載插件，包括動態載入、啟動時自動載入和通過配置文件載入。
智能QQ協議（SmartQQ）是qqbot支持的核心協議，qqbot實現了大部分協議功能。但由於協議本身的限制，某些功能可能沒有理想解決方案。
通過本文檔的介紹，用戶可以深入了解qqbot的使用方法、配置選項以及插件擴展，從而構建出功能豐富的QQ機器人。