你复制一段文字，通常不会马上知道它会在什么时候再次派上用场。可能是十分钟后，你要把刚才的命令贴回终端；也可能是下周，你要找回一张会议截图里的订单号。复制动作很短，真正花时间的是下一次寻找、确认和重新使用。
Syzygy 从这个小问题开始。它把剪贴板历史当作工作材料，而不是一次性缓存。每个条目都带有清楚的类型、预览和可用操作。你可以在本地搜索，也可以在需要时把选中的内容交给另一台已经配对的设备。同步是明确的选择，不是隐藏在页面背后的默认上传。
我们在设计这套工作流时，先写下了一个很实际的验收标准：断开网络之后，用户仍然应该能够找到刚才复制的内容；看到一个大文件时，用户应该知道它是否已经完整到达；按下回车时，系统应该说明它是在预览、下载，还是已经可以写入目标应用。
这些细节决定了剪贴板工具是否可靠。漂亮的列表只能帮助你第一次打开应用，稳定的状态和可恢复的操作，才决定你会不会在重要工作中继续依赖它。
先从一次复制动作看起
假设你从浏览器复制了一段带链接的说明。剪贴板里可能同时有纯文字、富文本和网页标记。再假设你从设计工具复制一个图标，里面还可能包含可渲染的图形和源内容。如果应用只看文件名或最后一种媒体类型，就会把这两次复制混成“文字”或“图片”。
Syzygy 会收集多个信号，再决定内容家族（document family）。它会查看实际字节、声明的媒体类型、文件名、文本结构和网页包装层。一个真正的 PDF 文件头，比一个叫做 notes.txt 的文件名更有说服力；一个完整的矢量图源内容，也不应该被网页外壳掩盖成普通 HTML。
识别完成后，条目会保存一个内容计划（content plan）。计划告诉界面应该用什么方式预览，哪些操作具有合法前提，以及哪些内容仍在等待本地化。这样，历史列表不需要猜测下一步，也不需要为每种格式维护一套互相矛盾的规则。
本地优先不是一句口号
本地优先（local-first）意味着当前工作所需的主要副本留在你的设备上。你可以在没有网络时打开已有条目、搜索短语、复制文本，并把编辑先保存为新的本地快照。网络仍然可以参与登录、设备配对、跨设备同步和你主动选择的在线服务，但这些边界都应该在动作开始前说清楚。
这和“完全不联网”是两件事。一个有用的工具可以使用网络，却不要求每次查看历史都先等待服务器。我们更关心的是：哪一份数据要离开设备，谁可以接收，失败之后本地工作是否仍然可继续。
你可以用一个简单测试判断产品是否真的遵守本地优先。先断开网络，打开最近条目，搜索一段已知文字，做一处修改，关闭应用，再重新打开。如果这些动作都能完成，你得到的是一份可工作的本地副本；如果页面只剩登录按钮，应用保存的可能只是远端投影。这个差异比宣传页上的“支持离线”更值得验证。
历史条目有自己的身份
每次复制都得到一个历史条目。条目身份不会因为你给它加标签、移动到回收站或从另一台设备下载正文而改变。稳定身份让搜索结果、预览窗口和同步任务可以指向同一份材料，也让删除和恢复不会意外创建重复条目。
条目保存标题、来源、时间、内容类型和可用的预览信息。大文件的正文属于内容块，可以在稍后传输。界面因此能够先显示“一个来自手机的 PDF”，再告诉你它是否已经拥有可打开的本地内容。知道存在，不等于已经完整；我们会把这两个状态分开显示。
内容计划还会记录文字表现（text representation）。一张截图可能只有图像表现，从设计工具复制的矢量图则可能同时拥有图形和源文本。源文本可以进入搜索、翻译或文本工作台，图形仍然可以按原来的视觉效果预览。保存两种视图，是为了让你在复用时不必在“保留外观”和“编辑内容”之间二选一。
预览应该帮助你做决定
预览不是缩略图墙。它回答的是一个具体问题：这份内容现在是什么，接下来哪一种动作最安全。纯文字显示可复制内容，Markdown 显示标题、列表和代码块，SVG 显示渲染图形，同时保留可以检查的源文本。PDF 预览保留页面排版，OCR 文字则作为额外的搜索和复制入口。
当内容尚未下载时，预览会显示等待中的状态和缺少的前提。它不会用一个空白面板让你猜测，也不会假装“打开成功”后再悄悄等待。你可以先修改标签、查看文件大小、选择下载，再决定是否把内容交给目标应用。
小卡片适合快速扫描，弹出窗口适合检查细节。两个界面消费同一份内容计划，所以从卡片切换到弹出窗口时，类型、状态和操作不会突然变一套。焦点也会回到打开窗口的控件，键盘用户不必重新寻找上下文。
命令面板（Command + K）连接意图和动作
在 macOS 上按 Command + K，在 Windows 或 Linux 上按 Ctrl + K，可以打开命令面板（Command Palette）。你可以先搜索页面，也可以输入 > 进入命令模式，然后用方向键选择动作并按回车确认。面板记住上一次成功执行的入口，并在下一次打开时把它放在第一项。
这份记忆只保存入口身份和少量显示信息，不会把剪贴板正文复制到第二份存储里。如果入口已经不存在，面板会丢弃过期记忆并回到普通列表；如果本地存储暂时不可用，命令仍然可以执行，只是不会更新记忆。记忆是导航帮助，不是另一套命令注册表。
回车键也不会绕过内容前提。远程图片需要先完成本地化，大型同步条目需要先拿到内容块，外部打开需要本地文件。系统会把“等待下载”和“物化失败”分开报告，避免用户以为目标应用收到了半截文件。
搜索不是把历史再复制一遍
本地索引（local index）保存条目的搜索投影。它可以包含标题、文件名、标签、来源、正文提取结果和 OCR 文字，但不应该成为第二份原始内容库。打开结果时，界面仍然回到历史条目，检查当前内容是否在本地、是否需要下载。
索引任务在后台运行。条目先进入历史，提取文字、渲染 PDF 页面或运行 OCR 可以稍后完成。搜索状态会显示“等待索引”“已完成”或“失败并可重试”。应用重启后，未完成的任务会从队列恢复，而不是让用户重新复制同一张截图。
搜索条件也有边界。你可以按标签、来源、日期和内容类型缩小范围，系统会限制单次提取的字节数和并发量，避免一个超大项目占满桌面资源。扫描 PDF 时，文字型页面优先使用已有文字层；没有文字层时，才在规定页数内渲染并进行 OCR。
OCR、翻译和文本工作台各自负责什么
OCR 处理像素，翻译处理语言，文本工作台（TextWorkbench）处理可重复的文字变换。三者的输入不同，输出也不同。对截图运行 OCR 不会修改原图；翻译会保留源文本和目标语言；文本工作台会把格式化、去重或排序后的结果保存为新的快照。
工具开始前会检查能力和前提。截图必须已经在本地，翻译必须有源文本，在线服务必须有可用配置，二进制设计文件不能冒充可编辑源代码。失败时系统报告缺少的条件，而不是生成一个看似成功的空结果。
快照让每次变换可追溯。你可以比较原文和清理后的文本，保留图片作为视觉参考，或者只把翻译结果复制到外部应用。原始条目不被覆盖，这一点对合同、发票和研究资料尤其重要。
标签让历史拥有语义
标签名称和颜色属于共享记录，而不是某一张卡片的临时样式。你把“客户”“研究”或“待回复”应用到条目后，列表、预览窗口和搜索结果都读取同一份标签记录。颜色由用户选择并保存，应用重启后仍然保持；界面不会每次刷新都随机生成新颜色。
修改标签名称或颜色走同一条更新路径。名称会去除两侧空白，颜色会先校验格式，关系更新和列表刷新在一次完整操作后完成。你可以只改颜色，也可以同时改名和改颜色，不需要为每个字段记住不同的页面规则。
标签不会强迫等待中的大文件下载。元数据头已经到达时，条目可以先被分类；正文稍后到达时，标签仍然有效。这个设计让手机流量和有限存储都可以由用户掌控。
回收站和保留策略不是同一件事
移到回收站会把条目从活跃历史中移开，但保留恢复机会。恢复会把它带回活跃范围，永久删除才会移除本地内容、搜索投影和后续同步所需的删除证据。保留策略只处理明确满足条件的回收站条目，不会因为一个条目很旧就静默删除仍在使用的资料。
把“离线保留”“置顶”“收藏”和“回收站”分开，是为了让每个状态回答一个问题：内容是否留在本地，条目是否应该排在前面，用户是否把它标记为有价值，还是它是否已经离开活跃历史。一个开关不能替代四种意图。
设备同步先建立信任
配对另一台设备时，两端都会显示可核对的身份。你为设备设置一个能认出的名称，确认同步范围，再接受配对。网络地址只说明数据怎样传输，不说明哪一台设备得到授权；同一 Wi-Fi 上的陌生设备仍然需要通过配对。
同步可以先发送元数据头，再发送正文内容。接收端先看到标题、标签和文件大小，后台任务根据设备策略决定是否下载。大项目不会阻塞命令面板、标签编辑和普通复制，下载进度与当前速度在任务行中单独展示。
路径选择会在局域网、虚拟专用网络、公共地址和中继之间探测。诊断信息会显示最终选择的路径、远程和本地地址、连接是否复用，以及发现、握手、队列、传输和写盘的耗时。这样“同步很慢”可以被拆成可检查的阶段，而不必把所有问题归咎于网络往返。
一个真实的电脑到手机流程
早上在电脑上复制会议地址，电脑立即把它写入本地历史。午休时，手机已经收到条目的标题和标签，但正文仍显示等待中，因为同步策略不会自动下载大内容。
你在手机上打开预览，确认文件大小和来源，点击下载。下载在后台执行，前台仍然可以打开命令面板、复制另一条短文字或编辑标签。任务行显示已完成字节、总字节和瞬时速度；失败时保留重试入口，不会用半截文件替换手机的系统剪贴板。
如果手机从 Wi-Fi 切换到移动数据，连接层会重新探测候选路径。同步意图不变，任务也不需要用户重新创建。最终诊断会记录路径变化和各阶段时间，支持人员可以据此判断是候选超时、队列等待、重新握手，还是本地写入变慢。
复制
│
├─ 本地保存历史条目
├─ 同步元数据头
├─ 用户确认下载
├─ 后台传输内容块
└─ 校验完成后才写入系统剪贴板
失败时先保护原始工作
任何写入目标应用的动作都遵循“准备、校验、写入、稳定、注入”的顺序。远程图片需要先下载并检查大小；网页图片需要先解码链接中的实体；SVG 等文本图形需要先保留源内容或生成可复制的渲染图。
如果下载失败，系统不创建剪贴板注入器，也不覆盖当前系统剪贴板。你可以重试同一条目，或者继续使用历史中的其他内容。错误信息包含失败阶段和可采取的下一步，而不是只显示一个没有上下文的“操作失败”。
网络恢复、索引恢复和本地数据库恢复也遵循相同原则。任务有有限重试和明确终态，重启后可以从持久化队列继续；已完成的任务不会重复创建历史。可恢复状态比无限旋转的加载图标更能让人放心。
你可以怎样验证一切正常
先复制纯文字、Markdown、截图、SVG 和 PDF，确认它们在历史中显示不同的预览和操作。再断网，搜索纯文字，打开已有截图，检查标签修改是否仍然存在。恢复网络后，配对一台测试设备，让小文字自动同步，让大文件保持等待，再按需下载。
接着重启应用，检查标签颜色、最近命令和搜索结果。把一条临时内容移到回收站，恢复它，再执行永久删除，确认搜索和列表都反映最终状态。最后打开网络诊断，先复制摘要模式，确认其中没有正文、令牌或账号密钥；只有在网络管理员需要时，才分享原始地址模式。
我们如何继续改进
每次版本更新都从用户能复现的场景开始，而不是从组件名称开始。一个问题报告最好包含操作时间、内容类型、设备角色、最终状态和脱敏诊断。我们再用这些事实检查：是识别错了、预览缺少前提、下载被前台阻塞、标签没有写回，还是连接路径选择不佳。
这套方法也约束了功能增长。新增格式必须说明如何识别、如何预览、能做哪些操作、缺少什么前提、失败后如何恢复。新增同步策略必须说明信任范围、路径选择和数据保留。新增在线工具必须说明输入、服务提供方和输出快照。清楚的边界让产品更安静，也让用户在需要时能迅速找到证据。
Syzygy 的目标不是让剪贴板变得复杂，而是让它在复杂工作里保持可解释。你复制的内容属于你当前的工作，历史应该随时可查，预览应该帮助你做决定，同步应该由你选择，失败应该留下恢复路径。其余细节，都应该服务于这四件事。
设计从用户能观察到的事实开始
我们不会先问“这个页面需要多少按钮”，而会先问“用户现在拥有哪一份数据”。 如果正文还没有到达，页面就显示等待中的内容块；如果标签已经写入，列表就立即 显示保存后的颜色；如果一次回车需要下载，操作行就显示下载阶段而不是空白窗口。
这种顺序看起来朴素，却能避免很多隐蔽错误。一个看似可点击的按钮，可能在后台 触发网络请求、创建任务、写入历史，再把结果交给系统剪贴板。把这些阶段合并成 一个“完成”标记，用户既无法判断发生了什么，也无法在失败后找到正确的重试入口。
我们把每个动作拆成“输入、前提、结果、失败状态”四个问题，并用同一套内容计划 回答它们。这样，卡片、预览窗口、命令面板和同步任务看到的是同一份事实，而不是 四套各自猜测的界面状态。
一条条目从出现到可用
复制动作完成时，历史记录先写入标题、时间、来源和内容家族。文字或小图片通常 很快拥有完整内容；大型 PDF、归档或项目目录可能只拥有元数据头。列表会把两者 区分出来，搜索可以先使用标题和标签，下载任务则在用户确认后排队。
内容块抵达后，系统校验长度和指纹，再将条目标记为就绪。预览读取已校验的本地 内容，外部打开也只接收完整文件。任何一步失败，条目都会保留原来的历史身份， 任务进入可重试状态，不会制造一条内容不完整的新记录。
历史条目
├─ 元数据头：标题、来源、标签、大小、类型
├─ 内容块：文字、图片、PDF 或多文件数据
├─ 派生结果：缩略图、OCR 文字、搜索字段
└─ 用户动作：预览、复制、下载、编辑、删除
图中的四层并不是四个互相独立的数据库。元数据头和内容块共同描述同一条目， 派生结果可以重新生成，用户动作则应该留下清楚的最终状态。这个关系让恢复操作 有据可查，也让清理派生索引不会误删原始工作。
为什么我们保留原始内容
“把图片转成文字”听起来像一次覆盖，但实际工作通常需要两种视图。发票截图要 保留原始版面，OCR 结果用来搜索号码；设计图要保留渲染外观，源文本用来调整颜色； 翻译结果要方便复制，原文还要留在旁边做核对。
因此，OCR、翻译和文本工作台都创建派生快照。快照带着来源条目的引用、操作类型 和创建时间。删除快照不会删除原始图片，删除原始条目时，界面也会先说明哪些派生 结果会一起进入回收站或被永久清理。
大内容必须让出前台
大型下载最容易暴露产品的真实质量。传输占用网络和磁盘，但它不应该阻塞一个 无关的键盘动作。你仍然应该能够打开命令面板、查看另一条历史、复制一段短文字， 或者给等待中的条目加标签。
我们把大内容任务放进后台队列，并为任务保存已完成字节、总字节、瞬时速度和 最近错误。任务行可以折叠，详细诊断按需打开。这样前台保持安静，用户需要排查 时又能看到准确证据，而不是只能盯着一个旋转图标。
移动设备还会遇到电量、网络切换和应用挂起。任务恢复时会重新校验本地部分， 继续传输缺少的范围；如果校验失败，就丢弃不完整部分并回到等待状态。系统剪贴板 只有在完整内容通过校验后才会写入。
颜色和名称应该属于用户
标签颜色是一项用户配置，不是视觉装饰。列表、第三列预览和弹出窗口都读取同一 条标签记录，因此修改颜色后，三个位置应该同时显示新值。应用重启之后，颜色仍然 来自保存的记录，而不是由条目名称再次计算。
名称更新也遵循同一条原则。输入会先去掉两侧空白，空名称和非法颜色会被拒绝， 名称关系和颜色更新在一次事务中完成。用户只改颜色时，关联条目不需要重新下载； 用户改名时，原有关系仍然指向同一批历史条目。
回收站给错误操作留下退路
工作资料不应该因为一次误触就消失。移到回收站会改变条目的活跃范围，但保留 恢复所需的内容和标签。恢复操作重新加入活跃历史，搜索投影也随之恢复。只有 用户明确选择永久删除时，系统才会清理本地内容和相关索引。
保留策略处理的是回收站中的候选条目。它可以按时间或数量运行，但不会把仍在活跃 列表里的资料当作垃圾。策略执行前后都应该显示受影响数量，任务失败时保留可重试 状态，避免用户误以为清理已经完成。
网络路径需要被解释
同步诊断不会只给一个“网络正常”结论。它会记录发现、候选探测、连接建立、队列、 内容传输、确认和本地写入的时间。最终选择的路径会标明是直连、虚拟专用网络、 局域网还是中继，并在需要时显示本地和远程地址。
同一条链路可能在不同时间选择不同路径。手机从 Wi-Fi 切换到移动数据时，旧路径 会失效，新路径需要验证；连接复用成功时，后续小内容不必重新握手。把这些事实 写进诊断，才能区分网络往返慢、候选超时、队列拥堵和磁盘写入慢。
候选路径 ──探测──> 选择最快的可用路径
│ │
├─ 局域网 ├─ 连接复用
├─ 虚拟专用网络 ├─ 发送与确认
├─ 公网地址 └─ 失败后有界重试
└─ 中继
路径选择不会改变配对关系。配对回答“谁可以访问”，路径回答“加密数据怎样到达”。 把两个概念分开，用户才不会因为看到一个虚拟专用网络地址，就误以为设备已经获得 授权。
诊断报告也要保护隐私
摘要模式包含设备角色、路径类别、计时、字节数和最终状态，不包含剪贴板正文、 账号密钥或会话令牌。它适合直接发给支持人员。原始模式可以显示地址和更细的探测 事件，只有在网络管理员确实需要时才分享。
复制诊断前，界面会让用户看到即将复制的范围。报告应该描述一次失败操作，而不是 导出整个工作区。支持人员得到的是可以复现问题的最小事实，用户保留的是完整的 内容控制权。
用一组小测试验证工作流
我们建议每次升级后完成同一组测试，而不是只检查应用能否启动。先复制一段文字、 一段 Markdown、一张截图、一个 SVG 和一个 PDF，确认预览和能力各不相同；再断网， 搜索文字、修改标签并重启，确认本地副本仍然可用。
恢复网络后，配对一台测试设备。让短文字自动同步，让大文件保持等待，点击下载并 观察进度和速度。下载期间打开命令面板，执行一个无关的本地复制，确认前台动作 没有被后台任务挡住。切换网络后，再看路径和连接复用字段是否反映变化。
最后把测试条目移到回收站、恢复并永久删除，确认列表、搜索和派生结果都按照范围 变化。复制摘要诊断，检查其中没有正文和令牌。这个闭环能发现识别、持久化、同步、 删除和隐私边界中的大多数回归。
什么时候应该联系支持
请提供操作时间、设备角色、条目类型、最终状态和摘要诊断。描述你点击了什么， 在哪个阶段看到等待或错误，是否切换过网络，以及重试后发生了什么。不要发送完整 剪贴板历史，也不要为了证明问题而上传客户资料或账号密钥。
如果问题只在某一种内容出现，请附上不含敏感正文的类型信息，例如“扫描 PDF 在 第二页 OCR 失败”或“远程图片下载成功，但回车注入未执行”。具体阶段比一句“不能 用”更容易让我们复现，也更容易确认修复是否真的覆盖了根因。
这套工作台适合谁
研究人员可以把网页引用、会议截图和扫描文件放在同一条历史里，先用本地搜索找回 线索，再决定是否把摘要发到手机。设计师可以在图形预览和源文本之间切换，不必 为了修改一个颜色而丢掉原始外观。
支持人员可以保留错误片段和命令输出，通过标签区分项目，再在结束后用回收站清理 临时材料。需要跨设备时，团队可以只配对经过确认的设备，让大文件按需下载， 把共享范围和网络路径同时记录下来。
这些场景看起来不同，却都依赖同一个基础：历史条目拥有稳定身份，内容类型可被 解释，用户动作有明确前提，失败后仍然保留恢复路径。我们把复杂性放在系统内部， 把必要事实留在用户面前。
一个长期维护的承诺
新增功能前，我们先检查它是否会引入第二份状态、第二套类型判断或无法解释的后台 任务。如果一个新按钮不能说明输入和失败条件，它还没有准备好进入工作台。如果一 项同步策略不能解释谁接收数据、怎样选择路径和怎样恢复，它也不应该默认开启。
我们会持续用真实设备、不同网络和不同内容类型测试这些边界。每次修复都应该让 系统更简单：颜色只有一个来源，预览只有一份计划，下载只有一个可观察的队列， 删除只有清楚的作用范围。简单不是减少能力，而是减少用户需要猜的事情。
把一次复制放进完整工作流
用户看到的是一个条目，系统处理的却是一组有先后关系的动作。采集先保存最小的历史事实，识别再补充内容家族，预览和搜索读取同一份计划；同步只传送已经允许的表示，派生工具为原始条目创建新的快照。下面的流程图说明这些动作如何共享条目标识，又如何保持各自的失败边界。
flowchart TD
A[复制内容] --> B[保存历史条目]
B --> C[识别内容家族]
C --> D[生成预览与能力]
D --> E{本地内容是否完整}
E -- 是 --> F[复制 / 搜索 / 编辑]
E -- 否 --> G[显示元数据并等待下载]
G --> H[后台传输与校验]
H --> F
F --> I[保存新的快照]
I --> J[标签、同步、回收或导出]这条路径把“看见内容”“拥有内容”和“修改内容”分开。用户可以先搜索一个只有元数据头的 PDF，也可以先给它加标签；需要复制正文时，系统才要求本地内容块通过校验。编辑、翻译或人工智能建议产生的新快照带着来源引用，删除派生结果不会影响原始条目。每一次动作都能回到同一个历史身份，支持人员也能按阶段复现问题。
继续阅读
阅读剪贴板内容类型，了解文字、图形、PDF 和多文件条目如何获得不同能力。阅读预览、弹出窗口与命令面板，了解从选中条目到目标动作的键盘路径。
如果你关心截图和扫描文件，继续阅读索引、OCR 与 PDF 搜索。如果你准备配对手机，阅读设备配对与 P2P 同步，先了解元数据头、后台下载和网络诊断。Syzygy 从一次复制开始，但它的价值在下一次需要时仍然找得到。