Syzygy 1.0.0：一个本地优先剪贴板工作台的完整交付

1.0.0 是 Syzygy 的第一个稳定版本。从 2026 年 1 月 4 日仓库里的第一行代码，到 7 月 22 日把版本号从 1.0.0-rc.0 提到 1.0.0，中间是 1388 个提交；仅 rc.0 之后的收尾窗口就有 134 个。它支持 macOS、Windows、Android 三端直接下载安装，iOS 构建已经完成、正在 App Store 审核队列里，Linux 理论上可跑但官方还没做全面测试。

一个版本号承诺什么，得看它把什么放进了主路径。1.0.0 的回答是：本地剪贴板历史、多格式预览与编辑、按需 P2P 同步、加密与配对授权，这四件事全部在本地数据平面上完成。服务器存在于这个架构里，但它是可选的侧车，负责账号、激活码、席位和配对授权，不在日常同步的热路径上。服务器完全不可达时，已配对设备之间的复制粘贴照常工作。

#同步的第一层永远是摘要

Syzygy 的同步模型叫摘要优先。设备 A 复制任何内容，先跨网络传播的是一条轻量摘要：内容类型、预览信息、创建时间、来源设备。设备 B 的列表里几乎立刻出现这条新记录，可以搜索、可以打标签、可以看到「有这么个东西」。

完整正文什么时候过来，由接收端的同步模式决定。每一台已配对的设备单独配置 realtime 或 on-demand 模式：realtime 默认对约 50 MiB 以内的正文自动物化，on-demand 默认约 5 MiB。超过有效阈值的内容停留在待下载状态，你从摘要判断值不值得拉，然后显式下载。所有正文按内容哈希经 iroh-blobs 传输，校验的是哈希，不是网络路径。

这个分层在弱网和大文件场景下的行为是可预期的：手机在蜂窝网络里收到一张 4K 截图的摘要，列表可浏览、可搜索，正文等回到 Wi-Fi 再拉。7 月的收尾窗口还补了几处工程细节：前台追赶同步的摘要数量上限校验、对端追赶的关联复用与健康度分类、把「排队接纳」正确计为成功以消除界面反复跳动。

#发现、加密与信任域密钥

局域网内靠 mDNS 直接发现设备。跨网段有两条可选链路：PKARR（借 DHT 与中继做发现）和 relay 中继。1.0.0 的出厂默认把 relay 关着：同一局域网开箱即用，需要跨网同步的用户要去设置里自己打开。我们把这个默认值如实写进文档，因为它是一个隐私与连通性之间的取舍，应该由用户决定。

传输层由 iroh 提供加密认证连接，配对响应走临时密钥协商出来的加密通道。打开安全模式（security_mode=on）后，保护再加深两层：文本、图片、文件的正文先加密再写入本地 blob 存储；header 广播升级为加密的 HeaderAnnounceEncryptedV1，用一把 owner 域的信任域密钥加密，私有公告不再复用公共 topic，而是切换到由 owner 身份、密钥代际和本地随机盐派生的独立 topic。

信任域密钥不是静态的：默认每 6 小时周期轮换，信任变更、屏蔽、忘记设备、邻居修复这些事件也会立即触发轮换。密钥投递有台账，只有收到对端「已安装」的确认才算收口；离线设备回来后通过邻居修复和周期维护补齐解密能力。剪贴板是高敏数据，我们选择把「谁能解密未来公告」做成可验证的密钥管理，而不是一个开关加一句承诺。

#剪贴板工作台：每种格式有自己的操作

一个条目进入 Syzygy 后能做什么，由内容计划（content plan）决定，1.0.0 的 rc 窗口把整个预览体系迁移到了这个结构上：系统根据条目所属的文档族生成文本、预览方式、可用能力与大小证据，界面据此渲染，而不是靠文件后缀猜。HTML 文档有专门的内容计划生成，文件的文本预览同样由内容计划支持。

纯文本进入文本操作台：字数统计、空格清理、Base64 编解码、JSON 格式化。代码自动获得语法高亮，Markdown 直接渲染预览。SVG 代码和 Figma 节点会被渲染成真实图片，所以你可以「复制为图片」把矢量图发进聊天软件，也可以切回源码模式粘贴原始 SVG。图片提供内置 OCR，模型随安装包本地分发，不联网。Office 场景覆盖 .xlsx、.docx、.pptx 文档和 .zip 压缩包的内容预览。网页图片的加载带回退策略并带 no-referrer 策略，远程资源不泄露来源页。

唤出这些能力的入口是 Quick Panel：alt+v 垂直布局、alt+shift+v 水平布局，两种布局各自持久化窗口尺寸、互不覆盖，水平布局默认接近全屏宽、高度约为工作区的四分之一，运行时把窗口钳制在显示器工作区内，拖丢的面板找得回来。主窗口聚焦时 alt+v 只做页内导航，避免面板叠在自己身上。主窗口、垂直面板、水平面板三种入口状态的快捷键语义被严格区分。从面板选中内容按 Shift+↑ 弹出原生风格的预览，预览里点 Popup 可以把这条内容撕成一个独立悬浮窗：调透明度、置顶、缩放，把一段代码或一张截图钉在屏幕最前方当参考。

全局热键覆盖完整闭环：cmdorctrl+shift+c 捕获复制、cmdorctrl+shift+v 粘贴最新一条、cmdorctrl+shift+k 触发快速同步、cmdorctrl+shift+s 按需拉取。所有热键在设置里可改，配置写进 config.json 的 hotkeys 段。

#管理：收藏、置顶、标签与检索

剪贴板历史的默认保留是 2000 条，超出的按淘汰策略清理，回收站另有独立上限。收藏（favorite）把条目永久归档进收藏列表；置顶（pin）把条目放进 Pinlist，固定显示在剪贴板页顶部和 Quick Panel 里，支持拖拽排序，ctrl+option+数字 0-9 直接粘贴对应顺位的条目。删除先进回收站，彻底清除才释放空间。

标签支持手动维护，也可以开 AI 自动打标。AI 打标与 AI 翻译都走 BYOK：自带密钥、自带接口，Syzygy 内置 OCR 之外的 AI 能力不附带任何隐性上传。翻译内置多引擎入口，百度、DeepL、谷歌、腾讯、有道以及各类 AI 翻译接口都在插件页配置。搜索建立在本地索引上，普通文字、图片 OCR 出的文本与 PDF 里的文字都进索引，「找上周那张截图或 PDF 里的字」在 1.0.0 就是本地完成的查询。需要长期留存的条目可以标记本地保留，不随保留策略淘汰。传输本身也可见：应用内有七日滚动用量统计与吞吐可视化，同步了多少、走了哪条路径，有数字可看。

#命令行是第四个入口

桌面与移动之外，1.0.0 带着完整的 CLI。cargo run -p syzygy-cli 进来的最小闭环是两端联机：A 端 stdin 输入 copy hello-from-a，B 端输入 paste，内容按哈希经 iroh-blobs 拉取。运行器有三种形态：stdin 模拟触发验证最小闭环，desktop 驱动系统剪贴板与热键注入，script 脚本驱动自动化回归。pair、history、peers 等子命令覆盖配对与历史管理，调试跨网发现时可以把 endpoint 地址写文件、从文件 bootstrap 对端。CLI 与桌面端复用同一套 Rust node、pairing、存储能力，这意味着核心同步逻辑每一天都被两种完全不同的界面使用，接口没藏住的 bug 藏不住。

#发布工程与运行时可靠性

稳定版本对「可靠」的定义不止功能。这个窗口里铺了这些底座：macOS 直发工作流接入公证并带提交失败重试，本地专属 bundle 给出明确警告；配置文件获得迁移与恢复机制，损坏的配置有路可走；剪贴板捕获走独立工作线程的排队处理，积压不阻塞界面；日志按文件数量轮转清理；后台任务的状态快照有超时保护，运行时状态支持过期标记而不是假装新鲜。这些不是功能列表上的条目，但它们决定了四个平台上的 Syzygy 在第 500 次复制时是否还和第一次一样可靠。

#PRO 首次上线：激活码、席位与配对授权

1.0.0 是 PRO 权益链路第一次随版本交付。流程是：注册登录、输入激活码、在权益确认界面核对权益是否符合预期、确认兑换，然后在席位表里把权益分配给指定设备，客户端刷新账户后生效。免费版的核心同步完全免费，在历史条目数、文件预览等处有容量限制；PRO 解除这些限制。

配对在 1.0.0 里有双重确认：云端配对授权验证通过，两台设备再互相完成本地信任确认，缺一不可；设备角色组合也要符合系统允许的配对规则，网络连通是最后一道自然前提。任何一步不满足，就不会出现半配对状态或强制同步。要坦率说明的是，这条链路是整个版本里最新的部分：付费、激活、席位分配、配对授权串成一条完整商业闭环，1.0.0 让它跑通，但它的成熟度需要真实用户的使用来检验，我们预期它会以高于核心同步的频率迭代。

#已知边界

• relay 出厂默认关闭，跨网同步需要手动开启 relay 或 PKARR；
• iOS 正在 App Store 审核，上架时间不在我们控制内；
• Linux 未做全面官方测试，兼容性问题可能存在；
• AI 自动打标消耗的 token 较多，现阶段官方建议以手动标签为主；
• 剪贴板功能本身也是在这个发布窗口里才从 preview 转正为 stable 的模块；
• macOS 分发已经接入公证流程并带提交重试，但这仍是我们在发布工程上持续投入的第一代。

这些边界不会都用同一种方式解决，但 1.0.0 的原则是把每个边界写清楚，让用户带着预期使用，而不是被营销话术惊喜。下一步，可以先读安装与首次运行指南把环境跑起来；1.0.0 之后的第一批修复见 1.0.1 更新说明。