docs/features/basic_functions.md
GPT Academic 的基础功能区提供了一组精心设计的快捷按钮，将常用的文本处理任务封装成一键式操作。与函数插件区的复杂功能不同，基础功能专注于对输入文本的即时处理——您只需输入文本，点击按钮，即可获得 AI 的专业处理结果。
这些功能的设计理念是"所见即所得"：按钮会在您输入的文本前后添加精心编写的提示词（Prompt），引导 AI 按照特定方式处理您的内容。这种机制让您无需了解提示词工程，就能获得专业级的处理效果。
| 功能按钮 | 作用 | 适用场景 |
|---|---|---|
| 学术语料润色 | 改进文本的语法、清晰度和学术风格 | 论文草稿润色、摘要改写 |
| 总结绘制脑图 | 分析文本逻辑关系，生成 Mermaid 流程图 | 文献综述、会议纪要整理 |
| 查找语法错误 | 逐句检查语法和拼写，以表格形式呈现修改建议 | 论文校对、邮件检查 |
| 中译英 | 将中文翻译为英文 | 摘要翻译、邮件撰写 |
| 学术英中互译 | 智能检测语言并翻译，保持学术风格 | 论文翻译、文献阅读 |
| 解释代码 | 分析代码功能和逻辑 | 代码阅读、学习新项目 |
基础功能的使用流程非常简单，遵循"输入文本 → 点击按钮 → 获取结果"的模式。
在界面右侧的输入框中输入或粘贴您要处理的文本，然后在基础功能区点击对应的功能按钮。系统会自动将您的输入与预设的提示词组合，发送给当前选中的大语言模型。处理结果将以流式方式显示在左侧的对话区域。
!!! tip "快捷操作" 基础功能按钮位于输入框下方，按钮名称直接反映其功能。如果您找不到某个按钮，可能是因为它被设置为隐藏状态——您可以通过配置文件开启它。
这是 GPT Academic 的标志性功能，专门针对学术写作场景优化。点击该按钮后，AI 会对您的文本进行全方位的学术润色处理。
处理内容包括：
输出格式：
AI 首先给出润色后的完整文本，然后以 Markdown 表格形式列出所有修改，并说明每处修改的原因。这种格式让您可以清楚地了解哪些内容被修改、为何修改，便于学习和审核。
使用示例：
假设您输入以下文本：
This paper propose a new method for image classification. The method is based on deep learning and achieve good results.
点击学术语料润色按钮后，AI 会返回润色后的文本：
This paper proposes a novel method for image classification. The proposed method is based on deep learning and achieves promising results.
并附上修改说明表格，列出"propose → proposes"（主谓一致）、"new → novel"（学术用词）等修改细节。
该功能将文本内容转化为结构化的 Mermaid 流程图，帮助您快速把握文本的逻辑框架和关键信息之间的关系。
工作原理：
AI 会分析输入文本的核心概念和逻辑关系，然后生成 Mermaid flowchart 代码。GPT Academic 的对话区支持 Mermaid 语法渲染，因此您可以直接看到可视化的流程图。
适用场景：
!!! info "关于 Mermaid" Mermaid 是一种基于文本的图表绘制语言，可以用简洁的语法描述流程图、序列图、甘特图等。GPT Academic 内置了 Mermaid 渲染支持，AI 生成的图表代码会自动转换为可视化图形。
与学术润色不同，该功能专注于语法和拼写检查，不会改变文本的表达风格。如果文本没有语法错误，AI 会明确告知"这段文字没有问题"。
输出格式：
AI 以两列 Markdown 表格呈现检查结果：左列是原文，右列是修正后的文本，关键修改部分会加粗标注。最后提供完整的校对后文本。
与润色功能的区别：
| 对比项 | 语法检查 | 学术润色 |
|---|---|---|
| 修改范围 | 仅修正语法和拼写错误 | 全面改进表达质量 |
| 风格变化 | 保持原有风格 | 提升学术规范性 |
| 输出重点 | 错误定位和修正 | 优化建议和解释 |
这两个功能都提供翻译服务，但设计目标有所不同。
中译英功能专注于将中文翻译为英文，适合快速翻译简短内容。
学术英中互译功能则更为智能：它会自动检测输入文本的语言，如果是英文则翻译为中文，如果是中文则翻译为英文。翻译过程中会保持学术风格，调整句序以符合目标语言的表达习惯。
!!! tip "翻译建议" 对于学术论文翻译，建议使用学术英中互译功能，它会更好地处理专业术语和学术表达。如果您需要翻译整篇 PDF 论文，请使用函数插件区的 PDF 论文翻译 功能。
该功能帮助您快速理解代码片段的功能和实现逻辑。只需将代码粘贴到输入框，点击按钮，AI 就会给出详细的代码解释。
解释内容通常包括：
!!! note "代码量建议" 基础功能适合解释单个函数或代码片段。如果您需要分析整个项目的代码结构，请使用函数插件区的 源码分析 功能。
初次使用 GPT Academic 的用户可能会困惑：基础功能区和函数插件区有什么区别？何时该用哪个？
基础功能是对文本的即时处理，工作方式是在您的输入前后添加预设提示词，然后一次性发送给 AI。它适合处理输入框中的文本内容，操作简单直接。
函数插件则可以执行更复杂的任务，包括：
简单来说：输入框里的文本用基础功能，上传的文件用函数插件。
| 场景 | 推荐使用 |
|---|---|
| 润色一段论文草稿 | 基础功能：学术语料润色 |
| 翻译整篇 PDF 论文 | 函数插件：PDF 论文翻译 |
| 解释一小段代码 | 基础功能：解释代码 |
| 分析整个代码项目 | 函数插件：解析 Python 项目 |
| 翻译一个段落 | 基础功能：学术英中互译 |
| 翻译完整 Markdown 文档 | 函数插件：翻译 README 或 MD |
GPT Academic 允许您创建自定义的基础功能按钮，定义专属的提示词模板。这在以下场景特别有用：
点击界面左上角的工具栏，找到界面外观设置，在其中可以管理自定义按钮。您可以为每个自定义按钮设置：
如果您熟悉 Python，也可以直接编辑 core_functional.py 文件。在 get_core_functions() 函数返回的字典中添加新条目：
"我的翻译助手": {
"Prefix": "请将以下内容翻译成流畅的中文，保持专业术语的准确性：\n\n",
"Suffix": "",
"Color": "secondary", # 按钮颜色：primary / secondary / stop
"Visible": True, # 是否显示
},
保存文件后，如果开启了插件热加载（PLUGIN_HOT_RELOAD = True），新按钮会立即生效，无需重启应用。
基础功能默认会保留对话历史，这意味着 AI 在处理时可以参考之前的对话内容。如果您发现 AI 的回复受到历史对话的干扰，可以先点击重置按钮清空历史，再执行基础功能。
部分功能（如学术润色）内置了 AutoClearHistory 选项，会自动清除历史以确保处理结果不受干扰。
不同的大语言模型在各项任务上表现各异。您可以根据任务特点选择模型：
在界面左上角的模型下拉菜单中切换模型，然后执行基础功能即可。