深入与附录

常见问题与故障排除

目录

这里汇集了常见问题的解答,以及在某些功能未按预期运行时可以自行排查的方法。


我的数据存放在哪里?

你的数据存放在数据文件夹中——一个包含 Markdown 文件的普通文件夹。当前路径可以在设置 → 数据文件夹中查看。存储位置由你在设置时选择。若要在多台设备上使用,请把它放在 iCloud 云盘中——请参阅下一个关于设备同步的问题。


如何在多台设备之间同步 TandemLoop?

把数据文件夹放在 iCloud 云盘中,并在每台设备上通过设置 → 数据文件夹选择这个文件夹。iCloud 会让文件保持最新;TandemLoop 在 Mac、iPad 和 iPhone 上读取的是同一份内容。

尽量每次只在一台设备上工作,并在切换设备之前等待同步完成——这样可以避免产生冲突副本。详情请参阅数据文件夹与文件格式一章。


使用 AI 功能需要自己的 AI 或订阅吗?

TandemLoop 本身不包含 AI。要使用提案和人机搭档协作,你需要一个外部的智能体式 AI 工具——例如 Claude Cowork、Claude Code、Codex、Gemini CLI 或 Antigravity——并允许它访问你的数据文件夹。使用哪种工具、是否需要为它付费订阅,完全取决于该工具本身。没有这类工具时,TandemLoop 的功能依然完整,只是没有 AI 建议。如何连接工具,请参阅连接 AI 工具。


我把数据文件夹移到了另一个磁盘。需要做什么?

打开设置 → 数据文件夹,然后选择切换数据文件夹…。随即会打开与首次启动时相同的设置对话框:你选择新的存储位置,TandemLoop 会检查文件夹的结构,之后就使用它继续工作。


归档没有找到任何内容——尽管我有已完成的任务。

请检查两点:

  1. 自动归档是否已开启? 自动归档默认关闭。请在设置 → 归档中通过自动归档开启。此设置按设备生效。
  2. 等待时间是否已过? 任务的默认规则是完成后时长(7 天)。昨天才完成的任务还不满足这个条件。你可以调整时长,或者把规则改为完成后立即归档。

已归档的条目会怎样?

已归档的任务、里程碑和项目会被移到数据文件夹的 _archive/ 子文件夹中。它们在那里保持不变——App 不再为其建立索引,也不会在普通视图中显示。你可以通过设置 → 归档 → 浏览归档查看归档。App 不提供自动恢复;如有需要,请手动把相关文件从 _archive/ 文件夹中移回。


某个快捷键不起作用。

打开设置 → 键盘快捷键,检查组合键是否设置正确。如果某个组合键已被占用,页面会提示冲突。请注意,不带修饰键的字母快捷键(例如 T 或 M)只有在没有输入框获得焦点时才会生效。


无法通过全局快捷键打开快速录入。

系统级快捷键 ⌃ + ⌥ + 空格键 不需要特别的权限。如果它不起作用,通常是其他程序或 macOS 占用了同一组合键。请在设置 → 键盘快捷键中为快速录入设定其他组合键;如果该组合键在系统范围内也已被占用,TandemLoop 会立即在那里提示。在 App 内,你随时可以通过菜单文件 → 快速录入打开快速录入。


我什么都改不了——每次尝试都会打开付费页面。

没有有效订阅时,TandemLoop 处于只读模式:你可以查看所有数据,但无法更改任何内容。请订阅,或通过设置 → 订阅 → 恢复购买恢复现有订阅。详见订阅与只读模式。


我找不到提案。

提案默认关闭;此时边栏中没有提案区域(在 iPhone 上没有“AI”标签页)。请在设置 → AI 智能体中开启。此开关适用于整个数据文件夹。


我在外部编辑了文件,但视图显示的仍是旧数据。

App 的文件监视功能通常会自动识别数据文件夹的外部更改。如果显示仍未更新,请手动重新载入缓存:设置 → 数据文件夹 → 重新载入缓存。


我不小心删除了一个项目。

在 Mac 上,TandemLoop 会把已删除的项目连同其中的任务和里程碑移到访达的废纸篓。从废纸篓把项目文件夹放回数据文件夹中的原位置(在废纸篓的快捷菜单中选择“放回原处”)——之后 TandemLoop 会再次显示它。在 iPad 和 iPhone 上,删除是永久性的;此时只能依靠数据文件夹的备份(例如时间机器或 iCloud 版本)。

删除无法通过“撤销”或 ⌘ + Z 还原。 对于已完成的条目,最好通过归档隐藏,而不是删除。