学术研究脉络梳理与创新点挖掘工具 - 使用说明
一、工具介绍
本工具是一款轻量级学术分析应用，支持上传论文集合文件（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. 启动工具
- 本地运行：执行
python app.py启动应用； - ModelScope部署：直接在创空间中启动（自动处理端口配置）；
- 界面访问：启动后自动打开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`。