1
创建飞书自建应用
- 打开 飞书开发者后台
- 点击右上角 「创建企业自建应用」
- 填写应用名称（如
LinuxDo Saver）和描述 - 创建成功后，在「凭证与基础信息」中获取：
| 字段 | 说明 | 示例 |
|---|---|---|
| App ID | 以 cli_ 开头 | cli_a1b2c3d4xxxx |
| App Secret | 点击显示 | xxxxxxxxxxxxxxxx |
App Secret 只显示一次，请妥善保存！
2
配置应用权限
- 点击左侧菜单「权限管理」
- 搜索并开通以下 2 个权限（免审权限）：
| 权限名称 | 权限标识 | 用途 |
|---|---|---|
| 多维表格 | bitable:app | 读写多维表格（必须） |
| 上传文件 | drive:file:upload | 上传 MD 附件时需要 |
点击「批量开通」完成授权。
3
发布应用
- 点击左侧菜单「版本管理与发布」
- 点击「创建版本」，填写版本号（如
1.0.0） - 点击「申请发布」，选择发布范围
- 等待审核通过（管理员可直接审核）
应用状态变为「已启用」后才能使用
4
创建多维表格
- 打开 飞书文档
- 点击「新建」→「多维表格」
- 输入表格名称（如
LinuxDo 收藏）
5
创建必需字段（7个）
在数据表中创建以下字段，名称和类型必须完全一致：
| 序号 | 字段名 | 字段类型 | 说明 |
|---|---|---|---|
| 1 | 标题 | 文本 | 帖子标题 |
| 2 | 链接 | 超链接 | 帖子 URL（可点击） |
| 3 | 作者 | 文本 | 发帖人 |
| 4 | 保存时间 | 日期 | 自动记录时间 |
| 5 | 评论数 | 数字 | 评论条数 |
| 6 | 附件 | 附件 | MD 文件 |
| 7 | 正文 | 文本 | 内容摘要 |
「链接」必须是超链接类型，不是文本！
6
添加应用为协作者
- 在多维表格页面，点击右上角「分享」
- 搜索你创建的应用名称
- 权限设置为「可编辑」
- 点击「确定」
这一步非常重要！否则应用无法访问表格。
7
获取 app_token 和 table_id
打开多维表格，从浏览器地址栏 URL 中提取：
URL 格式：
https://xxx.feishu.cn/base/VwGKbWxQXaKDxxxx?table=tblABC1xxxx&view=vewDEFxxxx提取结果：
app_token: VwGKbWxQXaKDxxxx （/base/ 后面到 ? 之前）table_id: tblABC1xxxx （?table= 后面，以 tbl 开头）
注意区分：
- app_token：整个多维表格文档的标识
- table_id：当前数据表的标识（以
- app_token：整个多维表格文档的标识
- table_id：当前数据表的标识（以
tbl 开头）
8
配置浏览器插件
- 打开插件配置页面（右键插件图标 → 选项）
- 勾选「保存到飞书多维表格」
- 填写配置信息：
| 配置项 | 填写内容 |
|---|---|
| API 版本 | 飞书（国内版）或 Lark（国际版） |
| App ID | 步骤 1 获取的 App ID |
| App Secret | 步骤 1 获取的 App Secret |
| 多维表格 Token | 步骤 7 获取的 app_token |
| 数据表 ID | 步骤 7 获取的 table_id |
点击「保存设置」。
9
测试连接
- 点击「测试连接」按钮
- 成功后显示字段验证通过和记录数
- 打开 LinuxDo 帖子，单击链接按钮测试保存
配置完成！现在可以一键保存帖子到飞书了。
关于评论保存的重要说明
由于浏览器技术限制，插件只能获取当前页面已加载的评论。
如果帖子评论较多：
1. 保存前请先滚动页面，加载更多评论
2. 插件只能抓取已经显示在页面上的评论
3. 未加载的评论（需要点击"加载更多"或滚动才能显示的）无法被获取
建议：保存前滚动到页面底部，确保所需评论已加载。
由于浏览器技术限制，插件只能获取当前页面已加载的评论。
如果帖子评论较多：
1. 保存前请先滚动页面，加载更多评论
2. 插件只能抓取已经显示在页面上的评论
3. 未加载的评论（需要点击"加载更多"或滚动才能显示的）无法被获取
建议：保存前滚动到页面底部，确保所需评论已加载。
配置检查清单
常见问题
Q: 提示「App ID 或 App Secret 错误」
检查凭证是否正确复制，App ID 必须以
cli_ 开头。Q: 提示「多维表格不存在」或「数据表不存在」
重新从 URL 提取 app_token 和 table_id，注意 table_id 以
tbl 开头。Q: 提示「没有权限访问」
检查是否将应用添加为多维表格的协作者（可编辑权限）。
Q: 提示「缺失字段」或「字段类型错误」
检查 7 个字段名称和类型是否完全一致，特别是「链接」必须是超链接类型。
Q: 评论保存不完整？
浏览器只能获取已加载的内容。保存前请先滚动页面，加载更多评论。
Q: 飞书国内版和 Lark 国际版的区别？
国内版域名 feishu.cn，国际版域名 larksuite.com，根据账号类型选择。