常见问题

同步数据失败怎么办？

推荐先使用「测试连接」功能

在同步数据前，强烈建议先使用设置页面的「测试连接」功能，可以快速定位问题：

1. 打开设置页面
2. 填写完 App ID、App Secret、多维表格 URL
3. 点击右侧的「测试连接」按钮
4. 根据测试结果排查问题

可能原因：

1. App ID 或 App Secret 填写错误 → 测试会显示「认证失败」
2. 应用权限未开通（需要开通多维表格相关权限）→ 测试会显示「权限不足 (403)」
3. 应用未发布或发布审核未通过 → 测试会显示「认证失败」或「权限不足」
4. 表格 URL 格式不正确 → 测试会显示「URL 格式错误」或「资源不存在 (404)」
5. 网络连接问题 → 测试会显示具体的网络错误

解决方法：

1. 检查 App ID 和 App Secret 是否正确（注意不要有多余空格）
2. 确认已在飞书开放平台开通多维表格权限：bitable:app:readonly
3. 确认应用已发布且审核通过
4. 确保复制了完整的表格 URL（格式：https://xxx.feishu.cn/base/{app_token}?table={table_id}）
5. 检查网络连接

为什么看不到图片？

可能原因：

1. 表格中未上传图片
2. 图片下载失败
3. 列名不是「图片附件」

解决方法：

1. 确认表格中已上传图片
2. 重新同步数据
3. 检查列名是否正确

键盘无法使用怎么办？

可能原因：

1. 未在系统设置中启用键盘
2. 主应用未同步数据
3. 键盘权限问题

解决方法：

键盘里标记「已使用」，回到 App 却没变？

原因：iOS 键盘扩展没有开启「允许完全访问」时，系统只允许它读取共享数据，不允许写入，所以标记状态存不下来。

解决方法（推荐从 App 里跳转，不用自己翻系统设置）：

1. 打开飞鸽 App，点击底部「设置」标签
2. 在「键盘设置」区域点击「开启允许完全访问」
3. 跳到系统设置后，进入「键盘」，打开「允许完全访问」
4. 系统弹窗提示时点击「允许」

也可以手动进系统设置：设置 → 通用 → 键盘 → 键盘 → 飞鸽键盘 → 允许完全访问。

iPad 上切不回系统键盘？

1.2.6 起键盘底部加了地球键，点击可循环切换输入法，长按可以选择指定键盘。

iPad 不会为第三方键盘自动补上系统切换键，所以这个键必须由键盘自己提供。如果你还看不到它，请更新到 1.2.6 或更高版本。

知识库里的多维表格能用吗？

可以。1.2.6 起支持知识库中的多维表格链接（形如 .../wiki/xxx?table=xxx）。

需要额外为飞书应用开通知识库读取权限（如 wiki:wiki:readonly），并把应用添加为该知识库的成员，否则会提示「无权访问该知识库」。

打字速度可以调整吗？

可以。在设置页面的「输出速度」中有三档可选：

支持多少条内容？

默认每次同步 20 条内容。你可以在设置页面的「高级设置」中调整拉取数量：

• iOS：设置 → 高级设置 → 拉取数量
• macOS：设置 → 高级设置 → 拉取数量

建议根据你的表格内容量调整：

• 内容较少（< 50 条）：保持默认 20 条即可
• 内容较多（50-200 条）：可设置为 50 或 100 条
• 内容很多（> 200 条）：可设置为 100 或更多

数据安全吗？

• iOS：键盘扩展不联网、不上传、不记录你的输入。「允许完全访问」权限仅用于在本机读写你自己同步的文案（详见隐私政策）
• Android：输入法不收集任何输入数据，所有数据仅在本地处理
• 飞书凭证仅存储在你的设备上
• 图片留在应用沙盒，只有你主动保存才会写入相册

支持哪些平台？

飞鸽键盘支持：

• iOS 17.0+：支持 iPhone，通过键盘扩展在任何 App 中使用
• Android 8.0+：支持 Android 手机，通过输入法在任何 App 中使用

可以在以下平台使用飞鸽键盘：

• 小红书
• 微博
• 抖音
• 微信公众号
• 知乎
• 备忘录
• 以及任何支持第三方键盘/输入法的 App

没找到答案？前往 联系我们 反馈问题或提功能建议。