# F&B Content Engine
### OpenClaw Plugin · v0.8.1

A complete social media operations plugin for F&B brands.  
Manages content from idea to publish across 7 platforms, with bilingual support,  
compliance gates, and owner escalation.

---

## 安装流程 / Installation (6 Steps)

### Step 1 · 创建 OpenClaw 实例 + 配置 Lark Bot

在 OpenClaw 里新建一个 Agent 实例，配置 Lark 机器人作为消息渠道。

> Create a new OpenClaw instance and configure the Lark bot as the messaging channel.

---

### Step 2 · 安装 Plugin

通过 OpenClaw 官方指令一键从全局 NPM 注册表安装：

```bash
openclaw plugins install git-plugin-amc
```
*执行后，OpenClaw 会自动拉取最新的 NPM 包、安装依赖，并启动预设配置。*

> **进阶安装方式：** 
> 如果你需要安装开发版（源码部署），可以克隆代码到本地后执行：`openclaw plugins install ./`

---

### Step 3 · 重启 Gateway，等待 Lark 消息

```bash
openclaw gateway restart
```

插件的 `gateway_start` 钩子会自动把 `SOUL.md.template` 配置块写入你的 SOUL.md。
下次会话启动时（`session_start`），检测到 `{{PLACEHOLDER}}` 后立即通过 Lark 发出 Bootstrap 开场消息，开始 13 问访谈。

**打开 Lark，等待 AI 内容官主动发来第一条消息。**

> **Recovery：** 访谈中途中断，重启后向 Lark Bot 发送 `/bootstrap` 重新触发。

---

### Step 4 · Bootstrap Mode 完成配置

Agent 通过 Lark 向品牌主提问（约 15 个问题，30 分钟），自动完成：

- 填写所有 `{{PLACEHOLDER}}` → 保存 `SOUL_{brand}.md`
- 更新品牌定制文件（brand-voice、allergen-gate、bilingual-gate）
- 调用 `mcp.lark.drive` 在 Lark 云盘创建品牌专属 vault 文件夹
- 上传 vault/ 到 Lark Drive vault

> The agent self-configures via conversation. No human needs to edit any files.

---

### Step 5 · 正式开始运营

配置完成后 Agent 发送确认消息给品牌主，立即按 cron-jobs.md 日程开始运营。  
第一批内容（3条）进入 Tier-1 审批队列，等待品牌主在 Lark 确认后发布。

> Setup complete. Agent begins the daily automation schedule immediately.

---

### Step 6 · 自动更新

完整的更新链路包含两层机制，确保每个安装实例都能及时收到更新通知：

#### 层 A — 主动推送（新版本发布时立即推送）

每次发布新 tag，GitHub Actions 自动向共享 Lark 群发送广播消息。

**接收广播的方式：**
加入"F&B Content Engine 更新通知"Lark 群：
> 联系 12eat AI Lab 获取入群链接，或在 GitHub 提 Issue 申请。

**如果你是 fork 部署，可以自建推送通道：**

1. 在你的 Lark 群里创建一个 Bot，获取 Webhook URL
2. 在 GitHub repo → Settings → Secrets 添加：
   - `LARK_UPDATE_WEBHOOK` — 主要通知群（正式版推送）
   - `LARK_DEV_WEBHOOK`（可选）— 测试群（beta / rc 版推送）
3. 之后每次 `git tag vX.Y.Z && git push --tags`，广播自动触发

#### 层 B — 轮询兜底（每周一 09:00 UTC 自动检查）

即使没有加入广播群，Agent 也会每周自动执行 `plugin-version-check` 定时任务。  
发现新版本时，自动向品牌 Lark 群推送通知，团队回复"更新插件"即可触发更新。

#### 更新执行

无论是日常检查还是重大版本升级，只需一行命令即可极速拉取 NPM 最新版：

```bash
# 一键无痛更新到最新版
openclaw plugins update git-plugin-amc
```

*(如果你需要强制触发更新并重载，可以使用项目根目录下的 `./update.sh`)*

**更新策略：**
- ✅ 自动更新：20 个通用技能文件、合规规则、平台策略、cron 计划
- 🔒 永不覆盖：`brand-voice.md`、`allergen-gate.md`、`bilingual-gate.md`（品牌定制内容）
- 🔒 永不覆盖：Lark Drive vault 里的所有运营记录
- ✅ 更新完成：`post_update` hook 自动发 Lark 通知，无需重启，无需确认

---

## Plugin 结构

```
git-plugin-amc/
├── plugin.yaml              ← Plugin 清单（版本、技能列表、更新策略）
├── SOUL.md.template         ← 品牌配置薄层（复制后填写 8 个参数即可）
├── update.sh                ← 手动更新脚本（备用；OpenClaw 原生更新优先）
│
├── skills/                  ← 20 个技能模块（OpenClaw plugin install 后自动就位）
│   ├── core/                   repurpose-chain, hook-engine, scheduling, content-types
│   ├── compliance/             fda-ftc-rules, allergen-gate*, platform-policies, image-rights
│   ├── localization/           brand-voice*, bilingual-gate*
│   ├── platforms/              instagram, tiktok, rednote, facebook, youtube, googlemap, x
│   └── operations/             kanban-integration, fallback-execution, owner-approval, feedback-loop, vault-manager, cron-jobs, update-plugin
│                            (* = brand-customized by Bootstrap Mode, never auto-updated)
│
├── bootstrap/               ← Bootstrap Mode：13问访谈脚本 + 配置逻辑
│   └── onboarding-flow/SKILL.md
│
└── vault/                   ← 运营模板（Bootstrap Mode 上传到 Lark Drive vault）
    ├── vault-index.md
   ├── brandcontext.md      品牌设定+平台策略+当前推广策略上下文
    ├── media/               (Empty directory — Native Bitable generated by create-vault.js)
    ├── post/                YYYYMMDD-post.md (Native Bitable generated by create-vault.js)


---

## 💎 Native Vault 架构 (v0.8.1 升级)

本插件不再使用纯文本 Markdown 管理关键排期。在初始化 Vault 时，底层脚本会自动调用飞书 API 凭空创建原生高级资产：

1. **多维表格 (Lark Bitable)**
   - **Content Schedule**：排期表自动生成为多维表格，自带单选标签（draft, approved, published）和时间过滤。
   - **Media Index**：素材库自动生成为多维表格，支持原生附件列存放原图/视频。
   - **Agent 交互**：Agent 使用 `lark.bitable` MCP Tool 实时读写表格状态。

2. **原生协作文档 (Lark Docx)**
   - Agent 会把草稿、月报通过 `lark.docs.create` 生成原生的飞书文档。
   - 老板可以直接在飞书里进行“划线评论”，Agent 会读取你的批注自动重写。

3. **交互式卡片审批 (Message Cards)**
   - 遇到合规风险或风控拦截时，不再使用枯燥的文本，Agent 会在飞书群推送带有【✅ 批准】和【❌ 打回】按钮的卡片，一键审批！
```

---

## 品牌定制文件

Bootstrap Mode 访谈结束后，3 个文件会被品牌信息自动填写：

| 文件 | 内容 | 填写来源 |
|---|---|---|
| `skills/localization/brand-voice.md` | 品牌个性、词汇表、禁用语 | 访谈 Q9/Q10 |
| `skills/compliance/allergen-gate.md` | 菜品过敏原对照表 | 访谈 Q12 |
| `skills/localization/bilingual-gate.md` | 中英文菜单词典 | 访谈 Q11 |

其余 17 个技能文件为通用内容，Plugin 更新时自动覆盖。

---

## 发布与互动工具栈

| 工具 | 作用 | 覆盖平台 |
|---|---|---|
| **PostFast MCP** (`mcp.postfast`) | 统一发布，原生 MCP Server，零开发 | Instagram, Facebook, TikTok, YouTube, X, Threads, LinkedIn |
| **GBP MCP** (`mcp.gbp`) | Google Business Profile 发帖 + 评论回复 + 数据 | Google Maps / Google Search |
| **Metricool** (`mcp.analytics`) | 跨平台数据聚合报告 | 所有已连接平台 |
| **半自动（Lark）** | 小红书及未连接平台：Agent 生成内容推送 Lark，团队手动发布 | 小红书 + pending_platforms |

> PostFast 定价：€29/月（12个账号），含所有已支持平台。GBP API 免费。

---

## Skill Packs（扩展技能库）

Skill packs 独立维护，**不包含在本 plugin 的默认安装中**。按需安装，不影响核心 plugin 更新。

```bash
# 安装单个 skill pack
openclaw skill-packs install \
  --repo https://github.com/alextiannus/acm-skill-packs \
  community/copywriting/aida-engine

# 安装整个分类
openclaw skill-packs install \
  --repo https://github.com/alextiannus/acm-skill-packs \
  community/copywriting
```

| 仓库 | 内容 | 许可 |
|---|---|---|
| [acm-skill-packs](https://github.com/alextiannus/acm-skill-packs) | 8个社区 packs：文案框架、平台算法、F&B专项 | MIT 开源 |
| @12eat-ai/skill-packs-premium | F&B深度、出海华人市场、节日营销、KOL Brief | 商业许可 |

---

## 版本历史

| 版本 | 日期 | 变更 |
|---|---|---|
| **v0.8.1** | 2026-05 | **Native Vault 架构大升级**：初始化时脚本直接调用飞书接口生成原生多维表格（Bitable）和文档（Docx）；合规审批流全面升级为飞书 JSON 交互式卡片（Message Cards）；全面迁移至 NPM 极速安装与更新体系。 |
| v0.6.3 | 2026-05 | 完整自动更新链路：post_update hook + GitHub Actions Lark 广播 + 更新命令处理；22个定时任务程序化注册；运行时凭证检测（PostFast API Key + GBP Location ID） |
| v0.6.2 | 2026-05 | Skill Packs 拆分为独立 repo；发布层重构 PostFast MCP + GBP MCP；修复 npm build |
| v0.5.0 | 2026-05 | 架构重构：src/index.ts 程序化钩子，openclaw.plugin.json，23个技能目录结构 |
| v0.4.0 | 2026-05 | 初始发布，7平台支持，Bootstrap Mode，3级升级协议 |

---

## 路线图

**v0.7 · 多品牌规模化**
- [ ] Mission Control 集成（`abhi1693/openclaw-mission-control`）
  — 一台服务器统一管理所有品牌 Agent 实例，无需 SSH + CLI
  — 统一监控 cron 状态、发布日志、异常告警，一键推送 plugin 更新
- [ ] VPS 部署指南（systemd / Docker，保障 24/7 稳定运行）
- [ ] npm publish + ClawHub 注册（`openclaw plugins install clawhub:git-plugin-amc`）

**v0.8 · 自动化升级**
- [x] GitHub Actions → plugin 发版后自动向 Lark 广播更新通知（v0.6.3）
- [ ] 多品牌跨平台数据聚合报告（Mission Control 层）

---

## License

MIT · Built by 12eat AI Lab