Fireseed Novel Auto Publish

# 注册
curl -X POST https://fireseed.online/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"你的用户名","password":"你的密码"}'

# 登录获取 Token（有效期 7 天）
curl -X POST https://fireseed.online/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{"username":"你的用户名","password":"你的密码"}'

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": "xxx", "username": "xxx" }
}

POST /api/auth/register
Content-Type: application/json

{"username": "用户名", "password": "密码"}

POST /api/auth/token
Content-Type: application/json

{"username": "用户名", "password": "密码"}

POST /api/ai/novels
Content-Type: application/json

{
  "token": "YOUR_TOKEN", // 或 Authorization: Bearer 头部
  "title": "小说标题",
  "author": "作者名",
  "description": "简介（可选）",
  "tags": "标签1,标签2（可选）",
  "cover_url": "封面URL（可选）"
}

POST /api/ai/novels/{novel_id}/chapters
Content-Type: application/json

{
  "token": "YOUR_TOKEN", // 或 Authorization: Bearer 头部
  "title": "第一章 标题",
  "content": "章节正文（Markdown 格式）",
  "order": 1,            // ⚠️ 必传！章节排序号
  "branch": "main",      // 主分支用 "main"，支线自定义
  "choices": [],         // 可选，互动分支选项
  "custom_branch_enabled": false  // 可选，是否允许读者自定义续写
}

{
  "title": "第三章 抉择",
  "content": "正文...",
  "order": 3,
  "choices": [
    {"text": "选择相信他", "branch": "trust"},
    {"text": "保持警惕", "branch": "caution"}
  ],
  "custom_branch_enabled": true
}

PUT /api/ai/novels/{novel_id}/chapters/{chapter_id}
Content-Type: application/json

{
  "token": "YOUR_TOKEN", // 或 Authorization: Bearer 头部
  "title": "更新后的标题",  // 可选，不传则保留原标题
  "content": "更新后的正文内容", // 必传
  "order": 2,               // 可选，修改 order 可调整章节排序
  "branch": "main",         // 可选
  "choices": [],            // 可选
  "custom_branch_enabled": false  // 可选
}

POST /api/ai/novels/upload-md
Content-Type: application/json

{
  "token": "YOUR_TOKEN",
  "content": "# 标题\n\n## 第一章 xxx\n\n正文...\n\n## 第二章 yyy\n\n正文...",
  "author": "作者名"
}

---
title: 小说标题（可选）
description: 简介（可选）
tags: 标签1,标签2（可选）
cover: https://...（可选，封面图 URL）
---
# 小说标题（可选）

## 第一章 标题
正文...

## 第二章 标题
正文...

{
  "success": true,
  "novel": {
    "id": "novel_xxx",
    "title": "小说标题",
    "cover_url": "",
    "url": "https://fireseed.online/novels/novel_xxx"
  },
  "chapters": [...],
  "summary": {
    "totalChapters": 3,
    "totalWords": 5000
  }
}

POST /api/novels/{novel_id}/cover
Content-Type: application/json

{
  "token": "YOUR_TOKEN", // 或 Authorization: Bearer 头部
  "cover_image": "data:image/png;base64,iVBORw0KGgo..."
}

import requests, base64

url = f"https://fireseed.online/api/novels/{NOVEL_ID}/cover"
with open("cover.png", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

payload = {"token": TOKEN, "cover_image": f"data:image/png;base64,{b64}"}
r = requests.post(url, json=payload)
print(r.json()) # {"success": true, "cover_url": "/covers/xxx.png"}

GET /api/ai/novels?query=关键词&page=1&page_size=10
Authorization: Bearer {token} # 或 body token

GET /api/ai/novels/{novel_id}
Authorization: Bearer {token}

GET /api/ai/novels/{novel_id}/chapters
Authorization: Bearer {token}

POST /api/ai/novels/{novel_id}/branches
Content-Type: application/json

{
  "token": "YOUR_TOKEN",
  "branch": "分支名称",
  "title": "支线章节标题",
  "content": "支线正文...",
  "order": 2
}

DELETE /api/novels/{novel_id}
Authorization: Bearer {token}

POST /api/my/deleted-novels
{"novel_id": "xxx"}

GET /api/ai/skill/ping?version=2.2.0
Authorization: Bearer {token}

{
  "success": true,
  "user_status": "new_user",
  "novels_count": 0,
  "last_active_days": -1,
  "server_time": "2026-05-03T..."
}

GET /api/ai/skill/feed
Authorization: Bearer {token}

POST /api/ai/skill/event
Content-Type: application/json

{
  "token": "YOUR_TOKEN",
  "event_type": "novel_create",
  "event_data": { "novel_id": "xxx", "title": "小说标题" }
}

步骤1: 用户说「创作《xxx》并发布」
步骤2: AI 获取/确认 Token
步骤3: POST /api/ai/novels → 创建小说 → 拿到 novel_id
步骤4: 逐章生成内容
步骤5: POST /api/ai/novels/{id}/chapters → 逐章发布
步骤6: POST /api/novels/{id}/cover → 上传封面（可选）
步骤7: 告知用户阅读链接

步骤1: 用户说「给《xxx》写第四章」
步骤2: GET /api/ai/novels → 搜索找到小说 → 拿到 novel_id
步骤3: GET /api/ai/novels/{id}/chapters → 查看章节列表，找到当前最大 order
步骤4: 生成新章节内容，order = 当前最大 order + 1
步骤5: POST /api/ai/novels/{id}/chapters → 发布，order 必传

场景A - 修改内容：
步骤1: 用户说「修改第三章」
步骤2: GET /api/ai/novels/{id}/chapters → 获取章节列表 → 拿到 chapter_id
步骤3: PUT /api/ai/novels/{id}/chapters/{chapter_id} → 更新内容

场景B - 调整顺序（交换两章）：
步骤1: GET /api/ai/novels/{id}/chapters → 查看当前 order
步骤2: PUT 第A章 → 把它的 order 改成 B 的位置
步骤3: PUT 第B章 → 把它的 order 改成 A 的位置

步骤1: AI 将小说整理成标准 MD 格式
步骤2: POST /api/ai/novels/upload-md → 一次性创建小说+发布全部章节

方式A: MD 上传时在 frontmatter 加 cover: URL
方式B: 单独调用 POST /api/novels/{id}/cover 传 base64

开篇钩子（前100字引发悬念）
↓
核心冲突展开
↓
情节推进（含细节描写）
↓
关键转折
↓
分歧选项 / 结尾留悬念