监听剪贴板需轮询，推荐0.5～1.0秒间隔并用MD5哈希比对；翻译优先选LibreTranslate，加源语言检测与UTF-8编码保存；须过滤非文本、控制字符及HTML，跳过图片等不可译内容。
监听剪贴板变化必须用轮询，pyperclip 本身不触发事件
Python 标准库没有剪贴板变更事件机制，pyperclip 只提供 paste() 和 copy() 两个同步操作函数。想“监听”，只能靠定时轮询——读取当前内容，和上一次比对。这不是缺陷，是 Windows/macOS/Linux 剪贴板 API 的共性限制。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 轮询间隔别设
0.1秒：太频繁会吃 CPU，也容易把用户连续复制的多个片段误判为多次变更；推荐0.5～1.0秒 - 用字符串哈希（如
hashlib.md5(text.encode()).hexdigest()）比对内容，避免空格、换行等细微差异导致误触发 - 首次启动时先调用一次
pyperclip.paste()获取初始值，否则第一次比对总命中 - Windows 下若遇到
PyGetClipboardData: empty clipboard类错误，加try/except忽略即可，属正常竞争态
翻译接口选 googletrans==4.0.0rc1 还是 deep-translator
googletrans 旧版（3.x）已失效，新版 googletrans==4.0.0rc1 可用但不稳定：常因 User-Agent 或频率被返回空结果；deep-translator 更可靠，内置多个免费后端（GoogleTranslator、LibreTranslate、MyMemoryTranslator），且支持离线 fallback。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 优先用
LibreTranslate（本地部署或调https://libretranslate.de公共 API），无需密钥，响应快，无配额限制 - 若必须用 Google，加
sleep(1)间隔请求，避免被限流；不要在轮询循环里直接调用，应单独封装并带重试 - 翻译前先用
langdetect.detect(text)判定源语言，避免硬编码src='auto'在短文本下翻车（比如 “yes” 可能被误判为西班牙语） - 目标语言固定为
target='zh'即可，不用动态切换——自动翻译场景里用户极少临时改目标语种
保存翻译结果到文件时，os.path.join() 和时间戳命名缺一不可
直接写死路径如 'output.txt' 会导致每次覆盖；用 datetime.now().strftime('%Y%m%d_%H%M%S') 生成文件名虽能防覆盖，但没考虑目录是否存在、权限是否足够、路径跨平台兼容性。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 保存目录用
Path.home() / 'Desktop' / 'clip_trans'（pathlib写法），比拼接字符串更安全 - 创建目录前加
os.makedirs(save_dir, exist_ok=True)，避免首次运行报FileNotFoundError - 文件名格式建议：
f"trans_{int(time.time())}_{hashlib.md5(text.encode()).hexdigest()[:6]}.txt"，兼顾唯一性、可读性和长度控制 - 写入用
encoding='utf-8'显式指定，否则 Windows 记事本打开中文可能乱码
完整流程中最大的坑是剪贴板内容类型混杂
用户复制的不只有纯文本：可能是图片、HTML 片段、富文本格式（如从 Word 复制带样式的文字）、甚至二进制数据。直接喂给翻译器会抛 UnicodeDecodeError 或返回乱码。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 调
pyperclip.paste()后立刻用isinstance(text, str)和len(text.strip()) > 0过滤非字符串/空白内容 - 用正则
re.sub(r'[\x00-\x08\x0b\x0c\x0e-\x1f\x7f-\x9f]', '', text)清除控制字符，再用html.unescape()解 HTML 实体（如&→&） - 若检测到
<html>或<body>开头，提取其中的纯文本（BeautifulSoup(text, 'lxml').get_text()），而非整段扔进去翻译 - 不处理图片或文件路径类剪贴板内容（如
file:///C:/.../image.png），直接跳过——翻译器无法处理，且这类内容通常也不需要翻译
真正难的不是调 API，而是让程序在用户随意复制各种东西时，既不崩、不卡、不误译，还能安静地把该存的文本存下来。边界情况比主流程更花时间。
