ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

AutoClip B站管理功能实战指南:账号管理、Cookie导入与切片投稿全流程

AutoClip B站管理功能实战指南:账号管理、Cookie导入与切片投稿全流程 AutoClip B站管理功能实战指南账号管理、Cookie导入与切片投稿全流程【免费下载链接】autoclipAutoClip : AI-powered video clipping and highlight generation · 一款智能高光提取与剪辑的二创工具项目地址: https://gitcode.com/GitHub_Trending/autoc/autoclipAutoClip 是一款 AI 驱动的视频高光提取与二创工具其中内置的 B 站管理模块为创作者提供了从账号接入到切片一键投稿的完整闭环。本文以 docs/BILIBILI_MANAGER_GUIDE.md 为核心骨架结合仓库后端 API、账号健康服务、上传服务与前端组件源码系统讲解 B 站账号的添加与管理方式、Cookie 获取与安全存储机制、切片投稿的完整流程以及投稿后的状态管理与故障排查方法帮助读者在 AutoClip 中安全、稳定地完成 B 站多账号管理与自动化投稿。功能概述为小白用户设计的账号管理与投稿体验新的 B 站管理功能专为小白用户设计目标是提供最简单、最直观的账号管理和投稿体验。它主要围绕两大能力展开账号管理支持 Cookie 导入方式接入账号安全可靠支持添加多个 B 站账号实时显示账号健康状态支持一键删除不需要的账号。投稿上传支持在切片详情页直接投稿单个切片支持同时上传多个切片批量投稿投稿时可灵活选择投稿账号分区设置覆盖 B 站全部一级分区。从源码结构看前端入口位于 frontend/src/components/BilibiliManager.tsx这是一个包含账号管理与投稿管理两个标签页的弹窗组件配合 frontend/src/services/uploadApi.ts 中封装的一组/upload接口完成前后端交互后端则由 backend/api/v1/upload.py 的账号路由与投稿路由、backend/services/bilibili_service.py 的账号服务与投稿服务、以及 backend/services/account_health_service.py 的健康检查服务共同支撑。第一步添加 B 站账号进入设置页面点击左侧导航栏的设置进入设置页面。选择B 站账号管理标签页即可看到账号管理入口。打开管理界面并添加账号点击管理 B 站账号按钮弹出 B 站管理弹窗对应前端组件 BilibiliManager.tsx。选择账号管理标签页。点击添加账号按钮打开添加账号表单。获取 Cookie关键步骤Cookie 是 B 站登录凭证的核心载体获取步骤如下打开 B 站网站https://www.bilibili.com并登录。按F12打开浏览器开发者工具。点击Network标签页。刷新页面找到任意一个请求并点击查看。在Request Headers中找到Cookie字段。复制 Cookie 的值注意不包含Cookie:前缀完整的 Cookie 是一个用分号分隔的键值对字符串例如SESSDATAxxxxxx; bili_jctyyyyyy; DedeUserIDzzzzzz; DedeUserID__ckMd5aaaaaa; buvid3bbbbbb导入账号输入账号昵称用于本地识别例如主账号备用账号。粘贴 Cookie 内容。点击添加账号。后端处理与安全性从源码看账号添加并非简单存储字符串而是经历了验证 → 加密 → 落库三个阶段见 backend/services/bilibili_service.pyCookie 验证verify_cookie会携带 Cookie 调用 B 站登录状态接口https://api.bilibili.com/x/web-interface/nav只有当返回code 0且data.isLogin为真时才判定有效并顺带取回midUID、uname用户名、头像、等级等用户信息bilibili_service.py#L33-L72。加密存储验证通过后Cookie 通过encrypt_data加密后存入bilibili_accounts表的cookies字段backend/models/bilibili.py数据库中不会保存明文 Cookie避免凭据泄露。同账号去重如果已存在同名账号则更新其 Cookie 与昵称而不是重复创建。从仓库中的健康检查服务可以确认B 站账号完整登录所需的必要字段包括SESSDATA、bili_jct、DedeUserID缺少这些字段的 Cookie 会被判定为无效见 account_health_service.py#L113-L126因此复制 Cookie 时应确保包含以上关键字段。第二步投稿切片选择切片并打开投稿进入项目详情页找到要投稿的切片。点击切片卡片上的投稿按钮B 站管理弹窗会自动切换到投稿标签页前端逻辑见 BilibiliManager.tsx#L107-L118。配置投稿信息选择 B 站账号从已添加的账号中选择要使用的投稿账号。选择视频分区AutoClip 内置了 B 站全部一级主分区列表定义在 frontend/src/services/uploadApi.ts#L59-L91在 frontend/src/config/bilibiliPartitions.ts 中有相同配置包括动画(1)、游戏(4)、鬼畜(8)、音乐(3)、舞蹈(129)、影视(181)、娱乐(5)、知识(36)、科技数码(188)、资讯(202)、美食(76)、小剧场(138)、汽车(176)、时尚美妆(155)、体育运动(235)、动物(75)、vlog(21)、绘画(162)、人工智能(207)、家装房产(208)、户外潮流(209)、健身(164)、手工(161)、旅游出行(165)、三农(158)、亲子(159)、健康(160)、情感(163)、生活兴趣(22)、生活经验(23)等括号内为分区 ID。输入视频标题标题会在投稿时作为 B 站稿件标题提交。添加描述和标签可选描述与标签数组会在创建投稿记录时以 JSON 字符串形式存入数据库。开始投稿点击开始投稿按钮前端会调用createUploadTask创建投稿任务uploadApi.ts#L152-L154。系统会在后台处理投稿前端展示任务状态。投稿完成后会显示成功提示成功后可在投稿记录中看到返回的bv_idBV 号。投稿任务的生命周期投稿记录由后端BilibiliUploadService统一管理backend/services/bilibili_service.py#L386-L697记录状态流转如下状态含义可执行操作pending待处理任务已创建取消processing处理中正在上传取消completed上传成功已记录 BV 号删除failed上传失败记录错误信息重试、删除cancelled已取消删除对应的后端接口与前端封装为POST /upload/projects/{project_id}/upload创建投稿任务POST /upload/records/{record_id}/retry重试失败任务只有failed状态可重试POST /upload/records/{record_id}/cancel取消任务只有pending/processing状态可取消DELETE /upload/records/{record_id}删除记录进行中的任务不能删除需先取消GET /upload/records获取投稿记录列表支持按项目过滤返回结果会 join 账号与项目信息便于前端直接展示账号昵称与项目名bilibili_service.py#L578-L627投稿记录的数据模型见 backend/models/bilibili.py#L42-L78其中partition_id默认值为 17单机游戏分区上传成功后记录bv_id、av_id、上传进度、文件大小与耗时等统计信息。账号健康状态实时掌握每个账号是否可用AutoClip 的账号健康状态体系是实时显示账号健康状态这一功能的底层实现核心逻辑位于 backend/services/account_health_service.py对外暴露的 API 位于 backend/api/account_health.py。健康检查从三个维度综合评估一个账号的状态account_health_service.py#L31-L92Cookie 有效性检查_check_cookie_validity解密后校验必要字段是否存在并结合记录的cookie_expires_at判断是否过期默认提前 7 天预警、30 天判定过期配置常量见 account_health_service.py#L26-L29。登录状态检查_check_login_status调用https://api.bilibili.com/x/web-interface/nav验证是否处于登录态。上传权限检查_check_upload_permission调用https://member.bilibili.com/x/web/archive/pre验证账号是否具备投稿权限。综合评估规则为任一维度为critical/expired则整体critical任一维度为warning/unknown则整体warning全部健康才是healthyaccount_health_service.py#L285-L316。整体状态会写回账号记录并附带last_health_check时间接口层还实现了 5 分钟内的结果缓存避免高频请求打爆 B 站接口backend/api/account_health.py#L61-L73。主要健康检查接口接口说明GET /health/check/{account_id}检查单个账号force_checktrue可跳过缓存强制实时检查POST /health/check批量检查支持指定account_ids不传则检查全部活跃账号返回各状态数量汇总GET /health/summary获取账号健康状态摘要POST /health/refresh-cookie刷新账号 Cookieauto_refreshtrue走 Celery 后台任务POST /health/schedule-check调度健康检查任务支持指定账号或全部账号此外账号服务还提供了多账号运营相关的辅助能力bilibili_service.py#L220-L315select_best_account按VIP 优先 → 等级次之 → 越久未使用越优先的规则智能挑选最佳投稿账号rotate_accounts_for_batch_upload批量投稿时对账号做轮换分配实现负载均衡get_account_upload_stats统计指定账号近 N 天的投稿数、成功率与最后投稿时间。使用技巧Cookie 获取技巧推荐浏览器Chrome、Edge、Firefox。获取位置开发者工具 → Network → 任意请求 → Request Headers → Cookie。格式要求完整的 Cookie 字符串键值对之间用分号分隔建议同时包含SESSDATA、bili_jct、DedeUserID等关键字段。有效期Cookie 通常有 7~30 天有效期过期后需要重新获取并更新。账号管理技巧昵称设置使用有意义的昵称如主账号备用账号测试账号正式账号便于在多账号场景下快速区分。定期检查建议定期检查账号状态利用健康检查接口及时更新过期 Cookie。多账号策略可以设置不同用途的账号例如用测试账号验证投稿流程、用正式账号发布正式内容批量投稿时会按账号轮换规则自动分配。投稿优化技巧标题优化使用吸引人的标题避免过长。分区选择选择合适的分区提高推荐效果。标签设置添加相关标签增加曝光度。批量投稿对于多个相关切片可以同时勾选批量投稿。注意事项安全提醒Cookie 安全Cookie 包含登录信息请妥善保管。AutoClip 后端在存储时会加密encrypt_data但 Cookie 本质是登录凭证不要分享给他人也不要在公共设备上登录。账号安全不要在公共设备上登录发现账号异常及时处理。定期更新建议定期更新 Cookie避免过期导致投稿失败。使用限制上传限制遵守 B 站上传规则和限制。内容规范确保内容符合 B 站社区规范。频率控制避免频繁投稿防止触发风控。故障排除Cookie 无效检查 Cookie 格式和有效期。可以从三个方面自查是否缺少SESSDATA/bili_jct/DedeUserID字段、是否已过期、粘贴时是否误带了Cookie:前缀。上传失败检查网络连接和账号状态先调用健康检查确认账号可用再重试投稿任务。分区错误确认分区 ID 是否正确。AutoClip 内置的分区 ID 均来自官方 API 文档对应的一级主分区 ID见 frontend/src/config/bilibiliPartitions.ts投稿表单中直接选择分区名称即可无需手填 ID。技术说明支持的登录方式AutoClip 支持多种 B 站登录方式后端在 backend/api/v1/upload.py 中通过GET /upload/login-methods返回登录方式列表登录方式风险等级推荐度说明Cookie 导入低⭐⭐⭐⭐⭐推荐最安全不会触发风控本地加密存储账号密码登录中⭐⭐⭐传统方式可能触发验证码有风控风险扫码登录高⭐⭐需要 B 站 APP容易触发风控成功率较低第三方登录微信/QQ中⭐⭐支持有限流程较复杂对应的前端封装见 uploadApi.ts#L96-L137cookieLogin、passwordLogin、startQRLogin/checkQRLoginStatus/completeQRLogin、thirdPartyLogin。其中Cookie 导入是最推荐的方式具体原因如下不会触发 B 站风控机制登录成功率高、操作简单Cookie 在本地加密存储安全性好。上传机制从源码结构看上传机制遵循 B 站官方投稿接口的标准流程backend/services/bilibili_service.py#L700-L929 中保留了预上传、分片上传、合并、提交投稿等阶段的实现骨架直接 API 调用使用 B 站官方投稿接口稳定可靠。分片上传支持大文件分片上传分片大小按 2MB 划分每个分片独立重试。重试机制上传失败自动重试默认最多 3 次指数退避等待。进度跟踪投稿记录中维护progress字段0-100前端可实时展示上传进度。注当前仓库中 BilibiliDirectUploader 的upload_video实现暂返回上传功能正在开发中的占位提示投稿记录创建、任务状态管理、重试/取消/删除等流程均已可用。若你使用的版本遇到投稿接口不可用可先完成账号接入与任务创建流程待上传实现就绪后直接复用现有投稿记录体系。技术支持如果遇到问题可以按以下顺序排查查看系统日志获取详细错误信息后端各服务均有结构化logger输出错误信息也会写入投稿记录的error_message字段。检查网络连接和账号状态调用健康检查接口或在前端查看账号状态标签。重新获取 Cookie 并更新账号Cookie 过期是最常见的原因。若问题依旧可结合 docs/BILIBILI_LOGIN_ALTERNATIVES.md 中的登录替代方案与故障排除章节或参考 docs/COOKIE_IMPORT_TROUBLESHOOTING.md 处理 Cookie 导入相关问题。【免费下载链接】autoclipAutoClip : AI-powered video clipping and highlight generation · 一款智能高光提取与剪辑的二创工具项目地址: https://gitcode.com/GitHub_Trending/autoc/autoclip创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表