ClipMate 剪贴板

你在解决什么问题

复制粘贴是日常开发、写文档和排障里的高频动作，但系统剪贴板通常只保留最后一次内容。文本还好，一旦连续切换多段代码、链接或报错信息，旧内容就丢了；若还需要在 Agent 对话里程序化读写剪贴板或查询「刚才复制过什么」，单靠操作系统界面往往不够。

ClipMate 以一组 Python 函数把「当前剪贴板 + 本地历史」变成可查询、可恢复的数据面，面向 Hermes Agent 等集成场景，由 Agent 按你的自然语言意图调用 tool.py 中的接口。

技能如何工作

实现上依赖 tkinter.clipboard 做跨平台剪贴板读写，历史条目（含文本；资料中亦支持图片类内容的记录）写入本地 JSON，进程重启后仍可加载。

对外暴露的核心能力包括：

• get_clipboard() / set_clipboard(text)：读取或设置当前剪贴板文本
• list_history(count)：按时间取最近 N 条历史
• search_history(keyword)：用关键词在历史里检索
• clear_history()：清空本地历史

函数返回结构化 JSON，并配有中英文 docstring 与统一错误格式，便于 Agent 解析与重试。产品向能力（自动捕获、收藏置顶、历史上限与自动清理、点击粘贴等）在历史层与配置中体现；你在对话里说明「找刚才复制的」「搜某关键词」「清空历史」即可触发对应调用。

适用边界与注意点

• 依赖环境：需具备可用的 Python 与 tkinter（部分极简 Linux 环境可能缺 GUI/tkinter，剪贴板读写会受影响）。
• 范围：面向本机剪贴板与本地历史文件，不是云端同步或多设备共享方案。
• 集成方式：作为 Agent 工具运行，实际行为以 scripts/tool.py 源码与返回 JSON 为准；图片与文本的捕获细节以你部署版本为准。