team/memory/design-patterns.md

name, description, type, originSessionId

name	description	type	originSessionId
设计模式与经验	PyWebView Bridge 通信模式和功能遗漏分析方法	reference	74c25b75-4539-4e2e-befc-145f81f71d59

设计模式与经验

最后更新: 2026-04-19

PyWebView Bridge API 通信模式

Desktop: Svelte 前端 + Python 后端，通过 pywebview JS Bridge 通信。

关键规则:

1. Bridge API 返回 JSON 字符串，前端解析
2. 剪贴板通过 Python 端 pyperclip（绕过 WebKitGTK 限制）
3. 敏感操作在 Python 端处理

功能遗漏分析方法

实现涉及数据存储的功能时，必须追踪端到端数据流：

数据从哪来？→ 谁处理？→ 存到哪里？→ 谁读取？→ 重启后能加载？

检查清单:

• 每个生成方法是否有对应保存方法
• config 中定义的路径是否有对应的读写逻辑
• UI 事件处理是否遗漏持久化步骤