Files

T

- 修复system.py缩进错误
- 优化前端页面样式（待重构）
- 改进API接口结构
- 完善文档和自动化脚本
- 平台基本功能稳定运行

2026-04-29 09:32:43 +08:00

8.8 KiB

Raw Blame History

宇之然内容管理平台 - 完整项目文档

📦 项目概览

宇之然内容管理平台是一个集自动化流水线与Web管理界面于一体的内容生产系统。

自动化模块: 采集→创作→优化→发布的全自动脚本
管理平台: Web UI 监控、控制、发布包管理
数据源: 单一 JSON 文件 + 本地案例库
目标: 每日自动生成高质量原创内容，多平台分发

🏗️ 目录结构

yu-zhi-ran/
├── platform/                 # 管理平台（FastAPI + Vue 3）
│   ├── backend/              # FastAPI 后端
│   │   └── app/
│   │       ├── api/          # REST API
│   │       │   ├── system.py # 系统状态、流水线控制
│   │       │   ├── topics.py # 选题管理
│   │       │   ├── publisher.py # 发布包管理
│   │       │   └── articles.py
│   │       └── core/         # 业务逻辑封装
│   │           ├── generator.py → 调用 scripts/creator.py
│   │           ├── optimizer.py → 调用 scripts/compliance_optimizer.py
│   │           └── sync.py    → 同步 automation/data/*.json
│   └── frontend/             # Vue 3 前端（CDN依赖）
│       └── index.html
├── automation/               # 自动化流水线（脚本+数据+日志）
│   ├── scripts/ (软链) → ../scripts/
│   ├── data/                # JSON 数据源
│   │   ├── sustainability_topics.json  # 选题库
│   │   ├── drafts/          # 草稿目录
│   │   └── releases/        # 发布包（按日期）
│   └── logs/                # 运行日志
│       ├── collector_*.log
│       ├── creator_*.log
│       ├── optimizer_*.log
│       └── publisher_*.log
├── scripts/                  # 底层CLI脚本（被automation/scripts/引用）
│   ├── collector.py         # 采集热点
│   ├── creator.py           # 内容创作
│   ├── compliance_optimizer.py  # 合规优化
│   ├── publisher.py         # 发布包生成
│   ├── research.py          # 研究资料
│   ├── outline.py           # 大纲生成
│   └── writer.py            # 撰写主力
├── content/                  # 已发布内容存储
│   ├── published/           # 按 topic_id 组织
│   ├── drafts/              # 草稿
│   ├── ideas/               # 选题记录
│   └── images/              # 配图资源
├── config/                   # 配置文件
│   ├── sources.yaml         # RSS/网页源配置
│   └── wecom_config.yaml    # 企业微信通知
├── brand/                    # 品牌资产
│   ├── brand-book.md
│   └── guidelines.md
├── research/                 # 行业研究
│   └── trends-2026.md
├── strategy/                 # 内容策略
│   └── 全球-本土比较研究与全新内容战略规划-2026-04-15.md
├── tasks/                    # 项目管理
│   └── todo.md
├── logs/                     # 根目录日志（兼容）
├── backup/                   # 备份归档
├── README.md                 # 项目总览
├── TEST_FULL_PIPELINE.md     # 测试指南
└── run_publisher.sh          # 快速启动发布任务

# 软链接（保持路径兼容）
automation/scripts → ../scripts/

🚀 快速开始

方式一：直接运行自动化流水线（CLI）

cd /root/openclaw-workspace/projects/yu-zhi-ran

# 手动执行各步骤
python scripts/collector.py        # 采集选题
python scripts/creator.py          # 创作内容
python scripts/compliance_optimizer.py  # 合规优化
python scripts/publisher.py        # 生成发布包

# 或使用测试脚本
python test_full_pipeline.py --topic-id A01

方式二：启动 Web 管理平台

cd platform
./run.sh 8001

# 访问
# - 界面: http://localhost:8001/
# - API文档: http://localhost:8001/docs

功能：

📊 仪表盘：选题统计、今日生成
🔄 控制台：一键触发 collector/creator/optimizer
📝 选题管理：列表、预览、状态
📦 发布管理：生成发布包、查看HTML、复制
📋 日志查看：所有模块实时日志

方式三：定时自动运行（cron）

# 编辑 crontab
crontab -e

# 添加以下任务（参考）
0 5 * * * cd /path/to/yu-zhi-ran && python automation/scripts/collector.py
30 5 * * * cd /path/to/yu-zhi-ran && python automation/scripts/creator.py
45 5 * * * cd /path/to/yu-zhi-ran && python automation/scripts/compliance_optimizer.py
0 6 * * * cd /path/to/yu-zhi-ran && python automation/scripts/publisher.py

🔄 系统架构

数据流

┌─────────────────┐
│  采集/创作/优化  │ ←─ automation/scripts/*.py
│  (CLI 脚本)     │
└────────┬────────┘
         │ 读写 JSON
         ▼
┌─────────────────┐
│ automation/data │
│ sustainability_ │
│   topics.json   │
└────────┬────────┘
         │ 同步
         ▼
┌─────────────────┐
│  platform/      │
│  FastAPI +      │
│  SQLite DB      │
└────────┬────────┘
         │ HTTP API
         ▼
┌─────────────────┐
│  Web 前端        │
│  (Vue 3)        │
└─────────────────┘

触发流程

操作	API端点	执行脚本	结果
点击"运行创作任务"	POST `/api/system/generate/run`	`scripts/creator.py`	生成草稿 → 状态: 待审查
点击"运行合规优化"	POST `/api/system/optimize/run`	`scripts/compliance_optimizer.py`	全自动通过 → 状态: 待发布
点击"生成发布包"	POST `/api/publisher/generate/{id}`	`scripts/publisher.py`	HTML包 → content/published/
页面刷新	GET `/api/system/status`	-	显示最新状态

📊 当前状态（2026-04-19）

选题库: 22 个（20 待处理 + 2 待发布）
自动运行: ✅ 每日 05:00-06:00 全流程
上次运行: 2026-04-19 05:30（A02 选题，8秒完成）
合规通过率: 100%（小样本）
发布包: A01、A02 已就绪（知乎+小红书）

查看详细日志：

tail -f automation/logs/creator_$(date +%Y-%m-%d).log
tail -f automation/logs/publisher_$(date +%Y-%m-%d).log

🔧 开发调试

检查环境

cd platform
python check.py

手动测试流水线

python test_full_pipeline.py --topic-id A05

API 测试

# 系统状态
curl http://localhost:8000/api/system/status

# 触发创作
curl -X POST http://localhost:8000/api/system/generate/run

# 流水线状态
curl http://localhost:8000/api/system/pipeline/status

数据库重置

cd platform/backend
rm -f data/yzr.db
python -c "from app.database import init_db; init_db()"

📝 配置说明

automation/config/sources.yaml

配置外部信息源（RSS/网页）：

sources:
  - name: "新华网-环保频道"
    type: "rss"
    url: "http://www.news.cn/..."
    focus: "可持续性"

  - name: "人民网-生态环境"
    type: "rss"
    url: "http://env.people.com.cn/..."
    focus: "环保政策"

platform/.env (可选)

PROJECT_ROOT=/path/to/yu-zhi-ran
DATA_DIR=/path/to/data
LOG_LEVEL=INFO

🎯 核心特性

特性	实现
降级策略	外部源失败 → 本地数据库 → Markdown案例库
锁机制	2小时超时，防止并发冲突
状态同步	JSON ↔ SQLite 自动同步
发布准备	生成多平台HTML + 发布指南，人工发布（风控）
Web管理	Vue 3 单页应用，无需构建
日志聚合	所有模块日志按日期归档

🚧 待办事项

添加用户认证（目前仅本地访问）
实现异步任务状态轮询（创作/优化耗时较长）
Nginx 反向代理配置（外网访问）
监控告警（失败通知）
多账号/IP策略（小红书多号分散风险）
数据导出功能（选题库、发布记录）

📚 相关文档

platform/PORTFOLIO.md - 平台架构详解
platform/README.md - 管理平台使用说明
PROJECT_PLAN_V2.md - 盈利模式与5平台矩阵
HERMES_AND_YUZHRAN_STATUS.md - 多Agent共享状态
2026-04-18-YUZHRAN-FIXES-SUMMARY.md - 技术修复总结

版本: 2.0 (2026-04-19) 维护: 宇之然 AI 助手 最后更新: 2026-04-19

8.8 KiB Raw Blame History Unescape Escape

宇之然内容管理平台 - 完整项目文档

📦 项目概览

🏗️ 目录结构

🚀 快速开始

方式一：直接运行自动化流水线（CLI）

方式二：启动 Web 管理平台

方式三：定时自动运行（cron）

🔄 系统架构

数据流

触发流程

📊 当前状态（2026-04-19）

🔧 开发调试

检查环境

手动测试流水线

API 测试

数据库重置

📝 配置说明

automation/config/sources.yaml

platform/.env (可选)

🎯 核心特性

🚧 待办事项

📚 相关文档

8.8 KiB

Raw Blame History