Skip to content

About

妙文系列 · 托管版(多用户后端 + PWA):网页版之上加登录/邀请码/密钥加密/数据隔离/导出,小白注册即用。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

妙文 · 托管版(多用户后端 + PWA)

面向小白的托管版公众号文章生成器。在网页版基础上新增:登录注册(邀请码)、密钥加密存储、按用户隔离、数据导出。

免费期至 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 隔离,互不可见。

API 一览

方法 路径 说明
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 安卓客户端,连接本后端。

About

妙文系列 · 托管版(多用户后端 + PWA):网页版之上加登录/邀请码/密钥加密/数据隔离/导出,小白注册即用。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages