# creatorhub

**Repository Path**: sleepforests/creatorhub

## Basic Information

- **Project Name**: creatorhub
- **Description**: 创作者平台
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-21
- **Last Updated**: 2026-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CreatorHub 创作者平台

面向创作者的一站式智能工作平台，覆盖内容探索、智能创作、创作工具、内容发布与运营分析，
支持单机版（macOS、Ubuntu、Debian）和 Cloud 版（Docker 自托管）两种部署方式。

## 品牌与子产品命名

| 英文名称 | 中文名称 | 定位 |
|---|---|---|
| **CreatorHub** | **创作者平台** | 主品牌与统一产品入口 |
| CreatorHub Explore | 内容探索 | 视频挖掘、热点发现与趋势研究 |
| CreatorHub Create | 智能创作 | 视频、音频及多模态内容生产 |
| CreatorHub Tools | 创作工具 | 素材获取、处理与增强工具 |
| CreatorHub Publish | 内容发布 | 多平台发布与内容运营 |
| CreatorHub Insights | 数据洞察 | 内容表现、趋势与增长分析 |
| CreatorHub Console | 平台管理 | 任务、消息、设置与费用管理 |

## 目录结构

```
.
├── backend/        Python 后端（FastAPI API + Worker）
├── frontend/       React Web 前端（Vite + TypeScript + Ant Design）
├── extensions/     Chrome 扩展项目
├── skills/         项目级 Codex Skills（开发、校验与发布工作流）
├── deploy/         部署配置
│   ├── standalone/ macOS/Linux 单机版安装脚本与单容器镜像
│   └── docker/     Cloud 版 Docker Compose 配置
└── README.md
```

`skills/` 按 Skill 名称分目录，用于集中维护 CreatorHub 的可复用 Skill。每个 Skill 以
`SKILL.md` 为入口，可按需包含 `agents/`、`scripts/`、`references/` 和 `assets/`；部署配置与
实际执行脚本仍分别保留在 `deploy/` 等职责目录中。

---

## 单机版（macOS / Ubuntu / Debian）

适合个人本地稳定使用。无需 Docker，无需登录，一键安装。

### 安装

```bash
curl -fsSL https://gitee.com/sleepforests/creatorhub/raw/master/deploy/standalone/install.sh | bash
```

支持 macOS Apple Silicon/Intel，以及 Ubuntu 的 amd64/arm64。
安装过程自动完成系统依赖、ffmpeg、Node.js 20、uv、Python 依赖、CreatorHub
内部 MySQL 初始化和前端构建。内部 MySQL 使用独立的 9832 端口和数据目录，
由 `creatorhub` 命令统一管理。Linux 使用 APT。IndexTTS 本地模型默认不安装，避免首次安装下载约 11 GB
模型与运行时；需要本地音色克隆时，再主动执行 `creatorhub install indextts`。

### 使用

```bash
creatorhub start     # 启动服务
creatorhub stop      # 停止服务
creatorhub restart   # 重启服务
creatorhub update    # 备份数据并更新代码、数据库、前端和 CreatorHub 浏览器助手
creatorhub status    # 查看运行状态
creatorhub logs      # 查看日志（creatorhub logs worker / creatorhub logs indextts）
creatorhub doctor    # 检查环境
```

首次安装默认跳过 IndexTTS。如需在安装时主动安装，可执行：

```bash
curl -fsSL https://gitee.com/sleepforests/creatorhub/raw/master/deploy/standalone/install.sh | bash -s -- --with-indextts
```

本地脚本也可以使用：`bash install.sh --no-indextts`。后续 `creatorhub update` 不会首次安装
IndexTTS，只会在检测到已有 IndexTTS 模型时修复其独立运行环境。

`creatorhub start` 自动启动 YouTube PO Token 服务，HTTP 健康检查通过后再启动 Worker；
`creatorhub stop/restart/status` 同时管理该服务。安装和更新会准备固定版本 1.3.1，
旧安装首次启动也会自动补装（需要访问 GitHub 和 npm；Node.js 20.19+、22.12+ 或 >=24）。
服务与依赖保存在 `${CREATORHUB_HOME:-~/.creatorhub-standalone/data}/runtime/youtube-pot-provider`，仅监听 `127.0.0.1:8816`。

```bash
creatorhub start youtube-pot-provider
creatorhub restart youtube-pot-provider
creatorhub logs youtube-pot-provider
creatorhub install youtube-pot-provider  # 仅准备依赖，不启动
```

默认向 API/Worker 注入 `YOUTUBE_POT_PROVIDER_URL=http://127.0.0.1:8816`。
如需外部服务，在启动命令的环境中设置 `YOUTUBE_POT_PROVIDER_URL`；此时跳过本地安装与启动，
只检查外部 `/ping`，不会停止外部进程。本机已手动启动的兼容服务也只复用、不接管 PID。
健康检查失败或 8816 被其他程序占用时，启动报错，不启动新的 Worker；
已有 API/Worker 不会因此被主动停止，修复后可重试 `creatorhub start`。
PO Token 服务就绪仅代表辅助服务可达，不保证所有 YouTube 403 都能消除。

启动后访问：**http://localhost:8765**

原生 `creatorhub` 默认监听端口统一为 8xxx：Web/API `8765`、IndexTTS `8810`、PO Token `8816`。
与 Docker 云版的宿主机 `9800–9804/9811`、Docker 单机版的 `9900` 不冲突。
Docker 云版 PO Token 仍使用容器内部 `4416`，不映射到宿主机；Docker 单机版的
IndexTTS `8810` 和 PO Token `8816` 也只在容器内监听。
显式设置 `CREATORHUB_PORT`、`INDEXTTS_PORT` 或外部服务 URL 时，以自定义配置为准。

首次启动会进入 Setup 向导，配置 AI API Key 和 TTS 方案。

也可以不经过 CLI，直接运行最新更新脚本：

```bash
curl -fsSL https://gitee.com/sleepforests/creatorhub/raw/master/deploy/standalone/update.sh | bash
```

单机版以 `origin/master` 的 Git 提交作为发布版本。单机业务数据库统一使用
CreatorHub 内部 MySQL。
CreatorHub 浏览器助手有新版本时，平台页面会提示用户下载并重新加载扩展。
本机 standalone 按稳定环境管理，不接收维护仓库中的未提交代码或本地开发快照；安装后始终使用
`creatorhub update` 更新正式发布到 `origin/master` 的版本。

### 维护者发布

```bash
deploy/standalone/release.sh check     # 校验工作区、脚本和 CreatorHub 浏览器助手
deploy/standalone/release.sh publish   # 校验通过后推送 master
```

发布检查的 Codex Skill 位于 `skills/creatorhub-standalone-release/`。发布不额外制作镜像
或维护版本清单，推送到 `origin/master` 的提交就是用户下一次 `creatorhub update` 获取的版本。

### 数据目录

源码单机版统一存放在 `~/.creatorhub-standalone/`，随时可整体备份、迁移或卸载：

```
~/.creatorhub-standalone/
├── data/         MySQL、媒体文件、模型、日志和运行状态
├── app/          CreatorHub 程序代码与前端
├── env/          本机私有环境配置
└── bin/creatorhub       实际命令入口
```

`~/.local/bin/creatorhub` 只是指向上述命令入口的符号链接。卸载时运行
`bash deploy/standalone/uninstall.sh`；脚本不会删除 Docker Cloud 数据目录。

### Linux 单容器安装测试

Docker standalone 正在随内部 MySQL 架构调整；当前优先支持 macOS 和 Ubuntu
原生 standalone 安装。原有单容器命令暂不作为本次发布的验证入口：

```bash
cp deploy/docker/.env.example deploy/docker/.env
deploy/docker/docker.sh standalone
```

Docker standalone 直接使用当前本地工作树构建镜像，允许部署尚未提交或推送的代码；容器内不使用
`creatorhub update` 获取代码。

#### Docker standalone 端口映射

| 服务 | 宿主机地址/端口 | 容器内地址/端口 | 说明 |
|---|---|---|---|
| CreatorHub Web + API | `http://localhost:9900` | `0.0.0.0:8765` | 唯一对外入口，宿主机 `9900 → 8765` |
| IndexTTS | 不发布 | `127.0.0.1:8810` | 仅供同一 standalone 容器内的 API/Worker 调用 |
| YouTube PO Token | 不发布 | `127.0.0.1:8816` | 仅供同一 standalone 容器内的 API/Worker 调用 |

Compose 的 `9900:8765` 没有限定宿主机 IP，默认会监听宿主机所有网络接口；表中的
`localhost` 是本机访问示例。需要限制为仅本机访问时，应在 Compose 中显式绑定 `127.0.0.1`。

#### Docker standalone 目录映射

宿主机根目录由 `STANDALONE_DOCKER_DIR` 控制，默认是
`${HOME}/.creatorhub-docker-standalone`：

| 宿主机目录 | 容器目录 | 读写 | 内容 |
|---|---|---|---|
| `${STANDALONE_DOCKER_DIR}/creatorhub` | `/root/.creatorhub` | 读写 | 应用源码、Python 虚拟环境和安装状态 |
| `${STANDALONE_DOCKER_DIR}/creatorhub-data` | `/root/.creatorhub-data` | 读写 | 内部数据库、媒体文件、配置、日志、缓存和模型 |

默认实际路径分别为 `~/.creatorhub-docker-standalone/creatorhub` 和
`~/.creatorhub-docker-standalone/creatorhub-data`。停止或重建容器不会删除这两个宿主机目录。

---

## Cloud 版（Docker 自托管）

适合多人团队使用，需要服务器和 Docker 环境。

### 启动

```bash
cp deploy/docker/.env.example deploy/docker/.env   # 填写密码、密钥、数据目录
deploy/docker/docker.sh up                          # 构建并启动全部服务
```

Docker cloud 的本地镜像直接从当前工作树构建，部署不要求代码已经提交或推送。日常变更应向
`deploy/docker/docker.sh` 显式传入受影响的服务名，只重建和重启相关服务。

### Docker cloud 端口映射

| Compose 服务 | 宿主机地址/端口 | 容器端口 | 说明 |
|---|---|---:|---|
| `frontend` | `http://localhost:9800` | `80` | 推荐 Web 入口；同时反向代理 `/api/` 到 API、`/storage/` 到 MinIO |
| `backend-api` | `http://localhost:9801` | `8000` | FastAPI 直连调试入口 |
| `mysql` | `localhost:9802` | `3306` | MySQL 直连端口 |
| `minio` API | `http://localhost:9803` | `9000` | MinIO S3 API 直连端口 |
| `minio` 控制台 | `http://localhost:9804` | `9001` | MinIO 管理控制台 |
| `indextts` | `http://localhost:9811` | `8000` | Docker CPU IndexTTS 直连端口 |
| `backend-worker` | 不发布 | — | 只访问 Compose 内部网络 |
| `youtube-pot-provider` | 不发布 | `4416` | 仅供 Worker 通过 `http://youtube-pot-provider:4416` 调用 |
| `minio-init` | 不发布 | — | 一次性初始化任务 |
| `database-migrate` | 不发布 | — | 按需执行的数据库迁移任务 |

这些端口映射均未限定宿主机 IP，默认会监听宿主机所有网络接口；表中的 `localhost` 是本机访问
示例。对外部署时应通过防火墙或 Compose 端口绑定限制 MySQL、MinIO、API 和 IndexTTS 的访问范围。

### Docker cloud 目录映射

宿主机持久化根目录由 `CREATORHUB_DOCKER_HOME` 控制，默认是
`${HOME}/.creatorhub-docker-cloud/creatorhub`：

| 宿主机目录 | Compose 服务 | 容器目录 | 读写 | 内容 |
|---|---|---|---|---|
| `${CREATORHUB_DOCKER_HOME}/db/mysql` | `mysql` | `/var/lib/mysql` | 读写 | MySQL 数据文件 |
| `${CREATORHUB_DOCKER_HOME}/files/minio` | `minio` | `/data` | 读写 | MinIO 对象数据 |
| `${CREATORHUB_DOCKER_HOME}/models/indextts-2.5` | `indextts` | `/models/IndexTTS-2.5` | 读写 | IndexTTS 权重及同目录辅助缓存 |
| `${CREATORHUB_DOCKER_HOME}/cache/indextts` | `indextts` | `/cache` | 读写 | IndexTTS 参考音频缓存 |
| `${CREATORHUB_DOCKER_HOME}/cache/worker` | `backend-worker` | `/root/.cache` | 读写 | Worker 模型及算法缓存 |
| `${CREATORHUB_DOCKER_HOME}/data/backend-api` | `backend-api` | `/app/data` | 读写 | API 工作目录 |
| `${CREATORHUB_DOCKER_HOME}/data/backend-worker` | `backend-worker` | `/app/data` | 读写 | Worker 工作目录 |
| `${CREATORHUB_DOCKER_HOME}/logs/backend-api` | `backend-api` | `/app/logs` | 读写 | API 日志 |
| `${CREATORHUB_DOCKER_HOME}/logs/backend-worker` | `backend-worker` | `/app/logs` | 读写 | Worker 日志 |
| `${CREATORHUB_DOCKER_HOME}/config` | `backend-api` | `/root/.creatorhub` | 读写 | Cloud 共享配置 |
| `${CREATORHUB_DOCKER_HOME}/config` | `backend-worker` | `/root/.creatorhub` | 只读 | Cloud 共享配置 |

Compose 还会以只读方式挂载仓库内的 `mysql/init.sql`、`mysql/my.cnf` 和
`minio/init.sh`，分别用于数据库初始化、MySQL 配置和 MinIO bucket 初始化。`frontend`、
`youtube-pot-provider`、`minio-init` 与 `database-migrate` 没有独立的持久化数据目录。

### 常用命令

```bash
deploy/docker/docker.sh status                      # 查看容器状态
deploy/docker/docker.sh logs creatorhub-backend-api # 查看日志
deploy/docker/docker.sh update                      # 拉取最新镜像并重启
deploy/docker/docker.sh down                        # 停止并销毁容器
```

完整说明见 [deploy/docker/README.md](deploy/docker/README.md)。

---

## 功能模块

平台当前提供 15 个可用模块，按使用场景分为以下三类。

### AI 创作工作流

| 模块 | 说明 |
|---|---|
| 音色克隆译制 | 克隆原视频人物音色，自动完成识别、翻译、配音、字幕与成片 |
| 视频配音 | 对视频进行 AI 配音，支持多语言翻译、音色选择、字幕和成片交付 |
| 短剧内容理解 | 批量直传或 URL 导入短剧，分析场景、人物和剧情，并支持阶段产物访问与 Bundle 导出 |
| 短剧译制 | 统一管理多集短剧的翻译、配音和本地化成片 |
| 短剧解说 | 基于短剧内容理解结果，自动完成选片、文案、配音和解说成片 |

### 素材与 AI 工具

| 模块 | 说明 |
|---|---|
| 短视频下载 | 下载和管理短视频内容，支持作者作品同步与周期任务 |
| 字幕擦除 | 识别视频中的硬字幕并智能修复被遮挡的画面 |
| 水印擦除 | 定位视频画面中的水印并修复被遮挡的内容 |
| 视频去背景音 | 支持 URL 或 MP4 上传，移除背景音乐、降低环境噪音并保留原画面 |
| 音频去背景音 | 支持 URL 或常见音频上传，分离人声与背景音乐，交付 WAV 和 MP3 |

### 运营与平台管理

| 模块 | 说明 |
|---|---|
| 发布中心 | 将成片交给已登录的小红书或抖音页面，并管理发布记录 |
| 任务中心 | 查看后台任务、周期任务、执行进度和失败信息 |
| 消息中心 | 查看任务通知、待办和历史消息 |
| 审计中心 | 追踪 API 调用明细与项目费用 |
| 帮助中心 | 查看平台各功能模块的使用指南 |

---

## 详细文档

- 后端开发规范：[backend/AGENTS.md](backend/AGENTS.md)
- API 与平台技术文档：[backend/help_center/maintained/](backend/help_center/maintained/)
- 阶段性方案与历史记录：[docs/](docs/)