多维表格附件视频预览插件

这个插件用于在飞书多维表格右侧栏中预览附件字段里的视频文件，支持通用模式（任意多维表格）。

功能说明

• 自动监听当前选中单元格。
• 当选中附件单元格时，自动解析该格中的视频附件并播放。
• 若自动识别失败，可切换到手动模式并指定附件字段。
• 一个单元格有多个视频时，默认播放第一个，并可在列表中切换。
• 非视频附件会自动过滤，仅保留可播放视频。

本地启动

npm install
npm run dev

打包发布

npm run build

构建产物位于 dist/，可用于上传到飞书插件托管环境。

飞书提审前校验（推荐）

飞书审核要求入口页面必须位于 dist/index.html。建议提审前执行：

npm run build:feishu

该命令会在构建完成后强校验 dist/index.html 是否存在且为 HTML 文档，不满足则直接报错。

代理地址配置

• 链接视频（非附件直链）默认通过 https://tborders.befriends.com.cn:18174/video-proxy 转发。
• 可通过环境变量 VITE_VIDEO_PROXY_BASE 覆盖代理基地址（例如测试环境）。
• 服务端 scripts/video_proxy_server.py 仅允许转发白名单域名（字节系 CDN + 阿里云 OSS *.aliyuncs.com 等）。修改白名单后需重新部署代理进程方可生效。

接入说明（飞书多维表格）

1. 在飞书开放平台创建多维表格扩展（侧边栏类型）。
2. 将开发地址配置为本地 vite 地址进行调试，或上传 dist/ 产物进行发布。
3. 在多维表格中安装该扩展后，点击任意记录的附件单元格即可在右侧预览视频。

已知限制

• 需要插件对当前表有读取附件权限。
• 依赖多维表格返回可用附件 URL，权限不足时会显示错误信息。
• 某些非常规视频格式可能受浏览器编解码能力限制。