App 配置与同步

配置飞书凭证

1. 打开飞鸽键盘应用
2. 进入设置页面：
   • iOS：点击底部「设置」标签
   • Android：点击「设置」标签
3. 填入以下信息：
   • App ID：从飞书开放平台「凭证与基础信息」获取
   • App Secret：从飞书开放平台「凭证与基础信息」获取
   • 多维表格 URL：从飞书多维表格复制的完整链接；iOS / macOS 支持 /base/ 和 /wiki/，Android 目前请使用 /base/ 形式的链接
4. 设置会自动保存，不需要另找「保存配置」按钮。iOS 点击「测试连接」，验证配置是否正确；Android 填完后回到内容页同步验证
5. iOS 看到连接成功后，继续下面的「同步数据」步骤

图中「飞书配置」的三个输入框，从上到下依次是 App ID、App Secret、多维表格 URL。「测试连接」在这组输入框的下方右侧。初次配置先填好这三项，下方的内容模式和使用状态同步选项保持默认即可。

测试连接功能（iOS）

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

测试会依次检查：

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

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

成功示例：

弹窗底部的「复制结果」可以把完整测试信息复制下来，反馈问题时一并附上会方便排查。

失败示例：

连接测试失败

权限不足 (403)
请检查应用权限配置

✓ 配置验证通过
✓ 已识别多维表格链接
✓ 认证成功
✗ 权限验证失败

同步数据

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

完成检查： 列表里出现你在飞书填写的测试标题和正文，图片也已显示。如果只看到文字、没有图片，先按图片下载排查处理，再继续启用键盘。

浏览内容

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

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

保存配图

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