You need to enable JavaScript to run this app. 如何使用Python读取、修改或删除Windows剪贴板全部历史记录
优惠活动
大模型
产品
解决方案
定价
更多

如何使用Python读取、修改或删除Windows剪贴板全部历史记录

Windows剪贴板历史的Python操作方案

前提条件

  • 首先确认你的Windows系统已经开启剪贴板历史功能:按下Win + V可以唤起历史面板即代表已开启,未开启的话需要先在「设置 - 系统 - 剪贴板」中打开开关,唤起的面板样式如下:
    Windows剪贴板历史面板
  • 需要用到微软官方提供的WinRT Python绑定库,安装命令:pip install winsdk(旧版winrt包已停止维护,推荐使用最新的winsdk)

功能实现代码

1. 读取所有剪贴板历史记录

import asyncio
from winsdk.windows.applicationmodel.datatransfer import Clipboard, ClipboardHistoryItemsResult

async def get_clipboard_history():
    # 申请剪贴板历史访问权限
    access_status = await Clipboard.request_history_access_async()
    if access_status.value != 1: # 1对应允许访问的状态枚举值
        print("无法访问剪贴板历史,请检查系统权限设置")
        return []
    # 拉取所有历史条目
    history_result: ClipboardHistoryItemsResult = await Clipboard.get_history_items_async()
    if not history_result.items:
        return []
    history_list = []
    for item in history_result.items:
        # 仅提取文本内容,图片、文件等其他格式可按需扩展对应读取方法
        if item.content.available_formats.contains("Text"):
            text_content = await item.content.get_text_async()
            history_list.append({
                "id": item.id,
                "content": text_content,
                "timestamp": item.timestamp.datetime
            })
    return history_list

if __name__ == "__main__":
    history = asyncio.run(get_clipboard_history())
    for idx, item in enumerate(history):
        print(f"第{idx+1}条 | 复制时间:{item['timestamp']} | 内容:{item['content']}")

2. 删除指定剪贴板历史条目

需要传入对应条目的ID(可从读取接口返回的字段中获取)

async def delete_clipboard_item(item_id: str):
    return await Clipboard.delete_item_from_history_async(item_id)

# 调用示例:asyncio.run(delete_clipboard_item("待删除条目对应的ID"))

3. 清空全部剪贴板历史

async def clear_all_clipboard_history():
    return await Clipboard.clear_history_async()

# 调用示例:asyncio.run(clear_all_clipboard_history())

4. 将指定历史条目设置为当前剪贴板内容

async def set_history_item_as_current(item_id: str):
    return await Clipboard.set_history_item_as_current_async(item_id)

注意事项

  • 上述接口仅支持Windows 10 1809及以上版本,低于该版本的系统没有原生剪贴板历史功能,无法使用。
  • 微软官方未开放直接修改历史条目内容的API,如需修改某条历史内容,可先读取条目内容修改后复制到剪贴板,再删除原有历史条目即可实现等效效果。
  • win32clipboard、pyperclip等库仅对接了传统Windows剪贴板接口,只能访问最近一次复制的活跃剪贴板内容,因此无法读取历史记录。

内容的提问来源于stack exchange,提问作者Yash Kolekar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 21:45:04