---
name: 内容管理
description: 文章、图片、视频分表分目录管理；文章正文在库内，图/视频文件在数据目录、库内仅存相对路径。代码分层：db 仓储 / services 业务 / cli 入口。
version: 2.0.0
author: 深圳匠厂科技有限公司
metadata:
  openclaw:
    slug: content-manager
    emoji: "📝"
    category: "通用"
    dependencies:
      required:
        - llm-manager
      auto_install: false
allowed-tools:
  - bash
---

# 内容管理器（文章 / 图片 / 视频）

## 代码结构（MVC 分层）

- `scripts/main.py`：仅入口与环境准备（`sys.path`、Windows UTF-8）。
- `content_manager/cli/`：参数解析与分发（Controller）。
- `content_manager/services/`：业务编排（调用仓储、llm-manager、文件复制）。
- `content_manager/db/`：SQLite 连接、建表迁移、按表划分的 **repository**（只做 SQL，不含业务规则）。
- `content_manager/config.py`：数据根路径、技能数据目录。
- `content_manager/constants.py`：提示词种子、平台别名等常量。

## 数据与表结构

- 库路径：`{JIANGCHANG_DATA_ROOT}/{JIANGCHANG_USER_ID}/content-manager/content-manager.db`
- **文章** 表 `articles`：`title`、`body`、`content_html`、`status`、`source`、`llm_target`、`account_id`、`error_msg`、`extra_json`、时间戳等（正文在库内）。
- **图片** 表 `images`：仅存 **`file_path`（相对技能数据目录）** 及 `title`、`status`、`source` 等元数据；二进制在 `{…}/content-manager/images/<id>/`。
- **视频** 表 `videos`：同上，文件在 `{…}/content-manager/videos/<id>/`；可选 `duration_ms`。
- 提示词相关表：`prompt_templates`、`prompt_template_usage`（供文章 `generate`）。

从旧版「TEXT 主键」`articles` 库启动时会自动迁移到新结构。

## 常用命令

将 `{baseDir}` 换为技能根目录。一级子命令为 **`article` / `image` / `video`**。

### 文章

```bash
python {baseDir}/scripts/main.py article list
python {baseDir}/scripts/main.py article get <id>
python {baseDir}/scripts/main.py article add --title "标题" --body "正文"
python {baseDir}/scripts/main.py article add --title "标题" --body-file D:\path\article.md
python {baseDir}/scripts/main.py article import-json D:\path\articles.json
python {baseDir}/scripts/main.py article generate 豆包 搜狐号 "RPA降本增效"
python {baseDir}/scripts/main.py article prompt-list 搜狐号 --limit 20
python {baseDir}/scripts/main.py article delete <id>
python {baseDir}/scripts/main.py article feedback <id> published <account_id>
python {baseDir}/scripts/main.py article save <id或占位> <title> <单行正文>
```

`article get` 输出 JSON：`id`、`title`、`content`、`content_html`、`status` 等。

### 图片 / 视频（库内只存路径）

```bash
python {baseDir}/scripts/main.py image add --file D:\a.png [--title "说明"]
python {baseDir}/scripts/main.py image list
python {baseDir}/scripts/main.py image get <id>
python {baseDir}/scripts/main.py image delete <id>
python {baseDir}/scripts/main.py image feedback <id> published <account_id>

python {baseDir}/scripts/main.py video add --file D:\a.mp4 [--title "说明"] [--duration-ms 120000]
python {baseDir}/scripts/main.py video list
python {baseDir}/scripts/main.py video get <id>
python {baseDir}/scripts/main.py video delete <id>
python {baseDir}/scripts/main.py video feedback <id> failed <account_id> "原因"
```

`image get` / `video get` 的 JSON 含 `file_path`（相对）、`absolute_path`（解析后绝对路径）。

## 环境变量

- `JIANGCHANG_DATA_ROOT`、`JIANGCHANG_USER_ID`：与 account-manager 一致。
- `llm-manager` 依赖其自身环境与账号/API Key 配置。