Initial commit: yu-zhi-ran platform with automation integration
This commit is contained in:
lt
@@ -0,0 +1,285 @@
|
||||
# 宇之然内容管理平台 - 完整项目文档
|
||||
|
||||
## 📦 项目概览
|
||||
|
||||
宇之然内容管理平台是一个集**自动化流水线**与**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）
|
||||
|
||||
```bash
|
||||
cd /root/.openclaw/workspaces/yzr-yxl/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 管理平台
|
||||
|
||||
```bash
|
||||
cd platform
|
||||
./run.sh 8001
|
||||
|
||||
# 访问
|
||||
# - 界面: http://localhost:8001/
|
||||
# - API文档: http://localhost:8001/docs
|
||||
```
|
||||
|
||||
**功能**：
|
||||
- 📊 仪表盘：选题统计、今日生成
|
||||
- 🔄 控制台：一键触发 collector/creator/optimizer
|
||||
- 📝 选题管理：列表、预览、状态
|
||||
- 📦 发布管理：生成发布包、查看HTML、复制
|
||||
- 📋 日志查看：所有模块实时日志
|
||||
|
||||
### 方式三：定时自动运行（cron）
|
||||
|
||||
```bash
|
||||
# 编辑 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 已就绪（知乎+小红书）
|
||||
|
||||
查看详细日志：
|
||||
```bash
|
||||
tail -f automation/logs/creator_$(date +%Y-%m-%d).log
|
||||
tail -f automation/logs/publisher_$(date +%Y-%m-%d).log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 开发调试
|
||||
|
||||
### 检查环境
|
||||
```bash
|
||||
cd platform
|
||||
python check.py
|
||||
```
|
||||
|
||||
### 手动测试流水线
|
||||
```bash
|
||||
python test_full_pipeline.py --topic-id A05
|
||||
```
|
||||
|
||||
### API 测试
|
||||
```bash
|
||||
# 系统状态
|
||||
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
|
||||
```
|
||||
|
||||
### 数据库重置
|
||||
```bash
|
||||
cd platform/backend
|
||||
rm -f data/yzr.db
|
||||
python -c "from app.database import init_db; init_db()"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 配置说明
|
||||
|
||||
### automation/config/sources.yaml
|
||||
|
||||
配置外部信息源（RSS/网页）：
|
||||
|
||||
```yaml
|
||||
sources:
|
||||
- name: "新华网-环保频道"
|
||||
type: "rss"
|
||||
url: "http://www.news.cn/..."
|
||||
focus: "可持续性"
|
||||
|
||||
- name: "人民网-生态环境"
|
||||
type: "rss"
|
||||
url: "http://env.people.com.cn/..."
|
||||
focus: "环保政策"
|
||||
```
|
||||
|
||||
### platform/.env (可选)
|
||||
|
||||
```bash
|
||||
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
|
||||
Reference in New Issue
Block a user