App 配置与同步

配置飞书凭证

打开飞鸽键盘应用
进入设置页面：
- iOS：点击底部「设置」标签
- Android：点击右上角设置图标
填入以下信息：
- App ID：从飞书开放平台「凭证与基础信息」获取
- App Secret：从飞书开放平台「凭证与基础信息」获取
- 多维表格 URL：从飞书多维表格复制的完整 URL，支持直接分享链接（/base/...）和知识库链接（/wiki/...）
测试连接（推荐）：点击右侧的「测试连接」按钮，验证配置是否正确
测试通过后，即可开始同步数据

只需要配置这三项信息即可。确保飞书应用已开通多维表格权限；使用知识库链接时还需开通知识库读取权限，详见飞书应用配置。

测试连接功能

配置完成后，强烈建议先点击「测试连接」验证配置，避免同步时出错。

测试会依次检查：

✓ 配置验证 — 检查必填项是否完整、URL 格式是否正确
✓ 认证测试 — 验证 App ID 和 App Secret 是否正确
✓ 数据获取 — 测试应用权限和多维表格访问
✓ 图片下载 — 测试图片附件访问（如果有）

测试结果会以弹窗形式显示，包含详细的步骤反馈：

成功示例：


连接测试成功！

✓ 配置验证通过
✓ URL 格式正确
✓ 认证成功
✓ 数据获取成功，共 5 条记录
✓ 图片下载成功 (3 条)

失败示例：


连接测试失败

权限不足 (403)
请检查应用权限配置
需要：bitable:app:readonly

✓ 配置验证通过
✓ URL 格式正确
✓ 认证成功
✗ 权限验证失败

如果测试失败，请根据错误提示检查配置：

认证失败：检查 App ID 和 App Secret 是否正确
权限不足 (403)：前往飞书开放平台检查应用权限
资源不存在 (404)：检查多维表格 URL 是否正确
无法识别该 URL：确认链接形如 .../base/xxx?table=xxx 或 .../wiki/xxx?table=xxx，知识库首页链接无法识别
无权访问该知识库：为应用开通 wiki:wiki:readonly 权限，并把应用加为知识库成员
网络错误：检查网络连接是否正常

输出速度

在设置页面的「输出速度」区域选择键盘打字的节奏：

档位	说明
正常	一次性输入，速度最快
微慢（默认）	模拟打字节奏，5-10 字符一组，每组间隔 30-70ms
拟人	模拟真人输入习惯，适合对输入检测严格的平台

键盘设置

iOS 的「键盘设置」区域包含：

开启允许完全访问 — 点击直接跳转到系统设置，不用自己翻菜单。键盘里的「标记已使用」需要此权限才能保存
自动标记已使用（仅分组模式）— 在键盘中选择内容输入完成时，自动将该条标记为已使用

iOS 不允许未开启「允许完全访问」的键盘扩展写入共享数据，因此键盘内的「标记已使用」会存不下来。未开启时填入标题、正文等功能照常可用。

最省事的开启方式：在这里点击「开启允许完全访问」→ 跳转后进入「键盘」→ 打开「飞鸽键盘」和「允许完全访问」两个开关。也可以手动走：设置 → 通用 → 键盘 → 键盘 → 飞鸽键盘 → 允许完全访问。完整步骤见键盘扩展使用。

键盘不联网、不上传，此权限仅用于本机读写你自己同步的文案。

高级设置

在设置页面的「高级设置」区域，你可以配置：

拉取数量：每次同步时从飞书拉取的记录数量，默认为 20 条

如果你的多维表格内容较多，可以适当增加拉取数量（如 50、100）以减少同步次数。但数量过大可能会影响同步速度。

同步数据

iOS

切换到「内容」标签
点击右上角的「同步数据」按钮或下拉刷新
等待数据同步完成
查看同步的内容列表

同步时会显示实时进度：连接飞书 → 获取数据 → 保存数据。

浏览内容

同步完成后，你会看到卡片式的内容列表：

每张卡片显示标题预览（2行）、正文预览（3行）、图片数量
已使用的条目会降低透明度
点击卡片进入详情页，查看完整内容和配图

保存配图

在内容列表中，找到需要发布的内容
点击该条目下方的「保存配图」按钮
首次使用会请求相册权限，点击「允许」
等待图片保存完成

图片会保存到系统相册，方便在小红书等平台发布时选择。

同步模式

飞鸽支持两种同步模式：

模式	说明
智能合并（默认）	保留已有的使用状态和相册保存状态，只更新内容
覆盖写入	完全刷新数据，会弹出确认对话框

内容模式

飞鸽提供两种内容展示模式，可在设置中切换：

逐条模式（默认）

每条记录作为一个整体展示，包含标题、正文、标签、评论语和配图。适合按条浏览和发布。

分组模式

将所有记录的标题、正文、标签、评论语、图片分别归类到独立的 Tab 中。适合需要灵活组合内容的场景。

分组模式下支持：

分 Tab 浏览 — 标题、内容、标签、评论语、图片各自独立管理
批量添加 — 点击右上角「+」按钮，从剪贴板粘贴多条内容，一次性添加（详细说明）
批量删除 — 长按进入编辑模式，多选后批量删除
已使用标记 — 每条内容可单独标记为已使用

批量添加时，标题和标签按每行一条解析，正文和评论语按空行分隔解析。

配置完成后，前往键盘扩展使用了解如何在小红书中使用。