软件定位

UGSci 将自然语言任务、领域专家、可执行计算工具、专业仿真软件和成果展示组织在同一工作环境中。用户可以从一份测井文件、一组注采数据或一个研究问题开始，逐步完成输入检查、计算分析、多专家复核和成果整理。软件适用于油藏工程师、储气库研究人员、测井解释人员、科研工作者及团队管理员。

桌面产品使用 UGSci Desktop 品牌；技术底座沿用 QwenPaw 的本地部署、模型配置、智能体工作区、记忆、技能、工具、安全和自动化体系。UGSci 领域组件提供行业界面与计算功能，UGSci Research 提供可选科研模式。命令行、目录名及部分协议仍保留 qwenpaw 字样，这是兼容入口。

核心工作方式

UGSci 的领域能力

油气工程：LAS 测井读取与质量检查、Arps 递减拟合和预测、储量估算、油气藏物质平衡、黑油 PVT 筛选、Vogel IPR、节点分析及质量守恒检查。

地下储气库：账面库存、分层有效库存、综合库存评价、库容筛选、井组配注配产候选方案，以及带约束和权重的方案排序与 Pareto 比较。

可信计算：记录输入指纹、算法与版本，展示公式代入、变换和有效性判断；对支持的公式计算使用签名重放令牌进行复算。

协作与表达：六种专家团模式、固定协作工作流、仿真任务跟踪、油气三维与测井可视化、GenUI 交互成果以及可选的文献和科研工作流。

能力生效条件

技能是操作方法，工具才是实际执行入口。共享技能库里有技能，不代表当前专家已安装或已启用。外部求解器需要有效安装路径、许可证、输入文件和配套依赖；科研检索需要相应网络与工具连接。

数据和工作区可以保存在本机。使用云端模型、外部 MCP 或联网检索时，相关输入仍可能发送到所配置的服务；本地部署不自动等于全程离线。计算建议需要业务人员复核，软件不会因为得到数值就完成工程审批。

安装与运行环境

一般用户优先使用团队提供的 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 质量检查需要准备的文件。
输出输入清单、单位检查项和完成标准。

配置模型

1. 进入设置中的模型管理，选择已有提供商或创建自定义提供商，填写实际服务地址与认证信息。密钥保存在配置中，不写入提问模板或成果文件。
2. 选定可用模型并保存；返回专家配置，确认当前专家的活动模型。不同专家可以使用不同模型。
3. 先发送简短文本问题，再测试需要的图片或长文档输入。只有服务明确支持相应输入类型时才使用该能力。

如何选择模型

管理工作区

每个专家对应一个智能体及其配置和工作区。模型、提示词、技能、MCP、记忆和对话历史随所选专家变化。切换专家后先检查当前名称，避免将文件或能力分配给错误角色。

建议每个业务项目建立 inputs、working、results 三个目录。inputs 存原始数据，working 存中间计算副本，results 存交付文件。目录名称可以自定，但应在任务中写明原始文件只读、输出路径和覆盖规则。

上传文件或提供路径前，确认文件已落到当前专家可访问的位置。聊天里出现文件名不等于引擎能直接访问该文件。将多个关联文件保持在同一项目目录，可减少伴随文件缺失。

结果保存与切换

1. 完成任务后要求输出实际文件路径、文件格式、输入数据来源和计算方法。
2. 在文件或工作区面板中打开产物，核对内容和大小，再备份整个项目。
3. 切换专家复核时明确指定已保存的结果文件及其路径；不要默认两个专家自动共享全部文件和记忆。

聊天 Loop 与工作目录

新任务前选择专家和模型，按任务长度选择 Loop，核对当前目录及审批设置。目录选择器的系统路径取自演示环境，实际部署按本机目录操作。

成果浏览器进程 GenUI 与 Trace

工作区抽屉包含五类视图。没有产物或进程时展示空态；Trace 记录工具与运行事件，不是模型隐藏思维的完整披露。

文件工作区角色日记与知识

文件页面区分任务文件、身份与偏好、日记和知识目录。打开文件可预览、编辑、下载或带入聊天；角色文件修改会影响之后的任务行为，先保存原始版本。

生成交互成果

GenUI 通过已注册的组件目录生成结构化交互界面，并可以用补丁增量更新。适合展示参数表、图表、表单、状态和分析结果。可用组件与交互取决于目录和工具契约，不是任意网页代码都能直接运行。

用户应先说明真实数据来源、显示字段、单位、可编辑项及提交影响。表单填写不等于已执行计算或已写入文件；提交之后需要检查反馈和实际产物。

查看文件和成果

1. 在对话或工作区打开生成的成果，核对图表轴、单位、数值、记录数量和输入参数。
2. Office 文件优先使用后端转换预览；转换不可用时可能回退到前端 OOXML 解析或下载。DOCX、XLSX、PPTX 的复杂版式可能与原软件有差异。
3. 文件预览用于阅读检查；需要编辑或验证正式版式时使用相应文档软件。报告必须包含真实已生成的文件路径。

导出交互界面

GenUI 支持 PNG 截图、HTML 导出及打印/保存 PDF。HTML 导出保留可支持的界面和本地表单状态，但离线页面不会向 UGSci 后端发送消息或提交数据。

PNG 导出适合静态截图；打印 PDF 需要浏览器允许打印窗口。导出前确认所有图片已加载，导出后重新打开检查文字、图表和媒体。

示例

用实际计算结果生成一个GenUI报告：显示输入参数、结果、单位、告警和版本。
提供参数表和结果图，不虚构数据。
如果增加表单，说明提交后调用的工具与写入路径。
最后导出HTML与PNG，并验证离线HTML不能向后端提交任务。

列表日历与模板

从列表或日历检查触发计划，也可以先选择内置模板。创建前确认当前智能体，避免把模板直接用于含真实数据的工作区。

全部重复频率与单次执行

周期任务支持分钟、小时、每天、每周、每月与 Cron 表达式；单次任务使用具体日期。逐屏展示频率变化后的相关配置。

任务类型与结构化内容

选择智能体任务或界面支持的其他任务类型，填写提示或结构化任务对象。JSON 不合法时不能依赖系统猜测。

回复目标与高级执行

指定结果送达的渠道、会话或收件箱，配置超时和并发等执行限制。目标渠道必须已连接且具有发送权限。

心跳完整配置

心跳按周期读取 HEARTBEAT.md，受活动时间窗口约束。需要安静运行时在任务文本中说明何时通知；频率、目标和窗口按当前智能体配置。

通用与消息显示

进入设置 通用。语言、主题、字体与聊天显示主要影响当前设备；运行配置和模型使用独立页面。截图按从上到下的顺序连续记录长页面。

1. 检查语言与主题。
2. 展开消息显示选项，配置工具摘要、思考内容和宽度。
3. 返回聊天页面确认阅读效果。

自定义主题

点击主题的自定义入口。配色、强调色、悬停色、背景和圆角共同控制界面外观；重置将回到预设。

侧栏入口与顺序

在侧栏布局编辑器中管理入口显示、顺序和新增项目。隐藏入口不会卸载插件；未启用能力仍可能不可使用。

1. 选择需要显示的入口。
2. 通过排序操作调整位置。
3. 返回应用检查侧栏是否与使用顺序一致。

语音转写的 API 与本机方式

转写方式可选择关闭、API 或本机模型。API 模式需要服务商与模型配置；本机方式需要模型文件和支持的设备环境。仅展示参数，未下载模型或发送录音。

Chrome 连接与高级设置

按 Windows macOS Linux 安装说明准备浏览器扩展并核对连接地址。页面中的默认路径是产品路径示例，不能直接作为所有机器的实际路径。

桌面宠物与导入

宠物依赖桌面运行环境，可通过所支持的 ZIP 包导入。本次展示导入表单，没有安装来源不明的包。

电脑操作与授权管理

电脑操作依赖桌面桥接和运行环境。采集环境显示未就绪，因此不能展示真实应用授权列表或桌面执行成功状态；部署桌面组件后再按实际应用权限配置。

GenUI 设置

开启 GenUI 后可在成果面板预览交互页面。显示开关不等于允许任意公式执行，公式能力仍按相关工具和安全配置处理。

模型目录与云服务商

模型页面管理云端、自定义、本机 Ollama 及内置 Llama.cpp。先配置提供商，再选模型，最后配置当前智能体的主模型和子模型。

添加提供商与协议选择

自定义服务支持界面列出的 OpenAI Chat Completions、Responses 或 Anthropic 协议。名称相近的协议不可随意互换，Base URL 使用服务实际入口。

提供商凭据请求头与生成参数

提供商配置包括启用、Base URL、API Key、Headers 和 JSON 参数。密码框保持空白，截图没有实际密钥。服务端指定的认证 Header 与 SDK 默认认证应避免冲突。

模型目录与手动模型

可获取服务端模型目录，或填写模型 ID 和显示名。目录数量、型号和能力声明会随服务改变；采集时的模型仅用于说明界面。

模型能力输出上限与高级参数

为每个模型分别设置图片、音频、视频和工具调用能力，以及输出上限、上下文容量、推理能力声明与生成 JSON。手动声明不构成能力验证，测试按钮可能产生真实服务请求。

智能体主模型子模型与备用模型

主模型承担日常对话，子模型承担委派任务；推理档位与备用模型按界面配置。配置后执行小任务，检查真正使用的模型和失败回退记录。

本机 Ollama 服务

填写本机 Ollama 服务地址，按需要提供认证信息。模型须已在该服务中可用，控制台填写名称不会下载模型。

内置 Llama cpp 与高级生成设置

内置运行环境、模型文件、服务端口和上下文容量分开管理。采集环境未安装本地推理运行环境，因此展示配置入口和未就绪状态，未进行模型下载或推理。

工作环境与高级 Shell 配置

进入运行配置 工作环境。配置智能体语言、时区、工作路径、增强代码能力及会话标题；展开高级设置查看 Shell 和记忆后端。

1. 确认当前智能体。
2. 填写存在的工作目录。
3. 配置超时与执行程序后，先用无副作用命令验证环境。

标准 Loop 与审批模式

标准 Loop 包含重复保护、轮次限制和完成检查。内置流程锁定，参数可以编辑；工具审批模式决定调用前是否需要审批。

1. 展开三个 Gate。
2. 核对重复检测窗口、相似度和最大轮次。
3. 按工具权限设置审批模式，执行后检查结束原因。

目标 Loop

目标模式持续工作直到目标完成或达到轮次、预算等上限。预算与完成检查必须结合结果验证，达到上限不能写成完成。

任务 Loop

任务模式围绕 Mission Story 状态工作，每个 Story 可由 Worker 处理并交给 Verifier 检查。截图含轮次、重试次数、验证指导和测试命令。

自定义 Loop

点击创建自定义 Loop 模式，填写名称及命令入口，并配置 Gate 参数。先用小任务检查终止条件，再用于长任务。

失败重试与服务等待

分别控制请求重试、退避等待、并发、QPM 和取得调用许可的最长等待时间。截图数值为示例环境配置，不是所有提供商的通用推荐值。

环境变量列表与新增

环境变量分为应用管理值与用户自定义值。不要把初始化路径当作任意可修改的字符串；自定义键名应与调用工具的要求一致。

上下文容量与四组高级选项

上下文容量页面连续记录了压缩比例、历史保留、工具结果压缩、视觉压缩和 byte Token 估算。顶部数值来自模型配置，不是实时使用量。

记忆提取整理与检索服务

自动记忆按对话轮数提取，梦境任务定时整理。主动搜索和每轮自动搜索可以分别控制。向量服务未配置时保留 BM25 关键词搜索；重排序与 Embedding 的 API 配置相互独立。

1. 设置提取频率及日记通知。
2. 配置梦境计划和通知。
3. 需要语义搜索时填写 Embedding 协议、地址、模型和维度。
4. 开启重排序前填写对应服务。
5. 验证维度后再重建索引。

资源占用与诊断

点击资源与诊断，核对组件存储与进程占用。这里显示采集时的实时数据，不代表产品固定内存需求。维护入口的重建索引会改变索引数据，先保留需要的资料。

频道总览与公共配置

进入设置 频道。先选择当前智能体，再点对应渠道的配置入口。以下每个渠道都展示了展开后的完整表单，公共参数在本节统一解释。未输入真实凭据，也没有进行扫码登录。

全局访问名单与黑名单

名单使用渠道实际用户或群标识，不使用显示名称代替。未启用或缺少连接条件时相关输入不可编辑；截图保留实际禁用状态。

钉钉 完整配置

扫码创建或手动填写客户端 ID 和密钥；消息格式、机器人编码与 API 地址分别设置。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

飞书 完整配置

填写飞书应用凭据并选择相应部署区域和消息处理选项。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

iMessage 完整配置

需要 macOS 的消息数据库和本机执行工具；Windows 采集只展示表单。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

Discord 完整配置

配置机器人令牌与频道访问范围，代理及提及条件按网络和群组需求设置。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

Telegram 完整配置

配置 Bot Token、连接地址和代理；使用平台返回的用户或群组 ID。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

QQ 完整配置

填写 QQ 机器人应用标识与密钥，核对运行模式及沙箱设置。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

微信 完整配置

按页面的扫码或连接流程接入；先完成身份连接，再配置消息呈现。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

企业微信 完整配置

配置企业微信所用机器人标识、认证及连接参数。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

元宝 完整配置

按元宝接入入口建立机器人或账号关联，使用其要求的凭据。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

Matrix 完整配置

填写 Homeserver、用户及访问令牌，房间范围和加密条件按服务要求核对。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

SIP 完整配置

开发模式使用 pyVoIP，生产模式使用 LiveKit SIP Server；SIP 凭据与 STT TTS 凭据各自配置。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

小艺 完整配置

配置小艺应用或设备接入参数，按平台提供的实际认证信息填写。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

Mattermost 完整配置

填写服务地址与机器人令牌，核对团队和频道权限。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

MQTT 完整配置

配置 Broker 地址、端口、主题、认证和 TLS，确认发布与订阅主题对应。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

Slack 完整配置

使用 Slack 应用或机器人连接凭据，按平台权限配置消息入口。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

语音 完整配置

配置实时语音的模型、语种、声音、转写和合成服务；麦克风及外部 API 需另外就绪。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

OneBot 完整配置

连接 OneBot 服务，地址、令牌、版本和反向连接等选项按该服务模式配置。 消息呈现和高级设置均已展开；连续截图涵盖页尾，不需要仅凭首屏猜测。

1. 填写平台必需的连接参数。
2. 核对本渠道的消息格式和访问范围。
3. 保存后启用并检查连接状态。
4. 从受允许的测试对象发送一条无敏感内容消息验证。

SIP 生产环境的 LiveKit 字段

SIP 模式切换为生产后显示 LiveKit 连接及认证等专有字段。与开发模式使用的 pyVoIP 配置分别核对，没有执行真实电话呼叫。

Matrix 密码认证分支

切换认证方式后显示密码分支。访问令牌和密码不能同时作为同一种认证解释；按所选方法填写真实服务凭据。

控制台频道设置

控制台是本机聊天入口，机器人前缀及消息展示按当前智能体保存，不需要外部 Bot 账号。

工具防护与规则详情

工具防护页面展示规则类别与生效状态。查看已有规则或新建匹配规则时，分别核对规则名、检测范围和动作；本次未关闭保护或保存新的宽松规则。

文件防护技能扫描与主机名单

文件保护限制受保护路径操作，技能扫描检查导入内容，免认证主机名单影响访问边界。只为已确认的使用场景配置，不把名单当作连接故障的常规解决办法。

完整备份与选择性备份

先填写名称及说明，再选择完整或部分范围。工作区、全局配置、技能池与秘密数据各有独立选择；恢复前核对会覆盖的目标和需要保留的数据。截图没有执行备份恢复或删除。

Token 消耗趋势与活动

按时间与智能体查看请求、输入输出 Token 及活动。空数据表示演示环境没有相关任务，不表示真实运行成本恒为零。

调试日志与后台工具策略

调试页支持筛选、刷新和下载日志。后台工具策略决定耗时任务保持前台或转入后台；排错时结合进程面板检查实际状态。

工具和技能的区别

管理当前专家能力

1. 进入工具·技能，确认左上当前专家。工具视图中的 MCP 接入与平台内置分别复用主平台的 MCP 和内置工具管理。
2. 进入技能视图，在当前专家和技能库之间切换。技能库供选择分配，当前专家列表用于确认实际安装与启用状态。
3. 打开技能详情，阅读方法、来源和依赖；按界面提供的安装或技能池管理操作分配到目标专家。
4. 返回当前专家列表核对技能，并运行一个能够验证实际能力的小任务。

技能规模与分类

本次项目基线中，UGSci 领域组件 skills 目录含 55 个 SKILL.md，科研组件含 88 个 SKILL.md。两者是分开统计的目录数量，存在方法重叠；不表示每位专家默认拥有 143 个技能，也不表示依赖均已安装。

领域技能覆盖油气基础、勘探、钻完井、油藏与生产、测井、地震数据、数据分析、科学计算和工程协作。科研技能覆盖文献检索、写作、统计、可视化、数据库和研究方法，按实际任务选择。

使用市场与应用

1. 打开市场，切换到 UGSci 分区。旧 /ugsci-market 路由会转向 /market?tab=ugsci；原有截图可能显示较早的独立市场布局。
2. 根据任务搜索技能、MCP 或专家模板。查看来源、依赖、访问权限和安装目标。
3. 安装后检查当前专家配置；第三方资源的安装落点和启用步骤以具体资源类型为准，不能假设都自动启用。
4. 应用入口用于打开已安装的完整工作台；应用可能需要独立数据目录或外部账号，应按该应用说明配置。

能力验证

如果技能已显示但工具无法执行，检查依赖、工具启用状态和审批策略。不要通过重复安装技能替代修复缺失运行环境。移除技能或工具前核对是否有正在运行的任务依赖它。

应用插件技能与 UGSci 市场

扩展页面先选择资源类型，再选择已安装、官方、UGSci 或市场来源。安装前查看版本和依赖；发布入口会产生外部发布行为，本次仅展示已有页面。

当前智能体技能列表与详情

进入设置 技能，查看当前智能体已启用或安装的技能。详情查看内容与适用范围，关闭技能不会直接卸载其底层依赖。

创建添加与 URL 导入技能

新技能填写名称、Markdown 内容、适用频道、预加载、标签和配置。name 与 description 元信息必填。URL 导入须使用可信来源，预览并核对内容后再启用。

技能池检索编辑与分发

技能池可检索公共条目、编辑内容与标签，并选择目标智能体分发。截图以 well log analysis 为示例，没有执行覆盖或广播到个人智能体。

工具开关与网页搜索服务

工具列表按当前智能体提供的工具显示。网页搜索选择后端后，还需配置该后端要求的凭据。工具存在不代表依赖或网络已经可用。

MCP 服务总览

服务列表展示启用状态、传输类型和连接结果。检查失败信息时先核对地址或可执行路径，不要反复无条件重试。

HTTP 与 stdio 服务创建

HTTP 服务填写地址和请求头；stdio 服务填写命令、参数及环境变量。JSON 导入按界面支持的服务模式填写，先检查语法。

NeqSim 的 Java 启动配置

NeqSim 服务需要 Java、驱动与相应运行目录。截图为独立演示环境中的配置，绝对路径不是用户机器上的必填固定值。

MCP 工具访问与默认审批

分别管理匹配规则和默认动作。规则须对应调用来源、对象及工具，启用服务不会自动给予所有调用方权限。

ACP 智能体与运行环境

外部 ACP 智能体由命令及运行环境启动。填写 ID、命令、参数、环境变量、可信执行与会话设置；Node 运行环境需可实际启动该程序。

浏览与选择专家

1. 打开专家·协作，切换到专家标签。根据名称、描述或技能关键词搜索。
2. 打开专家卡片详情，检查模型、工作目录、技能、MCP、系统提示词和执行审批设置。卡片信息来自实际智能体配置。
3. 启用目标专家，点击召唤专家进入对话。在输入区描述目标、文件、单位、输出和完成条件。

创建和调整专家

点击创建专家，选取合适领域模板或按业务要求填写名称、描述与配置。项目提供油藏工程师、钻井工程师、测井分析师、采油工程师、地球物理专家和 PVT 分析师六类基础模板。模板是初始配置，实际职责和能力仍需检查。

给专家配置最少必要技能和工具，写明没有数据时不得编造结论，以及计算前必须检查单位和输入有效性。保存后用小型任务确认生效，不以卡片存在作为运行成功依据。

任务模板

目标：检查输入 LAS 的深度范围、曲线名称、单位、缺失值和异常段。
输入：当前工作区 inputs/well01.las。
边界：原文件只读，不做自动岩性解释。
输出：results/well01_qc.json 和可读的质量摘要。
验收：逐项列出发现的问题；不支持的检查明确说明。

完成判断

对话应明确实际读入的文件和使用的工具，并产生质量检查记录或输出文件。若只给出通用解释，应继续要求执行可用工具或说明为什么无法执行。

专业角色名称不代表特定资质，也不保证结论正确。工程报告应复核输入、假设、单位和计算结果；涉及生产或设计决策时按本单位程序审查。

智能体管理与原生创建

创建原生智能体时填写 ID、名称、描述和工作区，选择初始技能及邮箱等选项。不同智能体的文件与运行配置分开维护。

外部智能体创建

外部智能体依赖相应运行协议和环境；名称、连接与启动方式必须与实际程序一致。

UGSci 专家中心模板与角色详情

行业专家中心可从模板创建专家。部分模板卡片是快捷创建按钮，点击即建立专家，并非总会打开额外表单。角色详情包含专业描述和能力入口。

专家心跳与工作文件

专家配置页的心跳周期、活动时间和目标与其自身工作区关联。工作文件保存专业角色和日常说明，编辑前确认选择了正确专家。

专家技能 MCP 与运行参数

逐项核对当前专家的技能、外部工具、Shell、循环、重试、上下文和记忆后端。全局提供商配置仍需先在模型页面完成。

导入入口与资源范围

导入向导先扫描可用来源，再选择资源并确认冲突处理。采集环境仅展示来源入口，没有读取或导入个人 Codex 数据；后续实际资源选择页依个人环境而定。

选择协作模式

发起预设团队任务

1. 进入专家·协作的专家团标签，选择储层评价、钻井设计、开发方案评审或流体性质分析等预设团队。
2. 展开执行流程，确认团队模式、角色任务和控制专家。填入任务中的参数与文件路径。
3. 点击运行工作流。查看对话及进行中的讨论，核对是否进入规划、分派、验证、综合、完成五个阶段。
4. 在讨论历史检查运行状态和终止原因，打开最终成果；只有最终阶段和成果都满足要求才算完成。

创建自定义专家团

1. 点击创建专家团，填写名称、描述、任务模板，并选择六种模式之一。
2. 选择角色和可用专家，编写每位角色的职责、所需技能及允许工具；明确最终汇总者。
3. 按所选模式配置执行步骤、路由说明或评审成功标准与最大轮数，保存后用小型输入测试。
4. 团队由后端工作区存储。多窗口编辑出现版本冲突时重新加载并合并修改，不从过期窗口强行覆盖。

角色派发与失败处理

OMP 表示多专家编排工作流。专家团可以按角色派发子任务，部分角色由控制专家在运行时生成；是否需要固定实例取决于团队绑定设置与实际运行权限，不能沿用旧手册“缺少同名专家就一定无法运行”的判断。

角色工具隔离和结构化交接用于明确职责。失败时先查输入文件、模型连接、允许工具和终止原因；工作流的重试次数受配置限制，不保证自动排除所有错误。不要反复提交相同昂贵仿真任务。

评审任务示例

请以评审迭代方式检查单井递减报告。
执行专家：检查日期、单位和停产段，给出拟合结果。
评审专家：独立复算并检查参数和预测边界。
成功标准：数据来源、方法、参数、单位、残差与限制齐全。
最多两轮；仍有分歧时列出问题，不强行通过。

专家团列表与成员角色

专家团配置包含名称、描述、协作模式、成员角色和绑定策略。演示表单仅用于截图，没有执行专家团任务。固定工作流按当前实现支持的绑定方式运行，其他选项需核对该版本状态。

顺序 模式

按步骤串联成员，核对上一步产物是否满足下一步输入。 上下两屏同时记录公共配置和模式专有选项。

并行 模式

多个成员各自分析同一任务，随后汇总；核对每个成员任务范围与输出要求。 上下两屏同时记录公共配置和模式专有选项。

主管 模式

指定主管专家组织分工并整合结果，主管应有明确的调度与验收职责。 上下两屏同时记录公共配置和模式专有选项。

路由 模式

按角色说明和任务特征选择适合成员，角色描述直接影响路由判断。 上下两屏同时记录公共配置和模式专有选项。

评审 模式

执行者先产出方案，评审者按标准提出修改并核对最终状态。 上下两屏同时记录公共配置和模式专有选项。

论证 模式

成员围绕不同观点交流，设置轮数上限，最终保留分歧与依据。 上下两屏同时记录公共配置和模式专有选项。

专家团与固定流程的区别

专家团适合开放讨论和多角色协作；协作工作流适合明确规定输入、步骤、依赖和交付物的重复业务。固定流程仍需要可执行的专家实例和工具配置，保存草稿不等于完成运行验证。

生成与编辑流程

1. 在专家·协作中切换协作工作流，输入业务目标、文件字段、角色、执行顺序及验收要求。
2. 点击生成可编辑草稿或使用流程模板创建草稿。检查每个节点的专家绑定、输入输出和依赖。
3. 当前固定流程的专家节点优先使用已经创建并验证的固定实例。该页面列出的优先实例、模板派生和按健康/成本动态路由策略属于规划项，不应当作固定工作流已实现功能。
4. 保存草稿后以小型项目运行，检查节点状态、事件、失败原因及最终文件。通过测试后再复制到正式项目。

月度报告流程描述

目标：生成月度单井递减分析报告。
输入：production.csv，包含 date、oil_rate，注明日期与产量单位。
步骤：数据检查 → 油藏工程计算 → 独立复算 → 报告整理。
各节点使用已验证的固定专家。
验收：输入只读，输出到 results；包含参数表、图表、预测边界与未解决问题。

更新流程

改变输入字段、计算方法或专家配置后，应重新试运行。为正式项目保存流程版本、关键参数和输出清单，避免无法解释两次运行结果差异。

出现节点失败时从日志确定失败阶段，先修正该节点依赖，再决定重试。对会产生文件或外部计算的节点，应核对之前是否已经成功执行。

模板库与我的工作流

模板库显示适用任务及步骤，我的工作流管理本地草稿。采集版本的创建草稿入口出现参数校验错误，因此未提供伪造的成功草稿截图；可从流程编辑器单独新建。

新建流程与画布操作

新建流程填写唯一 ID。画布左侧为节点工具箱，中间为节点与连线；支持缩放、适配视图、节点对齐和分布。示例流程只用于配置演示，未执行模型调用。

1. 新建工作流。
2. 单击工具箱节点添加到画布。
3. 单击节点打开属性，核对类型和输入。
4. 连接节点，配置输入输出并验证。
5. 保存通过验证的流程后再运行。

工作流输入输出定义

定义输入名称、类型与默认值，选择起始节点及输出节点 ID。连线和节点字段引用的 ID 应真实存在。

输入 节点

从工作流输入读取变量。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

输出 节点

向工作流外发布结果。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

专家执行 节点

按 agent_id、query 和 context 调用专家。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

工具调用 节点

执行已注册工具，参数必须匹配工具模式。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

模型调用 节点

通过当前已配置的模型服务处理 prompt 与 system。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

代码 节点

执行代码片段；复杂工程代码使用项目编码节点。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

条件分支 节点

按条件数组路由到首个匹配分支，否则进入 else_node。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

并行分支 节点

建立多个分支及合并路径。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

等待 节点

暂停指定秒数，运行期间可接受取消检查。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

错误处理 节点

记录失败并按配置执行恢复操作。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

子工作流 节点

按 flow_id 调用其他流程并传递 inputs。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

受限脚本 节点

在受限环境执行短 Python 代码，通过 result 返回值。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

脚本智能体 节点

迭代调用可用工具完成单会话计算与文件生成。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

项目编码智能体 节点

围绕 project_path 实施文件修改、构建和验证。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

数据转换 节点

对工作流状态执行模板表达式。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

人工复核 节点

使流程等待外部批准或拒绝；等待状态不是完成状态。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

质量门槛 节点

按 score、threshold 和 criteria 路由到通过或失败节点。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

迭代修正 节点

达到最大次数后进入 exhausted_node，防止无限修正。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

产物预览 节点

显示媒体产物的类型、尺寸、文件名及下载入口。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

控制智能体 节点

用于生成参数、调整状态与路由，不运行完整工具循环。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

图片加载 节点

读取本地图片为后续节点提供媒体对象。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

三维网格加载 节点

读取支持的 GLB、GLTF 或 OBJ 三维文件。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

产物打包导出 节点

将已生成产物及导入元信息打包到指定目标格式。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

开始 节点

标记流程入口与下一节点。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

结束 节点

标记流程终止并发布需要的输出。 公共执行控制包含重试、延迟、输出变量、正常后续节点和错误处理。输入项旁的星号表示必填。

注册工具调用节点

工具箱中存在同名的 Tool Call 入口，注册执行器版本的输入模式应按当前面板填写，不能直接套用另一版本的字段。

注册模型调用节点

工具箱中同名 LLM Call 的注册执行器版本单独展示。字段以选中的具体类型为准，模型和生成参数仍应符合实际服务协议。

检查引擎

1. 打开工具·技能的引擎视图，按仿真软件、领域计算和运行服务查看配置。
2. 点击自动检测，读取软件名称、版本、路径与状态。检测依赖常见安装路径和可执行文件线索。
3. 非标准安装位置使用添加引擎或配置入口补充实际路径、分类和调用信息。保存后重新检测。
4. 运行前单独检查许可证、工作目录、模型输入、配套文件和读写权限；先做只读检查或小模型测试。

支持条件

项目含 CMG、Eclipse、Intersect、tNavigator、COMSOL 等调用适配器，也维护 Petrel、Techlog、PIPESIM、OFM 等软件检测定义。列在检测清单中的软件不一定具有可直接执行的 UGSci 适配器。

COMSOL 批处理依赖实际软件与许可证，结果读取可能使用模型关联导出或 CSV。容器环境下无法自动访问宿主机所有安装目录和许可证；需要单独配置可访问的运行方式。

领域计算引擎提供确定性工程计算及可选科学计算库。SymPy、SciPy、PyMC 等适配器依赖相应库；NeqSim 还需要其运行环境和 Driver 连接就绪。软件应对依赖缺失返回明确错误，不使用虚构计算结果替代。

接入 MCP

1. 在工具视图的 MCP 接入中新增服务，按服务说明选择 stdio、SSE 或 Streamable HTTP 传输。
2. 本地 stdio 服务填写真实启动命令与参数，远程服务填写 URL 和必要认证。保存后检查连接与工具列表。
3. 仅向需要的专家开放服务和工具，按服务要求完成 OAuth 或访问策略设置。
4. 先执行不会修改外部数据的查询，核对返回结果及连接日志；通过后再用于正式任务。

ACP 运行服务

运行服务分类可嵌入主平台的 ACP 配置，用于连接外部 Agent runner。按当前界面创建、编辑或选择 runner，并进行配置校验；它与本地仿真求解器是不同类型的运行能力。

专业引擎总览与新增

注册求解器名称、厂商、版本、执行程序、安装目录、分类、说明、调用方式和许可证服务器。注册记录不等于已安装许可证。

CMG 详情与完整编辑表单

编辑执行路径和许可证配置，核对版本与调用方式。完整上下屏说明公共表单；下方其他引擎使用同类字段。

COMSOL Eclipse Intersect 与 tNavigator

分别检查每个商业引擎的路径、版本及授权条件。存在注册入口或检测结果不代表本次已运行完整数值算例。

领域计算引擎与库依赖总览

列表区分已就绪、需要配置、缺少依赖与待安装。按目标领域配置科学库；不应一次安装所有可选依赖。

储气库确定性工具

查看逐层库存、库容边界、配注配产、方案比较及审计工具的操作入口。单位与压力口径先核对，输出按待复核建议使用。

运行时服务与工具中心

区分当前专家的 MCP 服务、内置工具、运行时与技能目录，检查真正可调用的项目。

测井数据处理 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

递减分析 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

油气确定性计算内核 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

储层三维可视化 未知 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

PVT 与流体热力学 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

符号多项式计算 未配置 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

贝叶斯参数估计 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

多目标优化 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

离散事件队列仿真 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

图与网络分析 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

地理空间点集分析 未配置 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

机器学习回归 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

统计回归分析 依赖与操作

详情列出实现来源、版本、操作和依赖条件。按页面提示准备运行环境后刷新状态；未配置或缺少依赖的状态不表示计算失败或计算已通过。

入口与用途

在工作台打开“储气库动态”。该页面围绕储气库生产动态组织数据与分析；静态库存和库容评价方法见同模块的储气库评价章节。

本节依据 2026 年 10 月 16 日项目中的页面结构补充入口说明，既有图解仍按其采集日期标注。

按分析顺序阅读

准备评价输入

储气库评价应先确定评价周期、注气末状态、后续采气评价状态和层系划分。所有气量采用一致的标准状态与体积单位；同一层系的两个压力状态必须采用同一种明确声明的压力口径。

有效库存支持 absolute、apparent_formation 和 report_defined 三种压力口径声明。报告使用视地层压力时，应按该报告口径输入；系统不应悄悄改称绝压或混用口径。Z 因子、采气量和压力必须对应同一层系与采气段。

账面库存和有效库存

执行综合库存评价

1. 选择已启用储气库评价工具的专家，提交各层采气量、注气末压力/Z、评价压力/Z，以及评价周期和状态标识。
2. 提供账面库存，或提供期初库存和同期注采量；按工具契约选择一种账面库存输入方式。补充设计库容、垫底气和冲峰指标所需数据。
3. 请求调用综合库存评价入口 ugsci_storage_inventory_evaluate。该入口一次给出有效库存和评价指标，无需先重复调用全部分项工具。
4. 查看逐层结果、汇总指标、告警、方法、单位、输入指纹和待复核状态；保存结果后安排独立复核。

公式与稳定性

账面库存按 Gr = G0 + 累计注气量 − 累计采气量计算。分层有效库存按 Grm = Qp × (Pin/Zin) ÷ [(Pin/Zin) − (P/Z)] 计算，然后逐层求和。不能以账面库存减垫底气或全库平均压力替代分层有效库存公式。

需要 Qp > 0、正且有限的压力与 Z 因子，并满足 Pin/Zin > P/Z。p/Z 差值接近零时结果不稳定，工具按数值和工程阈值告警或拒绝；Grm/Qp 大于 20 时告警，大于 100 时拒绝。这个比值是撤采比例倒数的筛选代理，不是完整误差传播倍数。

库容筛选

库容评价工具按分层连通孔隙体积、最大/最小运行压力、对应 Z 因子、地层温度和标准状态筛选总库容、垫底气与工作气量。应先明确压力上下限与孔隙体积来源。

库存和库容工具固定输出待复核计算建议。工具不负责写入已批准状态；正式设计需结合地质、PVT、数值模拟和井筒能力复核。

练习提问

请先核查储气库库存评价输入，不做批准判断。
评价周期：cycle-01；层系分别计算。
请列出每层采气量、两状态压力与Z因子、压力口径和气量单位是否齐全。
缺字段时停止并列出缺项；齐全后调用综合库存评价，保存结果、告警和输入指纹。

井组配注与配产

配注和配产工具按可用井的最小/最大运行量及优先级权重分配目标量。先满足最小运行量，再按权重分配剩余需求，直到达到单井上限。不可用井不参与分配。

输入包括井或井组名称、最大能力、可选最小能力、权重和可用状态，以及本次目标量和统一单位。权重是分配偏好，不代表自动学习到的井组效益或安全等级。

操作步骤

1. 整理井组能力表，排除检修或不可用井，核对上下限和目标量采用同一日率单位。
2. 选择配注或配产工具，声明目标量和权重来源，提交结构化参数。
3. 检查总分配量、未满足量或超供量、单井利用率和 feasible 状态。目标超出能力时可能返回可执行部分和不可行标识；require_feasible 可要求直接拒绝不可行输入。
4. 将候选方案与井筒、管网和数模约束联合复核后，另行形成业务计划。

多方案比较

方案比较入口接受候选方案的标量指标、目标方向与权重、以及 <=、>= 或 == 约束。系统先筛除不满足约束的候选，再用本次集合的目标范围归一化并计算加权排序，同时识别 Pareto 非支配前沿。

可行方案少于三个、没有可行方案或指标缺失时，应检查告警。排名是本次输入集合内的相对比较；改变候选集合或权重可能改变排名，不是连续空间中的全局最优证明。

适用边界

上述工具用于早期工程筛选，不自动推断井间压力干扰、管网水力、瞬态或非均质性，也不会自动批准或写回生产模型。正式计划应结合耦合数模、敏感性和不确定性分析。

练习提问

请用配注工具做候选分配，单位均为 10^4 sm3/d。
目标总量：90。井A：最小10、最大50、权重2；井B：最小5、最大30、权重1；井C：不可用。
输出每井分配、总量、缺口、可行性和算法说明；标记待复核，不形成批准计划。

可用计算入口

执行方法

1. 明确要求使用哪个计算工具，给出全部必填数值、单位、数据来源和适用假设。
2. 先做输入检查，遇到缺失、非有限数、错误单位或超出范围的参数时停止并修正。
3. 执行计算后核对返回的方法、单位、告警、provider/engine 版本和输入指纹；不能只保存最后一个数值。
4. 保存参数和结果，安排独立复算；非确定性统计计算还应保存随机种子和采样配置等可用信息。

可选科学库

项目声明多项式求根、贝叶斯正态均值估计、多目标二次优化、队列仿真、图网络与空间点集分析、机器学习线性回归和统计 OLS 回归等工具。各入口提供有限范围的类型化计算，不等于覆盖整个库的全部功能。

依赖缺失时应安装团队支持的环境或选择可用替代方法。NeqSim 的闪蒸、PVT、相包络、流程模拟和多相管流通过内置 Driver 调用，需检查 NeqSim runtime 和当前工作区 Driver 是否就绪。

单位换算练习

请用 UGSci 工程单位换算工具，将 10 MPa 换算为 bar。
列出输入单位、输出单位、转换方法和结果。
不要用语言模型估计代替工具计算。

方法限制

经验 PVT、物质平衡和节点分析都依赖各自假设。油藏或储气库实际条件不满足假设时，应改用更合适模型并重新验证；软件提供计算路径和证据，不自动选择全部工程前提。

LAS 测井质量检查

1. 将 LAS 文件放入当前工作区，选择测井分析师并启用读取、校验工具。
2. 先调用读取工具，查看井名、深度范围、曲线列表、单位和缺失值标记。
3. 调用质量校验工具，检查深度序列、曲线和数据异常。不得将有效的缺失值标记当作物性数值。
4. 需要规范化导出时，指定新文件路径并说明处理规则；保留原文件。核对导出文件可以再次读取。

Arps 递减拟合与预测

1. 整理时间与产量数据，注明时间单位、产量单位和停产/措施调整情况。确定适合递减分析的阶段。
2. 使用 ugsci_decline_fit 拟合适用模型，记录初始产量、递减率、b 参数及拟合误差。
3. 调用预测工具时明确预测时间范围、时间口径和参数来源。计算 EUR 时补充相应终止条件或经济界限，避免无边界外推。
4. 比较拟合曲线与观测数据，检查残差和异常段，并让另一专家复算关键参数。

文件准备规范

分析任务示例

读取 inputs/production.csv，先检查时间顺序、缺失和单位。
仅对连续递减阶段进行 Arps 拟合，记录所选模型与参数。
预测未来12个月，并说明经济界限和时间单位；如果输入不足则停止。
输出参数表、拟合与预测图、残差说明，并独立复核。

完成标准

LAS 检查应给出实际文件、问题清单和处理结果。递减分析应有可复算参数、误差、预测范围和限制。图像平滑或数字精确不代表模型假设已经成立。

使用内置推导公式

1. 让专家调用公式目录工具，查看支持逐步追踪的公式标识、变量定义及单位。
2. 确认公式与业务口径一致，提供完整变量数值；调用 ugsci_trace_calculation。
3. 查看逐步符号表达、变量绑定、数值计算和有效性判断；核对每一步与原输入是否一致。
4. 保存公式版本、输入指纹、结果及可用的 replay_token，作为复算依据。

自由公式操作

自由公式默认关闭，需要管理员在 GenUI 设置中启用相应开关，并确认 SymPy 等依赖和复杂度限制。启用后支持预检、符号重排与求解、数值代入，以及替换、化简、展开、收集和求解等变换。先做 formula_preview 检查语法、符号和复杂度，再请求 derive、evaluate 或 transform。

推导展示记录的是可检查的数学步骤，不是模型内部思维过程，也不自动证明用户输入方程符合真实物理系统。变量单位、适用域和边界条件需要用户与专家明确。

重放与版本差异

ugsci_replay_calculation 验证签名重放令牌后重跑支持的内置公式，比较输入指纹与引擎、提供者版本。返回 reproducible 或 version_changed 等状态及差异信息。

令牌可能因签名环境缺失无法生成，也可能因密钥变化或格式错误无法验证。重放能力限于支持的计算路径，不意味着任意历史聊天、仿真或自由公式都可通过同一令牌复现。

练习提问

先列出可追踪的 UGS 公式。选择适合我数据的一项，解释变量与单位。
先预检完整性；输入不齐时不要计算。
执行后展示逐步代入、有效性判断、版本、输入指纹及可用重放令牌。

输入准备与启动

1. 在当前工作区准备仿真输入及全部 include/伴随文件，确认求解器路径、许可证、工作目录和输出目录。
2. 要求专家只读检查输入文件、版本和运行参数。需要修改 deck 时使用副本，并记录修改项。
3. 确认正式计算条件后调用 launch_simulation，保存任务标识及输出路径。工具启动成功只表示任务已提交或进程已启动。
4. 使用 check_simulation_status 或 wait_for_simulation 跟踪状态、日志与收敛。不要重复启动同一任务来询问进展。

结果读取与分析

1. 确认任务终态、进程退出信息和产物是否存在。完成状态还需与日志和实际输出互相核对。
2. 使用 read_simulation_results 读取支持的汇总数据，再用 analyze_simulation 检查收敛、平衡、性能或方案对比。
3. 需要三维展示时，将实际输出交给油气可视化的相应读取器，并保留网格及动态伴随文件。
4. 归档输入副本、求解器版本、参数、任务记录、日志和主要结果。

失败和取消

常见失败来自许可证、路径、缺失 include、格式版本或收敛问题。先读取具体错误，再决定修正和重试。停止聊天或 /stop 不应被假定为一定终止外部求解器，应确认任务状态和实际进程。

若运行中心组件已安装，可以按其任务入口查看队列、取消、重试和运行事件；是否可用取决于组件启用与实际 operation 注册。UGSci 的仿真与计算工具本身不替代专业软件许可证。

提问模板

请先只读检查本项目仿真输入、求解器路径、许可证配置和输出目录。
列出检查结果与缺失项，不启动。
确认就绪后启动一次，保留任务标识；跟踪日志与收敛，完成后读取结果并说明告警。

运行中心四种视图

运行、模型、研究和比较分别管理任务记录、模型版本、Study 及多方案指标。没有注册模型或运行任务时，条件相关按钮禁用，截图保留这种状态。

入口与数据导入

油气可视化入口为 /oilgas-visualization，也可由专家调用工具打开指定数据集，或从工作区关联文件进入对应查看器。数据先经读取与转换，再加载到场景，文件关联存在不代表任何同后缀文件都能成功解析。

项目注册 EGRID/GRID/GRDECL、INIT/UNRST、ROFF、CMG DAT/SR3/IRF、tNavigator 关联数据、LAS/DLIS、VTK 等数据入口，具体支持取决于文件变体、伴随文件和依赖。部分商业二进制或大模型需要相应库及可导出的中间格式。

查看场景

1. 准备源文件和必要的网格、属性或井信息伴随文件，调用 import_subsurface_dataset。记录返回的数据集 ID 与导入状态。
2. 打开数据集，检查网格尺寸、坐标、单位、活动单元及可用属性。与输入摘要对照，避免坐标或层位错位。
3. 切换孔隙度、渗透率、岩相等实际存在的属性。若数据集含动态属性，选择对应时间步；静态数据不会凭空生成动态属性。
4. 根据需要调整色图、透明度、线框及相机，聚焦井、网格单元或管段。

剖面 筛选和报告

可用工具包括按 I/J/K 提取切片、沿折线生成剖面、沿井轨迹生成井剖面，以及按属性、索引或空间范围筛选场景。执行后查询命令状态，确认实际成功；文本回复不能代替场景变更确认。

截图工具保存当前可视化场景；统计报告工具生成当前数据集属性分析报告，并可保存到工作区 JSON 文件。分享截图时同时注明数据集、属性、单位、时间步和筛选条件。

操作提问

导入当前项目的网格和伴随属性文件，返回数据集ID。
打开场景并列出真实可用属性；切换到孔隙度。
按实际网格范围提取K层切片，查询命令执行状态。
保存当前截图和属性统计JSON，记录色标、单位、时间步和筛选条件。

故障处理

无法导入时检查格式变体、文件读权限、同目录伴随文件及可选读取库。只有时间步列表真实存在时才使用时间切换。场景空白时先检查活动单元、可见图层、相机位置、坐标尺度及浏览器 WebGL 能力。

大数据集先在副本中选择代表性属性、时间步或较小模型测试。不要把浏览器加载成功解释为数据已完整或工程解释已正确。