装不上、打不开
提示「无法验证开发者」，打不开
折镜还没有做苹果的签名与公证，所以第一次打开 macOS 会拦一下。去系统设置 → 隐私与安全性，往下翻到那条被拦下的提示，点一次「仍要打开」。只这一次，之后不再问。
打开就闪退，或者界面一片空白
先确认装的是对的那一个包：苹果标 →「关于本机」看芯片那一行，Apple 芯片和 Intel 用的不是同一个安装包。 确认没错还是不行的话，把应用删掉重下一次——下载中断得到的半个包也是这个症状。
macOS 安装包尚未开放。这一节写在这里，是为了它开放的那天你有的对照。 眼下可以在首页那张纸上先写两行。
文件与数据
我写的东西到底存在哪？
在你自己指的那个文件夹里，是明文 .md。图片在文档旁边的 img/， 绘图在 drawings/，图表在 diagrams/。不知道当前是哪个文件夹的话， 看侧栏最下面那一行；右键任何一个文件 →「在访达中显示」，直接跳过去。
会不会上传到什么地方？
不会。折镜没有账号、没有同步、没有遥测。唯一联网的时候是你主动用 AI 助手（请求从你的电脑直接发给你填的那家服务商）和检查更新（只问一个版本号）。
我在访达里改了文件，折镜没跟上
正常情况下它会立刻跟上——它一直看着那个文件夹。极少数情况下（比如网盘刚同步完一大批文件） 可以点侧栏最下面那一行，把当前库再选一次，等于重扫一遍。
删掉的文档还能找回来吗？
侧栏里的删除不进废纸篓，但折镜记着整库时间点： 按 ⇧⌘H 打开版本历史，切到「整个文档库」，挑一个删除之前的时刻， 在文件列表里找到它，点「恢复这个文件」。
能放在 iCloud 或者坚果云里吗？
能，它就是一个普通文件夹。折镜自己不做同步，冲突交给你的同步工具处理—— 这和你用别的软件编辑 .md 是一样的。多台机器别同时改同一篇就好。
卸载之后怎么彻底清干净？
把应用拖进废纸篓，你的文档不受影响（它们从来就不在应用里）。 要连设置和会话记录一起清掉，删掉 ~/资源库/Application Support/ 下折镜那个文件夹； 库里的 .fm 是版本时间点，一并删掉就没有历史了。
写着不对劲
公式不渲染
先看美元号是不是成对，中间是不是紧贴着空格（$ x $ 不成立）。 按 ⌘/ 看一眼源码最快。还有一种是「以为它坏了」： 光标停在这对美元号中间时，公式故意保持源码，把光标移开它就渲染了。
图片显示不出来
多半是图片文件被移走了，或者手写的路径不对。最省事的办法是重新拖一次—— 拖进来的图会被拷到文档旁边的 img/，路径由折镜写，不会写错。
源码里的表格竖线对不齐，要紧吗？
不要紧。Markdown 表格不要求列宽对齐，渲染出来照样是整齐的。你在折镜里看到的表格才是它的样子。
打「/」没弹出菜单
它只在一个词的开头才认（行首，或者一个空格后面），并且不会在代码块、公式、 表格、网址里弹出来——这是为了不打扰 and/or、24/7 这类正常写法。 在空行上再试一次。
某个快捷键按了没反应
先去设置 → 快捷键搜一下那个命令，看它现在绑的是什么。 如果显示「未绑定」或者和你想的不一样，当场点一下改绑。也有可能被系统或输入法先抢走了 （截图、切换输入法这类），换一个组合就好。
中文输入法打字时，回车会不会误触发？
不会。折镜认得输入法的候选状态，你确认候选词的那个回车不会被当成命令。
AI 助手报错
| 它说 | 意思和做法 |
|---|---|
| 未配置 API Key | 还没填 Key。设置 → 服务商与模型，填好点保存。步骤见助手那一篇。 |
| 请求返回了 HTML 页面 | 地址或报文格式不对，请求打到了一个网页而不是 API。重新在下拉里选一次服务商最快——预设会把地址和格式一起填对。 |
| 连接失败 | 网络不通，或者 Key 无效、余额不足。点「测试连接」看具体报的是什么；国外的服务商在国内直连往往需要代理。 |
| 模型返回错误 | 多半是模型 ID 写错或该模型你没有权限。点「获取模型」拉一次列表，从里面选。 |
| 它只会聊天，不动我的文档 | 换一个支持工具调用的模型——模型菜单里每一项都标着支不支持。 |
助手改坏了我的文档
助手每次动手之前都会先记一个时间点（标着「助手改写前」）。 按 ⇧⌘H 打开版本历史，挑那一条恢复即可。想彻底避免，把改动审批模式保持在手动——它每次改都得先经你点头。
关于折镜本身
有 Windows 版 / iPad 版吗？
目前只有 macOS 12 及以上。
有深色模式吗？
暂时没有。折镜的界面只有纸色一种——这一版就是照着「一张纸」做的。
要钱吗？会变成订阅吗？
买断制：一次付费，永久使用，不是订阅。具体价格在正式版发布时公布。 AI 那部分折镜不卖额度，你用自己的 Key，钱结在你和服务商之间。