bili-note-cookie · B 站视频详情（飞书字段捷径 · Cookie 鉴权版）

是什么

一个飞书多维表格字段捷径（Field Shortcut）的独立发布包。 bili-note 的 Cookie 鉴权版，可获取更精准的播放 / 互动数据，以及登录态可见的隐藏字段。

发布到飞书应用市场后，用户在飞书多维表格里：

1. 新建/打开一张表，加一列字段类型选「字段捷径」→ 选本捷径
2. 在「链接」字段里贴一条 B 站视频 URL
3. 在「Cookie」字段里填入有效的 B 站登录态 Cookie
4. 点击「运行」→ 自动把更精准的视频信息写回当前行

后台调用流程：

飞书多维表格单元格
    ↓ (url + cookie)
bili-note-cookie 字段捷径（本仓）
    ↓ (heyi_agent bilibili/parse_url + get_video_detail，带 Cookie)
B 站内部 API
    ↓ (video view JSON)
字段捷径 → 字段映射 → 写回单元格

与 bili-note 的区别

维度	bili-note	bili-note-cookie（本仓）
是否需要 Cookie	否	是
稳定性	基础公开字段	鉴权后字段更精准（实时播放等）
适用场景	公开数据采集	精细分析 / 登录态可见内容

输入参数

参数	必填	类型	说明
url	✅	Url / Text	B 站视频链接
cookie	✅	Text	B 站登录态 Cookie（关键字段 bili_ticket）

输出字段

字段	类型	说明
id	Text	主键 / 隐藏
bvid	Text	BV 号
aid	Text	AV 号
title	Text	视频标题（主显示）
author	Text	UP 主昵称
description	Text	视频简介
cover_url	Url	封面
pubdate	DateTime	发布时间
keywords	Text	关键词
page_link	Url	视频页面链接
view_count	Number	播放量
danmaku_count	Number	弹幕数
reply_count	Number	评论数
favorite_count	Number	收藏数
coin_count	Number	投币数
share_count	Number	分享数
like_count	Number	点赞数
ext_time	DateTime	数据抓取时间
error_message	Text	错误信息

鉴权机制

B 站对登录态可见内容有权限控制，调用方需在请求头带 Cookie 字段，关键登录态字段：

• bili_ticket（B 站核心登录态）

Cookie 获取方式：

1. 浏览器登录 B 站 → F12 → Network → 复制请求头 Cookie 字段

⚠️ Cookie 会过期，失效后输出 error_message，需重新获取。

用户使用流程

步骤 1：在飞书多维表格里配置字段捷径

1. 新建/打开一张表
2. 加一列，类型选「字段捷径」→ 选本捷径
3. 在捷径配置里填入：
   • url 字段：选本表的「B 站视频链接」列
   • cookie 字段：手动粘贴一段有效的 B 站 Cookie

步骤 2：运行

1. 在「B 站视频链接」列填一条视频 URL
2. 点击「运行字段捷径」→ 自动把 18 个字段写回当前行

两种使用方式

方式 1：独立发布包（本仓）

cd bili-note-cookie
npm install
npm run dev
npm run build
npm run pack       # 字段捷径 output/output_*.zip，工作流节点 output/action/output.zip

发布：把 zip 上传到 飞书开发者后台 → 字段捷径 → 上传 zip

方式 2：聚合仓内开发

cd ../lark_field_shortcut
npm run dev:bili-note-cookie
npm run build:bili-note-cookie
npm run pack:bili-note-cookie
npm run test:bili-note-cookie

聚合仓模式下，60+ 客户端共享底层工具（detailClient / runtime / i18n / validators / linkResolve），新功能请直接开发在聚合仓对应 clients/bili-note-cookie/。

关键约束（CLAUDE.md 摘要）

• 客户端隔离：@lark-opdev/block-basekit-server-api 内部 basekit 是单例，禁止在 src/index.ts 静态 import 全部 18+ 客户端（会互相覆盖）。聚合仓已通过 process.env.VITE_CLIENT 运行时动态 require 解决。
• pack 必须用自建脚本：block-basekit-cli pack:field 会泄漏所有客户端代码到 zip，必须用聚合仓的 scripts/pack-client.js 走扁平 build/ 流水线。
• i18n 强制：i18n/{zh-CN,en-US,ja-JP,index}.ts 四文件必须齐全，禁止 makeI18nMessages / value === key 占位。
• ENDPOINTS 维护：调用 heyi_agent 扁平 operation，已废弃 /raw/ 路径。

仓库地址

https://gitcode.com/weixin_45178729/bili-note-cookie.git

License

Private（仅供业务方使用）。