# ai-article

**Repository Path**: lp-Imagine/ai-article

## Basic Information

- **Project Name**: ai-article
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Draftly · 内容工作台

面向微信公众号的内容创作工作台：选题 → 大纲 → 正文 → 配图 → 预览 / 检测 → 推送草稿箱。支持桌面与移动端；长任务异步执行，前端轮询进度。

## 功能

- **创作流程**：工作台选题 → 多方案大纲 → 正文生成（含精炼关）/ 扩写 / 润色 → 标题摘要与配图 → 公众号样式预览 → 推送草稿箱 / 同步到博客
- **AI**：主模型 + 可选辅助模型（可跨厂商）；封面与章节配图（需配置图像模型）；面向微信「高信息量 / 反低质 AIGC」的写作约束与风险检测
- **内容质量**：生成后自动精炼（提信息密度、去套话）；风险检测覆盖 AI 套话、闲聊开篇、空洞注水、同质化骨架等信号
- **账号**：登录 / 注册；文章与设置按用户隔离；超管可管理用户
- **后台任务**：大纲 / 正文 / 配图等入队执行，浮标追踪进度；支持每用户并发与日配额
- **博客同步**：将正文转为 Markdown，经 GitHub Contents API 写入 vuepressblog，触发 Pages 自动部署

## 技术栈

Next.js 16、React 19、Tailwind CSS 4、PostgreSQL、Prisma、Zod、Vitest

## 快速开始

需要 Node.js 20+ 与 PostgreSQL。

```bash
npm install
cp .env.example .env

# 终端 1：本机 Postgres（无 Docker 时）
npm run db:pg

# 或：docker compose up -d db

# 终端 2
npx prisma migrate deploy
npx prisma generate
npm run dev
```

打开 [http://localhost:3000](http://localhost:3000)。默认超管见 `.env.example` 中的说明。

在 **设置** 页配置 AI / 图像 / 微信公众号，或写入环境变量（完整列表见 [`.env.example`](.env.example)）。

注册需填写邮箱并完成邮箱验证码验证；忘记密码通过绑定邮箱的验证码重置。邮件支持双通道（见
[`.env.example`](.env.example)）：

- **SMTP**：`MAIL_PROVIDER=smtp` + `SMTP_HOST` / `SMTP_PORT` / `SMTP_SECURE` / `SMTP_USER` /
  `SMTP_PASS` / `SMTP_FROM`（163 / QQ / 企业邮等，全局配一次即可给任意收件人发信）
- **Resend**：`MAIL_PROVIDER=resend` + `RESEND_API_KEY` + `SMTP_FROM`（发件域名需在 Resend 验证）

不配 `MAIL_PROVIDER` 时默认 auto：有 `RESEND_API_KEY` 走 Resend，否则有 `SMTP_HOST` 走 SMTP。
未配置任何通道时，开发模式把验证码打印到服务端日志，生产环境会提示「邮件服务未配置」。

### 同步到 vuepressblog

正文生成后，可在文章页「发布」区点击 **同步到博客**，将 Markdown 写入 [vuepressblog](https://github.com/lp-Imagine/vuepressblog) 的 `website/sync/<section>/`，并触发 GitHub Actions 部署到 GitHub Pages。

每个账号可在自己的「设置 → 博客同步」里填 GitHub Token（`contents:write` + `actions:write`）、
目标仓库、分支与站点 URL。Token 仅保存在该用户下，其他人不可见。
未在设置中填写时会回退到 `.env` 中的全局默认值：

```bash
BLOG_GITHUB_TOKEN=ghp_xxx          # PAT：contents:write + actions:write
BLOG_GITHUB_REPO=lp-Imagine/vuepressblog
BLOG_GITHUB_BRANCH=master
BLOG_SITE_URL=https://lp-imagine.github.io/vuepressblog/
```

契约见博客仓库 `docs/SYNC.md`。同一篇文章再次同步会覆盖同路径文件（幂等）。

### 常用命令

```bash
npm run dev          # 开发
npm run db:pg        # 本机嵌入式 Postgres
npm run build        # 生产构建
npm run start        # 生产运行
npm run test         # 单元测试
```

## Docker 部署

```bash
docker compose up -d --build
```

Compose 会启动 PostgreSQL 与应用。请持久化 Postgres 数据卷，并参考 `.env.example` 配置 `DATABASE_URL`、任务配额、`COOKIE_SECURE` 等。

反代时建议拉长超时（如 `proxy_read_timeout 300s`），示例见 `docker/nginx-baota.conf.example`。有域名并启用 HTTPS 后，将 `COOKIE_SECURE=1`。

从旧版 SQLite 迁库可用：`npm run db:migrate:sqlite-to-pg`（需自行指定 `SQLITE_PATH` 与 `DATABASE_URL`）。

## 安全提示

仓库可公开；下列内容**不要**提交到 Git，也不要发到 Issue / 聊天：

- `.env`、API Key、微信 AppSecret、数据库密码、超管密码
- 数据库备份 / 导出（含用户与文章）、服务器 SSH 密钥

本地：`cp .env.example .env` 后只改自己的 `.env`（已忽略）。  
生产：务必设置强 `POSTGRES_PASSWORD` / `SUPER_ADMIN_PASSWORD`；未设超管密码时生产环境会生成随机密码并打一次日志。仅 HTTP 时不要开 `COOKIE_SECURE`；上 HTTPS 后再设 `COOKIE_SECURE=1`。

## License

Private — 本地 / 内部使用。