Best Minds
DistroKid 上传：CSV 自动生成与一键填表
2026-01-16 23:46 · 独立音乐发布流程 · 本仓库 DistroKid 工具链
把 _pre_publish 的手工 CSV 变成 ./dk prepub 一条命令 + Chrome 扩展一键完成
要点速览
- 用 ./dk prepub 从 _pre_publish/<主题>/<列表外|列表内> 生成 distrokid_tracks.csv/.json（album 自动填 <主题>）
- Chrome 扩展 v2 导入 CSV 后“一键完成”填 Title / Songwriter / Apple credits
- 曲目过多时：./dk batch（分批）或 ./dk albumize（拆多张专辑，每张 <=35）
关键洞见
- 单一真相：从文件夹事实（文件名/侧车）生成 CSV，而不是手改 CSV
- 真正必须手动的只有“选择文件/文件夹授权”（浏览器安全限制），其余应自动化
- 把 defaults/profile 固化进工具，让 SOP 只承担“复核”而不是“记忆步骤”
步骤指南（新手友好）
新手模式
- 准备默认值
确认 tools/distrokid/distrokid_defaults.json 已填 artist/real name/credits。 - 生成 CSV
运行：./dk prepub '3_clone_douyin/tools/_pre_publish/春节/列表外'（写入 distrokid_tracks.csv/.json）。 - 打开 DistroKid
打开 https://distrokid.com/new/ 并切到 Album/多首歌模式。 - 扩展一键填表
扩展面板选择文件夹（含 distrokid_tracks.csv）→ 自动导入 → 点“一键完成”。 - 提交前复核
核对 album/title/explicit/instrumental/credits；若音频未绑定，手动选一次文件夹授权。
检查清单
-
目标目录里已有 distrokid_tracks.csv/.json，且曲目数正确
-
vocal/instrumental profile 正确（有歌词侧车通常选 vocal_zh）
-
album 已确认（默认 <主题>；需要时用 --album 覆盖）
-
Apple credits：每首至少 1 Performer + 1 Producer
-
提交前做一次人工合规复核（版权/封面/发行日期/平台规则）
奥卡姆优先（只保留必要的）
- 不要手改 CSV：改文件名/目录结构后重跑 ./dk prepub
- 不要在网页逐首复制粘贴：让扩展批量填 Title/Songwriter/Credits
- 不要一次塞进超大合集：超过阈值就 batch/albumize
SVG 图解
专家视角
Atul Gawande — Surgeon, writer; author of The Checklist Manifesto
- 立场： 把流程写成可执行的最小检查单：工具生成 + 人类复核。
- 论据： 当任务重复且字段多时，最大的风险来自小错误的累积；把默认值固化、把步骤序列化，并保留最后的人工复核点，会显著降低返工与漏填。
- 边界： 脚本不能绕过浏览器文件选择安全；专辑名/封面/发行日期/版权等不可自动推断的信息仍需你最终确认。
“（paraphrase）Checklist 的价值是让专家在复杂流程中少犯低级错。” — The Checklist Manifesto
方案对比
| 方案 | 适用场景 | 收益 | 代价 | 关键风险 | 第一步 |
|---|---|---|---|---|---|
| A | 固定 _pre_publish 目录结构 | 一条命令生成 CSV/JSON；默认值可复用；album 自动填 <主题>。 | 仍需你决定最终专辑名/发行日期等；曲目过多时需要拆分。 | defaults/profile 配错（vocal/instrumental）导致上传信息偏差。 | ./dk prepub '3_clone_douyin/tools/_pre_publish/春节/列表外' |
| B | 曲目 >35 需要拆专辑 | 自动拆分多张专辑文件夹，每张自带 CSV/JSON（便于逐张上传）。 | 分组/命名可能不符合你的审美，需要人工调整。 | 歌词侧车缺失会降低聚类质量；拆分后需再确认每张专辑的语义一致性。 | ./dk albumize '3_clone_douyin/tools/_pre_publish/春节/列表外' --max-tracks 35 --defaults tools/distrokid/distrokid_defaults.json |
证据与置信度
| 主张 | 证据 | 置信度 | 来源 |
|---|---|---|---|
| 仓库已具备：从文件夹生成 DistroKid CSV/JSON + 扩展导入后一键填表。 | tools/distrokid/dk.py（新增 prepub）+ plugin make_tracks_csv.py + chrome_extension_v2。 | 高 | Repo files (local) |
下一步
- 对目标列表目录跑 ./dk prepub
- 在 DistroKid 页面用扩展“一键完成”
- 若 >35 首，先 ./dk albumize 再逐张上传
细节（可选）
二级页面
保持主报告简洁。复杂推导、长表格、深度材料放到二级 HTML 页面，再在这里以链接方式引用。
- 新增命令：
./dk prepub（代码：tools/distrokid/dk.py） - 示例目录：
3_clone_douyin/tools/_pre_publish/春节/列表外（已生成distrokid_tracks.csv/.json） - SOP：
standard/prompt/发布/上传/DistroKid_批量上传_自动CSV_SOP.md - 扩展（v2）：
3_clone_douyin/plugin/distrokid-tools/distrokid/chrome_extension_v2 - 更长版说明：
3_clone_douyin/plugin/distrokid-tools/DISTROKID_BULK_UPLOAD_SOP.md
一条命令：
./dk prepub '3_clone_douyin/tools/_pre_publish/春节/列表外'来源
收尾总结
把“上传填表”当成一条发布流水线：工具生成 → 扩展导入 → 人类复核 → 提交。
- 每次上传都从目录重新生成 CSV，避免手工漂移。
- 默认值放进 defaults/profile，减少每次决策与出错。
- 把不可自动化的步骤（文件授权/合规确认）显式留给人。
一个下一步动作
现在就跑：./dk prepub '3_clone_douyin/tools/_pre_publish/春节/列表外'
“自动化不是为了更快，而是为了更少地出错。
把人留在最后的复核点。”
— Zon SOP