Files

827 lines
27 KiB
Python
Raw Permalink Normal View History

2026-01-27 13:57:32 +08:00
"""提示词工坊 API"""
from fastapi import APIRouter, Depends, HTTPException, Request
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import select, func, or_
from typing import Optional
2026-01-27 16:36:05 +08:00
from datetime import datetime
2026-01-27 13:57:32 +08:00
import uuid
from app.database import get_db
from app.config import settings, INSTANCE_ID, is_workshop_server
from app.models.writing_style import WritingStyle
from app.models.prompt_workshop import PromptWorkshopItem, PromptSubmission, PromptWorkshopLike
from app.schemas.prompt_workshop import (
ImportRequest, DownloadRequest, PromptSubmissionCreate,
ReviewRequest, AdminItemCreate, AdminItemUpdate
)
from app.services.workshop_client import workshop_client, WorkshopClientError
from app.constants.prompt_categories import PROMPT_CATEGORIES
from app.logger import get_logger
router = APIRouter(prefix="/prompt-workshop", tags=["prompt-workshop"])
logger = get_logger(__name__)
# ==================== 辅助函数 ====================
def get_current_user_id(request: Request) -> str:
"""获取当前登录用户ID"""
user_id = getattr(request.state, 'user_id', None)
if not user_id:
raise HTTPException(status_code=401, detail="未登录")
return user_id
def get_user_identifier(user_id: str) -> str:
"""生成云端用户标识"""
return f"{INSTANCE_ID}:{user_id}"
def get_user_identifier_from_request(request: Request) -> str:
"""
从请求中获取用户标识
中间件已经处理了代理请求,将用户标识存储在 request.state.user_id
- 代理请求:user_id 格式为 "instance_id:user_id"
- 本地请求:user_id 是本地用户ID,需要转换为 "instance_id:user_id" 格式
"""
user_id = getattr(request.state, 'user_id', None)
if not user_id:
raise HTTPException(status_code=401, detail="未登录或用户ID缺失")
# 检查是否为代理请求(user_id 已经是完整格式)
is_proxy = getattr(request.state, 'is_proxy_request', False)
if is_proxy:
# 代理请求,user_id 已经是 "instance_id:user_id" 格式
return user_id
else:
# 本地请求,需要添加实例前缀
return get_user_identifier(user_id)
def get_optional_user_identifier(request: Request) -> Optional[str]:
"""
获取可选的用户标识(用于公开API,可以没有用户)
"""
user_id = getattr(request.state, 'user_id', None)
if not user_id:
return None
# 检查是否为代理请求
is_proxy = getattr(request.state, 'is_proxy_request', False)
if is_proxy:
return user_id
else:
return get_user_identifier(user_id)
2026-01-27 13:57:32 +08:00
def _item_to_dict(item: PromptWorkshopItem, is_liked: bool = False) -> dict:
"""将模型转换为字典"""
return {
"id": item.id,
"name": item.name,
"description": item.description,
"prompt_content": item.prompt_content,
"category": item.category,
"tags": item.tags,
"author_name": item.author_name,
"is_official": item.is_official,
"download_count": item.download_count,
"like_count": item.like_count,
"is_liked": is_liked,
"created_at": item.created_at.isoformat() if item.created_at else None
}
def _submission_to_dict(submission: PromptSubmission) -> dict:
"""将提交记录转换为字典"""
return {
"id": submission.id,
"name": submission.name,
"description": submission.description,
"prompt_content": submission.prompt_content,
"category": submission.category,
"tags": submission.tags,
"author_display_name": submission.author_display_name,
"is_anonymous": submission.is_anonymous,
"status": submission.status,
"review_note": submission.review_note,
"reviewed_at": submission.reviewed_at.isoformat() if submission.reviewed_at else None,
"created_at": submission.created_at.isoformat() if submission.created_at else None,
"source_instance": submission.source_instance,
"submitter_name": submission.submitter_name
}
async def check_workshop_admin(request: Request):
"""检查是否为工坊管理员(必须是云端实例的管理员)"""
if not is_workshop_server():
raise HTTPException(status_code=403, detail="此功能仅在云端服务可用")
user = getattr(request.state, "user", None)
if not user:
raise HTTPException(status_code=401, detail="未登录")
if not user.is_admin:
raise HTTPException(status_code=403, detail="需要管理员权限")
return user
# ==================== 公开 API ====================
@router.get("/status")
async def get_status():
"""获取服务状态"""
result = {
"mode": settings.WORKSHOP_MODE,
"instance_id": INSTANCE_ID
}
if not is_workshop_server():
result["cloud_url"] = settings.WORKSHOP_CLOUD_URL
try:
result["cloud_connected"] = await workshop_client.check_connection()
except Exception:
result["cloud_connected"] = False
return result
@router.get("/items")
async def get_items(
request: Request,
category: Optional[str] = None,
search: Optional[str] = None,
tags: Optional[str] = None,
sort: str = "newest",
page: int = 1,
limit: int = 20,
db: AsyncSession = Depends(get_db)
):
"""获取提示词列表(公开接口,不需要登录)"""
user_identifier = get_optional_user_identifier(request)
2026-01-27 13:57:32 +08:00
if is_workshop_server():
# 服务端模式:直接查询本地数据库
return await _get_items_local(db, category, search, tags, sort, page, limit, user_identifier)
else:
# 客户端模式:代理到云端
try:
return await workshop_client.get_items(
category=category, search=search, tags=tags,
sort=sort, page=page, limit=limit,
user_identifier=user_identifier
)
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
async def _get_items_local(
db: AsyncSession,
category: Optional[str],
search: Optional[str],
tags: Optional[str],
sort: str,
page: int,
limit: int,
user_identifier: Optional[str]
) -> dict:
"""本地查询提示词列表"""
# 构建查询
query = select(PromptWorkshopItem).where(PromptWorkshopItem.status == "active")
count_query = select(func.count(PromptWorkshopItem.id)).where(PromptWorkshopItem.status == "active")
if category:
query = query.where(PromptWorkshopItem.category == category)
count_query = count_query.where(PromptWorkshopItem.category == category)
if search:
search_filter = or_(
PromptWorkshopItem.name.ilike(f"%{search}%"),
PromptWorkshopItem.description.ilike(f"%{search}%")
)
query = query.where(search_filter)
count_query = count_query.where(search_filter)
# 排序
if sort == "popular":
query = query.order_by(PromptWorkshopItem.like_count.desc())
elif sort == "downloads":
query = query.order_by(PromptWorkshopItem.download_count.desc())
else: # newest
query = query.order_by(PromptWorkshopItem.created_at.desc())
# 计数
count_result = await db.execute(count_query)
total = count_result.scalar_one()
# 分页
query = query.offset((page - 1) * limit).limit(limit)
result = await db.execute(query)
items = result.scalars().all()
# 获取用户点赞状态
liked_ids = set()
if user_identifier:
like_result = await db.execute(
select(PromptWorkshopLike.workshop_item_id).where(
PromptWorkshopLike.user_identifier == user_identifier
)
)
liked_ids = {row[0] for row in like_result.fetchall()}
# 获取分类统计
cat_result = await db.execute(
select(
PromptWorkshopItem.category,
func.count(PromptWorkshopItem.id)
).where(PromptWorkshopItem.status == "active")
.group_by(PromptWorkshopItem.category)
)
categories = [
{"id": cat, "name": PROMPT_CATEGORIES.get(cat, cat), "count": count}
for cat, count in cat_result.fetchall()
]
return {
"success": True,
"data": {
"total": total,
"page": page,
"limit": limit,
"items": [
_item_to_dict(item, is_liked=item.id in liked_ids)
for item in items
],
"categories": categories
}
}
@router.get("/items/{item_id}")
async def get_item(item_id: str, request: Request, db: AsyncSession = Depends(get_db)):
2026-01-27 13:57:32 +08:00
"""获取单个提示词详情"""
user_identifier = get_optional_user_identifier(request)
2026-01-27 13:57:32 +08:00
if is_workshop_server():
result = await db.execute(
select(PromptWorkshopItem).where(
PromptWorkshopItem.id == item_id,
PromptWorkshopItem.status == "active"
)
)
item = result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
return {"success": True, "data": _item_to_dict(item)}
else:
try:
return await workshop_client.get_item(item_id, user_identifier=user_identifier)
2026-01-27 13:57:32 +08:00
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
@router.post("/items/{item_id}/import")
async def import_item(
item_id: str,
data: ImportRequest,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""导入提示词到本地写作风格"""
user_id = get_current_user_id(request)
user_identifier = get_user_identifier(user_id)
# 获取提示词详情
if is_workshop_server():
result = await db.execute(
select(PromptWorkshopItem).where(PromptWorkshopItem.id == item_id)
)
item = result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
item_data = _item_to_dict(item)
# 增加下载计数
item.download_count += 1
await db.commit()
else:
# 从云端获取
try:
result = await workshop_client.get_item(item_id, user_identifier=user_identifier)
2026-01-27 13:57:32 +08:00
item_data = result.get("data", result)
# 通知云端增加下载计数
try:
await workshop_client.record_download(item_id, user_identifier)
except Exception as e:
logger.warning(f"通知云端下载计数失败: {e}")
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
# 创建本地写作风格
count_result = await db.execute(
select(func.count(WritingStyle.id)).where(WritingStyle.user_id == user_id)
)
max_order = count_result.scalar_one()
new_style = WritingStyle(
user_id=user_id,
name=data.custom_name or item_data["name"],
style_type="custom",
description=f"从提示词工坊导入: {item_data.get('description', '') or ''}",
prompt_content=item_data["prompt_content"],
order_index=max_order + 1
)
db.add(new_style)
await db.commit()
await db.refresh(new_style)
return {
"success": True,
"message": "导入成功",
"writing_style": {
"id": new_style.id,
"name": new_style.name,
"style_type": new_style.style_type,
"prompt_content": new_style.prompt_content
}
}
@router.post("/items/{item_id}/like")
async def toggle_like(
item_id: str,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""点赞/取消点赞"""
user_identifier = get_user_identifier_from_request(request)
2026-01-27 13:57:32 +08:00
if is_workshop_server():
# 检查是否已点赞
result = await db.execute(
select(PromptWorkshopLike).where(
PromptWorkshopLike.user_identifier == user_identifier,
PromptWorkshopLike.workshop_item_id == item_id
)
)
existing_like = result.scalar_one_or_none()
# 获取提示词
item_result = await db.execute(
select(PromptWorkshopItem).where(PromptWorkshopItem.id == item_id)
)
item = item_result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
if existing_like:
# 取消点赞
await db.delete(existing_like)
item.like_count = max(0, item.like_count - 1)
liked = False
else:
# 添加点赞
new_like = PromptWorkshopLike(
id=str(uuid.uuid4()),
user_identifier=user_identifier,
workshop_item_id=item_id
)
db.add(new_like)
item.like_count += 1
liked = True
await db.commit()
return {"success": True, "liked": liked, "like_count": item.like_count}
else:
try:
return await workshop_client.toggle_like(item_id, user_identifier)
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
@router.post("/items/{item_id}/download")
async def record_download(
item_id: str,
data: DownloadRequest,
db: AsyncSession = Depends(get_db)
):
"""记录下载(仅云端实例使用)"""
if not is_workshop_server():
raise HTTPException(status_code=403, detail="此接口仅供云端实例使用")
result = await db.execute(
select(PromptWorkshopItem).where(PromptWorkshopItem.id == item_id)
)
item = result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
item.download_count += 1
await db.commit()
return {"success": True, "download_count": item.download_count}
@router.post("/submit")
async def submit_prompt(
data: PromptSubmissionCreate,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""提交提示词"""
user_identifier = get_user_identifier_from_request(request)
2026-01-27 13:57:32 +08:00
2026-01-27 16:36:05 +08:00
# 作者名称优先使用用户填写的 author_display_name
# 如果用户未填写,才使用系统获取的用户名
submitter_name = data.author_display_name
2026-01-27 16:36:05 +08:00
if not submitter_name:
# 用户未填写作者名称,尝试从系统获取
is_proxy = getattr(request.state, 'is_proxy_request', False)
if is_proxy:
submitter_name = "未知用户"
else:
2026-01-27 16:36:05 +08:00
user = getattr(request.state, 'user', None)
if user:
submitter_name = user.display_name
else:
user_id = getattr(request.state, 'user_id', None)
if user_id:
from app.user_manager import user_manager
user = await user_manager.get_user(user_id)
submitter_name = user.display_name if user else "未知用户"
else:
submitter_name = "未知用户"
2026-01-27 13:57:32 +08:00
if is_workshop_server():
# 直接创建提交记录
# 对于代理请求,source_instance 从 Header 获取
source_instance = request.headers.get("X-Instance-ID") or INSTANCE_ID
2026-01-27 13:57:32 +08:00
submission = PromptSubmission(
id=str(uuid.uuid4()),
submitter_id=user_identifier,
submitter_name=submitter_name,
source_instance=source_instance,
2026-01-27 13:57:32 +08:00
name=data.name,
description=data.description,
prompt_content=data.prompt_content,
category=data.category,
tags=data.tags,
author_display_name=data.author_display_name or submitter_name,
is_anonymous=data.is_anonymous,
status="pending"
)
db.add(submission)
await db.commit()
await db.refresh(submission)
return {
"success": True,
"message": "提交成功,等待管理员审核",
"submission": {
"id": submission.id,
"status": submission.status,
"created_at": submission.created_at.isoformat() if submission.created_at else None
}
}
else:
try:
return await workshop_client.submit(
user_identifier=user_identifier,
submitter_name=submitter_name,
data=data.model_dump()
)
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
@router.get("/my-submissions")
async def get_my_submissions(
request: Request,
status: Optional[str] = None,
db: AsyncSession = Depends(get_db)
):
"""获取我的提交记录"""
user_identifier = get_user_identifier_from_request(request)
2026-01-27 13:57:32 +08:00
if is_workshop_server():
query = select(PromptSubmission).where(
PromptSubmission.submitter_id == user_identifier
)
if status:
query = query.where(PromptSubmission.status == status)
query = query.order_by(PromptSubmission.created_at.desc())
result = await db.execute(query)
submissions = result.scalars().all()
return {
"success": True,
"data": {
"total": len(submissions),
"items": [_submission_to_dict(s) for s in submissions]
}
}
else:
try:
return await workshop_client.get_submissions(user_identifier, status)
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
@router.delete("/submissions/{submission_id}")
async def withdraw_submission(
submission_id: str,
request: Request,
2026-01-27 16:34:17 +08:00
force: bool = False,
2026-01-27 13:57:32 +08:00
db: AsyncSession = Depends(get_db)
):
2026-01-27 16:34:17 +08:00
"""
删除提交记录
- 待审核(pending)的提交可以直接撤回
- 已审核(approved/rejected)的提交需要 force=True 参数才能删除
"""
user_identifier = get_user_identifier_from_request(request)
2026-01-27 13:57:32 +08:00
if is_workshop_server():
result = await db.execute(
select(PromptSubmission).where(
PromptSubmission.id == submission_id,
PromptSubmission.submitter_id == user_identifier
)
)
submission = result.scalar_one_or_none()
if not submission:
raise HTTPException(status_code=404, detail="提交记录不存在")
2026-01-27 16:34:17 +08:00
# 待审核的可以直接撤回,已审核的需要 force 参数
if submission.status != "pending" and not force:
raise HTTPException(status_code=400, detail="只能撤回待审核的提交,删除已审核记录请使用 force 参数")
2026-01-27 13:57:32 +08:00
await db.delete(submission)
await db.commit()
2026-01-27 16:34:17 +08:00
if submission.status == "pending":
return {"success": True, "message": "撤回成功"}
else:
return {"success": True, "message": "删除成功"}
2026-01-27 13:57:32 +08:00
else:
try:
2026-01-27 16:34:17 +08:00
return await workshop_client.withdraw_submission(submission_id, user_identifier, force)
2026-01-27 13:57:32 +08:00
except WorkshopClientError as e:
raise HTTPException(status_code=503, detail=str(e))
# ==================== 管理员 API(仅云端实例) ====================
@router.get("/admin/submissions")
async def admin_get_submissions(
request: Request,
status: Optional[str] = None,
source: Optional[str] = None,
page: int = 1,
limit: int = 20,
db: AsyncSession = Depends(get_db)
):
"""获取待审核列表(管理员)"""
await check_workshop_admin(request)
query = select(PromptSubmission)
count_query = select(func.count(PromptSubmission.id))
if status and status != "all":
query = query.where(PromptSubmission.status == status)
count_query = count_query.where(PromptSubmission.status == status)
if source:
query = query.where(PromptSubmission.source_instance == source)
count_query = count_query.where(PromptSubmission.source_instance == source)
# 计数
count_result = await db.execute(count_query)
total = count_result.scalar_one()
# 待审核数量
pending_result = await db.execute(
select(func.count(PromptSubmission.id)).where(PromptSubmission.status == "pending")
)
pending_count = pending_result.scalar_one()
# 分页查询
query = query.order_by(PromptSubmission.created_at.desc())
query = query.offset((page - 1) * limit).limit(limit)
result = await db.execute(query)
submissions = result.scalars().all()
return {
"success": True,
"data": {
"total": total,
"pending_count": pending_count,
"page": page,
"limit": limit,
"items": [_submission_to_dict(s) for s in submissions]
}
}
@router.post("/admin/submissions/{submission_id}/review")
async def admin_review_submission(
submission_id: str,
data: ReviewRequest,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""审核提交(管理员)"""
admin = await check_workshop_admin(request)
result = await db.execute(
select(PromptSubmission).where(PromptSubmission.id == submission_id)
)
submission = result.scalar_one_or_none()
if not submission:
raise HTTPException(status_code=404, detail="提交记录不存在")
if submission.status != "pending":
raise HTTPException(status_code=400, detail="该提交已被审核")
admin_user_id = getattr(admin, 'user_id', str(admin))
if data.action == "approve":
# 创建工坊条目
new_item = PromptWorkshopItem(
id=str(uuid.uuid4()),
name=submission.name,
description=submission.description,
prompt_content=submission.prompt_content,
category=data.category or submission.category,
tags=data.tags or submission.tags,
author_id=None if submission.is_anonymous else submission.submitter_id,
author_name=submission.author_display_name if not submission.is_anonymous else None,
source_instance=submission.source_instance,
is_official=False,
status="active"
)
db.add(new_item)
submission.status = "approved"
submission.workshop_item_id = new_item.id
submission.reviewer_id = admin_user_id
submission.review_note = data.review_note
2026-01-27 16:36:05 +08:00
submission.reviewed_at = datetime.utcnow()
2026-01-27 13:57:32 +08:00
await db.commit()
await db.refresh(new_item)
return {
"success": True,
"message": "已通过审核并发布",
"workshop_item": _item_to_dict(new_item)
}
else:
submission.status = "rejected"
submission.reviewer_id = admin_user_id
submission.review_note = data.review_note
2026-01-27 16:36:05 +08:00
submission.reviewed_at = datetime.utcnow()
2026-01-27 13:57:32 +08:00
await db.commit()
2026-01-27 16:36:05 +08:00
await db.refresh(submission)
2026-01-27 13:57:32 +08:00
return {
"success": True,
"message": "已拒绝",
"submission": _submission_to_dict(submission)
}
@router.post("/admin/items")
async def admin_create_item(
data: AdminItemCreate,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""添加官方提示词(管理员)"""
await check_workshop_admin(request)
new_item = PromptWorkshopItem(
id=str(uuid.uuid4()),
name=data.name,
description=data.description,
prompt_content=data.prompt_content,
category=data.category,
tags=data.tags,
author_name="官方",
is_official=True,
status="active"
)
db.add(new_item)
await db.commit()
await db.refresh(new_item)
return {"success": True, "item": _item_to_dict(new_item)}
@router.put("/admin/items/{item_id}")
async def admin_update_item(
item_id: str,
data: AdminItemUpdate,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""编辑提示词(管理员)"""
await check_workshop_admin(request)
result = await db.execute(
select(PromptWorkshopItem).where(PromptWorkshopItem.id == item_id)
)
item = result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
update_data = data.model_dump(exclude_unset=True)
for key, value in update_data.items():
setattr(item, key, value)
await db.commit()
await db.refresh(item)
return {"success": True, "item": _item_to_dict(item)}
@router.delete("/admin/items/{item_id}")
async def admin_delete_item(
item_id: str,
request: Request,
db: AsyncSession = Depends(get_db)
):
"""删除提示词(管理员)"""
await check_workshop_admin(request)
result = await db.execute(
select(PromptWorkshopItem).where(PromptWorkshopItem.id == item_id)
)
item = result.scalar_one_or_none()
if not item:
raise HTTPException(status_code=404, detail="提示词不存在")
await db.delete(item)
await db.commit()
return {"success": True, "message": "删除成功"}
@router.get("/admin/stats")
async def admin_get_stats(
request: Request,
db: AsyncSession = Depends(get_db)
):
"""获取统计数据(管理员)"""
await check_workshop_admin(request)
# 提示词总数
items_count = await db.execute(
select(func.count(PromptWorkshopItem.id)).where(PromptWorkshopItem.status == "active")
)
total_items = items_count.scalar_one()
# 官方提示词数量
official_count = await db.execute(
select(func.count(PromptWorkshopItem.id)).where(
PromptWorkshopItem.status == "active",
PromptWorkshopItem.is_official == True
)
)
total_official = official_count.scalar_one()
# 待审核数量
pending_count = await db.execute(
select(func.count(PromptSubmission.id)).where(PromptSubmission.status == "pending")
)
total_pending = pending_count.scalar_one()
# 总下载量
downloads_sum = await db.execute(
select(func.sum(PromptWorkshopItem.download_count))
)
total_downloads = downloads_sum.scalar_one() or 0
# 总点赞量
likes_sum = await db.execute(
select(func.sum(PromptWorkshopItem.like_count))
)
total_likes = likes_sum.scalar_one() or 0
return {
"success": True,
"data": {
"total_items": total_items,
"total_official": total_official,
"total_pending": total_pending,
"total_downloads": total_downloads,
"total_likes": total_likes
}
}