pasteboard.history

获取剪贴板历史记录。

声明

历史列表 = pasteboard.history([ 数量限制 ])

参数及返回值

• 数量限制 整数型 可选
  • 返回的最大条目数，0 或不传表示返回全部
• 历史列表 顺序表型
  • 返回剪贴板历史记录列表，最新的在前

说明

获取剪贴板历史记录。历史记录来源：

1. 通过 pasteboard.write 写入的内容
2. 系统剪贴板变化（需启动 ClipboardListenerService 监听服务）

最多保存 100 条历史记录，超出后自动删除最旧的记录。 相同内容不会重复记录。

示例

-- 获取全部历史
local history = pasteboard.history()
print("历史条数:", #history)
for i, item in ipairs(history) do
    print(i, item)
end

-- 获取最新 5 条
local recent = pasteboard.history(5)

Android 特性

在 Android 上，需要启动 ClipboardListenerService 前台服务才能监听系统剪贴板变化：

am start-foreground-service -n com.nbtouch/.ClipboardListenerService

未启动服务时，仅记录通过 pasteboard.write 写入的内容。