UGSci油气 · 储气库 · 科研
功能与操作说明

首次使用与安装

从启动、模型配置到完成第一次有结果可检查的任务。

安装与运行环境

一般用户优先使用团队提供的 UGSci Desktop 安装包。Windows、macOS 或 Linux 的具体可用版本以交付安装包为准。本手册的 Windows 操作示例建议使用现代 64 位系统、可用的本地写入目录及更新的浏览器;这些是部署建议,不是已经完成的全平台兼容认证。

源码运行要求 Python 3.11 至 3.13;前端构建还需按项目要求准备 Node.js。运行大型三维模型、并行专家或外部数值模拟时,内存、显卡、CPU、磁盘与许可证要求取决于模型规模和专业软件。首次验证可从小型文件和只读任务开始。

桌面版启动

  1. 运行团队提供的安装程序,按向导完成安装,并确认安装包来源。双击 UGSci Desktop,等待后端服务和窗口就绪。
  2. 打开设置中的模型页面,填写所用模型服务的地址、密钥和模型名称,或连接已部署的本地模型服务。保存后将模型指定给当前专家。
  3. 在左侧选择当前专家,发送“只介绍你的职责,不运行任何工具”。出现有效回复,说明模型调用链路已连通。
  4. 查看专家·协作、工具·技能及油气可视化入口。若前两个入口未显示,切换侧栏的极简模式,并确认 UGSci 组件已加载。

源码版启动

开发者应从本项目目录安装,避免把公开仓库的原版安装包当成包含全部 UGSci 定制内容的交付包。先建立虚拟环境,再安装本项目依赖、初始化运行目录并启动服务。以下为 Windows PowerShell 示例,C:\UGSci\source 需要替换成实际项目目录;已有配置时不要直接使用强制覆盖初始化。

cd C:\UGSci\source
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .
qwenpaw init --defaults
qwenpaw app

浏览器访问与组件检查

源码服务默认在 http://127.0.0.1:8088/ 提供控制台;如启动时更改端口,以启动日志为准。桌面版无需用户手动设置此地址。目录、命令和后端包名保持 qwenpaw 兼容命名。

本手册功能基线为 UGSci 领域组件 0.7.4;项目技术底座版本为 2.2.2b6,科研组件为 0.1.4。组件清单声明 QwenPaw 2.1.0 至 2.3.0 的兼容范围,实际部署仍应使用经过团队验证的组合。

第一次练习

完成标准:有清晰的输入清单和检查项;没有在未经说明的情况下启动正式计算。只有可用模型不足以证明专业工具可用,后续还需要用小型样例逐项验证工具。

只做只读检查,不运行仿真,不修改原始文件。
请介绍当前专家的模型、可用技能和工具;列出我做 LAS 质量检查需要准备的文件。
输出输入清单、单位检查项和完成标准。