# 内容创作工作流

**Repository Path**: agent-dev-team/content-flow

## Basic Information

- **Project Name**: 内容创作工作流
- **Description**: 基于LangGraph的内容创作流水线，覆盖选题、检索、大纲、撰写、审核到发布全流程。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# content-flow 内容创作工作流

> 基于 **LangGraph** 的智能内容创作流水线（CLI 脚本）。输入一个主题，自动完成「选题分析 → 资料检索 → 大纲生成 → 内容撰写 → 质量审核」，输出一篇结构完整的 Markdown 文章。内置**模型池故障转移**与**条件路由重写**，保证产出质量与稳定性。

---

## 一、功能特性

- **状态图编排**：`StateGraph` 显式定义节点与边，执行过程可追踪
- **结构化输出**：每个节点用 Pydantic 约束输出结构
- **条件路由**：审核分数 ≥ 75 通过，否则打回重写（最多 `max_retry` 次，默认 2）
- **模型池容错**：多模型按序轮询，单模型失败自动切换，全部失败回退默认值
- **可观测**：每步日志 + 可选 LangSmith 追踪（`config.yml` 的 `langsmith` 段）
- **扁平结构**：函数直接调用，无类封装，易于学习

---

## 二、技术栈

- 核心编排：`langgraph`
- LLM 集成（阿里云百炼）：`langchain` / `langchain-community` / `dashscope`
- 结构化与配置：`pydantic` / `pyyaml`
- 可观测：`langsmith`
- 依赖管理：**uv 项目模式**（`pyproject.toml` + `uv.lock`，清华 TUNA 镜像）；`package = false`（脚本集合，不打包自身）

---

## 三、快速开始

```bash
python -m pip install uv        # 安装 uv（如未装）
uv sync                         # 一键安装依赖（自动创建 .venv 并锁定版本）
uv run python main.py           # 运行主程序（按提示输入主题，默认主题兜底）
uv run python ab_test.py        # Prompt A/B 测试
```

> 类比 `pnpm`：`uv sync` ≈ `pnpm install`，`uv run` ≈ `pnpm` 前缀。

---

## 四、工作流

```
选题分析(TopicAnalysis) → 资料检索(MaterialList) → 大纲生成(Outline)
    → 内容撰写(DraftContent) → 质量审核(ReviewResult)
        → 通过：输出 Markdown
        → 不通过：回到 内容撰写（最多 max_retry 次）
```

- `model_pool.py`：按 `config.yml` 扁平列表顺序轮询，含 `enabled` 开关临时屏蔽某模型
- `nodes.py`：各节点业务逻辑（含 Prompt 版本切换）
- `ab_test.py`：Prompt A/B 测试脚本

---

## 五、配置

编辑 `config.yml`：

- `models`：模型池（名称、`enabled` 开关、调用参数）
- `langsmith`：`enabled` 与 `api_key`，开启链路追踪

`config.yml` 含真实密钥，**请勿提交**。