联系
联系支持时，请包含你的 macOS 版本，以及RibbonDiff → About（或 App Store 的“Version History”）中显示的应用版本。
Pro 访问权限（Limited / Pro Trial / Pro Lifetime）
RibbonDiff 可免费下载，并可在 Limited 模式下比较输入或粘贴的文本。打开和保存文件、使用 Workspace 与 Workspace 文件搜索，以及使用 Version History 都可在 Pro 中使用。
Limited（免费）
- 可以比较和编辑两个窗格中的文本（输入/粘贴）。
- 可以使用实时 Diff 更新、中央 Ribbon 连接线、每窗格 Find、自动换行和主题。
Pro（Trial 或 Lifetime）
- 从磁盘（
⌘O）、Finder、Terminal 或拖放打开文件 - 每个窗格的 Save / Save As…（
⌘S/⇧⌘S） - 文件夹或
.rd-workspace文档，并在 Workspace 侧边栏中打开，以及保存 Workspace 文档（⇧⌥⌘S) - 使用 Find in Workspace…（
⇧⌘F）在打开的 Workspace 中搜索文本，也可 Option-click 在其他标签页中打开结果 - 通过内联重命名创建新的 Workspace 文件或文件夹，然后可从侧边栏移动、删除、在 Finder 中显示或复制路径
- 对 Git 管理的 Workspace 内文件使用 Version History，并显示只读历史预览
- 在 Settings 中启用后，显示每个窗格的可选Line Endings／Encoding控件
开始 Pro Trial（7 天）
RibbonDiff → Settings… → Pro，打开开始 7 天 Pro Trial（Start 7-Day Pro Trial）并点击它。Trial 为一次性，期限为 7 天，不会自动续订。
解锁 Pro Lifetime
RibbonDiff → Settings… → Pro，打开解锁 Pro Lifetime（Unlock Pro Lifetime）并点击它。这是一次性购买。
恢复购买
重新安装或更换 Mac 后，如果 Pro 访问权限未显示，请打开Settings → Pro → 恢复购买（Restore Purchases）。
旧付费版用户：如果你在 RibbonDiff 还是付费 App Store 下载时购买过，使用同一 Apple ID 应会自动解锁Pro Lifetime。如果没有解锁，请使用恢复购买（Restore Purchases）。
快速帮助
- 完整文档： 详细工作流和快捷键请参阅用户指南。
- 快捷键列表： 打开 RibbonDiff 帮助（Help → RibbonDiff Help）（⌘?）会打开内置快捷键参考窗口。
- 比较文本： 在左右窗格中粘贴或输入文本。Diff 会自动更新。
- 打开文件（Pro）：将文件拖放到窗格，或先点击窗格再按⌘O。
- 新建比较： 新建窗口（File → New Window）（⌘N）打开不带 Workspace 侧边栏的新独立比较窗口，带侧边栏的新建窗口（File → New Window with Sidebar）（⇧⌘N）打开带侧边栏的窗口。要在当前窗口组中打开新标签页，请使用⌘T。
- Workspace（Pro）： 打开 Workspace（File → Open Workspace…）（⇧⌘O）可在新的独立窗口中打开文件夹或
.rd-workspace文档。要把 Workspace 关联到当前窗口，请使用侧边栏中的打开文件夹或 Workspace 文件（Open Folder or Workspace File）操作。 - Workspace 文件搜索（Pro）：选择 Find → Find in Workspace…（⇧⌘F）即可搜索打开的 Workspace 中的文本文件。使用 View → Show File Tree（⌘1）和 View → Show File Search（⌘2）切换侧边栏模式。搜索会在标签页之间保持可见，保留查询和展开结果，为 Git 修改文件显示 M 标记，并支持 Option-click 在其他标签页中打开结果。
- Workspace 文件管理（Pro）：使用侧边栏操作菜单，或右键点按文件夹/文件来添加文件或文件夹、在新标签页中打开文件、在 Finder 中显示项目、复制相对或完整路径、多选项目、将项目拖入文件夹，或在确认后将删除项目移到废纸篓。
- Version History（Pro）： Git 管理的 Workspace中打开文件，并使用分支和版本选择器将当前文件与只读历史快照进行比较。
- 保存（Save）（Pro）：点击窗格使其成为活动窗格，然后使用⌘S / ⇧⌘S。保存始终应用到活动窗格。要保存 Workspace 文档，请使用保存 Workspace（Save Workspace） / Workspace 另存为（Save Workspace As…）。
- 当磁盘上的文件发生变化时： 如果已打开文件在磁盘上发生变化且没有未保存编辑，RibbonDiff 会自动重新加载；替换应用内未保存编辑前会先询问确认。
- 在每个窗格中搜索： 使用每个窗格的 Find 字段，或按⌘F，然后使用⌘G/⇧⌘G在匹配项之间移动。
- 自动换行： 若要避免长行横向滚动，请切换自动换行。
- Whitespace 过滤器： Whitespace工具栏开关或空白过滤器（View → Whitespace Filters）（⌃⌘I），一次性开关已保存的缩进/行首/行尾空白比较过滤器。
- 换行符 / 编码（Line Endings / Encoding）（可选）： Settings → General启用徽标。这会影响保存时文件的写入方式，但在 Diff 中会被规范化（通常仅 LF 与 CRLF 的差异不会产生差异）。
- 主题： 可以自定义 Diff 颜色和背景，并将主题作为 JSON 导入/导出。
- 多个比较： 可以使用新窗口或 macOS 窗口标签页同时打开多个 Diff。打开 Workspace 时，该窗口中的所有标签页会共享同一侧边栏和项目树。
设置 / Settings
打开 Settings
在菜单栏中选择RibbonDiff → Settings…（快捷键： ⌘,）。
常用部分
- Pro：查看访问级别、了解包含内容、开始 7 天 Trial、解锁 Pro Lifetime 或恢复购买。如果在 Limited 模式下尝试打开或保存文件、使用 Workspace 或 Workspace 文件搜索，或使用 Version History 等 Pro 专属工作流，RibbonDiff 会显示 Pro 提示。
- General: 设置行号（按窗格）、默认自动换行、已保存 Whitespace 过滤器的默认设置、可选 Line Endings / Encoding 徽标、Workspace 项目大小和行高。
- Appearance: 调整 Diff 高亮颜色（添加/删除/更改）以及中央连接线（Ribbon）的颜色。
- Backgrounds: System选择跟随 Light/Dark Mode 的背景，或切换到Custom颜色。
- Syntax: 启用自定义语法颜色，并分别编辑 Light/Dark 调色板。
- Themes: 切换内置主题或你自己保存的主题。
导入主题（JSON）
Settings → Theme，打开导入主题（Import Theme…）并点击.json文件。导入的主题会显示在User Themes中。
导出主题（JSON）
Settings → Theme，打开导出主题（Export Theme…），输入名称，然后选择.json文件保存位置。
提示：如果导入主题后没有出现在列表中，请关闭并重新打开 Settings，然后再次检查 Theme 部分。
故障排除
无法使用打开/拖放/保存文件、Workspace、Workspace 文件搜索或 Version History
打开或保存文件、使用 Workspace 以及使用 Workspace 文件搜索都是 Pro 工作流。Version History 也是 Pro 专属，并且只会显示在 Git 支持的 Workspace 内的文件上。请在 RibbonDiff → Settings… → Pro 中确认你处于 Pro Trial 或 Pro Lifetime。如果已经购买，请使用 Restore Purchases。
我的 Pro Trial 结束后会怎样？
7 天后，RibbonDiff 会回到 Limited 模式。文件打开/保存工作流、Workspace、Workspace 文件搜索和 Version History 会再次停用，但你仍可继续比较输入或粘贴的文本，或解锁 Pro Lifetime。
Workspace 保持折叠，或显示升级提示
Workspace 可以保存为Pro功能。如果 RibbonDiff 显示升级提示，请从RibbonDiff → Settings… → Pro开始 Pro Trial 或解锁 Pro Lifetime。如果当前窗口已经打开 Workspace，请使用共享侧边栏，不要期望每个标签页有独立 Workspace。
Workspace 文件管理没有完成
新的 Workspace 项目名称不能为空，不能包含 /，也不能与同一文件夹中的其他项目重名。拖动移动必须以 Workspace 内的文件夹为目标；RibbonDiff 会阻止无变化移动、移动到项目自身或子文件夹，以及重复名称冲突。删除会将已确认的文件和文件夹移到废纸篓。
Workspace 文件搜索没有结果
Workspace 文件搜索需要打开的 Workspace，并会搜索该 Workspace 内的文本文件。请确认你处于 Pro Trial 或 Pro Lifetime、Workspace 已打开，并且搜索文本存在于可读取的文本文件中。如果你在标签页之间移动，或从文件树返回，RibbonDiff 会保留当前查询、结果、展开的文件和滚动位置。二进制、无法读取或非常大的文件可能会被跳过。
无法使用 Version History
Version History 是Pro 专用的 Workspace 功能。只有当当前文件位于Git 管理的 Workspace中时才会显示。如果文件位于 Workspace 外，或 Workspace 未受 Git 管理，分支和版本选择器可能不会显示。
Open Workspace… 打开了新窗口
这是预期行为。打开 Workspace（File → Open Workspace…）始终会将所选文件夹或.rd-workspace文档打开在新的独立窗口中。若要用 Workspace 替换当前窗口中的比较，请使用侧边栏中的打开文件夹或 Workspace 文件（Open Folder or Workspace File）操作，或将文件夹或.rd-workspace文件拖放到侧边栏。
Wrap / Whitespace / Swap / Clear 消失了
顶部工具栏行可能已隐藏。显示工具栏（View → Show Toolbar），或按⌥⌘T，即可恢复包含Whitespace开关在内的顶部工具栏。编辑器内容、Workspace 和 Diff 不会改变。
已打开文件在磁盘上发生了变化
应用内没有未保存编辑时，RibbonDiff 会自动重新加载已更改文件。如果有未保存编辑，替换为磁盘上的新内容前会先询问确认。
Restore Purchases 未能解锁 Pro
请确认这台 Mac 已登录原购买所用的同一 Apple ID。然后退出并重新启动 RibbonDiff，再次尝试Settings → Pro → 恢复购买（Restore Purchases）。如果仍然失败，请将应用版本和 macOS 版本通过邮件发送给支持（无需包含机密信息）。
打开文件后文本乱码
可能是用错误编码解码了。Settings → General在Encoding徽标，选择其他编码后重新打开文件。
更改 Line Endings 或 Encoding 后文件被重写，但文本看起来相同
这是预期行为。RibbonDiff 会在内部规范化换行符和编码，因此只更改徽标可能会在不改变显示文本的情况下重写文件保存格式的细节。
大量粘贴后文本看起来不同步
请在窗格内单击并滚动一次，或关闭/开启 Word Wrap 来刷新布局。
非常大文本的性能
非常大的比较可能需要一些时间计算。如果感觉很慢，请比较较小范围或拆分输入。
主题导入/导出问题
请确认文件是有效 JSON，并符合 RibbonDiff 的主题格式。如果导入主题后仍未显示，请重新打开 Settings 并检查 Theme 菜单。
功能请求和反馈
请将建议发送至ribbon@craftclay.com。如可行，也请包含简短的非机密输入示例和预期结果。