首页/资讯中心/详情

DeepInsight CLI工具完全指南：命令行高效操作技巧

DeepInsight CLI工具完全指南：命令行高效操作技巧
📅 发布时间：2026/6/30 17:44:21

DeepInsight CLI工具完全指南：命令行高效操作技巧

【免费下载链接】deepInsightThe deep-research enables efficient RAG retrieval and multi-source data analysis, supporting intelligent reasoning for automated complex research tasks.项目地址: https://gitcode.com/openeuler/deepInsight

前往项目官网免费下载：https://ar.openeuler.org/ar/

DeepInsight CLI工具是openEuler deepInsight项目的命令行接口，让您能够通过终端快速高效地完成深度研究、会议管理和API服务启动等任务。本文将为您详细介绍DeepInsight CLI的完整使用技巧，帮助您掌握这个强大的AI研究工具。

🚀 快速入门：安装与配置

环境准备与安装步骤

首先，您需要克隆项目仓库并安装依赖：

git clone https://gitcode.com/openeuler/deepInsight cd deepInsight conda create -n deepInsight python=3.11 poetry install cp .env.example .env

在.env文件中配置您的API密钥（如DeepSeek API Key）和数据库连接信息。

数据库初始化

运行以下命令初始化数据库：

alembic upgrade head

DeepInsight采用多Agent架构，支持复杂研究任务的高效完成

📊 核心命令详解

基础命令结构

DeepInsight CLI使用di作为主命令，包含三个主要子命令：

  • di resch- 深度研究功能
  • di conf- 会议管理功能
  • di api- API服务管理

1. 深度研究助手（resch）

深度研究助手是DeepInsight的核心功能，支持智能化的研究任务执行：

# 启动深度研究 di resch gen --topic "人工智能发展趋势" # 查看帮助信息 di resch --help

使用场景：当您需要系统性地研究某个技术主题时，DeepInsight会：

  1. 自动分析研究需求
  2. 制定详细的研究计划
  3. 执行多轮研究迭代
  4. 生成结构化研究报告

深度研究界面展示智能体协作过程

2. 会议管理（conf）

会议管理功能专门用于处理学术会议论文分析：

# 查看会议列表 di conf list # 生成会议知识库 di conf gen --name "ICLR 2025" --files-src ./docs # 会议问答交互 di conf chat --name "ICLR 2025" --files-src ./docs --question "今年最佳论文有哪些创新点？" # 删除会议记录 di conf remove --id 12

跨会议主题分析功能：

# 分析多个会议中的共同主题 di conf topic --question "分布式系统一致性" --name "HOTOS 2025, OSDI 2025" --file-src "./path1,./path2"

此命令会生成：

  • 统计信息分析
  • 论文详细分析
  • 跨会议总结报告
  • 自动生成的PDF文档

输出目录：data/conference_report_result/cross_topic-<会议名称>/

会议分析生成的详细报告展示

3. API服务（api）

启动后端API服务，支持Web界面访问：

# 启动API服务 di api start --config ./config.yaml # 指定专家配置文件 di api start --config ./config.yaml --expert-config ./experts.yaml # 使用环境变量配置 DEEPINSIGHT_CONFIG=./config.yaml di api start

🔧 高级配置技巧

配置文件管理

DeepInsight支持通过config.yaml进行详细配置：

workspace: work_root: ./data chart_image_dir: charts image_path_mode: base_url image_base_url: http://127.0.0.1:8888/api/v1/deepinsight/charts/image

图表图片路径配置建议：

  • 命令行模式：image_path_mode: relative
  • Web预览模式：image_path_mode: base_url

RAG配置优化

支持多种RAG后端组合：

rag: engine: type: lightrag lightrag: enable_graph_extraction: false parser: type: mineru_vl mineru_vl: enable_vl: true

支持的RAG组合：

  • mineru_vl + lightrag- 推荐组合
  • mineru_vl + llamaindex- 混合索引
  • llamaindex + llamaindex- 全流程LlamaIndex

💡 实用技巧与最佳实践

1. 快速测试示例数据

# 使用示例会议数据进行快速测试 di conf gen --name "HOTOS 2025" --files-src ./example/papers/hotos-2025/

2. 批量处理多个会议

# 同时处理多个会议 di conf chat --name "HOTOS 2025, OSDI 2025" --files-src "./path1,./path2" --question "分布式系统一致性协议的研究进展"

3. 环境变量配置

通过环境变量简化命令行操作：

# 设置默认配置文件路径 export DEEPINSIGHT_CONFIG=./my_config.yaml # 设置API密钥 export DEEPSEEK_API_KEY=your_key_here export TAVILY_API_KEY=your_tavily_key

4. 输出结果管理

所有生成的文件都保存在data/目录下，结构清晰：

  • data/conference_report_result/- 会议分析报告
  • data/research_reports/- 深度研究报告
  • data/charts/- 生成的图表图片

🚨 故障排除

常见问题解决

  1. 数据库连接失败

    # 检查数据库配置 cat .env | grep DATABASE # 重新初始化数据库 alembic upgrade head

  2. API密钥配置错误

    # 验证环境变量 echo $DEEPSEEK_API_KEY echo $TAVILY_API_KEY

  3. 文件路径问题

    # 确保源文件路径正确 ls -la ./docs/

调试模式

启用详细输出以排查问题：

di --verbose conf gen --name "测试会议" --files-src ./docs

📈 性能优化建议

1. 资源管理

  • 对于大型会议论文集，建议分批处理
  • 使用SSD存储加速文件读取
  • 适当调整内存分配

2. 缓存策略

  • 重复使用的会议数据会被自动缓存
  • 可手动清理缓存：rm -rf data/cache/

3. 并行处理

对于多个独立任务，可以：

# 在后台运行多个分析任务 di conf gen --name "会议1" --files-src ./data1 & di conf gen --name "会议2" --files-src ./data2 &

🎯 总结

DeepInsight CLI工具提供了强大的命令行接口，让您能够：

  1. 高效完成深度研究- 通过智能Agent协作生成专业报告
  2. 智能分析学术会议- 支持多会议跨主题分析
  3. 灵活配置部署- 支持多种RAG后端和运行模式
  4. 简化工作流程- 一键生成PDF报告和结构化分析

掌握这些CLI技巧，您将能够充分利用DeepInsight的强大功能，显著提升研究效率和工作质量。无论是学术研究、技术分析还是知识管理，DeepInsight都能成为您的得力助手。

核心文件路径参考：

  • CLI主入口：deepinsight/cli/main.py
  • 会议管理命令：deepinsight/cli/commands/conference.py
  • 研究命令实现：deepinsight/cli/commands/research.py
  • API服务命令：deepinsight/cli/commands/api.py

开始您的深度研究之旅吧！🚀

【免费下载链接】deepInsightThe deep-research enables efficient RAG retrieval and multi-source data analysis, supporting intelligent reasoning for automated complex research tasks.项目地址: https://gitcode.com/openeuler/deepInsight

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考