Settings
微信设置操作类，提供各类设置的读取和修改。
基本操作
open()
打开设置面板。
logout()
退出登录。
账号与安全
get_account_info()
获取账号信息。
- 返回
dict— 包含昵称、微信号、手机号等
get_login_method()
获取登录方式设置。
- 返回
str
set_login_method(method)
设置登录方式。
- method
str— 登录方式
存储管理
storage_path
获取当前文件存储路径。
- 返回
str
change_storage_path(storage_path=None)
修改文件存储路径。
is_auto_download_enabled()
是否开启自动下载。
- 返回
bool
set_auto_download(enable, size_mb=None)
设置自动下载。
- enable
bool— 开启/关闭 - size_mb
int | None— 自动下载大小限制（MB）
auto_download_size_mb
自动下载大小限制。
- 返回
int
is_keep_chat_history()
是否保留聊天记录。
- 返回
bool
set_keep_chat_history(enable)
设置是否保留聊天记录。
clear_all_chat_history()
清空所有聊天记录。
manage_storage()
打开空间管理。
- 返回
WindowControl
clean_redundant_data()
清理冗余数据。
clean_cache()
清理缓存。
get_storage_info()
获取存储空间信息。
- 返回
dict
通用设置
get_language() / set_language(language)
获取/设置界面语言。
get_translate_language() / set_translate_language(language)
获取/设置翻译目标语言。
get_appearance() / set_appearance(appearance)
获取/设置外观主题。
get_font_size() / set_font_size(size)
获取/设置字体大小。
- size
int— 字体大小
get_auto_translate() / set_auto_translate(enable)
自动翻译开关。
get_readonly_file() / set_readonly_file(enable)
只读模式打开文件。
get_show_search_history() / set_show_search_history(enable)
显示搜索历史。
get_auto_voice_to_text() / set_auto_voice_to_text(enable)
自动语音转文字。
get_use_system_browser() / set_use_system_browser(enable)
使用系统浏览器打开链接。
get_keep_window_on_screenshot() / set_keep_window_on_screenshot(enable)
截图时保持窗口。
get_hide_on_screen_share() / set_hide_on_screen_share(enable)
共享屏幕时隐藏微信。
get_auto_update() / set_auto_update(enable)
自动更新。
get_auto_start() / set_auto_start(enable)
开机自启动。
通知设置
get_notification_info()
获取所有通知设置。
- 返回
dict
set_notification_info(*, ...)
批量设置通知选项。
get_message_notification_sound() / set_message_notification_sound(enable)
消息通知声音。
get_voip_notification_sound() / set_voip_notification_sound(enable)
通话通知声音。
get_moment_notification_badge() / set_moment_notification_badge(enable)
朋友圈通知角标。
get_game_notification_badge() / set_game_notification_badge(enable)
游戏通知角标。
get_only_friend_interaction_reminder() / set_only_friend_interaction_reminder(enable)
仅好友互动提醒。
快捷键
get_shortcut_info()
获取快捷键配置信息。
- 返回
dict
reset_shortcuts()
重置所有快捷键为默认值。
插件管理
get_plugins()
获取已安装的插件列表。
- 返回
List[dict]
download_plugin(plugin_name)
下载安装指定插件。
- plugin_name
str— 插件名称 - 返回
bool
关于
current_version
当前微信版本号。
- 返回
str
get_about_info()
获取关于页面信息。
- 返回
dict
check_update()
检查更新。
- 返回
WeixinUpdate
open_help()
打开帮助页面。
upload_log()
上传日志。
open_feedback()
打开反馈页面。
open_privacy_agreement()
打开隐私协议。
open_service_agreement()
打开服务协议。
示例
python
from pywxauto import Weixin
wx = Weixin()
settings = wx.settings
# 获取账号信息
info = settings.get_account_info()
print(f"微信号: {info.get('account')}")
# 修改设置
settings.set_font_size(16)
settings.set_auto_voice_to_text(True)
settings.set_appearance("深色")
# 查看存储信息
storage = settings.get_storage_info()
print(f"存储路径: {settings.storage_path}")