README_CN.MD

Chinese Novel Translator API

Tiếng Việt | English | 中文

一个使用 Microsoft Agent Framework 和 DeepSeek 将中文小说翻译成越南语的 API。

项目结构

app/
|-- ai/             基于 DeepSeek 的小说分析工作流
|-- core/           配置、数据库和分页
|-- dtos/           请求和响应模型
|-- ebook/          TXT/EPUB 解析和内容提取
|-- endpoints/      FastAPI 接口
|-- entities/       SQLAlchemy 实体
|-- repositories/   数据库访问
|-- services/       业务逻辑
`-- main.py         FastAPI 应用入口

安装

环境要求：

• Python 3.14 或更高版本
• uv
• DeepSeek API 密钥

安装依赖：

uv sync

从示例文件创建 .env：

Copy-Item .env.example .env

配置 .env：

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
DATABASE_URL=sqlite:///./app.db

DATABASE_URL 为可选配置。默认使用位于 app.db 的 SQLite 数据库。

运行项目

uv run fastapi dev

API 默认运行于 http://127.0.0.1:8000。

API 文档：

Swagger UI: http://127.0.0.1:8000/docs
ReDoc:      http://127.0.0.1:8000/redoc
OpenAPI:    http://127.0.0.1:8000/openapi.json

应用启动时会自动创建数据库及其数据表。

许可证

本项目采用 Apache License 2.0 许可证。