📦 装扮管理
v1.0.1Bilibili garb (个性装扮) 数据 collection and 管理. 搜索 garb items, query suit/collection details, scan benefit 数据 for owned items (including discontin...
详细分析 ▾
运行时依赖
版本
Add Apache-2.0 license
安装命令
点击复制技能文档
# Bilibili Garb (B站个性装扮) 收集并管理 Bilibili 个性装扮数据:装扮套装、数字卡收藏集及 benefit 子项。 ## 配置 所有认证凭据均从环境变量或配置文件读取。在 workspace 中创建 configs/bili-api-creds.json: ``json { "appkey": "27eb53fc9058f8c3", "appsecret": "", "access_key": "", "csrf": "", "DedeUserID": "", "SESSDATA": "" } ` 或导出环境变量: `bash export BILI_SESSDATA="" export BILI_ACCESS_KEY="" export BILI_CSRF="" export BILI_UID="" ` > 获取凭据方法:从 Bilibili 移动端 HTTP 流量抓取(如 mitmproxy、Charles)。access_key 会定期过期,需要刷新。 ## 命令 ### 搜索装扮条目 `bash bash scripts/bilibili-garb-search.sh "关键词" ` 同时搜索官方 API 与本地图鉴数据库。输出 Markdown 包含: - 收藏集(收藏集)及其 biz_id - 套装条目(套装)及其 item_id - 本地图鉴中的绝版条目,标记为 [藏馆-绝版] ### 查询收藏集/套装详情 `bash bash scripts/bilibili-garb-collection.sh -i ` - ID ≤ 6 位 → 收藏集模式 - ID > 6 位 → 套装模式 - 对绝版条目自动回退到本地图鉴数据库 ### 扫描 Benefit 数据 `bash python3 scripts/garb-benefit-scan.py [options] ` 从 data/decorations-database.json 读取已拥有的装扮条目,逐个调用 benefit API,并将结果追加至 data/garb-benefit-results.ndjson。 选项: - --limit N — 仅处理前 N 条 - --dry-run — 仅显示待扫描条目,不实际调用 API - --force — 重新扫描已有 benefit 数据的条目 - --debug — 输出完整 API 响应 支持断点续扫(Ctrl+C 安全)与去重。 ## 关键 API 知识 完整 API 文档见 references/bilibili-garb-api-reference.md。重点: 1. Benefit API (/x/garb/v2/user/suit/benefit) 是获取绝版条目数据的唯一方式,需要登录态。 2. DIY 套装:当 item_id 带连字符(如 1775103232001-0)时,需将 biz_id 作为 item_id 参数传入,原 item_id 会返回 -400。 3. part 参数:仅 part=space_bg 一次调用即可返回全部 9 种子项类型,无需循环。 4. 品级判定:以 item_list API 的 scarcity 字段为准。当 scarcity_rate=2 且 rate2_count==1 时,默认小隐(30),勿自动升为大隐。 5. DLC 头像框:必须从 lottery_home_detail 获取,不能取自收藏集自身的 frame/frame_image`。 ## 标准操作流程 分步工作流程见 references/bilibili-garb-sop.md。