add

Author: ahsd-coder

.vscode/settings.json

@@ -0,0 +1,2 @@
+{
+}

README.md

@@ -30,9 +30,17 @@ curl -X 'POST' \
 
 # 部署
 
+## 只有后端时启动
 ```commandline
 fastapi run main.py
 ```
+## 后端+前端启动
+```commandline
+uvicorn main:app --host 0.0.0.0 --port 8000
+解释：Uvicorn是一个ASGI服务器，负责接收HTTP请求并转发给FastAPI应用处理。FastAPI本身只是一个框架，不负责网络监听；uvicorn才是真正"跑起来"的那个进程
+main:app → main是Python模块名，对应main.py文件；app是该模块里的变量，即main.py里的app = FastAPI()
+uvicorn会先 import main,然后拿到main.py里的FastAPI实例，开始监听请求
+```
 
 # 推广
 ```commandline

config.py

@@ -15,9 +15,9 @@
 
 TFIDF_MODEL_PKL_PATH = "assets/weights/tfidf_ml.pkl"
 
-BERT_MODEL_PKL_PATH = "assets/weights/bert.pt"
+BERT_MODEL_PKL_PATH = "assets/weights/bert.pt"  # 微调完成后的权重
 BERT_MODEL_PERTRAINED_PATH = "assets/models/bert-base-chinese/"
 
-LLM_OPENAI_SERVER_URL = f"https://dashscope.aliyuncs.com/compatible-mode/v1" # ollama
-LLM_OPENAI_API_KEY = "sk-ea2dab7625464c94b794fa19c8ed60e7"
+LLM_OPENAI_SERVER_URL = f"https://llm-1u0cr1ya4sew3j07.cn-beijing.maas.aliyuncs.com/compatible-mode/v1" # ollama
+LLM_OPENAI_API_KEY = "sk-ws-H.RYPPHRP.8vGC.MEQCIHOnIbG3Xgji7P4S5aEUrJJcNrI9cuQ9m_MZnaHRxpqlAiAdmVloCGH9CvaUwy_6IvibdA-QEzPJxi_5hosJnnLM2g"
 LLM_MODEL_NAME = "qwen-turbo"

data_schema.py

@@ -8,8 +8,11 @@ class TextClassifyRequest(BaseModel):
     """
     request_id: Optional[str] = Field(..., description="请求id, 方便调试")
     request_text: Union[str, List[str]] = Field(..., description="请求文本、字符串或列表")
+# 如Optional[str]表示类型只能是字符串或者空，不能传数字、数组等
 
-
+# Field(...)中的...代表必填，等价于不设默认值，key必须存在
+# 虽然Optional(可以为None)，但接口调用时必须带上request_id这个key,只是值可以传null
+# Field(None)代表非必填，不传该字段也不会报错
 class TextClassifyResponse(BaseModel):
     """
     接口返回格式

docs/superpowers/specs/2026-06-28-frontend-design.md

@@ -0,0 +1,48 @@
+# 前端设计文档：车载语音意图识别界面
+
+## 概述
+
+为意图分类 API 服务构建面向真实用户的车载语音助手前端界面。用户输入语音转文字后的文本，选择模型，查看意图识别结果。
+
+## 技术选型
+
+- **原生 HTML/CSS/JS**：零依赖，无需 Node.js 构建工具
+- **FastAPI StaticFiles 挂载**：前后端同服务部署，无跨域问题
+- **localStorage**：历史记录本地持久化
+
+## 目录结构
+
+```
+frontend/
+├── index.html          # 主页面
+├── css/
+│   └── style.css       # 样式
+├── js/
+│   ├── api.js           # API 调用封装
+│   └── app.js           # 主逻辑
+```
+
+## 页面布局
+
+- 顶部标题栏：标题 + 副标题
+- 模型切换区：4 个模型选项卡（正则 / TF-IDF / BERT / 大模型）
+- 输入区域：大文本输入框 + 提交按钮
+- 结果卡片：分类结果、耗时、原文回显
+- 历史记录：本地保存的识别历史列表
+
+## 视觉风格
+
+- 深色主题（模拟车机中控屏）
+- 蓝色主色调 + 渐变光效
+- 结果卡片淡入动画
+- 响应式布局（桌面 + 移动端）
+
+## API 对接
+
+- POST `/v1/text-cls/regex`
+- POST `/v1/text-cls/tfidf`
+- POST `/v1/text-cls/bert`
+- POST `/v1/text-cls/gpt`
+
+请求体：`{request_id, request_text}`
+响应体：`{request_id, request_text, classify_result, classify_time, error_msg}`