Collections

收藏管理模块，提供收藏内容的浏览、搜索和操作。

Collections 方法

open()

打开收藏面板。

get_collections(count=None)

获取收藏列表。

• count int | None — 获取数量，None 获取所有可见
• 返回 List[Collection]

iter_collections(count=None, speed=100)

逐条遍历收藏（通过滚动）。

• Yields Collection

search(keyword)

搜索收藏。

• keyword str — 搜索关键词
• 返回 List[Collection]

get_visible_collections()

获取当前可见的收藏列表。

• 返回 List[Collection]

Collection 类

单条收藏项。

属性

属性	类型	说明
title	str	收藏标题
description	str	收藏描述
source	str	来源
time	str	收藏时间
name	str	原始名称
actions	List[str]	可用操作列表

方法

open()

打开查看收藏详情。

forward(nicknames, remark=None)

转发收藏给联系人。

• nicknames List[str] — 转发目标

delete()

删除收藏。

edit_tag()

编辑标签。

copy()

复制收藏内容。

copy_link()

复制链接。

save_as()

另存为。

read()

读取收藏内容。

• 返回 bytes | str — 二进制数据或文本内容

is_in_list()

控件是否存在于收藏列表的 UIA 树中。

• 返回 bool

is_visible()

控件是否完全在收藏列表的可视区域内。

• 返回 bool

scroll_to_visible()

滚动到可见区域。

• 返回 bool

收藏子类型

类	说明
NoteCollection	笔记收藏
FileCollection	文件收藏
LinkCollection	链接收藏
ImageCollection	图片收藏
VoiceCollection	语音收藏
MiniProgramCollection	小程序收藏
ChatHistoryCollection	聊天记录收藏
LocationCollection	位置收藏
MusicCollection	音乐收藏
VideoCollection	视频收藏
VideoAccountCollection	视频号收藏

示例

from pywxauto import Weixin

wx = Weixin()

# 搜索收藏
results = wx.collections.search("会议记录")
for item in results:
    print(f"{item.title} - {item.time}")

# 转发收藏
results[0].forward(["张三"])

# 遍历所有收藏
for item in wx.collections.iter_collections(count=50):
    print(item.title)