# Easel · 功能点梳理

> 来源：Easel 项目源码（`E:/ProgramData/AIProject/vibe-product/Easel`）—— README / 能力地图 `docs/skill-function-mapping.md` / 前端组件 `web/frontend/src/components` / CHANGELOG。
> 权威参照：[官方能力地图 docs/skill-function-mapping.md](https://github.com/ZJU-REAL/Easel/blob/main/docs/skill-function-mapping.md)（在线版已核对，114 Skill 全覆盖）。
> 定位：**开源（Apache 2.0）社媒内容工作台**，由浙江大学 ZJU-REAL / OpenDCAI Lab 出品，基于 OpenClaw Agent。
> 一句话：**你的私人、持续进化的社媒运营助手**——从一个想法开始，完成发现、策划、创作、发布与复盘。

---

## 一、产品定位

- **是什么**：面向社媒创作者的开源内容工作台。把 OpenClaw Agent、账号画像、内容技能和真实媒体工具接在一起，让 Agent 不只"说怎么做"，而是**直接把内容做出来并归档**，且可**直接/按需发布**。
- **核心差异**：
  - **一个 Agent 贯穿完整链路**：发现热点 → 评估选题 → 规划日历 → 生成文案/视觉 → 制作视频 → 发布 → 归因，同一工作流完成。
  - **画像驱动**：每个账号有独立定位/风格/受众/平台/偏好/记忆，输出越来越贴合真实账号。
  - **技能是真执行**：图片/卡片/配音/字幕/剪辑/短剧/发布都配可运行脚本，成品写入 `outputs/`。
  - **一份素材多平台形态**：同主题改写成小红书卡片、短视频、知乎长文或短帖。
  - **项目化保存**：内容、素材、中间件、元数据按项目归档。
  - **真实发布与复盘闭环**：支持小红书、抖音、快手、知乎、B站、微信视频号、微信公众号 7 个平台。

---

## 二、五层内容工作流

| 层 | 职责 |
|----|------|
| **1 发现** | 聚合热榜、行业新闻、竞品动态、用户讨论，筛选适合账号的机会 |
| **2 策划** | 把机会变成选题、标题、脚本和内容矩阵，写入内容日历 |
| **3 创作** | 生成文案、卡片、海报、信息图、音频、视频、短剧、论文解读等可发布素材 |
| **4 发布** | 按平台适配标题/正文/画幅/媒体，执行发布前检查并发送到已登录账号 |
| **5 归因** | 读取播放、互动、评论、内容表现，把有效结构与偏好沉淀回账号画像 |

---

## 三、Web 工作台功能点（前端实际页面）

> 依据 `web/frontend/src/components/Sidebar.tsx` 的导航定义：主导航 6 项，其中「工作台」内含子导航。

### 主导航（左侧栏）
| 页面 | 组件 | 功能 |
|------|------|------|
| **工作台** | `DashboardPage` | 工作台总览；内含子导航「热点雷达 / 选题库 / 内容日历 / 发布中心」 |
| **对话** | `ChatPage` | 与 Agent 多轮对话；会话管理（新建/重命名/归档/删除）；拖入素材作为结构化附件 |
| **技能库** | `SkillPage` / `SkillDrawer` | 浏览与直接运行 114 个 Skill；按能力分类 |
| **内容库** | `OutputsPage` | 产物管理：`outputs/` 项目归档、HTML 预览、复制到公众号 |
| **账号** | `AccountsPage` | 管理各平台登录账号（小红书/抖音/快手/知乎/B站/视频号/公众号） |
| **画像** | `ProfilePage` | 账号画像的创建与编辑（六维） |

### 工作台子导航
| 页面 | 组件 | 功能 |
|------|------|------|
| **热点雷达** | `TrendsPage` | 聚合微博/抖音/知乎/B站/百度/头条等热榜，筛选适合当前账号的选题 |
| **选题库** | `IdeasPage` | 管理选题、评估与沉淀 |
| **内容日历** | `CalendarPage` | 统一管理选题/草稿/待发/已发/平台活动；结合节日节点规划；记录每日发布安排 |
| **发布中心** | `PublishPage` | 一份母版内容 → 多平台版本；格式适配、媒体附件、发布前检查、预览、真实发布 |
| **拆解页** | `BreakdownPage` | 内容拆解分析 |

### 顶部栏 / 其它
- **画像选择器**：侧栏顶部切换「通用模式」或具体账号画像；当前对话已绑定画像则禁止切换（提示新建对话）。
- **设置面板**（`SettingsPanel`）：模型配置（chat/transcribe/image/video/music/speech 六通道）· 环境安装 · 更多设置；可改 provider/model/Base URL/API Key、加自定义 provider、主备切换、真实自测（报告握手延迟）。
- **环境安装**（`EnvBoard` / `install_tool.py`）：本地引擎真实体检、后台安装、进度回写。
- **新手引导**（`OnboardingWizard`）：首次使用引导。
- **网关状态**：侧栏底部显示「网关已连接 / 离线 / 连接中」。

---

## 四、Skill 能力库（共 114 个 Skill，6 层）

> 每个条目对应 `skills/openclaw/` 中一个 `SKILL.md`，通过 Agent 执行。

### 🧱 基础能力（6）
- `asset-manager` 产物管理（归档/打标签/搜索/素材清单）
- `batch-process` 批量处理（压缩/水印/转格式/缩放/音量归一化）
- `skill-my-account` 查询已登录账号与粉丝/获赞/作品
- `skill-profile-builder` 画像构建引导（从社媒链接分析生成 6 维 Profile）
- `skill-profile-manager` 画像全生命周期管理
- `template-library` 内容模板保存/复用/版本管理

### 🔭 发现层（9）
- `skill-trending-topics` 全网热搜聚合（微博/抖音/知乎/头条/B站）
- `skill-news-intelligence` 行业资讯情报简报
- `skill-competitor-analysis` 竞品账号策略拆解
- `skill-content-gap-analysis` 内容空白（蓝海选题）分析
- `skill-cross-platform-diff` 跨平台内容差异分析
- `skill-event-calendar` 节日/事件/大促日历
- `skill-algorithm-updates` 平台算法与规则变化追踪
- `skill-rss-aggregator` RSS/Newsletter 聚合
- `skill-ugc-discovery` UGC（粉丝内容/测评/提及）发现

### 🧭 策划层（16）
- `skill-positioning-analysis` 差异化定位分析
- `skill-audience-profiler` 受众画像构建
- `skill-brand-onboarding` 创作者/品牌入驻建档
- `skill-voice-builder` 个人声音画像构建
- `skill-account-diagnosis` 账号诊断/起号体检
- `skill-content-strategy` 内容策略方案
- `skill-content-matrix` 选题矩阵
- `skill-content-calendar` 月度内容排期
- `skill-topic-evaluator` 选题潜力评分
- `skill-trend-rider` 热点结合方案
- `skill-hook-generator` 开头钩子生成
- `skill-article-outline` 长文大纲
- `skill-carousel-planner` 轮播/多图笔记分页规划
- `skill-campaign-planner` 活动/营销策划（618/双11/年货节）
- `skill-collab-proposal` 品牌合作/联名策划
- `skill-livestream` 直播方案

### 🎨 创作层（51，实列 52）—— 文字 / 视觉 / 音频 / 视频 / 复合
- **文字**：`social-content`、`xhs-note-creator`、`copywriting`、`post-formatter`、`novel-writer`、`text-polisher`、`text-condenser`、`style-transfer`、`paper-explainer`、`doc-convert`、`gzh-design`
- **视觉**：`card-design`、`card-quote`、`card-xiaohongshu`、`poster-hero`、`infographic`、`comparison-card`、`meme-generator`、`mindmap`、`chart-visualization`、`data-report`、`ecom-details-image`、`ai-image-gen`、`image-editing`、`image-enhance`、`remove-bg`、`green-screen`
- **音频**：`tts-voiceover`、`multi-voice-dubbing`、`voice-clone`、`ai-music`、`audio-denoise`、`audio-editing`、`audio-mix`、`audio-visualizer`、`auto-subtitle`、`subtitle-translate`
- **视频**：`ai-video-gen`、`video-production`、`auto-short-video`、`short-drama`、`video-editing`、`video-script`、`video-strategy`、`video-reframe`、`video-highlights`、`clipify`、`video-chapters`、`video-intro-outro`、`slideshow-video`、`beat-sync-video`、`video-to-article`

#### 创作层 Skill 分类明细表（文字 11 / 视觉 16 / 音频 10 / 视频 15 = 52）

| 类别 | 数量 | Skill | 功能 |
|------|:---:|-------|------|
| **文字** | 11 | `social-content` | 通用多平台社媒内容（单条/兜底），钩子+正文+标签+互动引导 |
| | | `xhs-note-creator` | 小红书内容总入口：标题/正文/caption/hashtags + 3-9 张图文卡片 |
| | | `copywriting` | 国内带货转化营销文案（种草/信息流/促销/详情页/落地页） |
| | | `post-formatter` | 用 PAS/AIDA/BAB/STAR/SLAY 框架结构化社媒帖子 |
| | | `novel-writer` | 长篇小说/网文连载创作（世界观→人设→大纲→逐章） |
| | | `text-polisher` | 文本润色：七轮扫描 + 去 AI 感改写 |
| | | `text-condenser` | 字数裁剪/摘要/金句提取 |
| | | `style-transfer` | 文案风格迁移（严肃↔搞笑、书面↔口语等） |
| | | `paper-explainer` | 科研论文解读（arXiv/PDF → 视频或图文） |
| | | `doc-convert` | Markdown → HTML / PDF / 长图 PNG |
| | | `gzh-design` | 微信公众号文章排版引擎（一键自动排版） |
| **视觉** | 16 | `card-design` | 社媒卡片视觉设计系统（配色/字体层级/满画幅/质检） |
| | | `card-quote` | 16:9 横版金句卡、数据卡 |
| | | `card-xiaohongshu` | 1080×1440 小红书竖版知识卡片组 |
| | | `poster-hero` | 1080×1920 竖版营销海报 |
| | | `infographic` | 信息图（静态 AntV / 动画 GIF） |
| | | `comparison-card` | 对比图/一图流（A vs B 参数对比） |
| | | `meme-generator` | 表情包/Meme（梗图、反应图） |
| | | `mindmap` | 思维导图（Markdown 大纲 → 可交互 HTML） |
| | | `chart-visualization` | 数据图表（25+ 类型，调 AntV API） |
| | | `data-report` | CSV/Excel/JSON → 可视化报告页（KPI+图表+洞察） |
| | | `ecom-details-image` | 电商商品视觉方案（主图/场景图/详情页） |
| | | `ai-image-gen` | 通用 AI 生图（文生图/图生图/变体） |
| | | `image-editing` | 通用图像处理（缩放/裁剪/转格式/水印/拼接） |
| | | `image-enhance` | 图片增强放大（Lanczos + 去噪 + 锐化） |
| | | `remove-bg` | 图片去背景/抠图/换背景（AI 语义分割） |
| | | `green-screen` | 绿幕抠像/换背景/合成（图/视频） |
| **音频** | 10 | `tts-voiceover` | 文字转语音配音（云 TTS，输出 SRT） |
| | | `multi-voice-dubbing` | 多角色对话配音（按角色分配音色与情绪） |
| | | `voice-clone` | 语音克隆（上传样本克隆专属音色） |
| | | `ai-music` | AI 音乐/BGM 生成 |
| | | `audio-denoise` | 音频降噪 |
| | | `audio-editing` | 通用音频处理（剪辑/转码/归一化/拼接/变速） |
| | | `audio-mix` | 音频混音（口播+BGM+音效，BGM 闪避） |
| | | `audio-visualizer` | 音频可视化视频（动态波形/频谱） |
| | | `auto-subtitle` | 自动字幕/语音转字幕（SRT/ASS/TXT/JSON） |
| | | `subtitle-translate` | 字幕翻译/双语字幕（软挂载/硬烧录） |
| **视频** | 15 | `ai-video-gen` | AI 视频生成（文生视频/图生视频/数字人） |
| | | `video-production` | 整片视频产线（探针→转录→分场→…→交付，双确认门） |
| | | `auto-short-video` | 一句话主题 → 成品短视频（一键出片流水线） |
| | | `short-drama` | 多集 AI 微短剧制作 |
| | | `video-editing` | 自然语言剪辑视频（裁剪/拼接/变速/去静音/覆盖） |
| | | `video-script` | 视频脚本（7 秒~30 分钟全时长） |
| | | `video-strategy` | 视频制作策略与工具选型 |
| | | `video-reframe` | 智能转换画幅（9:16/16:9/1:1，模糊填充/人脸居中） |
| | | `video-highlights` | 长视频/直播高光切片 |
| | | `clipify` | 长视频提取精彩片段 + 竖版转制 + 字幕烧录 |
| | | `video-chapters` | 视频章节/时间戳目录 |
| | | `video-intro-outro` | 视频片头/片尾生成并拼接 |
| | | `slideshow-video` | 图片相册 → 视频（Ken Burns + 转场 + BGM） |
| | | `beat-sync-video` | 音乐卡点/踩点视频 |
| | | `video-to-article` | 视频转录改写为图文（小红书/公众号/知乎）+ 抽帧配图 |

> 注：合计 11+16+10+15 = **52**，与在线能力地图「创作层」实际列出的条目数一致（官方分层总览表标注为 51，存在 1 项的口径差，以逐条清单为准）。四类无重复、无遗漏。

### 📣 发布层（20）
- **平台发布**：`skill-xhs-publisher`（小红书）、`skill-douyin-upload`（抖音）、`skill-kuaishou-upload`（快手）、`skill-zhihu-publisher` / `skill-zhihu-answer`（知乎）、`skill-bilibili-upload`（B站）、`skill-channels-upload`（微信视频号）、`skill-wechat-publisher`（微信公众号）
- **适配与调度**：`skill-cross-platform-publish`、`skill-content-repurposing`、`skill-publish-scheduler`、`skill-short-link`
- **质量与合规**：`skill-quality-gate`、`skill-risk-scanner`、`skill-publish-checklist`、`skill-persona-check`、`skill-seo-quality`
- **互动与通知**：`skill-community-ops`、`skill-xhs-comment-reply`、`skill-publish-notify`

### 📊 归因层（11）
- `skill-data-tracker`（数据快照/增长趋势/内容生命周期）
- `skill-content-postmortem`（单条复盘 + 爆款规律提炼）
- `skill-comment-insights`（评论情感/高频词/诉求挖掘）
- `skill-publish-analytics`（发布日志四维归因）
- `skill-social-performance-review`（月度效果复盘）
- `skill-strategy-advisor`（策略迭代建议）
- `skill-xhs-analyzer`（小红书内容分析）
- `skill-post-scorer`（帖子互动潜力评分）
- `skill-content-calendar-log`（内容日历底座）
- `skill-publish-log`（发布记录管理）
- `roi-calculator`（ROI：CTR/CPC/CPM/ROAS）

---

## 五、账号画像（六维）

一个画像 = `profiles/<名字>/` 目录，六维：**定位 · 风格 · 受众 · 平台 · 偏好与红线 · 长期记忆**。
可在 Web「画像」页创建编辑；同一画像跨多个已登录平台复用。

---

## 六、CLI 入口

| 命令 | 作用 |
|------|------|
| `easel web [--port 7860]` | 启动 Web 工作台（推荐） |
| `easel chat` | 终端多轮对话 + 选画像 |
| `easel skill <name> -i "..." [-p <画像>]` | 直接运行指定 Skill |
| `easel doctor` | 检查 Python/Node/OpenClaw/关键配置 |
| `easel ping` | 检查 gateway 与 Agent 连通性 |
| `easel gateway start/stop/...` | 管理 OpenClaw gateway |

---

## 七、技术架构与平台支持

- **栈**：Python 3.10+ / FastAPI 后端 + React（Vite）前端 + OpenClaw Agent + Playwright Chromium。
- **目录**：`easel/`(CLI) · `web/`(后端+前端) · `skills/openclaw/`(技能) · `skills/shared/` · `profiles/`(画像) · `outputs/`(产物) · `openclaw/`(隔离 profile)。
- **独立性**：使用独立 `easel` OpenClaw profile，不覆盖本机已装 OpenClaw；Web 默认 `:7860`，gateway 端口自动解析。
- **发布平台**：小红书、抖音、快手、知乎、B站、微信视频号、微信公众号（7 个）。
- **兼容**：Linux / macOS / Windows 10-11（原生，不需 WSL）。
- **Roadmap**：① 适配 Windows 全链路 ② 安装简易化 ③ 优化页面 Agent 交互 ④ 适配更多 Harness（Claude Code / DeepSeek / Codex）。

---

## 附：功能点 ↔ 截图对照

> 截图位于本文件夹 `截图/` 子目录。官方 README 仅提供 4 张工作台功能截图 + 品牌/海报，见下。

| 截图 | 功能 |
|:----:|------|
| 00_品牌图 / 00_产品海报 | 项目品牌 | 
| 01_画像_账号画像配置 | 账号画像配置（六维、多平台选择） |
| 02_热点雷达_多平台热榜 | 热点雷达（微博/抖音/知乎/B站/百度/头条 六栏热榜） |
| 03_内容日历 | 内容日历（月视图 + 节日节点 + 排期） |
| 04_发布中心_多平台适配 | 发布中心（一份母版 → 小红书/抖音/快手/视频号/知乎/B站 多平台版本） |

> 注：Easel 官方仓库只提供上述 4 张工作台功能截图；对话页、技能库、内容库、账号页等其余界面无官方截图，如需可从运行中的工作台（`easel web` → `localhost:7860`）实时截取。