用途:为新沙盒初始化文件系统,根据已连接账号的组织与艺人数据生成目录结构。
主要能力:调用 Recoup CLI 获取组织与艺人列表,为每个艺人创建目录并写入 RECOUP.md 标识文件,最后提交并推送。
使用方式:先检查环境变量 RECOUP_ACCOUNT_ID 是否设置。若设置,所有命令加 --account $RECOUP_ACCOUNT_ID;若未设置则省略该参数。依次运行 recoup orgs list --json [--account $RECOUP_ACCOUNT_ID] 获取组织,再对每个组织运行 recoup artists list --org {organization_id} --json [--account $RECOUP_ACCOUNT_ID] 获取艺人。目录名使用 CLI 返回的 artistSlug,不得追加 UUID 或后缀;若 orgs/{org}/artists/{artist-slug}/ 已存在则跳过;否则执行 mkdir -p orgs/{org}/artists/{artist-slug}。每个艺人目录写入 RECOUP.md,包含 artistName、artistSlug、artistId 三个字段。完成后执行 git add -A && git commit -m "setup: create org and artist folders" && git push origin main。
适用场景:需要为 Recoupable 平台账号批量搭建工作区目录时。
限制:RECOUP_ACCOUNT_ID 仅在使用 Org API Key 时需要;使用 Personal API Key 时省略 --account,CLI 自动使用已认证账号。RECOUP.md 是工作区激活标识。其余细节暂未提供。