前言¶
在化工流程模拟里，HYSYS 的 GUI 手工操作有两类成本很高：一是重复性建模，一个装置动辄几十上百个模块，改一次工况就要重新点一遍；二是结果不可复现，手点的过程无法脚本化，别人接手只能从头再来。
另一种做法是直接写 COM 调用，但 HYSYS 的类型名、端口编号、单位体系和错误码散落在各处，第一次接的人往往卡在「连不上实例」这一步。
下面介绍的这个 Skill 把这条路趟平了：它用 Python（pywin32 走 COM）驱动 Aspen HYSYS V11.0，把连接、建模、求解、复核封装成可重复调用的脚本，并在真机上逐节点实测过。
这是什么¶
一句话定位：面向 Aspen HYSYS 的自动化脚本集，让你用 Python 而不是鼠标，完成化工流程的搭建、修改、求解和结果复核。
- 出品与坐标：SkillHub 上由 user_6eed38f8 发布维护，坐标 @user_6eed38f8/aspen-hsysy-automation，来源标注为 community。
- 版本：2.3.0，分类 professional，标签 requires_api_key=false（不需要 API Key）。
- 定位区别：它不是替代 HYSYS 的模拟器，也不是一个通用 COM 封装库，而是把「哪些模块能自动建、塔怎么搭才收敛、哪些地方必须手工干预」这些经验固化成了脚本和参考文档。
核心能力¶
按功能分节，以下均为官方简介中列出的能力。
连接与工况管理¶
覆盖 HYSYS 实例的连接与管理、已有工况的打开、以及从空白开始创建新工况、单位体系设置、求解控制、保存与导出。
新机器上的第一步不是写业务代码，而是先确认安装路径和可用的 ProgID——这一步单独放在了 scripts/hysys_discovery.py 里。
组分、物性包与物流¶
支持组分录入、物性包选择（references/property_methods.md 讲选型），以及物流与能量流的建立和连接。原油评价相关流程另有 references/crude_petroleum.md。
常规单元操作¶
用 scripts/basic_modules.py 做「一句话搭模块」，覆盖的模块类型包括：
- 混合器、三通、闪蒸、三相分离
- 加热、冷却、换热器
- 泵、压缩机、膨胀机、阀、管段
- 组分分流器
- 各类反应器
逻辑单元¶
Recycle（循环）、Set、Adjust、Balance、Spreadsheet 这类逻辑单元也纳入覆盖范围，用于处理流程中的循环与参数调节。
严格塔从零搭建¶
精馏、吸收、萃取三类严格塔都可以从零搭建。V2.3.0 给出的是一套「四道坎配方」，对应严格塔收敛中最常卡住的地方：
CanSolve判据：判断塔当前是否真的可解。- 进料级重接：进料位置不对导致不收敛时的重接处理。
LoadColumnTemplate重试：模板加载失败时的重试策略。- 全凝器与规格数：全凝器工况与规格数值的对应关系。
官方简介称，按这套配方已经能逐位复现 GUI 手工做出的工况。相关细节在 references/columns.md。
简捷塔（Shortcut Column）¶
这是 V2.3.0 明确写出的能力边界部分。简捷塔走的是 shdistop 这条路，文档给出的是「三层证据」，用来说明哪些行为可靠、哪些不可靠，并给出「骨架继承」路线——即先用简捷塔搭骨架、再转严格塔复核的做法。
要提醒的是：简捷塔的结论是能力边界，不是无条件可用。用之前先读证据层，别假设它能替代严格塔。
反应器与反应集¶
支持转化反应器、动力学 PFR，以及反应集（reaction set）输入。反应器参数组织方式和动力学计算细节见 references/reactors.md。
结果读取与导出¶
求解完成后可以读取结果并导出，用于后续复核或对接其他脚本。scripts/hysys_client.py 中提供了 force_run（强制求解）和 default_output_dir（默认输出目录）两个封装项。
核心资产与目录¶
这个 Skill 的价值主要在四个脚本和七份参考文档里。
脚本放在 scripts/：
scripts/hysys_client.py 连接 / 工况 / 单位 / 求解 / 保存封装，含 force_run 与 default_output_dir
scripts/basic_modules.py 一句话搭模块
scripts/column_specs.py 列规格 + 反应器/反应集工具 + 目标值连续化
scripts/hysys_discovery.py 新机器先跑：定位安装路径与可用 ProgID
参考文档放在 references/：
references/v11_com_recipes.md COM 类型名全表 / 端口 / 单位 / 错误码
references/columns.md 塔（严格塔 + 简捷塔）
references/reactors.md 反应器与反应集
references/property_methods.md 物性包选型
references/crude_petroleum.md 原油评价
references/tutorial_cases.md 35 例对照
references/verified_cases.md 35 例跑通记录
references/changelog.md 逐版本证据档案
两份 35 例文档的作用不同：tutorial_cases.md 是操作对照，verified_cases.md 是跑通记录。改脚本前先看后者，确认你要动的路径有人实测过。
启用方式¶
官方抓取到的资料里没有给出具体的安装命令或配置字段，因此这里不写未经核实的命令。可确认的信息如下：
- Skill 采用通用 SKILL.md 格式，在支持该格式的 Agent 环境（Cursor / Codex CLI / Claude Code 等）中加载本 Skill 目录即可使用。
- 标签 requires_api_key=false，不需要配置 API Key。
- 运行前提：本机已安装 Aspen HYSYS V11.0，Python 环境可用 pywin32，且 HYSYS 的 COM 组件可被正常注册。首次在新机器上使用时，先执行
scripts/hysys_discovery.py确认路径与 ProgID。
各环境具体加载方式请以你所用 Agent 的 Skill 加载说明为准；本节不含未核实的安装命令。
典型用法¶
按官方资料给出的资产组织，一次完整流程建议这样走：
- 环境确认：跑
scripts/hysys_discovery.py，确认 HYSYS 安装路径和可用 ProgID。这一步失败的话，后面的连接都会失败。 - 建立连接：用
scripts/hysys_client.py完成连接，打开已有工况或从零创建新工况，设置单位体系。 - 搭模块：用
scripts/basic_modules.py建立物流、能量流和常规单元操作；需要塔规格、反应器或反应集输入时用scripts/column_specs.py。 - 求解：调用求解封装，必要时用
force_run强制求解，输出目录由default_output_dir控制。 - 复核：读取结果并导出，对照
references/tutorial_cases.md与references/verified_cases.md检查是否与预期一致。
严格塔的搭建不要跳过 references/columns.md，V2.3.0 的四道坎配方就在那里。简捷塔同理，先读能力边界三层证据再动手。
适用场景与注意¶
适合的场景：
- 需要在 HYSYS 中批量建模或批量改工况，GUI 手工操作重复成本高。
- 需要把流程模拟纳入可复现、可版本管理的流程里。
- 需要严格塔从零搭建，且希望按已验证的配方避坑。
需要留意的限制：
- 运行环境是 Windows + HYSYS V11.0 COM，跨平台或 HYSYS 其他版本未在资料中声明支持。
- 简捷塔是能力边界明确的工具，不能无条件替代严格塔。
- 版本变更带来的差异要看
references/changelog.md，官方按版本归档了证据。 - 官方页面给出的评分 100000、下载 1705、安装 0（接口返回值，抓取于 2026-10-30）。安装数为 0 与评分、下载数并存，说明这些指标只能作为参考，不代表实际使用规模。
结尾¶
这个 Skill 的价值在于把 HYSYS 自动化里最容易卡住的部分（连接、塔的收敛、简捷塔的边界、反应器输入）整理成了脚本和带证据的文档，而不是一个笼统的 COM 封装。如果你的工作涉及化工流程模拟、精馏塔搭建或 HYSYS 批量工况复核，值得先跑一遍 hysys_discovery.py，再按官方参考文档走。
官方地址：https://api.skillhub.cn/user_6eed38f8/aspen-hsysy-automation
页面地址：https://www.skillhub.cn/skills/user_6eed38f8/aspen-hsysy-automation
