全套查看飞书 IM 追加溯源参数的方法，分电脑端、移动端、网站后端抓取、flow‑extra 解码
一、PC 飞书（最省事）
方式 1‑地址栏直接复制完整链接
- 在飞书聊天 / 内嵌笔记点击外链
- 链接唤起系统浏览器；浏览器顶部地址栏就是带全部溯源参数的完整 URL，直接复制即可
注意：飞书内置浏览器预览会隐藏参数，一定要选择在外部浏览器打开
方式 2 F12 开发者工具查看完整请求参数
- 浏览器打开网页，按下
F12→ Network（网络） - 刷新页面，点开第一条文档请求
- Headers‑Query String Parameters，所有飞书追加参数全部罗列在此
二、手机端飞书
- 点击消息里面的链接
- 右上角「…」→ 在浏览器打开
- 调取手机自带浏览器，顶部网址栏即可拿到完整带参链接
- 安卓：长按地址栏复制
- iPhone：轻点地址框全选复制
重点：飞书内置内置浏览器会隐藏跳转附加参数，必须跳转至系统原生浏览器
三、你的网站前端 JS 获取所有溯源参数
直接复制下面代码，可以读取、打印、解析飞书全部 query 参数，适合调试、记录来源 doc‑id
javascript
运行
//读取全部url参数
const params = new URLSearchParams(location.search);
//单独取出每一个
let f_link_type = params.get("f_link_type");
let flow_extra = params.get("flow_extra");
let sec_link_scene = params.get("sec_link_scene");
console.log("飞书全部溯源参数",Object.fromEntries(params));
//解码 base64 的 flow_extra
function base64Decode(str){
return JSON.parse(atob(str))
}
console.log( base64Decode(flow_extra) )
解码之后就能拿到笔记 ID、链接所在位置等埋点信息。
四、后端服务端捕获（Nginx、PHP、Java）
- Nginx：
$args变量可以拿到全部 GET 溯源参数 - PHP：
$_GET - Nodejs：
req.query
五、flow_extra 解码教程
你遇到的
flow_extra=eyJxxx== 属于 Base64 加密 JSON
- 复制等号后面字符串
- 在线 base64 解密，即可得到 json：
json
{
"inline_display_position":0,
"doc_position":0,
"doc_id":"1a1e005d403c6a4c‑cf7c11d6052d9433"
}
doc_id 就是飞书那条内嵌笔记唯一编号，用来做流量溯源。
六、常见参数对照表
表格
| 参数 | 作用 |
|---|---|
| f_linkinlinenote | 来源：聊天内嵌笔记链接 |
| flow_extra | Base64 埋点，笔记 ID、链接位置 |
| use_xbridge3 | 第三代跨端跳转组件 |
| loader_name=forest | 飞书外链加载内核 |
| need_sec_link=1 | 开启外链安全风控校验 |
| sec_link_scene=im | 打开场景：即时通讯聊天 |
| theme=light | 适配浅色客户端主题 |
七、拓展：网站自动清理飞书溯源垃圾参数（防止重复 URL 造成统计混乱）
//页面加载自动剔除飞书追踪参数
let url = new URL(location.href);
url.searchParams.delete('f_link_type');
url.searchParams.delete('flow_extra');
url.searchParams.delete('use_xbridge3');
url.searchParams.delete('loader_name');
url.searchParams.delete('need_sec_link');
url.searchParams.delete('sec_link_scene');
url.searchParams.delete('theme');
history.replaceState({},'',url.href)