# 学术研究脉络梳理与创新点挖掘工具 - 使用说明 ## 一、工具介绍本工具是一款轻量级学术分析应用，支持上传论文集合文件（TXT/Word格式），通过调用Google Gemini大模型（中转服务）自动梳理研究脉络时间线、挖掘未来可行研究点，并以可视化方式呈现结果，帮助学术研究者快速总结领域发展逻辑与创新方向。当前版本已适配ModelScope创空间部署，采用Gradio界面框架实现更友好的交互体验。 ## 二、核心技术栈 | 模块 | 技术/依赖 | |------------|-------------------------------| | 交互界面 | Gradio >=4.0.0 | | 文件解析 | mammoth.js（Word文档解析） | | AI模型 | Google Gemini-3-pro-preview（通过中转服务调用） | | 网络中转 | 第三方Gemini中转服务（支持gemini-3-pro-preview模型） | | 安全处理 | HTML转义机制（防XSS攻击） | ## 三、快速使用指南 ### 1. 环境准备 - 运行环境：支持Python 3.8+的环境或ModelScope创空间； - 依赖安装：通过`requirements.txt`安装所需依赖（已移除Flask相关组件，新增Gradio依赖）； - 环境变量：需配置`GEMINI_API_KEY`（中转服务专属密钥，格式：`sk-qH9wF（示例）...`）。 ### 2. 启动工具 1. 本地运行：执行`python app.py`启动应用； 2. ModelScope部署：直接在创空间中启动（自动处理端口配置）； 3. 界面访问：启动后自动打开Gradio交互界面（默认端口7860，ModelScope会自动映射）。 ## 四、详细操作步骤 ### 1. 上传论文文件 - 通过Gradio界面的「文件上传」组件，选择包含多篇论文信息的文件（支持`.txt`/`.docx`格式）； - 文件内容需包含论文的**标题、发表年份、摘要**（至少3篇同领域论文，便于模型梳理脉络）； - 文件大小限制：默认10MB，可根据需求调整配置。 ### 2. 启动分析 - 确认已配置环境变量`GEMINI_API_KEY`或在界面输入框中填写密钥； - 点击「开始梳理与挖掘」按钮触发分析； - 等待5-10秒（模型分析耗时，界面会显示加载状态）。 ## 五、结果说明分析完成后，界面会展示2个核心模块： ### 1. 研究脉络可视化 - 按「年份」生成纵向时间轴，标注对应阶段的**核心发展/技术突破**； - 附带「代表性论文标题」列表，清晰呈现领域演进节点。 ### 2. 未来可行研究点 - 以卡片网格形式展示3-5个创新研究方向； - 每个卡片包含**研究点名称**与**立论依据**（说明该方向的价值与合理性）。

提示： 分析结果的精准度取决于上传论文信息的完整性，建议尽可能提供论文的标题、年份、摘要、核心结论等信息。所有输出内容已通过HTML转义处理，确保展示安全。

## 六、注意事项 - **中转服务限制**：本工具依赖第三方中转服务（可在第三方门店购买额度，本模型额度大概费用在0.5元到1元/次）调用Gemini模型，仅支持`gemini-3-pro-preview`模型；中转服务额度请自行购买，超出后需补充额度。 - **文件要求**：仅支持`.txt`（纯文本）、`.docx`（Word文档）格式；文件需包含论文的「标题、年份、摘要」（信息越完整，分析结果越精准）。 - **结果异常处理**：若显示“JSON解析失败”，工具已内置格式清理逻辑，重新上传文件重试即可；若显示“无可用渠道”，联系中转服务管理员确认模型权限。 - **部署配置**：在ModelScope创空间部署时，无需修改端口配置（默认7860），启动脚本`start.sh`已适配环境；本地运行可通过`demo.launch()`参数调整端口。 ## 七、常见问题

Q：为什么上传文件后无结果？

A：在Gradio界面下方查看错误提示，检查文件是否包含至少3篇论文的「年份+摘要」信息，或确认`GEMINI_API_KEY`是否有效。

Q：模型支持哪些语言的论文？

A：支持中英文论文，优先推荐中文内容（模型对中文文献的适配性更优）。

Q：加载状态长时间不消失怎么办？

A：检查网络是否正常，或刷新页面重新上传文件分析；若仍失败，联系中转服务管理员确认服务是否正常。

Q：如何在本地环境运行？

A：1. 安装依赖：`pip install -r requirements.txt`；2. 设置环境变量：`export GEMINI_API_KEY="你的密钥"`；3. 启动应用：`python app.py`。