refactor: 重构项目工程目录架构并清理冗余说明文档
这个提交包含在:
101
README.md
普通文件
101
README.md
普通文件
@ -0,0 +1,101 @@
|
|||||||
|
# 物理竞赛 AI Agent 框架 - 项目总览与使用指南
|
||||||
|
|
||||||
|
## 项目简介
|
||||||
|
|
||||||
|
这是一套针对大学物理实验(声速测量)的 **模块化 AI Agent 框架**。
|
||||||
|
系统已从早期的单一长提示词文档,重构为代码可驱动执行的模块化架构,并保留了对 Web UI 的快速集成能力。
|
||||||
|
|
||||||
|
本系统提供三种核心 AI 教学角色:
|
||||||
|
1. **疑问解答老师** (QA Teacher):引导学生完成实验预习,解答理论与操作疑问。
|
||||||
|
2. **答题评估老师** (Grader Teacher):根据标准答案评分,并提供启发式反馈。
|
||||||
|
3. **数据评价老师** (Data Eval Teacher):针对学生的实验测量数据,评估误差并指出潜在的操作缺陷。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 核心目录结构
|
||||||
|
|
||||||
|
\\\ ext
|
||||||
|
/
|
||||||
|
README.md # 本文档,项目总览与入口
|
||||||
|
run_agents.py # 核心运行脚本(基于 AutoGen 的终端测试入口)
|
||||||
|
config.env.example # 环境变量示例(需配置模型 API Key)
|
||||||
|
components/ # (规划中/逻辑映射)模块化提示词与知识库
|
||||||
|
personas/ # AI 角色设定(背景、语气、教学风格)
|
||||||
|
tasks/ # 工作流要求(评估步骤、JSON 输出格式要求等)
|
||||||
|
data/ # 领域知识库(专业词汇表、评分标准等 RAG 语料)
|
||||||
|
json-schemas/ # 严格的结构化输出 JSON 协议
|
||||||
|
docs/ # 补充参考与文档
|
||||||
|
示例对话与快速参考.md # 典型交互用例与知识点速查
|
||||||
|
web_app_integration/ # Web / 云端集成代码与模板
|
||||||
|
prompts/ # 重点:专为 Web 云函数一键粘贴准备的合体版提示词模板
|
||||||
|
cloudfunctions/ # 腾讯云开发 (CloudBase) 云函数 Node.js 源码示例
|
||||||
|
archive/ # 归档目录(存放早期的冗余单一文档,过渡期后删除)
|
||||||
|
\\\
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 快速开始:本地运行测试
|
||||||
|
|
||||||
|
本系统支持在终端中直接进行调试与体验,动态拼装 personas/ 和 asks/ 中的提示词。
|
||||||
|
|
||||||
|
### 1. 环境准备
|
||||||
|
确保你已安装 Python 3.8+,并安装依赖:
|
||||||
|
\\\ash
|
||||||
|
pip install pyautogen python-dotenv
|
||||||
|
\\\
|
||||||
|
|
||||||
|
### 2. 配置 API Key
|
||||||
|
在项目根目录创建 \.env\ 文件(可复制自 \config.env.example\ 无则自建),并填入你的大模型配置:
|
||||||
|
\\\env
|
||||||
|
# 示例:使用 DeepSeek 或千问等兼容 OpenAI 格式的模型
|
||||||
|
OPENAI_API_KEY=your_api_key_here
|
||||||
|
OPENAI_BASE_URL=https://api.deepseek.com/v1
|
||||||
|
MODEL_NAME=deepseek-chat
|
||||||
|
\\\
|
||||||
|
|
||||||
|
### 3. 运行交互引擎
|
||||||
|
\\\ash
|
||||||
|
python run_agents.py
|
||||||
|
\\\
|
||||||
|
按照终端提示,选择 1(疑问)、2(评估)或 3(数据)对应的老师,即可开始交互。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 快速开始:Web/云函数集成
|
||||||
|
|
||||||
|
对于前端开发者或需要在真实业务中集成该 Agent 的场景:
|
||||||
|
|
||||||
|
### 方案 A:直接复制一键提示词
|
||||||
|
如果您使用的是低代码平台(如 Coze, Dify)或只想要一个完整的 System Prompt:
|
||||||
|
请前往 \web_app_integration/prompts/\ 目录,直接复制对应老师的 \.md\ 文件全文即可。
|
||||||
|
*注意:这三份文件由 \personas\ + \ asks\ + \data\ 拼装而成,方便直接粘贴。作为单一事实来源(SSOT),深度的逻辑修改请优先更新基础模块。*
|
||||||
|
|
||||||
|
### 方案 B:完整云开发部署
|
||||||
|
参考 \Web应用集成指南.md\(位于根目录或 web_app_integration 目录)。该指南包含:
|
||||||
|
- CloudBase 云函数具体实现(Node.js SDK 调用)
|
||||||
|
- 结构化 JSON 返回的处理策略
|
||||||
|
- 前端 React 组件接入示例
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 进阶:如何修改 AI 逻辑
|
||||||
|
|
||||||
|
系统采用 **Prompt as Code (模块化)** 设计。如果您发现 AI 回答不符合预期,请定位并修改以下文件,而非修改整个长提示词:
|
||||||
|
|
||||||
|
1. **语气或人设不好?** -> 修改 \personas/xxx-teacher.md\
|
||||||
|
2. **处理流程/评分标准不对?** -> 修改 \ asks/xxx.md\ 或 \data/grading-standards.md\
|
||||||
|
3. **前端解析 JSON 报错?** -> 检查并修改 \json-schemas/evaluation-schema.json\
|
||||||
|
4. **术语解释不准?** -> 扩充 \data/physics-glossary.md\
|
||||||
|
|
||||||
|
修改完成后,重新执行 \python run_agents.py\ 验证效果。当认为效果稳定后,请同步把修改更新到 \web_app_integration/prompts/\ 下的集成模板中。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 关于文件清理的说明
|
||||||
|
|
||||||
|
2026年4月重构记录:
|
||||||
|
原根目录下的三份千行提示词:
|
||||||
|
- \疑问解答老师.md\
|
||||||
|
- \数据评价老师.md\
|
||||||
|
- \声速测量实验答题评估老师.md\
|
||||||
|
现已移动至 \rchive/\ 目录进行归档,未来将彻底删除。当前所有业务逻辑均由拆分后的 \personas\ 和 \ asks\ 目录承载。
|
||||||
296
Web应用集成指南.md
296
Web应用集成指南.md
@ -1,86 +1,86 @@
|
|||||||
# 声速测量实验预习问答系统 - Web集成指南
|
# 澹伴€熸祴閲忓疄楠岄涔犻棶绛旂郴缁?- Web闆嗘垚鎸囧崡
|
||||||
|
|
||||||
## 概述
|
## 姒傝堪
|
||||||
|
|
||||||
这份文档为开发人员提供了如何将"预习问答老师"提示词集成到Web应用或云函数的具体指导。
|
杩欎唤鏂囨。涓哄紑鍙戜汉鍛樻彁渚涗簡濡備綍灏?棰勪範闂瓟鑰佸笀"鎻愮ず璇嶉泦鎴愬埌Web搴旂敤鎴栦簯鍑芥暟鐨勫叿浣撴寚瀵笺€?
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 一、云函数端实现(后端)
|
## 涓€銆佷簯鍑芥暟绔疄鐜帮紙鍚庣锛?
|
||||||
|
|
||||||
### 1.1 函数签名与输入处理
|
### 1.1 鍑芥暟绛惧悕涓庤緭鍏ュ鐞?
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
// CloudBase 云函数示例 (Node.js)
|
// CloudBase 浜戝嚱鏁扮ず渚?(Node.js)
|
||||||
const cloud = require('@cloudbase/node-sdk');
|
const cloud = require('@cloudbase/node-sdk');
|
||||||
|
|
||||||
// 初始化
|
// 鍒濆鍖?
|
||||||
const app = cloud.init({
|
const app = cloud.init({
|
||||||
env: 'your-env-id'
|
env: 'your-env-id'
|
||||||
});
|
});
|
||||||
|
|
||||||
// 预习问答云函数
|
// 棰勪範闂瓟浜戝嚱鏁?
|
||||||
exports.soundSpeedQAHandler = async (event, context) => {
|
exports.soundSpeedQAHandler = async (event, context) => {
|
||||||
try {
|
try {
|
||||||
const { studentQuestion, conversationHistory = [] } = event;
|
const { studentQuestion, conversationHistory = [] } = event;
|
||||||
|
|
||||||
// 验证输入
|
// 楠岃瘉杈撳叆
|
||||||
if (!studentQuestion || typeof studentQuestion !== 'string') {
|
if (!studentQuestion || typeof studentQuestion !== 'string') {
|
||||||
return {
|
return {
|
||||||
code: 400,
|
code: 400,
|
||||||
message: '问题不能为空',
|
message: '闂涓嶈兘涓虹┖',
|
||||||
data: null
|
data: null
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
// 调用AI模型生成回答
|
// 璋冪敤AI妯″瀷鐢熸垚鍥炵瓟
|
||||||
const response = await generateTeacherResponse(
|
const response = await generateTeacherResponse(
|
||||||
studentQuestion,
|
studentQuestion,
|
||||||
conversationHistory
|
conversationHistory
|
||||||
);
|
);
|
||||||
|
|
||||||
// 返回结构化响应
|
// 杩斿洖缁撴瀯鍖栧搷搴?
|
||||||
return {
|
return {
|
||||||
code: 200,
|
code: 200,
|
||||||
message: '成功',
|
message: '鎴愬姛',
|
||||||
data: response
|
data: response
|
||||||
};
|
};
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('QA处理错误:', error);
|
console.error('QA澶勭悊閿欒:', error);
|
||||||
return {
|
return {
|
||||||
code: 500,
|
code: 500,
|
||||||
message: '服务异常',
|
message: '鏈嶅姟寮傚父',
|
||||||
error: error.message
|
error: error.message
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
// 核心AI调用函数
|
// 鏍稿績AI璋冪敤鍑芥暟
|
||||||
async function generateTeacherResponse(question, history) {
|
async function generateTeacherResponse(question, history) {
|
||||||
const ai = await app.ai.getAI();
|
const ai = await app.ai.getAI();
|
||||||
|
|
||||||
// 构建系统提示词(使用前面的完整提示词)
|
// 鏋勫缓绯荤粺鎻愮ず璇嶏紙浣跨敤鍓嶉潰鐨勫畬鏁存彁绀鸿瘝锛?
|
||||||
const systemPrompt = `你是声速测量实验预习问答老师...[这里粘贴完整的提示词]`;
|
const systemPrompt = `浣犳槸澹伴€熸祴閲忓疄楠岄涔犻棶绛旇€佸笀...[杩欓噷绮樿创瀹屾暣鐨勬彁绀鸿瘝]`;
|
||||||
|
|
||||||
// 构建对话历史上下文
|
// 鏋勫缓瀵硅瘽鍘嗗彶涓婁笅鏂?
|
||||||
const messages = [
|
const messages = [
|
||||||
{ role: 'system', content: systemPrompt },
|
{ role: 'system', content: systemPrompt },
|
||||||
...history.map(msg => ({
|
...history.map(msg => ({
|
||||||
role: msg.role, // 'user' 或 'assistant'
|
role: msg.role, // 'user' 鎴?'assistant'
|
||||||
content: msg.content
|
content: msg.content
|
||||||
})),
|
})),
|
||||||
{ role: 'user', content: question }
|
{ role: 'user', content: question }
|
||||||
];
|
];
|
||||||
|
|
||||||
// 调用模型
|
// 璋冪敤妯″瀷
|
||||||
const result = await ai.generateText({
|
const result = await ai.generateText({
|
||||||
model: 'hunyuan-2.0-instruct-20251111', // 推荐的模型
|
model: 'hunyuan-2.0-instruct-20251111', // 鎺ㄨ崘鐨勬ā鍨?
|
||||||
messages: messages,
|
messages: messages,
|
||||||
temperature: 0.7, // 适度的创意度
|
temperature: 0.7, // 閫傚害鐨勫垱鎰忓害
|
||||||
maxTokens: 2000
|
maxTokens: 2000
|
||||||
});
|
});
|
||||||
|
|
||||||
// 结构化输出
|
// 缁撴瀯鍖栬緭鍑?
|
||||||
return {
|
return {
|
||||||
answer: result.text,
|
answer: result.text,
|
||||||
questionCategory: detectCategory(question),
|
questionCategory: detectCategory(question),
|
||||||
@ -89,11 +89,11 @@ async function generateTeacherResponse(question, history) {
|
|||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
// 问题分类函数
|
// 闂鍒嗙被鍑芥暟
|
||||||
function detectCategory(question) {
|
function detectCategory(question) {
|
||||||
const conceptKeywords = ['怎样理解', '为什么', '什么是', '原理', '关系'];
|
const conceptKeywords = ['鎬庢牱鐞嗚В', '涓轰粈涔?, '浠€涔堟槸', '鍘熺悊', '鍏崇郴'];
|
||||||
const operationKeywords = ['怎么操作', '如何进行', '步骤', '调节', '测量方法'];
|
const operationKeywords = ['鎬庝箞鎿嶄綔', '濡備綍杩涜', '姝ラ', '璋冭妭', '娴嬮噺鏂规硶'];
|
||||||
const calculationKeywords = ['怎么计算', '公式', '数据', '单位', '结果'];
|
const calculationKeywords = ['鎬庝箞璁$畻', '鍏紡', '鏁版嵁', '鍗曚綅', '缁撴灉'];
|
||||||
|
|
||||||
if (conceptKeywords.some(kw => question.includes(kw))) {
|
if (conceptKeywords.some(kw => question.includes(kw))) {
|
||||||
return 'concept';
|
return 'concept';
|
||||||
@ -105,23 +105,23 @@ function detectCategory(question) {
|
|||||||
return 'mixed';
|
return 'mixed';
|
||||||
}
|
}
|
||||||
|
|
||||||
// 生成后续提示
|
// 鐢熸垚鍚庣画鎻愮ず
|
||||||
function generateFollowUp(question) {
|
function generateFollowUp(question) {
|
||||||
return "这个解释清楚了吗?还有其他疑问吗?或者你想深入了解某个知识点?";
|
return "杩欎釜瑙i噴娓呮浜嗗悧锛熻繕鏈夊叾浠栫枒闂悧锛熸垨鑰呬綘鎯虫繁鍏ヤ簡瑙f煇涓煡璇嗙偣锛?;
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1.2 流式回答支持
|
### 1.2 娴佸紡鍥炵瓟鏀寔
|
||||||
|
|
||||||
对于较长的回答,建议使用流式(streaming)模式,提升用户体验:
|
瀵逛簬杈冮暱鐨勫洖绛旓紝寤鸿浣跨敤娴佸紡(streaming)妯″紡锛屾彁鍗囩敤鎴蜂綋楠岋細
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
// 流式回答处理
|
// 娴佸紡鍥炵瓟澶勭悊
|
||||||
exports.soundSpeedQAStreaming = async (event, context) => {
|
exports.soundSpeedQAStreaming = async (event, context) => {
|
||||||
const { studentQuestion, conversationHistory = [] } = event;
|
const { studentQuestion, conversationHistory = [] } = event;
|
||||||
|
|
||||||
const ai = await app.ai.getAI();
|
const ai = await app.ai.getAI();
|
||||||
const systemPrompt = `你是声速测量实验预习问答老师...`;
|
const systemPrompt = `浣犳槸澹伴€熸祴閲忓疄楠岄涔犻棶绛旇€佸笀...`;
|
||||||
|
|
||||||
const messages = [
|
const messages = [
|
||||||
{ role: 'system', content: systemPrompt },
|
{ role: 'system', content: systemPrompt },
|
||||||
@ -129,30 +129,30 @@ exports.soundSpeedQAStreaming = async (event, context) => {
|
|||||||
{ role: 'user', content: studentQuestion }
|
{ role: 'user', content: studentQuestion }
|
||||||
];
|
];
|
||||||
|
|
||||||
// 设置流式处理的响应头
|
// 璁剧疆娴佸紡澶勭悊鐨勫搷搴斿ご
|
||||||
context.headers = {
|
context.headers = {
|
||||||
'Content-Type': 'text/event-stream',
|
'Content-Type': 'text/event-stream',
|
||||||
'Cache-Control': 'no-cache'
|
'Cache-Control': 'no-cache'
|
||||||
};
|
};
|
||||||
|
|
||||||
// 流式调用
|
// 娴佸紡璋冪敤
|
||||||
const stream = await ai.streamText({
|
const stream = await ai.streamText({
|
||||||
model: 'hunyuan-2.0-instruct-20251111',
|
model: 'hunyuan-2.0-instruct-20251111',
|
||||||
messages: messages,
|
messages: messages,
|
||||||
temperature: 0.7
|
temperature: 0.7
|
||||||
});
|
});
|
||||||
|
|
||||||
// 逐段发送客户端
|
// 閫愭鍙戦€佸鎴风
|
||||||
for await (const chunk of stream) {
|
for await (const chunk of stream) {
|
||||||
context.sendChunk(chunk.text);
|
context.sendChunk(chunk.text);
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1.3 对话历史管理
|
### 1.3 瀵硅瘽鍘嗗彶绠$悊
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
// 对话记录数据库操作
|
// 瀵硅瘽璁板綍鏁版嵁搴撴搷浣?
|
||||||
async function saveConversation(studentId, questions, answers) {
|
async function saveConversation(studentId, questions, answers) {
|
||||||
const db = app.database();
|
const db = app.database();
|
||||||
|
|
||||||
@ -170,7 +170,7 @@ async function saveConversation(studentId, questions, answers) {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
// 获取用户的历史记录(用于上下文)
|
// 鑾峰彇鐢ㄦ埛鐨勫巻鍙茶褰曪紙鐢ㄤ簬涓婁笅鏂囷級
|
||||||
async function getConversationHistory(studentId, limit = 5) {
|
async function getConversationHistory(studentId, limit = 5) {
|
||||||
const db = app.database();
|
const db = app.database();
|
||||||
|
|
||||||
@ -182,7 +182,7 @@ async function getConversationHistory(studentId, limit = 5) {
|
|||||||
|
|
||||||
if (result.data.length === 0) return [];
|
if (result.data.length === 0) return [];
|
||||||
|
|
||||||
// 提取最近的对话记录
|
// 鎻愬彇鏈€杩戠殑瀵硅瘽璁板綍
|
||||||
const messages = result.data[0].messages || [];
|
const messages = result.data[0].messages || [];
|
||||||
return messages.slice(-limit).map(msg => ({
|
return messages.slice(-limit).map(msg => ({
|
||||||
role: msg.type === 'q_a_pair' ? 'user' : 'assistant',
|
role: msg.type === 'q_a_pair' ? 'user' : 'assistant',
|
||||||
@ -193,29 +193,29 @@ async function getConversationHistory(studentId, limit = 5) {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 二、Web前端实现(React示例)
|
## 浜屻€乄eb鍓嶇瀹炵幇锛圧eact绀轰緥锛?
|
||||||
|
|
||||||
### 2.1 对话组件
|
### 2.1 瀵硅瘽缁勪欢
|
||||||
|
|
||||||
```jsx
|
```jsx
|
||||||
import React, { useState, useRef, useEffect } from 'react';
|
import React, { useState, useRef, useEffect } from 'react';
|
||||||
import cloud from '@cloudbase/js-sdk';
|
import cloud from '@cloudbase/js-sdk';
|
||||||
|
|
||||||
export function SoundSpeedQA() {
|
export function SoundSpeedQA() {
|
||||||
const [messages, setMessages] = useState([]); // 对话历史
|
const [messages, setMessages] = useState([]); // 瀵硅瘽鍘嗗彶
|
||||||
const [input, setInput] = useState(''); // 输入框内容
|
const [input, setInput] = useState(''); // 杈撳叆妗嗗唴瀹?
|
||||||
const [loading, setLoading] = useState(false);
|
const [loading, setLoading] = useState(false);
|
||||||
const [questionCategory, setQuestionCategory] = useState(null);
|
const [questionCategory, setQuestionCategory] = useState(null);
|
||||||
const messagesEndRef = useRef(null);
|
const messagesEndRef = useRef(null);
|
||||||
|
|
||||||
// 初始化CloudBase
|
// 鍒濆鍖朇loudBase
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
cloud.init({
|
cloud.init({
|
||||||
env: 'your-env-id'
|
env: 'your-env-id'
|
||||||
});
|
});
|
||||||
}, []);
|
}, []);
|
||||||
|
|
||||||
// 自动滚动到底部
|
// 鑷姩婊氬姩鍒板簳閮?
|
||||||
const scrollToBottom = () => {
|
const scrollToBottom = () => {
|
||||||
messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
|
messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
|
||||||
};
|
};
|
||||||
@ -224,19 +224,19 @@ export function SoundSpeedQA() {
|
|||||||
scrollToBottom();
|
scrollToBottom();
|
||||||
}, [messages]);
|
}, [messages]);
|
||||||
|
|
||||||
// 提交问题
|
// 鎻愪氦闂
|
||||||
const handleSubmit = async (e) => {
|
const handleSubmit = async (e) => {
|
||||||
e.preventDefault();
|
e.preventDefault();
|
||||||
if (!input.trim()) return;
|
if (!input.trim()) return;
|
||||||
|
|
||||||
// 添加用户消息到对话历史
|
// 娣诲姞鐢ㄦ埛娑堟伅鍒板璇濆巻鍙?
|
||||||
const userMessage = { role: 'user', content: input };
|
const userMessage = { role: 'user', content: input };
|
||||||
setMessages(prev => [...prev, userMessage]);
|
setMessages(prev => [...prev, userMessage]);
|
||||||
setInput('');
|
setInput('');
|
||||||
setLoading(true);
|
setLoading(true);
|
||||||
|
|
||||||
try {
|
try {
|
||||||
// 调用云函数
|
// 璋冪敤浜戝嚱鏁?
|
||||||
const response = await cloud.callFunction({
|
const response = await cloud.callFunction({
|
||||||
name: 'soundSpeedQAHandler',
|
name: 'soundSpeedQAHandler',
|
||||||
data: {
|
data: {
|
||||||
@ -248,7 +248,7 @@ export function SoundSpeedQA() {
|
|||||||
if (response.result.code === 200) {
|
if (response.result.code === 200) {
|
||||||
const { answer, questionCategory: category } = response.result.data;
|
const { answer, questionCategory: category } = response.result.data;
|
||||||
|
|
||||||
// 添加助手回应
|
// 娣诲姞鍔╂墜鍥炲簲
|
||||||
setMessages(prev => [...prev, {
|
setMessages(prev => [...prev, {
|
||||||
role: 'assistant',
|
role: 'assistant',
|
||||||
content: answer,
|
content: answer,
|
||||||
@ -257,18 +257,18 @@ export function SoundSpeedQA() {
|
|||||||
|
|
||||||
setQuestionCategory(category);
|
setQuestionCategory(category);
|
||||||
} else {
|
} else {
|
||||||
// 错误处理
|
// 閿欒澶勭悊
|
||||||
setMessages(prev => [...prev, {
|
setMessages(prev => [...prev, {
|
||||||
role: 'assistant',
|
role: 'assistant',
|
||||||
content: '抱歉,服务暂时有问题。请稍后再试。',
|
content: '鎶辨瓑锛屾湇鍔℃殏鏃舵湁闂銆傝绋嶅悗鍐嶈瘯銆?,
|
||||||
isError: true
|
isError: true
|
||||||
}]);
|
}]);
|
||||||
}
|
}
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
console.error('调用失败:', error);
|
console.error('璋冪敤澶辫触:', error);
|
||||||
setMessages(prev => [...prev, {
|
setMessages(prev => [...prev, {
|
||||||
role: 'assistant',
|
role: 'assistant',
|
||||||
content: '网络连接失败,请检查后重试。',
|
content: '缃戠粶杩炴帴澶辫触锛岃妫€鏌ュ悗閲嶈瘯銆?,
|
||||||
isError: true
|
isError: true
|
||||||
}]);
|
}]);
|
||||||
} finally {
|
} finally {
|
||||||
@ -279,29 +279,29 @@ export function SoundSpeedQA() {
|
|||||||
return (
|
return (
|
||||||
<div className="qa-container">
|
<div className="qa-container">
|
||||||
<div className="qa-header">
|
<div className="qa-header">
|
||||||
<h2>声速测量实验预习问答</h2>
|
<h2>澹伴€熸祴閲忓疄楠岄涔犻棶绛?/h2>
|
||||||
<p>有任何疑问?问我吧!我是你的物理老师。</p>
|
<p>鏈変换浣曠枒闂紵闂垜鍚э紒鎴戞槸浣犵殑鐗╃悊鑰佸笀銆?/p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* 对话历史展示 */}
|
{/* 瀵硅瘽鍘嗗彶灞曠ず */}
|
||||||
<div className="qa-messages">
|
<div className="qa-messages">
|
||||||
{messages.map((msg, index) => (
|
{messages.map((msg, index) => (
|
||||||
<div key={index} className={`message ${msg.role}`}>
|
<div key={index} className={`message ${msg.role}`}>
|
||||||
<div className="message-avatar">
|
<div className="message-avatar">
|
||||||
{msg.role === 'user' ? '👨🎓' : '👨🏫'}
|
{msg.role === 'user' ? '馃懆鈥嶐煄? : '馃懆鈥嶐煆?}
|
||||||
</div>
|
</div>
|
||||||
<div className="message-content">
|
<div className="message-content">
|
||||||
{msg.role === 'assistant' && msg.category && (
|
{msg.role === 'assistant' && msg.category && (
|
||||||
<span className="category-badge">{msg.category}</span>
|
<span className="category-badge">{msg.category}</span>
|
||||||
)}
|
)}
|
||||||
{msg.content}
|
{msg.content}
|
||||||
{msg.isError && <span className="error-icon">⚠️</span>}
|
{msg.isError && <span className="error-icon">鈿狅笍</span>}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
))}
|
))}
|
||||||
{loading && (
|
{loading && (
|
||||||
<div className="message assistant">
|
<div className="message assistant">
|
||||||
<div className="message-avatar">👨🏫</div>
|
<div className="message-avatar">馃懆鈥嶐煆?/div>
|
||||||
<div className="message-content">
|
<div className="message-content">
|
||||||
<div className="typing-indicator">
|
<div className="typing-indicator">
|
||||||
<span></span><span></span><span></span>
|
<span></span><span></span><span></span>
|
||||||
@ -312,30 +312,30 @@ export function SoundSpeedQA() {
|
|||||||
<div ref={messagesEndRef} />
|
<div ref={messagesEndRef} />
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* 输入框 */}
|
{/* 杈撳叆妗?*/}
|
||||||
<form onSubmit={handleSubmit} className="qa-form">
|
<form onSubmit={handleSubmit} className="qa-form">
|
||||||
<textarea
|
<textarea
|
||||||
value={input}
|
value={input}
|
||||||
onChange={(e) => setInput(e.target.value)}
|
onChange={(e) => setInput(e.target.value)}
|
||||||
placeholder="请输入你的预习问题(例如:为什么需要多次测量?)"
|
placeholder="璇疯緭鍏ヤ綘鐨勯涔犻棶棰橈紙渚嬪锛氫负浠€涔堥渶瑕佸娆℃祴閲忥紵锛?
|
||||||
disabled={loading}
|
disabled={loading}
|
||||||
rows="3"
|
rows="3"
|
||||||
/>
|
/>
|
||||||
<button type="submit" disabled={loading || !input.trim()}>
|
<button type="submit" disabled={loading || !input.trim()}>
|
||||||
{loading ? '思考中...' : '提问'}
|
{loading ? '鎬濊€冧腑...' : '鎻愰棶'}
|
||||||
</button>
|
</button>
|
||||||
</form>
|
</form>
|
||||||
|
|
||||||
{/* 提示 */}
|
{/* 鎻愮ず */}
|
||||||
<div className="qa-tips">
|
<div className="qa-tips">
|
||||||
<p>💡 提示:你可以问关于<strong>原理</strong>、<strong>操作</strong>、<strong>计算</strong>方面的问题</p>
|
<p>馃挕 鎻愮ず锛氫綘鍙互闂叧浜?strong>鍘熺悊</strong>銆?strong>鎿嶄綔</strong>銆?strong>璁$畻</strong>鏂归潰鐨勯棶棰?/p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 2.2 样式
|
### 2.2 鏍峰紡
|
||||||
|
|
||||||
```css
|
```css
|
||||||
.qa-container {
|
.qa-container {
|
||||||
@ -533,133 +533,133 @@ export function SoundSpeedQA() {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 三、系统提示词的集成方式
|
## 涓夈€佺郴缁熸彁绀鸿瘝鐨勯泦鎴愭柟寮?
|
||||||
|
|
||||||
### 3.1 完整系统提示词(粘贴到云函数)
|
### 3.1 瀹屾暣绯荤粺鎻愮ず璇嶏紙绮樿创鍒颁簯鍑芥暟锛?
|
||||||
|
|
||||||
在上面的 `generateTeacherResponse` 函数中,将以下内容替换 `systemPrompt`:
|
鍦ㄤ笂闈㈢殑 `generateTeacherResponse` 鍑芥暟涓紝灏嗕互涓嬪唴瀹规浛鎹?`systemPrompt`锛?
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const systemPrompt = `
|
const systemPrompt = `
|
||||||
[这里粘贴 疑问解答老师.md 中的完整提示词内容]
|
[杩欓噷绮樿创 鐤戦棶瑙g瓟鑰佸笀.md 涓殑瀹屾暣鎻愮ず璇嶅唴瀹筣
|
||||||
|
|
||||||
重要补充(运行时指令):
|
閲嶈琛ュ厖锛堣繍琛屾椂鎸囦护锛夛細
|
||||||
1. 当前对话学生问题中的关键词是:""
|
1. 褰撳墠瀵硅瘽瀛︾敓闂涓殑鍏抽敭璇嶆槸锛?"
|
||||||
2. 当前识别的问题类别是:""(由系统自动填入)
|
2. 褰撳墠璇嗗埆鐨勯棶棰樼被鍒槸锛?"锛堢敱绯荤粺鑷姩濉叆锛?
|
||||||
3. 回答时注意:不要输出JSON,直接使用markdown格式进行回答
|
3. 鍥炵瓟鏃舵敞鎰忥細涓嶈杈撳嚭JSON锛岀洿鎺ヤ娇鐢╩arkdown鏍煎紡杩涜鍥炵瓟
|
||||||
4. 如果问题超出声速测量实验范围,客气地说明:"这个问题超出了我的专长范围。我专门教声速测量实验。你还有其他与这个实验相关的疑问吗?"
|
4. 濡傛灉闂瓒呭嚭澹伴€熸祴閲忓疄楠岃寖鍥达紝瀹㈡皵鍦拌鏄庯細"杩欎釜闂瓒呭嚭浜嗘垜鐨勪笓闀胯寖鍥淬€傛垜涓撻棬鏁欏0閫熸祴閲忓疄楠屻€備綘杩樻湁鍏朵粬涓庤繖涓疄楠岀浉鍏崇殑鐤戦棶鍚楋紵"
|
||||||
`;
|
`;
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3.2 动态系统提示词(高级用法)
|
### 3.2 鍔ㄦ€佺郴缁熸彁绀鸿瘝锛堥珮绾х敤娉曪級
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
function buildSystemPrompt(category, studentLevel = 'freshman') {
|
function buildSystemPrompt(category, studentLevel = 'freshman') {
|
||||||
const basePrompt = `[完整提示词内容...]`;
|
const basePrompt = `[瀹屾暣鎻愮ず璇嶅唴瀹?..]`;
|
||||||
|
|
||||||
// 根据问题类别调整指导
|
// 鏍规嵁闂绫诲埆璋冩暣鎸囧
|
||||||
const categoryGuidance = {
|
const categoryGuidance = {
|
||||||
concept: '学生问的是概念类问题。请从现象出发,逐步深入原理。优先使用物理图像而非公式。',
|
concept: '瀛︾敓闂殑鏄蹇电被闂銆傝浠庣幇璞″嚭鍙戯紝閫愭娣卞叆鍘熺悊銆備紭鍏堜娇鐢ㄧ墿鐞嗗浘鍍忚€岄潪鍏紡銆?,
|
||||||
operation: '学生问的是操作类问题。请明确列出步骤,每步说清为什么这样做。给出常见错误提醒。',
|
operation: '瀛︾敓闂殑鏄搷浣滅被闂銆傝鏄庣‘鍒楀嚭姝ラ锛屾瘡姝ヨ娓呬负浠€涔堣繖鏍峰仛銆傜粰鍑哄父瑙侀敊璇彁閱掋€?,
|
||||||
calculation: '学生问的是计算类问题。请给出推导过程而不仅仅是答案。确保学生理解每个公式。'
|
calculation: '瀛︾敓闂殑鏄绠楃被闂銆傝缁欏嚭鎺ㄥ杩囩▼鑰屼笉浠呬粎鏄瓟妗堛€傜‘淇濆鐢熺悊瑙f瘡涓叕寮忋€?
|
||||||
};
|
};
|
||||||
|
|
||||||
// 根据学年调整难度
|
// 鏍规嵁瀛﹀勾璋冩暣闅惧害
|
||||||
const levelGuidance = {
|
const levelGuidance = {
|
||||||
freshman: '这是大一学生。保持讲解通俗易懂,避免过度复杂的数学。',
|
freshman: '杩欐槸澶т竴瀛︾敓銆備繚鎸佽瑙i€氫織鏄撴噦锛岄伩鍏嶈繃搴﹀鏉傜殑鏁板銆?,
|
||||||
sophomore: '这是大二学生。可以涉及更深入的物理概念和数学推导。'
|
sophomore: '杩欐槸澶т簩瀛︾敓銆傚彲浠ユ秹鍙婃洿娣卞叆鐨勭墿鐞嗘蹇靛拰鏁板鎺ㄥ銆?
|
||||||
};
|
};
|
||||||
|
|
||||||
return `${basePrompt}\n\n## 当前对话指导\n${categoryGuidance[category] || ''}\n${levelGuidance[studentLevel]}`;
|
return `${basePrompt}\n\n## 褰撳墠瀵硅瘽鎸囧\n${categoryGuidance[category] || ''}\n${levelGuidance[studentLevel]}`;
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 四、部署检查清单
|
## 鍥涖€侀儴缃叉鏌ユ竻鍗?
|
||||||
|
|
||||||
### 前置准备
|
### 鍓嶇疆鍑嗗
|
||||||
- [ ] CloudBase环境已创建,获得 Environment ID
|
- [ ] CloudBase鐜宸插垱寤猴紝鑾峰緱 Environment ID
|
||||||
- [ ] Node.js 14+ 已安装
|
- [ ] Node.js 14+ 宸插畨瑁?
|
||||||
- [ ] CloudBase CLI 已安装:`npm install -g @cloudbase/cli`
|
- [ ] CloudBase CLI 宸插畨瑁咃細`npm install -g @cloudbase/cli`
|
||||||
|
|
||||||
### 云函数部署
|
### 浜戝嚱鏁伴儴缃?
|
||||||
```bash
|
```bash
|
||||||
# 1. 登录CloudBase
|
# 1. 鐧诲綍CloudBase
|
||||||
tcb login
|
tcb login
|
||||||
|
|
||||||
# 2. 创建函数项目结构
|
# 2. 鍒涘缓鍑芥暟椤圭洰缁撴瀯
|
||||||
mkdir cloudbase-functions
|
mkdir cloudbase-functions
|
||||||
cd cloudbase-functions
|
cd cloudbase-functions
|
||||||
mkdir soundSpeedQA
|
mkdir soundSpeedQA
|
||||||
cd soundSpeedQA
|
cd soundSpeedQA
|
||||||
|
|
||||||
# 3. 创建 package.json
|
# 3. 鍒涘缓 package.json
|
||||||
npm init -y
|
npm init -y
|
||||||
|
|
||||||
# 4. 安装依赖
|
# 4. 瀹夎渚濊禆
|
||||||
npm install @cloudbase/node-sdk
|
npm install @cloudbase/node-sdk
|
||||||
|
|
||||||
# 5. 复制上面的云函数代码到 index.js
|
# 5. 澶嶅埗涓婇潰鐨勪簯鍑芥暟浠g爜鍒?index.js
|
||||||
|
|
||||||
# 6. 部署函数
|
# 6. 閮ㄧ讲鍑芥暟
|
||||||
tcb functions:deploy soundSpeedQA --env your-env-id
|
tcb functions:deploy soundSpeedQA --env your-env-id
|
||||||
```
|
```
|
||||||
|
|
||||||
### 前端部署
|
### 鍓嶇閮ㄧ讲
|
||||||
```bash
|
```bash
|
||||||
# 1. 创建 React 应用
|
# 1. 鍒涘缓 React 搴旂敤
|
||||||
npx create-react-app sound-speed-qa
|
npx create-react-app sound-speed-qa
|
||||||
cd sound-speed-qa
|
cd sound-speed-qa
|
||||||
|
|
||||||
# 2. 安装 CloudBase SDK
|
# 2. 瀹夎 CloudBase SDK
|
||||||
npm install @cloudbase/js-sdk
|
npm install @cloudbase/js-sdk
|
||||||
|
|
||||||
# 3. 复制上面的 React 组件和样式到项目
|
# 3. 澶嶅埗涓婇潰鐨?React 缁勪欢鍜屾牱寮忓埌椤圭洰
|
||||||
|
|
||||||
# 4. 配置 Environment ID
|
# 4. 閰嶇疆 Environment ID
|
||||||
# 在组件中更新 cloud.init({ env: 'your-env-id' })
|
# 鍦ㄧ粍浠朵腑鏇存柊 cloud.init({ env: 'your-env-id' })
|
||||||
|
|
||||||
# 5. 部署到 CloudBase 云托管
|
# 5. 閮ㄧ讲鍒?CloudBase 浜戞墭绠?
|
||||||
npm run build
|
npm run build
|
||||||
tcb hosting:deploy build --env your-env-id
|
tcb hosting:deploy build --env your-env-id
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 五、常见问题与排查
|
## 浜斻€佸父瑙侀棶棰樹笌鎺掓煡
|
||||||
|
|
||||||
### Q1: 函数调用超时
|
### Q1: 鍑芥暟璋冪敤瓒呮椂
|
||||||
**A**:
|
**A**:
|
||||||
- 检查模型响应时间。使用流式处理(streamText)减少等待感
|
- 妫€鏌ユā鍨嬪搷搴旀椂闂淬€備娇鐢ㄦ祦寮忓鐞嗭紙streamText锛夊噺灏戠瓑寰呮劅
|
||||||
- 增加云函数超时时间:在云函数配置中设置为 30+ 秒
|
- 澧炲姞浜戝嚱鏁拌秴鏃舵椂闂达細鍦ㄤ簯鍑芥暟閰嶇疆涓缃负 30+ 绉?
|
||||||
|
|
||||||
### Q2: 提示词似乎没有生效
|
### Q2: 鎻愮ず璇嶄技涔庢病鏈夌敓鏁?
|
||||||
**A**:
|
**A**:
|
||||||
- 确保系统提示词的标点、换行符完全正确
|
- 纭繚绯荤粺鎻愮ず璇嶇殑鏍囩偣銆佹崲琛岀瀹屽叏姝g‘
|
||||||
- 在云函数日志中查看实际发送的提示词内容
|
- 鍦ㄤ簯鍑芥暟鏃ュ織涓煡鐪嬪疄闄呭彂閫佺殑鎻愮ず璇嶅唴瀹?
|
||||||
- 使用简化版提示词测试,逐步添加内容
|
- 浣跨敤绠€鍖栫増鎻愮ず璇嶆祴璇曪紝閫愭娣诲姞鍐呭
|
||||||
|
|
||||||
### Q3: UI 布局在移动设备上破损
|
### Q3: UI 甯冨眬鍦ㄧЩ鍔ㄨ澶囦笂鐮存崯
|
||||||
**A**:
|
**A**:
|
||||||
- 使用媒体查询调整 `.qa-container` 的宽度
|
- 浣跨敤濯掍綋鏌ヨ璋冩暣 `.qa-container` 鐨勫搴?
|
||||||
- 在移动设备上设置:`max-width: 100%; max-height: 100vh;`
|
- 鍦ㄧЩ鍔ㄨ澶囦笂璁剧疆锛歚max-width: 100%; max-height: 100vh;`
|
||||||
|
|
||||||
### Q4: 对话历史太长导致成本增加
|
### Q4: 瀵硅瘽鍘嗗彶澶暱瀵艰嚧鎴愭湰澧炲姞
|
||||||
**A**:
|
**A**:
|
||||||
- 在发送给模型前,只保留最近的 3-5 条对话(通过 `conversationHistory.slice(-3)` 实现)
|
- 鍦ㄥ彂閫佺粰妯″瀷鍓嶏紝鍙繚鐣欐渶杩戠殑 3-5 鏉″璇濓紙閫氳繃 `conversationHistory.slice(-3)` 瀹炵幇锛?
|
||||||
- 定期清理旧对话记录
|
- 瀹氭湡娓呯悊鏃у璇濊褰?
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 六、性能优化建议
|
## 鍏€佹€ц兘浼樺寲寤鸿
|
||||||
|
|
||||||
### 缓存热门问题
|
### 缂撳瓨鐑棬闂
|
||||||
```javascript
|
```javascript
|
||||||
const questionCache = {};
|
const questionCache = {};
|
||||||
|
|
||||||
async function getAnswerWithCache(question) {
|
async function getAnswerWithCache(question) {
|
||||||
// 生成问题的哈希作为缓存key
|
// 鐢熸垚闂鐨勫搱甯屼綔涓虹紦瀛榢ey
|
||||||
const key = hashQuestion(question);
|
const key = hashQuestion(question);
|
||||||
|
|
||||||
if (questionCache[key]) {
|
if (questionCache[key]) {
|
||||||
@ -673,8 +673,8 @@ async function getAnswerWithCache(question) {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 批量问题处理
|
### 鎵归噺闂澶勭悊
|
||||||
如果有多个学生同时提问,使用队列机制避免同时调用过多:
|
濡傛灉鏈夊涓鐢熷悓鏃舵彁闂紝浣跨敤闃熷垪鏈哄埗閬垮厤鍚屾椂璋冪敤杩囧锛?
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const queue = [];
|
const queue = [];
|
||||||
@ -699,16 +699,16 @@ async function processQuestionQueue() {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 七、扩展功能想法
|
## 涓冦€佹墿灞曞姛鑳芥兂娉?
|
||||||
|
|
||||||
### 7.1 智能题库生成
|
### 7.1 鏅鸿兘棰樺簱鐢熸垚
|
||||||
基于学生的提问历史,自动生成针对性的练习题:
|
鍩轰簬瀛︾敓鐨勬彁闂巻鍙诧紝鑷姩鐢熸垚閽堝鎬х殑缁冧範棰橈細
|
||||||
```javascript
|
```javascript
|
||||||
async function generatePracticeTasks(studentId) {
|
async function generatePracticeTasks(studentId) {
|
||||||
const history = await getConversationHistory(studentId);
|
const history = await getConversationHistory(studentId);
|
||||||
const wakePoints = identifyWeakPoints(history);
|
const wakePoints = identifyWeakPoints(history);
|
||||||
|
|
||||||
// 调用另一个云函数生成题目
|
// 璋冪敤鍙︿竴涓簯鍑芥暟鐢熸垚棰樼洰
|
||||||
const tasks = await cloud.callFunction({
|
const tasks = await cloud.callFunction({
|
||||||
name: 'generatePracticeTasks',
|
name: 'generatePracticeTasks',
|
||||||
data: { weakPoints }
|
data: { weakPoints }
|
||||||
@ -718,29 +718,29 @@ async function generatePracticeTasks(studentId) {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 7.2 学生学习仪表板
|
### 7.2 瀛︾敓瀛︿範浠〃鏉?
|
||||||
展示每个学生的学习进度:
|
灞曠ず姣忎釜瀛︾敓鐨勫涔犺繘搴︼細
|
||||||
- 已掌握的知识点
|
- 宸叉帉鎻$殑鐭ヨ瘑鐐?
|
||||||
- 还需加强的方面
|
- 杩橀渶鍔犲己鐨勬柟闈?
|
||||||
- 预习完成度
|
- 棰勪範瀹屾垚搴?
|
||||||
- 常见错误统计
|
- 甯歌閿欒缁熻
|
||||||
|
|
||||||
### 7.3 教师后台管理
|
### 7.3 鏁欏笀鍚庡彴绠$悊
|
||||||
让老师能够:
|
璁╄€佸笀鑳藉锛?
|
||||||
- 查看学生的提问和系统回答
|
- 鏌ョ湅瀛︾敓鐨勬彁闂拰绯荤粺鍥炵瓟
|
||||||
- 编辑/纠正系统的某些回答
|
- 缂栬緫/绾犳绯荤粺鐨勬煇浜涘洖绛?
|
||||||
- 查看质量不佳的回答并改进提示词
|
- 鏌ョ湅璐ㄩ噺涓嶄匠鐨勫洖绛斿苟鏀硅繘鎻愮ず璇?
|
||||||
- 导出学生学习数据
|
- 瀵煎嚭瀛︾敓瀛︿範鏁版嵁
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 总结
|
## 鎬荤粨
|
||||||
|
|
||||||
这个完整的实现包括:
|
杩欎釜瀹屾暣鐨勫疄鐜板寘鎷細
|
||||||
✅ 云函数后端(AI调用、对话管理)
|
鉁?浜戝嚱鏁板悗绔紙AI璋冪敤銆佸璇濈鐞嗭級
|
||||||
✅ React前端组件(可视化交互)
|
鉁?React鍓嶇缁勪欢锛堝彲瑙嗗寲浜や簰锛?
|
||||||
✅ 提示词集成(教学逻辑)
|
鉁?鎻愮ず璇嶉泦鎴愶紙鏁欏閫昏緫锛?
|
||||||
✅ 数据持久化(对话保存)
|
鉁?鏁版嵁鎸佷箙鍖栵紙瀵硅瘽淇濆瓨锛?
|
||||||
✅ 部署指南(上线步骤)
|
鉁?閮ㄧ讲鎸囧崡锛堜笂绾挎楠わ級
|
||||||
|
|
||||||
祝实现顺利!如有问题,可参考CloudBase官方文档或联系技术支持。
|
绁濆疄鐜伴『鍒╋紒濡傛湁闂锛屽彲鍙傝€僀loudBase瀹樻柟鏂囨。鎴栬仈绯绘妧鏈敮鎸併€?
|
||||||
|
|||||||
351
项目总览与使用指南.md
351
项目总览与使用指南.md
@ -1,351 +0,0 @@
|
|||||||
# 声速测量实验预习问答系统 - 项目总览
|
|
||||||
|
|
||||||
## 项目简介
|
|
||||||
|
|
||||||
这是一套完整的**大学物理实验预习指导系统**,专门针对"声速测量实验"的学生预习阶段。
|
|
||||||
|
|
||||||
**核心目标**:帮助学生在正式实验前,通过AI助手解答预习中的各类疑问,建立坚实的理论基础和操作认知。
|
|
||||||
|
|
||||||
**应用场景**:
|
|
||||||
- ✅ 学生预习时的个性化问答平台
|
|
||||||
- ✅ 集成到在线学习系统的课程支持模块
|
|
||||||
- ✅ 教师准备答疑内容的参考资料库
|
|
||||||
- ✅ 独立的聊天机器人应用
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📁 项目文件结构与用途
|
|
||||||
|
|
||||||
### 1. **疑问解答老师.md** ⭐ 核心提示词
|
|
||||||
**内容**:完整的AI系统提示词,涵盖角色定义、教学方法、知识体系、交互流程
|
|
||||||
|
|
||||||
**适合对象**:
|
|
||||||
- ✨ 直接集成到ChatGPT、Claude等大模型平台使用
|
|
||||||
- ✨ 作为云函数的系统提示词
|
|
||||||
- ✨ 教师understand实验教学的完整框架
|
|
||||||
|
|
||||||
**关键章节**:
|
|
||||||
- 📚 支持的问题类型(概念/操作/计算/混合)
|
|
||||||
- 🎓 核心知识体系与公式
|
|
||||||
- 🗣️ 交互流程与教学策略
|
|
||||||
- 📊 学生预习学习路径
|
|
||||||
|
|
||||||
**使用步骤**:
|
|
||||||
```
|
|
||||||
1. 打开 ChatGPT/Claude
|
|
||||||
2. 在系统提示词(System prompt)框中粘贴此文件全文
|
|
||||||
3. 在对话框问题,系统将按教学设计回答
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 2. **Web应用集成指南.md** 💻 开发实现手册
|
|
||||||
**内容**:完整的技术实现指南,包含后端和前端代码
|
|
||||||
|
|
||||||
**适合对象**:
|
|
||||||
- 💻 Web开发人员(React/Node.js开发者)
|
|
||||||
- 🔧 想要部署自己的完整系统的团队
|
|
||||||
- 📱 需要集成到在线学习平台的技术负责人
|
|
||||||
|
|
||||||
**核心内容**:
|
|
||||||
- ☁️ CloudBase云函数实现(Node.js)
|
|
||||||
- ⚛️ React前端交互组件与样式
|
|
||||||
- 🔌 AI模型集成与流式处理
|
|
||||||
- 📦 部署步骤与检查清单
|
|
||||||
- 🐛 常见问题排查
|
|
||||||
- ⚡ 性能优化建议
|
|
||||||
- 🚀 扩展功能想法
|
|
||||||
|
|
||||||
**使用流程**:
|
|
||||||
```
|
|
||||||
1. 复制"云函数端实现"代码到你的CloudBase环境
|
|
||||||
2. 复制"React组件"代码到前端项目
|
|
||||||
3. 配置Environment ID
|
|
||||||
4. 按"部署检查清单"逐步部署
|
|
||||||
5. 测试验证
|
|
||||||
```
|
|
||||||
|
|
||||||
**推荐的部署方案**:
|
|
||||||
- **后端**:CloudBase云函数 或 自建Node.js服务
|
|
||||||
- **前端**:React + CloudBase SDK(Web应用)
|
|
||||||
- **模型**:Hunyuan 2.0 / DeepSeek V3
|
|
||||||
- **存储**:CloudBase数据库(对话记录)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 3. **示例对话与快速参考.md** 📖 教学示例与参考资料
|
|
||||||
**内容**:4个详细的示例对话 + 快速参考表
|
|
||||||
|
|
||||||
**适合对象**:
|
|
||||||
- 🎓 学生快速了解系统能做什么
|
|
||||||
- 👨🏫 教师借鉴教学示例的讲解方式
|
|
||||||
- 🔍 开发人员理解系统的输出风格
|
|
||||||
|
|
||||||
**示例覆盖**:
|
|
||||||
1. **概念问题示例**:频率与波长的关系(详细推导)
|
|
||||||
2. **操作问题示例**:如何准确找共鸣点(实操指导)
|
|
||||||
3. **计算问题示例**:温度修正的应用(计算步骤)
|
|
||||||
4. **混合问题示例**:诊断数据偏差的原因(综合分析)
|
|
||||||
|
|
||||||
**快速参考内容**:
|
|
||||||
- 知识点速查表
|
|
||||||
- 预习学习路径
|
|
||||||
- 自检清单
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 4. **其他已有文件的关系**
|
|
||||||
|
|
||||||
| 文件名 | 用途 | 与本系统的关系 |
|
|
||||||
|--------|------|----------------|
|
|
||||||
| 声速测量实验答题评估老师.md | 答题评分与反馈 | **姊妹系统**,适用于答题阶段 |
|
|
||||||
| 数据评价老师.md | 数据分析与评估 | **配套系统**,可用于实验后 |
|
|
||||||
| ai-agent-prompts.md | 通用框架 | **参考文档**,本系统基于此扩展 |
|
|
||||||
|
|
||||||
**三个系统的完整学习路径**:
|
|
||||||
```
|
|
||||||
预习阶段 → 本系统(疑问解答老师)→ 解答学生提问,建立基础
|
|
||||||
↓
|
|
||||||
实验阶段 → (学生进行实验操作)
|
|
||||||
↓
|
|
||||||
作业阶段 → (学生提交答题和数据)
|
|
||||||
↓
|
|
||||||
评分阶段 → 答题评估老师 → 评估学生的理论答题
|
|
||||||
↓
|
|
||||||
↳ 数据评价老师 → 评估学生的实验数据和处理
|
|
||||||
|
|
||||||
三套系统形成完整的教学闭环。
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 快速开始指南
|
|
||||||
|
|
||||||
### 场景A:只想用ChatGPT快速体验
|
|
||||||
|
|
||||||
**所需文件**:`疑问解答老师.md`
|
|
||||||
|
|
||||||
**步骤**:
|
|
||||||
1. 打开 https://chat.openai.com
|
|
||||||
2. 点击"Create new chat"
|
|
||||||
3. 复制 `疑问解答老师.md` 中的完整提示词
|
|
||||||
4. 粘贴到对话框,系统会自动激活
|
|
||||||
5. 开始提问!
|
|
||||||
|
|
||||||
**时间成本**:5分钟
|
|
||||||
**成本**:免费(使用ChatGPT Plus)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 场景B:想部署完整的Web应用
|
|
||||||
|
|
||||||
**所需文件**:全部(特别是`Web应用集成指南.md`)
|
|
||||||
|
|
||||||
**前提条件**:
|
|
||||||
- 有CloudBase账号(或其他云服务账号)
|
|
||||||
- 懂一点Node.js和React
|
|
||||||
- 已安装Node.js 14+
|
|
||||||
|
|
||||||
**步骤**:
|
|
||||||
```
|
|
||||||
1. 阅读"Web应用集成指南.md"的"项目概述"部分
|
|
||||||
2. 按"云函数部署"部分创建后端
|
|
||||||
3. 按"前端部署"部分创建前端
|
|
||||||
4. 按"部署检查清单"逐项检查
|
|
||||||
5. 测试运行
|
|
||||||
```
|
|
||||||
|
|
||||||
**时间成本**:3-5小时
|
|
||||||
**成本**:CloudBase免费额度内0元,超出部分低成本
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 场景C:想用在自己的在线教学平台上
|
|
||||||
|
|
||||||
**所需文件**:`疑问解答老师.md` + `Web应用集成指南.md`
|
|
||||||
|
|
||||||
**实现方式**:
|
|
||||||
1. **浅集成**:学生在你的平台上看到"联系ChatGPT"的链接,打开后使用提示词
|
|
||||||
2. **深集成**:在你的平台内嵌入React组件,直接提问,结果显示在平台内
|
|
||||||
3. **完全集成**:使用自己的AI API(如通义千问、云函数等),替换提示词中的模型部分
|
|
||||||
|
|
||||||
**推荐**:从浅到深逐步升级
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 场景D:只想作为教师参考资料
|
|
||||||
|
|
||||||
**所需文件**:`疑问解答老师.md` + `示例对话与快速参考.md`
|
|
||||||
|
|
||||||
**用途**:
|
|
||||||
- 理解如何指导学生预习
|
|
||||||
- 借鉴讲解的方式和深度
|
|
||||||
- 了解学生常见的疑问点
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📋 文件使用清单
|
|
||||||
|
|
||||||
### 最少必需
|
|
||||||
- ☑️ `疑问解答老师.md` - 核心提示词
|
|
||||||
|
|
||||||
### 完整应用(Web版)
|
|
||||||
- ☑️ `疑问解答老师.md` - 系统提示词
|
|
||||||
- ☑️ `Web应用集成指南.md` - 开发指南
|
|
||||||
- ☑️ `示例对话与快速参考.md` - 参考资料
|
|
||||||
|
|
||||||
### 学校教学使用(如果集成到教学系统)
|
|
||||||
- ☑️ `疑问解答老师.md` - 提示词
|
|
||||||
- ☑️ `Web应用集成指南.md` - 部署方案
|
|
||||||
- ☑️ `示例对话与快速参考.md` - 教学参考
|
|
||||||
- ☑️ `声速测量实验答题评估老师.md` - 答题评分(配套)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 核心特色
|
|
||||||
|
|
||||||
### 📚 教学设计
|
|
||||||
✅ **层次化讲解**:从简答到深入的多层次解答
|
|
||||||
✅ **启发式教学**:鼓励学生独立思考而非死记硬背
|
|
||||||
✅ **全维度覆盖**:原理、操作、计算三大维度兼顾
|
|
||||||
✅ **个性化反馈**:根据问题类型自动调整讲解深度
|
|
||||||
|
|
||||||
### 💻 技术特性
|
|
||||||
✅ **完整的代码示例**:可直接使用的Node.js和React代码
|
|
||||||
✅ **流式回答支持**:长答案可实时流式传输,用户体验更好
|
|
||||||
✅ **对话历史管理**:记录学生的预习进度,支持后续追问
|
|
||||||
✅ **易于定制**:清晰的代码注释,便于修改和扩展
|
|
||||||
|
|
||||||
### 🌟 用户体验
|
|
||||||
✅ **温暖的教学风格**:不冷漠、有耐心、鼓励学生
|
|
||||||
✅ **精准的内容**:直击学生的真实困惑点,不啰嗦
|
|
||||||
✅ **清晰的结构**:每个回答都有核心答案、深入讲解、自检题
|
|
||||||
✅ **可视化设计**:React界面美观易用,适合学生使用
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔧 自定义与扩展
|
|
||||||
|
|
||||||
### 如何修改针对不同学年的讲解深度?
|
|
||||||
编辑 `Web应用集成指南.md` 中的 `buildSystemPrompt` 函数,根据 `studentLevel` 参数调整提示词。
|
|
||||||
|
|
||||||
### 如何添加新的知识点或修正错误?
|
|
||||||
1. 打开 `疑问解答老师.md`
|
|
||||||
2. 找到"核心知识体系"章节
|
|
||||||
3. 添加或修改相关公式、概念
|
|
||||||
4. 云函数会自动使用最新内容
|
|
||||||
|
|
||||||
### 如何集成到我们学校的在线系统?
|
|
||||||
参考 `Web应用集成指南.md` 的"2.1 前端集成"部分。
|
|
||||||
|
|
||||||
### 如何支持其他语言(如英文)?
|
|
||||||
在 `buildSystemPrompt` 中添加语言参数,分别提供中英文提示词。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📊 系统能做什么
|
|
||||||
|
|
||||||
### ✅ 能做
|
|
||||||
- 解答学生关于声速测量实验的各类问题
|
|
||||||
- 逐步推导公式,而非只给答案
|
|
||||||
- 指出学生的常见错误点
|
|
||||||
- 提供操作指导和改进建议
|
|
||||||
- 提出自检问题,帮助学生验证理解
|
|
||||||
- 记录对话历史,支持多轮追问
|
|
||||||
|
|
||||||
### ❌ 不能做
|
|
||||||
- 诊断已经出现的实验操作失误(这需要现场指导)
|
|
||||||
- 替学生完成计算和数据处理
|
|
||||||
- 评判学生的作业和答题
|
|
||||||
- 提供超出声速实验范围的物理咨询
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 💬 FAQ(常见问题)
|
|
||||||
|
|
||||||
**Q:系统用的是什么AI模型?**
|
|
||||||
A:推荐使用 Hunyuan 2.0 或 DeepSeek V3。也可用 ChatGPT-4、Claude等其他模型,效果可能略有差异。
|
|
||||||
|
|
||||||
**Q:学生的对话数据会被保存吗?**
|
|
||||||
A:如果使用Web应用版本,对话会保存在CloudBase云数据库中。你可以选择不保存,或只保存课程相关的统计数据。建议遵守隐私政策。
|
|
||||||
|
|
||||||
**Q:一次最多能问几个问题?**
|
|
||||||
A:没有限制。但建议一次一个问题,这样讲解更精准。如果一个问题太复杂,系统会先回答核心部分,再问要不要深入。
|
|
||||||
|
|
||||||
**Q:系统支持追问吗?**
|
|
||||||
A:支持。第二个问题、第三个问题都可以基于前面的对话继续追问,系统会记住上下文。
|
|
||||||
|
|
||||||
**Q:系统能检测学生是否真的理解了吗?**
|
|
||||||
A:可以部分检测。通过"自检问题",如果学生能回答出来,说明理解了。你也可以定期生成"理解测试"题目。
|
|
||||||
|
|
||||||
**Q:实验中遇到问题时,学生能用这个系统吗?**
|
|
||||||
A:不建议。预习阶段用最好。实验中有问题应该找现场指导老师。
|
|
||||||
|
|
||||||
**Q:如何确保系统给的答案是正确的?**
|
|
||||||
A:系统基于经过验证的提示词,所有回答都符合标准的物理教学逻辑。但建议你(作为教师)定期抽检学生的对话,确保系统的回答质量。
|
|
||||||
|
|
||||||
**Q:可以给每个班级不同的讲解风格吗?**
|
|
||||||
A:可以。在云函数中根据 `classId` 或 `studentLevel` 加载不同的系统提示词变体。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📞 技术支持与反馈
|
|
||||||
|
|
||||||
### 遇到问题了?
|
|
||||||
1. 首先检查 `Web应用集成指南.md` 的"常见问题与排查"部分
|
|
||||||
2. 如果是提示词问题,检查是否正确粘贴了全文(包括所有公式和符号)
|
|
||||||
3. 如果是前端问题,查看浏览器的控制台日志(F12)
|
|
||||||
4. 如果是云函数问题,查看CloudBase的函数日志
|
|
||||||
|
|
||||||
### 想反馈改进意见?
|
|
||||||
- 📧 记录下"系统给的答案不准确"或"缺少XXX知识点"
|
|
||||||
- 🔄 告诉我们,我们会更新提示词
|
|
||||||
- 📝 提供改进的具体建议(比如"应该用更简单的例子")
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📈 预期效果
|
|
||||||
|
|
||||||
### 学生方面
|
|
||||||
- ✨ 预习效率提高 30-50%(不用等老师答疑)
|
|
||||||
- ✨ 预习完成度提升(可随时探索还不懂的地方)
|
|
||||||
- ✨ 实验失误率下降(对原理和步骤更清楚)
|
|
||||||
- ✨ 学习自信心增加(有人可以随时提问)
|
|
||||||
|
|
||||||
### 教师方面
|
|
||||||
- ✨ 减少重复答疑(学生很多问题先问系统)
|
|
||||||
- ✨ 课堂时间更高效(集中在难题和操作上)
|
|
||||||
- ✨ 数据可见化(知道哪些学生预习不充分)
|
|
||||||
- ✨ 教学材料可复用(其他班级也能用)
|
|
||||||
|
|
||||||
### 学校方面
|
|
||||||
- ✨ 实验合格率提升(学生准备更充分)
|
|
||||||
- ✨ 教学质量可量化(对话数据可分析)
|
|
||||||
- ✨ 资源利用高效(一套系统多个班用)
|
|
||||||
- ✨ 可持续改进(收集学生问题,不断优化教学)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏁 总结
|
|
||||||
|
|
||||||
这套系统将预习指导从"等老师空闲时回答"变成了"随时随地的个性化学习"。
|
|
||||||
|
|
||||||
**核心价值**:
|
|
||||||
> 让每个学生在实验前都有一位耐心的、专业的、全天候的物理老师在身边。
|
|
||||||
|
|
||||||
**使用建议**:
|
|
||||||
1. 从简单开始:先用ChatGPT版本体验效果
|
|
||||||
2. 如果效果好:再部署完整的Web应用
|
|
||||||
3. 定期维护:根据学生反馈改进提示词
|
|
||||||
4. 数据分析:看下学生最常问什么问题,优化教学
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**祝你的教学更高效,学生的预习更轻松!**
|
|
||||||
|
|
||||||
如有任何疑问,欢迎继续提问。😊
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
*最后更新:2026年3月30日*
|
|
||||||
*版本:1.0 完整版*
|
|
||||||
在新工单中引用
屏蔽一个用户