geoffrey-svg/trial-reels-starter

Trial Reels Starter 设置指南

一次性设置。请按顺序完成步骤，跳过已就绪的部分。每一步：先用大白话给出简短说明，然后执行操作或提问。技术细节留给你自己处理。

步骤 1：工具准备

1. 在当前目录下运行 ./install.sh。它将安装 ffmpeg（用于制作视频）以及两个 Python 组件（Pillow 和 fontTools），若已安装则跳过。
2. 如果缺少 Homebrew，请引导用户从 brew.sh 安装 Homebrew：用户需在终端中输入 Mac 密码。请向用户解释他看到的提示（密码在输入时不会显示），然后重新运行 ./install.sh。
3. 仅需说：“工具已就绪。”

步骤 2：你的风格

1. 如果用户从 AI Suite 粘贴了一段包含设置块（JSON，包含 tekst 字段）的提示内容：请使用 python3 engine/scripts/instellingen.py --schrijf - 将该设置块写入，并且不要提出任何问题。
2. 否则： 建议用户最方便的方式是在 AI Suite 中选择风格（Trial Reels 磁贴，附带示例），然后粘贴提示。如果用户不想这样做，请一次性询问：字体（通过 python3 engine/scripts/instellingen.py --lettertypes 可获取常用名称和文件名列表）、文字是放在背景块上还是独立字母并带有边框、颜色，以及文字在画面中的位置（上方、中间或下方）。
3. 展示结果：运行 python3 engine/scripts/voorbeeld.py（或者使用 --video <路径> 针对用户自己的视频）。你自己先查看效果，然后展示给用户。询问是否满意。

步骤 3：你希望如何发布？

如果 mijn-trial-reels/accounts.json 已存在但 koppeling.json 不存在，说明这是来自之前版本（1.0，通过 Zernio）的安装。此时不要提问，也不要创建新密钥：直接运行 python3 engine/scripts/sleutel.py --bewaard zernio，然后跳转到步骤 5。

用几句话向用户解释：Reels 将通过关联功能在约定时间发布到 Instagram，由用户选择。给出三个选项并询问用户选择哪一个：

1. Metricool —— 如果用户已经在使用它。Reels 将出现在用户的 Metricool 计划表中，与其他帖子在一起，数据也来自 Metricool。要求：Advanced 或更高订阅（包含 API；根据 metricool.com/pricing 截至 2026 年 10 月 19 日，按年预付每月 €43 起），并且用户的 Instagram 账户需作为品牌添加到 Metricool。
2. Zernio —— 如果用户没有 Metricool 或希望分开管理。免费支持最多 2 个 Instagram 账户，无需信用卡。通过 Zernio 进行排程和数据查看。
3. 自行使用其他工具发布（例如 Later、Buffer 或 Instagram 应用）。系统只生成 Reels；用户需自行将其作为 Trial Reel 上传，并在相应平台查看数据。无需关联：运行 python3 engine/scripts/sleutel.py --zelf，然后跳转到步骤 5。

步骤 4：设置关联

Metricool

1. 运行 ./install.sh --metricool：安装 cloudflared。Metricool 只接受通过公开地址的视频；因此系统仅在排程期间短暂公开 Reels 文件夹。
2. 让用户在 Metricool 中查找 API 信息（如 Metricool 帮助中心 help.metricool.com 中“如何找到 Metricool 用户 ID”所述，查阅日期 2026 年 10 月 19 日）：
   1. Token：Metricool → 账户设置 → 在 API 下。仅 Advanced 和 Custom 订阅有此选项。
   2. 用户编号（userId）：在浏览器中打开 Metricool 并打开一个品牌。地址栏中会显示类似 ...?blogId=12345&userId=1234567 的内容；userId= 后面的数字即为用户编号（blogId= 后的数字为品牌编号，不需要）。
3. 用户将 token 和用户编号粘贴到对话中。使用 printf '%s' '<token>' | python3 engine/scripts/sleutel.py --metricool --user <用户编号> 保存。切勿在回答中重复该 token。脚本会先尝试在 Metricool 验证；若无效，让用户检查（并确认其订阅包含 API）。
4. python3 engine/scripts/koppel.py 将显示带有 Instagram 账户的品牌。使用 python3 engine/scripts/koppel.py --gebruik <Instagram用户名> 设置要使用的品牌。如果该 Instagram 账户关联到多个品牌，脚本会要求输入品牌编号：询问用户是哪个品牌，然后使用 --gebruik <编号>。

Zernio

1. 让用户登录或从 zernio.com 创建账户。进入 API keys，点击 Create API key。用户应立即复制密钥：Zernio 只显示一次。密钥以 sk_ 开头。
2. 用户将密钥粘贴到对话中。使用 printf '%s' '<密钥>' | python3 engine/scripts/sleutel.py 保存。切勿在回答中重复该密钥。如果密钥无效，让用户创建新密钥。
3. python3 engine/scripts/koppel.py --link 将生成一个用于关联 Instagram 的链接。在用户打开该链接之前：请先让用户在 Instagram 中切换到要关联的账户，因为 Instagram 会关联当前登录的账户。
4. 然后运行 python3 engine/scripts/koppel.py 和 python3 engine/scripts/koppel.py --gebruik <名称>。

两种方式均需注意： Instagram 要求使用 专业账户（创作者或企业）且 公开；Trial Reels 需要至少 200 粉丝；粉丝数不足时将发布普通 Reels，这些 Reels 所有粉丝都能看到。请告知用户这一点。如需添加更多账户，可使用 koppel.py --erbij <名称>（不要用 --gebruik，那会替换整个列表）。

步骤 5：发布规则与何为“赢家”

请在一则消息中询问以下问题，并提供默认值，以便用户直接回复“可以”：

1. 每个账户每天发布多少条 Reels？ 默认 5。建议：在新账户上从 2 到 5 条开始。Instagram 通过 API 通常每个账户每天只允许约 5 个 Trial Reels（根据个人账户测试，超过此限制会遭拒绝）；一开始就每天发几十条的测试账户后来失去了曝光。
2. 每条 Reels 之间至少间隔多少分钟？ 默认 45（最小 30）。
3. 在什么时间段内发布？ 默认在 9:00 至 21:00 之间，使用用户计算机的时区（如果时区不正确，请用户确认）。
4. 是否自动推送给粉丝： 用户是希望在 Instagram 应用中手动将表现好的 Trial Reel 公开，还是让 Instagram 自动处理？
5. 何时视为一条 Reel 获胜？ 默认条件：该 Reel 的观看次数至少达到该账户平均观看次数的 3 倍，并且至少 500 次观看。仅在使用 API 关联（Metricool 或 Zernio）时需要。

使用 python3 engine/scripts/instellingen.py --schrijf - 写入回答，仅包含 posten 和 winners 两个块（例如 {"posten": {"per_dag": 3, "minuten_tussen": 45, "van": 9, "tot": 21, "tijdzone": "Europe/Amsterdam", "doorzetten": "zelf"}, "winners": {"factor": 3, "min_views": 500}}）。如果脚本拒绝某个值，请解释原因并重新询问。然后用一句话说明当前设置（python3 engine/scripts/instellingen.py）；如果窗口内可容纳的每日数量少于所选值，则显示实际值。

完成

用两到三句话说明现在可以做什么：提供视频和文本、预览 Reels、批准提案（或自行发布时提取 Reels），并在几天后询问数据。提议立即制作第一批（例如 5 条 Reels）。