# content

**Repository Path**: jadon110/content

## Basic Information

- **Project Name**: content
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-07-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 头条热点选题工作台

本项目是一个本机单用户系统：`FastAPI + SQLite(WAL) + APScheduler + Vue 3/Vite + Docker Compose`。

它用于采集今日头条真实热榜，把热榜当成“公众注意力信号”，再通过兼容聊天补全接口的模型生成适合人工智能、科技、互联网科普号使用的选题方案、文章提纲和资料补充清单。

系统不再默认生成可直接发布的完整文章，也不做新闻改写、洗稿或自动发布。

## 功能

- 默认采集真实头条热榜接口：`https://www.toutiao.com/hot-event/hot-board/?origin=toutiao_pc`。
- SQLite 本地存储，默认数据库路径为项目根目录 `data/app.db`。
- 模型配置在前端“设置”页，保存到 SQLite 的 `Setting` 表。
- 出于安全考虑，提交仓库前应清空数据库里的 `ai.api_key`；换机器后请在“设置”页重新填写 API Key。
- 热点池会给每条热点计算相关性评分，辅助判断是否适合人工智能、科技、互联网科普延展。
- 每条热点可以生成选题方案；每个选题包含选题卡、文章提纲、资料补充清单。
- 发布流程弱化为“采用记录”：只记录是否采用、是否发布、发布链接和备注。

## 数据重置说明

本次重构不兼容旧的草稿、审核、发布包数据。

旧表会在数据库初始化时被清理，新的主表包括：

- 热点
- 选题方案
- 文章提纲
- 资料补充项
- 采用记录
- 模型任务记录
- 设置

如果需要从干净状态启动，可以删除 `data/app.db` 后重新启动后端，系统会自动创建新表和默认设置。

## 本地运行

```powershell
docker compose up --build
```

打开：

- 前端：http://localhost:5173
- 后端健康检查：http://localhost:8000/api/health

## 非 Docker 开发

后端：

```powershell
python -m pip install -r backend\requirements.txt
cd backend
python -m uvicorn app.main:app --reload
```

前端：

```powershell
cd frontend
npm.cmd ci
npm.cmd run dev
```

## 配置

进入前端“设置”页：

- 热榜接口：默认使用今日头条 PC 热榜 JSON 地址。
- Base URL：兼容 `/v1` 或完整 `/chat/completions` 的模型接口地址。
- API Key：模型服务密钥，不要提交到公开仓库。
- 模型名：兼容模型名。
- Temperature：默认 `0.4`。
- 内容定位：默认“人工智能/科技/互联网科普”。
- 相关关键词：用于热点相关性评分。
- 排除关键词：用于过滤不适合账号定位的热点。

也可以通过环境变量覆盖本地路径：

- `APP_DB_PATH`：SQLite 数据库路径。
- `APP_STORAGE_PATH`：本地存储目录。

## 测试

```powershell
python -m pytest backend\tests -q
cd frontend
npm.cmd test -- --run
npm.cmd run build
```

## 使用流程

1. 进入“设置”，配置模型和内容定位。
2. 在“热点池”点击“手动采集”，获取真实头条热榜。
3. 对适合人工智能、科技、互联网科普延展的热点点击“生成选题”。
4. 到“任务中心”查看选题生成任务是否成功。
5. 到“选题库”筛选候选选题，查看角度、目标读者、原创空间和改写风险。
6. 打开“选题详情”，编辑选题卡、文章提纲和资料补充清单。
7. 完成资料核验后，按实际写作情况记录“采用”或“已发布”。
8. 如果已经发布，在“采用记录”中回填发布链接和备注。

## 内容边界

系统默认把热榜理解为注意力入口，而不是可改写素材。

推荐产出：

- 解释型选题
- 科普型提纲
- 资料核验清单
- 面向普通读者的背景说明和判断框架

不推荐产出：

- 单篇新闻改写
- 规避原创检测的洗稿
- 未核验事实的完整文章
- 自动发布内容