AI写网文平台 · 光湖码字

光湖码字 · AI创作伙伴平台 — 首期功能模块

概览

本模块实现「AI写网文」平台的三大核心功能：

平台首页（Landing Page） — 对话式设计入口
用户注册/登录系统 — 手机号+验证码，三种角色（作者/编辑/运营），JWT鉴权
AI伙伴对话框 — 登录后分配专属AI伙伴，WebSocket实时对话

技术栈

层级	技术	说明
前端	React 18 + TypeScript + Vite	UI 组件化
样式	Tailwind CSS 3	响应式设计
状态管理	Zustand	轻量状态
实时通信	Socket.io	AI伙伴对话
后端	Node.js + Express + TypeScript	API 服务
认证	JWT	Token 鉴权
AI	OpenAI SDK	GPT-4 / Claude
数据	Notion API（主）+ 内存缓存（降级）	数据存储

目录结构

writing-platform/
├── frontend/           ← 前端（React + Vite）
│   ├── src/
│   │   ├── pages/      ← 页面组件
│   │   ├── components/ ← UI 组件
│   │   ├── hooks/      ← 自定义 Hooks
│   │   ├── services/   ← API 调用封装
│   │   └── stores/     ← Zustand 状态管理
│   └── dist/           ← 构建输出
│
├── backend/            ← 后端（Express + TypeScript）
│   ├── src/
│   │   ├── routes/     ← API 路由
│   │   ├── middleware/  ← 中间件
│   │   ├── services/   ← 业务逻辑
│   │   └── models/     ← 数据模型
│   └── dist/           ← 构建输出
│
├── nginx-writing.conf  ← Nginx 路由配置参考
└── README.md           ← 本文件

API 接口

方法	路径	说明
POST	`/api/writing/auth/send-code`	发送验证码
POST	`/api/writing/auth/register`	注册
POST	`/api/writing/auth/login`	登录
GET	`/api/writing/user/me`	获取当前用户
POST	`/api/writing/ai/chat`	AI 对话（REST）
GET	`/api/writing/health`	健康检查

AI伙伴

角色	AI伙伴	人设
作者	笔灵	温暖的创作伙伴
编辑	慧眼	专业的审稿助手
运营	星图	敏锐的数据分析师

环境变量

变量名	说明	状态
`LLM_API_KEY`	AI 模型 API Key	✅ 已有
`LLM_BASE_URL`	AI 模型端点	✅ 已有
`NOTION_TOKEN`	Notion API Token	✅ 已有
`JWT_SECRET`	JWT 签名密钥	⭕ 需配置
`SMS_ACCESS_KEY`	阿里云短信 Key	⏳ 待配置
`SMS_ACCESS_SECRET`	阿里云短信 Secret	⏳ 待配置
`WRITING_DB_ID`	Notion 用户表 ID	⭕ 需创建
`REDIS_URL`	Redis 连接	⭕ 可选

部署

# 构建前端
cd frontend && npm install && npm run build

# 构建后端
cd ../backend && npm install && npm run build

# 启动后端（PM2）
pm2 start ecosystem.config.js

# Nginx 配置（参考 nginx-writing.conf）

路由

前端入口：guanghulab.com/writing/
后端端口：3100

3.2 KiB Raw Blame History Unescape Escape

AI写网文平台 · 光湖码字

概览

技术栈

目录结构

API 接口

AI伙伴

环境变量

部署

路由

3.2 KiB

Raw Blame History