FastAPI猜字谜实战（8）：收官

最新推荐文章于 2026-10-29 17:11:03 发布

原创最新推荐文章于 2026-10-29 17:11:03 发布 · 459 阅读

4 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

话题

#【多重好礼】鸿蒙心迹 · 开发录原创征稿活动

本文为FastAPI猜字谜系列终篇，聚焦用户体验细节优化：实现服务启动自动打开浏览器页面；前端+后端双层清洗AI返回的Markdown乱码符号；改进会话加载逻辑支持续玩上局；为历史会话添加可编辑名称字段并补全RESTful接口；通过降低temperature参数抑制AI输出外语乱码词。所有优化均基于Python、FastAPI、Uvicorn及前端JavaScript实现。

这是系列的最后一篇。功能都齐了，页面也能玩了，但攒了几个膈应人的小毛病没治：每次得手动开浏览器、AI 回复带乱码符号、一进页面就顶掉我上局的进度、历史全是时间戳分不清。这一篇挨个收拾，项目就算正式落地了。

一、不想每次手动敲地址，让它自己弹出来

最烦的是每次玩都得先跑 main.py，再切到浏览器输入 localhost:8000。能不能一启动就自动把页面打开？

能。Python 自带 webbrowser，我配合定时器延后一下就成：

import threading
import webbrowser

if __name__ == "__main__":
# 延迟 1.5 秒后再打开浏览器
threading.Timer(1.5, lambda: webbrowser.open("http://localhost:8000/")).start()
uvicorn.run(app, host="0.0.0.0", port=8000, access_log=False)

关键是那个延迟。 服务是 uvicorn.run 才起来的，我要是紧接着就 webbrowser.open，浏览器抢在服务监听之前打开，会直接显示连不上。所以我用 threading.Timer 把开浏览器这件事推后 1.5 秒，等后厨把门支起来了再叫客人。这样我直接点运行，终端服务和浏览器页面就能一起就位。

二、AI 回复带一堆井号星号，看着太乱

大模型爱用 Markdown 排版，动不动给我冒出 # 标题、**加粗** 这些符号，可我的气泡是纯文本，这些符号就原样杵在那，脏兮兮的。

我上了两道防线。第一道从源头治，在系统提示词里明令禁止：

- 只用纯文本回复，绝对不要使用任何 Markdown 标记（如 # 井号标题、* 星号加粗、反引号、- 列表符号等）。

但 prompt 不是百分百听话，偶尔还是漏。所以第二道在前端兜底，渲染 AI 回复前先用正则把这些符号洗掉：

function cleanMarkdown(text) {
if (!text) return text;
return text
.replace(/```[\s\S]*?```/g, '') // 去代码块
.replace(/`([^`]*)`/g, '$1') // 去行内代码
.replace(/\*\*([^*]*)\*\*/g, '$1') // 去加粗
.replace(/(^|\n)[ \t]*#{1,6}[ \t]*/g, '$1') // 去标题
.replace(/(^|\n)[ \t]*[*-][ \t]+/g, '$1') // 去列表符
.trim();
}

我在 addBubble 里，凡是 AI 的消息就先过一遍 cleanMarkdown 再显示（我的消息不用洗）。源头约束加末端兜底，双保险，页面就干净了。

三、一进页面就顶掉上局进度，改成“接着玩”

第七篇我写的是页面一加载就 startNewGame 新开一局。可当我想续玩上一局时，一刷新全没了，特别气人。

我改了加载逻辑：进来先问后端要历史列表，有历史就自动载入最近那一局，实在没有才新开。

async function initOnLoad() {
const resp = await fetch('/api/sessions');
const data = await resp.json();
const sessions = (data.code === 200 && data.data) ? data.data : [];

if (sessions.length) {
await resumeSession(sessions[0].id); // 直接续上最近的一局
} else {
await startNewGame(); // 没历史才新开
}
}

这里能直接拿 sessions[0] 当最近一局，靠的是第五篇列表接口已经按时间倒序排好了，头一个就是最新的。resumeSession 会请求那局的详情、把历史消息一条条铺成气泡，我接着往下猜就行。想开新局我留了“新游戏”按钮，主动点它才是新开。

四、历史全是时间戳分不清，给它加个名字

历史一多全是 2026-10-23_15-30-12 这种，根本记不住哪个是哪局。第三篇我存了个空 name 字段，就是留着这时候用的。

后端我补了个 PUT 接口专门改名。改名前我先判断这局在不在，不在就返回 404 提示，而不是直接抛异常：

@app.put("/api/sessions/{session_id}", response_model=ApiResponse, summary="重命名会话", tags=["会话管理"])
def rename_session(session_id: str, request: RenameRequest) -> ApiResponse:
session_file = get_session_file_name(session_id)
if not session_file.exists():
return ApiResponse(code=404, message="会话不存在，无法重命名", data=None)

with open(session_file, "r", encoding="utf-8") as f:
session_data = json.load(f)

session_data["name"] = request.name

with open(session_file, "w", encoding="utf-8") as f:
json.dump(session_data, f, ensure_ascii=False, indent=2)
return ApiResponse(code=200, message="重命名成功", data=None)

我只改 name 这一个字段，读出来改完再原样写回，messages 一点不动。前端历史列表每项挂个重命名按钮，弹个框让玩家输新名字，请求成功后刷新列表就显示新名了。
这一来，RESTful 那四个动作 GET 查、POST 增、PUT 改、DELETE 删，我总算在这项目里凑齐了。