初始化提交:contentm_agent 工作区全量快照

内容分四块:
1、产品规划产出 —— MCN 短视频整合营销工作台的①段五份(1a 需求/1b 竞品/1c 画像/1d 策略/1e 场景)、②段两份(2a 功能/2b 布局)、③段界面(DESIGN.md 契约与令牌表 + mcn-workbench.html 原型 + 实测/会诊/审查三份 + 23 张闸门截图)。
2、开源竞品调研 —— 5 个内容工作台项目的取证原始件与 1b 系列分析文档。
3、参考资料 —— 竞品视频抽帧 1145 张 + 2 个源视频 + 功能点截图。
4、机制侧 —— 协作脚本与状态台账、工作区记忆日志、抽帧/OCR 脚本。

.gitignore 只排运行时日志、脚本备份副本与一次性探针输出,其余按原样入库。
This commit is contained in:
WorkBuddy committed 2026-10-08 08:13:02 +08:00
commit df56c2c137
1773 files changed
+205840

No files matched your search

@@ -0,0 +1,33 @@
# 总控路由流程(内容搜索 / 运营分析)
> 对应顶层 SKILL.md 的路由逻辑:用户输入 → 识别「平台 / 对象 / 任务」→ 路由到分支技能执行。
```
用户输入(平台名+关键词 / 链接 / 分析任务 / 运营任务)
│
▼
[1] 输入识别(四件事)
平台:小红书 / B站 / 抖音 / 公众号 / 全域
对象:关键词 / 笔记链接 / 视频链接 / 文章链接 / 博主主页
任务:搜索 / 详情 / 评论 / 博主作品 / 风格分析 / 热度指标 / 爆款原因
输出:表格 / 摘要 / 选题建议 / HTML 报告 / 标题公式
│
▼
[2] 路由分发
├─ 小红书关键词热度 → gzh-Skills/xhs-hotnotes(fetch_xhs_hot_articles.py)
├─ 小红书链接/博主/评论 → gzh-Skills/global-content-search(Agent Reach 优先,Guaikei 兜底)
├─ B站 关键词/视频/UP主 → gzh-Skills/global-content-search(bili-cli / 公开 API)
├─ 抖音 → global-content-search(需 DOUYIN_COMMAND,未配置则如实说明)
├─ 公众号关键词爆款 → gzh-Skills/gzh-explosive-content-detector
└─ 公众号赛道聚合 → gzh-Skills/baokuan-article-analysis(daily_sector_trends.py)
│
▼
[3] 输出(六要素)
平台与后端状态 / 结果表格 / 热度判断 / 内容风格 / 爆款原因 / 下一步建议
```
## 诚实边界
- 只读公开数据,不做发帖/评论/点赞等写操作
- 平台查不了 → 说明原因 + 给出配置方式,不编造数据
- 小红书详情需完整 `xsec_token` URL(搜索结果返回)
@@ -0,0 +1,30 @@
# 公众号创作流程
> 对应 gzh-Skills 板块(12 个技能)。按创作流程排列:**先定位 → 找选题 → 写正文 → 起标题 → 配图排版**。
```
定位装修 ──→ 找选题 ────────→ 写正文 ──────────→ 起标题 ──→ 配图排版
```
## 分环节流程
| 环节 | 技能 | 说明 |
|------|------|------|
| **定位** | `gzh-positioning` | 账号简介 / 关注后回复 / 自定义菜单三件套,带微信字数校验 |
| **找选题** | `baokuan-article-analysis` | 按赛道/关键词抓公众号爆款,数据洞察 |
| | `gzh-explosive-content-detector` | 每日爆款收录(低粉高阅读、数据增长中) |
| | `global-content-search` | 全域搜索(小红书/B站/抖音)找跨平台灵感 |
| | `xhs-hotnotes` | 小红书热门笔记,找选题灵感 |
| **写正文** | `gzh-longform-writer` | 长文 1500-4000 字:诊断 → 六种写法路由 → 质检 |
| | `gzh-short-post` | 短文 ≤1000 字,去 AI 腔规则 + 自检;可压长文为短文 |
| **起标题** | `baokuan-title-generator` | 科技/AI 领域 10万+ 爆款标题生成、评分、A/B |
| **配图** | `space-chart-image` | 10 类图表(流程/架构/思维导图/SWOT) |
| | `space-text-logic-diagram` | 文本逻辑拆解 → 逻辑关系图 |
| **封面** | `space-gzh-cover` | 2.35:1 头图,分享安全区校验与裁切预览 |
| **排版** | `space-wechat-layout` | 整篇文章 → 公众号 HTML(一键复制) |
## 使用方式
- 整条流程:说「帮我做一篇公众号文章」,AI 按定位→选题→正文→标题→排版推进
- 单环节触发:直接点名(如「起 10 个标题」「做封面」)
- 共享文风档案:`gzh-Skills/references/my-voice.md`(两个写作技能可读,「用我的风格」即生效)
@@ -0,0 +1,34 @@
# 小红书创作流程
> 对应 xhs-Skills 板块(10 个技能)。总控 `space-xhs-buddy` 判断卡点并串起全流程。
```
space-xhs-buddy(总控)
│
├─ 定位 ──→ 热点选题 ──→ 标题 ──→ 正文 ──→ 封面 ──→ 图文/信息图 ──→ 复盘
```
## 分环节流程
| 环节 | 技能 | 说明 |
|------|------|------|
| **总控** | `space-xhs-buddy` | 判断你卡在哪一环,路由并串成工作流 |
| **定位** | `space-xhs-positioning` | 赛道选择、定位句、人设三件套、内容支柱、冷启动 |
| **热点选题** | `space-xhs-hotspot` | 拉高互动笔记、判趋势、爆款共性(需数据 Key,可降级) |
| **标题** | `space-xhs-title` | 15 种方法批量出候选、评分、合规校验、A/B |
| **正文** | `space-xhs-writer` | 7 种笔记类型、标签策略、发布前 14 项体检 |
| **封面** | `space-xhs-cover` | 标题提炼、风格推荐、主体保真、多版测试 |
| **图文排版** | `xhs-html` | 6+ 张 3:4 单文件 HTML,62 种风格 |
| **信息图** | `space-xhs-image` | Codex 内置生图,单图或 6-9 张组图 |
| **账号体检** | `space-xhs-account-audit` | 八维打分、竞品对标、卡点定位 |
| **复盘** | `space-xhs-note-analytics` | 六层漏斗归因、多篇横向找规律 |
## 配置说明
- 数据查询类(hotspot/account-audit)可选配 `REDFOX_API_KEY` / `SOCIALDATAX_API_KEY` / `GUAIKEI_API_TOKEN`,**运行时探测逐级降级**,未配置时走公开搜索兜底并标注"未经数据验证"
- `space-xhs-image` 用 Codex 内置 image_gen,无需外部生图 Key
- 不做自动发布/刷互动/批量起号(只做分析与参谋)
## 使用方式
- 说「帮我做小红书」→ 自动路由总控;或直接点名环节(如「看看这条笔记数据」「帮我起号定位」)
@@ -0,0 +1,36 @@
# 视频创作流程
> 对应 video-Skills 板块(10 个技能)。总控 `space-video` 导演串联全流程:**参考 → 选题 → 脚本 → 剪辑 → B-roll → 字幕 → 封面**。
```
space-video(总控/导演)
│
├─ 选题 → 转字幕 → 脚本 → 剪辑 → B-roll → 字幕 → 配音配乐 → 封面
```
## 分环节流程
| 环节 | 技能 | 说明 |
|------|------|------|
| **总控** | `space-video` | 判断走哪步、路由子技能、成片后复盘 |
| **选题** | `space-video-topic` | 下载参考去水印、逐字稿、选题/钩子、标题、正文 |
| **转字幕** | `space-video-transcript` | YouTube/小宇宙/B站/抖音/小红书链接 → Markdown+SRT,再按需下载源文件 |
| **脚本** | `space-video-script` | 去 AI 味口播稿 + 精确到秒分镜 |
| **剪辑** | `space-video-edit` | 剪口播(删前保后 + 风险分层)+ 成片 |
| **B-roll** | `space-video-broll` | HTML → 确定性 MP4 动画/motion(代码渲染) |
| | `space-video-broll-sketch` | 文章转手绘图解,调 Seedance/libtv 视频模型逐帧生成 |
| **字幕** | `space-video-subtitle` | 转写、断句、AI 校对、SRT/ASS、烧录 |
| **配音配乐** | `space-video-audio` | TTS 旁白、找 BGM、压音混音、响度归一 |
| **封面** | `space-video-cover` | 家族气质 + 平台比例 + 高点击缩略图 |
## 串联用法
- 说「从头帮我做一条视频」→ `space-video` 接管,逐环节调子技能,文件落盘交接
- 发送平台链接 → `space-video-transcript` 先提字幕 → 再询问是否下载源文件
- 各技能可单独触发(见各 SKILL.md 触发词)
## 配置说明
- 转字幕 ASR:`GROQ_API_KEY`(Groq)或本地 whisper / agent-reach,自动探测后端
- B-roll 手绘:`ARK_API_KEY`(火山方舟 Seedance)或 `LIBTV_ACCESS_KEY`(libtv,需已装 libtv-skill)
- 视频下载:yt-dlp(`--cookies-from-browser` 需用户允许)
@@ -0,0 +1,32 @@
# 知识库
> content-creation 为多技能集合,知识内容分布在各子技能的 `references/` 中。本目录为顶层索引入口,按**通用/分类**两层组织。
## 知识分类(通用 vs 分类)
| 分类 | 位置 | 内容 | 边界 |
|------|------|------|------|
| 🏷️ **分类知识(板块专属)** | `gzh-Skills/*/references/` | 公众号文风/标题/排版方法 | 仅公众号流程使用 |
| | `xhs-Skills/*/references/` | 小红书笔记格式/封面/复盘模板 | 仅小红书流程使用 |
| | `video-Skills/*/references/` | 视频字幕规范/音乐源/B-roll 方法 | 仅视频流程使用 |
| 🌐 **通用知识(跨板块)** | `video-Skills/space-video-transcript/references/platforms.md` 等 | 平台字幕规范(YouTube/B站/抖音通用)、跨平台音乐源 | 各板块引用 |
## 板块知识入口
| 板块 | 知识位置 | 代表性内容 |
|------|---------|-----------|
| 公众号 | `gzh-Skills/references/` | 共享文风档案 `my-voice.md` 等 |
| 小红书 | `xhs-Skills/*/references/` | 各环节技能的知识/模板(如 xhs-hotnotes 的 `xhs_hot_article_format.md`) |
| 视频 | `video-Skills/*/references/` | 平台字幕规范、音乐源等 |
## 使用方法
- 顶层 SKILL.md(总控)负责路由;具体知识由对应子技能加载自己的 references
- 各子技能的 SKILL.md 中标注了其知识依赖,按需读取
- 新增**板块专属知识** → 放入对应子技能 references/
- 新增**跨板块通用知识** → 放入本目录(`references/知识库/`)
## 边界说明(不重叠)
- 板块知识**归属单一板块**:公众号知识只放 gzh-Skills,小红书只放 xhs-Skills,视频只放 video-Skills,不交叉放置
- 跨板块通用知识(多板块复用)才放顶层 `references/知识库/`,避免与子技能 references 重复