面向小白的托管版公众号文章生成器。在网页版基础上新增:登录注册(邀请码)、密钥加密存储、按用户隔离、数据导出。
免费期至 2026-12(占位,正式上线前改
config.py的FREE_UNTIL)。到期后用户可自行导出数据迁移。
妙文系列 · 一套由 DeepSeek 驱动的「公众号文章生成器」,由三个仓库协作组成: 🌐 网页版
Article-Agent(自托管后端 + 网页) · ☁️ 托管版Article-Agent-App(多用户后端 + PWA) · 📱 安卓客户端smart-elf-app(Flutter 原生 App)
| 仓库 | 定位 | 面向 | 部署 | 鉴权 | 数据 |
|---|---|---|---|---|---|
网页版 Article-Agent |
自托管网页工具 | 技术用户 | 用户自己一键部署 | 访问口令 | 本地 |
托管版 Article-Agent-App |
多用户后端 + PWA | 小白用户 | 托管方部署 | 账号 + 邀请码 | 服务端(加密,按用户隔离) |
安卓客户端 smart-elf-app |
Flutter 原生 App | 手机用户 | 安装 APK | 账号 + 邀请码 | 复用托管版后端 |
一句话关系:网页版是能力母体(四步生成 + 推送的完整实现);托管版在其之上增加 登录 / 邀请码 / 密钥加密 / 多用户隔离 / 数据导出,把同一套接口做成多人服务; 安卓客户端则是连接托管版后端的 Flutter 原生外壳。
| 网页版(自托管) | 托管版(多用户) | |
|---|---|---|
| 面向 | 技术用户 | 小白 |
| 部署 | 用户自己一键部署 | 托管方部署,多用户 |
| 密钥 | 存用户自己机器 | 服务端加密存储 |
| 鉴权 | 一个访问口令 | 账号密码 + 邀请码 |
| 数据 | 本地 | 服务端,按用户隔离,可导出 |
| 前端形态 | 网页 | 网页 PWA(可加到主屏) |
| 官方客户端 | — | smart-elf-app(Flutter 安卓 App) |
git clone https://github.com/hong-red/Article-Agent-App.git
cd Article-Agent-App
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app:app --host 0.0.0.0 --port 8000首次启动会自动生成一个默认邀请码并打印到日志(SMART2026)。也可以用 CLI 管理邀请码:
.venv/bin/python manage.py invite 你的邀请码 # 新增邀请码
.venv/bin/python manage.py list # 列出邀请码- 网页 PWA:前端是纯静态页(
static/),带manifest.json+sw.js,手机浏览器打开后可「添加到主屏」,像 App 一样使用。 - 安卓 App:
smart-elf-app(Flutter 原生客户端),默认连接本后端。
- 密码:PBKDF2 加盐散列,不存明文。
- 用户密钥(DeepSeek Key / 公众号 Secret):用 Fernet 对称加密后存 SQLite,密钥文件
data/secret.key(首次启动自动生成,勿泄露)。 - 会话:登录发随机 token,前端放 localStorage,请求带
Authorization: Bearer <token>。 - 数据隔离:文章/素材按
user_id隔离,互不可见。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/auth/register |
注册(用户名/密码/邀请码) |
| POST | /api/auth/login |
登录,返回 token |
| GET | /api/auth/me |
当前用户 |
| POST | /api/auth/logout |
退出 |
| GET | /api/info |
应用信息(免费期) |
| GET/POST | /api/settings |
读取/保存用户设置(加密) |
| POST | /api/generate/titles /content /format |
生成 |
| POST | /api/render |
Markdown → HTML |
| GET/POST/PUT/DELETE | /api/articles |
文章(按用户隔离) |
| POST | /api/articles/{id}/push |
推送到草稿箱 |
| GET | /api/export |
导出当前用户全部数据 |
| GET/POST/DELETE | /api/images /api/materials |
图片/素材 |
├── app.py # FastAPI 后端(认证 + 生成 + 文章 + 导出)
├── db.py # SQLite:用户/会话/邀请码/文章/素材
├── crypto.py # 密码散列 + 密钥加密
├── config.py # 配置(数据目录、免费期)
├── manage.py # 邀请码管理 CLI
├── llm.py imagesearch.py markdown_html.py wechat.py # 复用网页版
└── static/ # 前端 PWA(index.html / app.js / style.css / manifest.json / sw.js)
Article-Agent:网页版(自托管),本托管版的能力来源。smart-elf-app:Flutter 安卓客户端,连接本后端。