独立开发者应用营销流水线

一套面向独立 iOS 开发者的零 LLM 日常营销系统。只需一次性撰写你的内容角度（angles），后续由周计划器（Weekly Planner）与日发布器（Daily Publisher）自动完成：生成各平台原生文案，并通过 Postiz 自动排期发布。

流水线功能说明

1. 周计划器（Weekly Planner） —— 读取你的内容库（content bank），筛选尚未使用过的角度，套用各平台专属模板，生成 weekly-plan-YYYY-MM-DD.json 文件。
   无需 LLM。每周运行一次（或在新增角度后手动运行）。

2. 日发布器（Daily Publisher） —— 每日清晨（cron 设为上午 7 点）自动执行，读取当周计划中对应当天的条目，并通过 Postiz 公共 API 将其排期发布。

   • X（原 Twitter）、Facebook 的纯文本帖直接排期发布；
   • TikTok / YouTube Shorts 则触发你的视频生成脚本（或通过 --text-only 参数跳过视频环节）。

你唯一需要调用 LLM 的场景，是当内容库枯竭时，补充新的角度。

支持的平台

架构图

content-bank.json         ← 你的角度集合（含 hook + 文案段落 + caption）
       │
       ▼
weekly-planner.js         ← 选取角度、渲染模板 → weekly-plan.json
       │
       ▼
weekly-plan-YYYY-MM-DD.json
       │
       ▼
daily-publisher.js        ← 读取当日条目 → Postiz API → 进入实时排期队列
       │
       ▼
Postiz (postiz.com)       ← 缓冲并按设定时间向各平台发布

模板系统 —— content-templates.json 定义各平台文案模式（如 hot-take、question-hook、relatable-meme 等）。计划器会轮转使用不同模式，避免重复。支持变量：{hook}、{insight}、{cta}、{appName}、{appHandle}、{hashtags}。

发布历史记录 —— posting-history.json 追踪已发布的角度，确保计划器仅在内容库耗尽后才循环复用已有角度。

初始化配置

1. 所需账号

• Postiz —— 可自托管或使用云服务（postiz.com），免费版即可满足需求。
  在 Postiz UI 中连接你的 TikTok、YouTube、X 和 Facebook 账号，并记下各平台的 integration ID。

• 社交平台账号 —— TikTok 创作者账号、YouTube 频道、X 账号、Facebook 专页。

2. 运行初始化脚本

cd /path/to/your-app-marketing/
bash skills/indie-app-marketing-pipeline/scripts/setup.sh

该脚本将执行以下操作：

• 创建目录结构（plans/、logs/、content-bank.json 等）；
• 提示输入 Postiz URL、API Key 及各平台 integration ID；
• 生成含 10 个初始角度的示例内容库；
• 创建 .env 文件。

3. 配置你的应用信息

编辑由 setup.sh 创建的 config.json：

{
  "app": {
    "name": "YourAppName",
    "handle": "@YourHandle",
    "appStoreUrl": "https://apps.apple.com/app/yourapp",
    "websiteUrl": "https://yourwebsite.com",
    "topicCategory": "productivity"
  },
  "postiz": {
    "apiKey": "$POSTIZ_API_KEY",
    "integrationIds": {
      "tiktok": "your-tiktok-integration-id",
      "youtube": "your-youtube-integration-id",
      "x": "your-x-integration-id",
      "facebook": "your-facebook-integration-id"
    }
  }
}

4. 编辑内容库

向 content-bank.json 中填充适用于你应用的角度。格式参考 assets/sample-content-bank.json，策略指南参见 references/content-bank-guide.md。

每个角度需包含以下字段：

{
  "id": "unique-kebab-case-id",
  "hook": "一句抓人眼球的 hook",
  "texts": [
    "视频脚本开场句",
    "第二段落",
    "第三段落 / 核心洞察",
    "收尾句"
  ],
  "caption": "TikTok / YouTube 视频字幕（含 hashtag）"
}

5. 运行周计划器

node scripts/weekly-planner.js --dry-run          # 预览生成结果
node scripts/weekly-planner.js                    # 实际写入计划文件
node scripts/weekly-planner.js --week 2026-04-07  # 指定起始周（YYYY-MM-DD）
node scripts/weekly-planner.js --days 3           # 仅规划 3 天内容

6. 运行日发布器

node scripts/daily-publisher.js --dry-run         # 预览今日排期内容
node scripts/daily-publisher.js                   # 执行发布（推送到 Postiz）
node scripts/daily-publisher.js --text-only       # 跳过视频，仅排期纯文本帖
node scripts/daily-publisher.js --skip-past       # 跳过已过发布时间的条目

7. 设置日发布器定时任务（macOS cron）

# 打开 crontab 编辑器
crontab -e

# 添加以下行（每日上午 7:00 执行）：
0 7 * * * cd /path/to/your-app-marketing && node scripts/daily-publisher.js >> logs/cron.log 2>&1

也可使用 launchd plist 实现更精细的控制。

自定义选项

发布排期

编辑 weekly-planner.js 中的 VISUAL_SCHEDULE、X_SCHEDULE 和 FB_SCHEDULE 数组。
默认使用美国东部时间（EST）——如需适配本地时区，请修改 toISOEst() 函数中的时区偏移量。

默认排期如下：

内容模板

编辑 assets/content-templates.json 自定义文案模式。计划器会为每个平台轮转使用全部模板。
模板变量说明详见 references/platform-strategy.md。

Facebook 帖文

Facebook 帖文来源于独立的 fb-brand-content-bank.json（内容更丰富、篇幅更长）。周计划器仅在周一、三、五的时段从中选取内容。
该文件的结构规范请参阅 references/content-bank-guide.md。

每日角度数量

修改 weekly-planner.js 中的 ANGLES_PER_DAY 常量（默认值为 3），可调整每日发布的视频角度数量。

文件说明

scripts/
  weekly-planner.js        ← 生成周计划文件
  daily-publisher.js       ← 将当日帖文排期至 Postiz
  setup.sh                 ← 首次初始化脚本

assets/
  content-templates.json   ← 各平台文案模板
  sample-content-bank.json ← 10 个初始角度示例

references/
  content-bank-guide.md    ← 如何撰写与维护角度库
  platform-strategy.md     ← 各平台最佳实践指南

参考资料

• content-bank-guide.md —— 如何写出有效角度
• platform-strategy.md —— 各平台定制化运营策略
• Postiz 文档 —— API 接口参考