PHAST-SAFETI二次开发教程02环境与许可——安装、Veracity 授权、Knowledge Centre 与版本档案版本声明块工具与软件Phast™ 与 Safeti™ 的版本主线为 9.x历史锚点版本为 8.464 位架构、8.6CFD 池火、8.7CFD 射流火与 8.x埋地管道、火球。具体版本号一律以官方 Knowledge Centre 的发布说明为准。语言与环境官方 Python 库 PyPWS 要求 Python 3.11 及以上官方 API 客户端形态为 Excel、Python、.NET 与 TypeScript 四种。本文目标把装得上、授权通、版本对得上、令牌管得住这四件事一次做对并交付一套可复用的环境自检脚本。一句话结论二次开发的环境地基由四块砖构成——安装介质与发布说明统一走官方 Knowledge Centre商用授权走 Veracity 商店按 Individual 或 Network 形态、以订阅、租赁或永久方式购买Phast API 调用依赖官方发放的访问令牌而所有版本号必须落进你的项目档案并以官方发布说明为唯一判据这四件事各有对应的自检动作任何一块含糊都会在后续脚本里变成难查的故障。〇、本篇要解决的认知问题Q1Phast™ 与 Safeti™ 的许可形态有哪些为什么安装前必须先问清授权类型Q2软件从哪买、从哪下、发布说明在哪看为什么客户门户这个词现在不该再用Q3Phast API 一定要访问令牌吗令牌应该怎么放、怎么轮换Q4为什么本系列反复强调版本先声明版本档案在项目里具体长什么样Q5除了文档官方还有哪些可以学的资源培训、网络研讨会、用户会议一、机制解析1.1 许可形态先问清谁的许可、怎么算钱Phast™ 与 Safeti™ 是商业闭源软件任何二次开发都建立在合法授权之上。授权决策要回答三个正交问题问题常见选项对二次开发的影响授权对象Individual单机绑定脚本运行的那台机器必须是授权机器授权对象Network网络浮动多台机器/CI 节点可竞争使用许可适合批处理农场付费模式订阅 / 租赁 / 永久决定你的自动化流水线能持续多久、续期节奏如何授权期限短至 1 天、长至 3 年短期授权适合培训与冲刺项目不宜承载长期流水线为什么必须先问清这直接决定架构。若你规划一个跑在服务器上的批量流水线却只买了 Individual 单机授权脚本在服务器上会因找不到授权而失败——这不是代码问题是授权形态问题改代码永远改不好。1.2 渠道Veracity 商店与 Knowledge Centre 各管什么官方把交易和资料分成了两处务必分清事务官方入口说明购买/订阅/续期Veracity 商店如 https://store.veracity.com/phast商业交易与授权凭证安装介质下载Knowledge Centre 软件下载页官方安装包发布说明Knowledge Centre 发布说明页版本变更的唯一权威判据技术文档与用户手册Knowledge Centre 技术文档、用户手册页建模细节、数据层次定义视频与网络研讨会Knowledge Centre 网络研讨会页含 Phast API 专题、9.1 概览、Phast 到 Safeti 过渡等经验法则把 Knowledge Centre 当作唯一书架收藏夹里的第一条。该站的帮助资源历史上曾以客户门户的名义被提及如今统一由 Knowledge Centre 承载——在项目文档里请统一写 Knowledge Centre不要再写旧称否则新人会找不到入口。1.3 令牌API 通道的入场券Phast API / Phast Web Services 是托管服务形态的接口门户 https://phastwebservices.dnv.com/ 计算端点形如https://phastwebservices.dnv.com/api/analytics/v1/。调用它需要向 DNV 获取访问令牌access token。这带来三条工程纪律令牌不进代码。它等价于账号凭证写进脚本就等于写进版本库铁律 5。令牌会过期。设计流水线时必须把令牌续期/轮换当成一个正常运维动作而不是事故。令牌有权限范围。若某类计算被拒绝先怀疑授权范围与令牌有效期再怀疑代码。铁律 5令牌与许可不硬编码access token 与许可信息不得写入脚本或仓库一律走环境变量或密钥管理服务。这条铁律在 16~20 篇的实战里会被反复引用但纪律必须在第 02 篇就立起来因为坏习惯一旦形成就很难改。1.4 版本档案把以发布说明为准落到文件上官方发布节奏以主线 9.x 历史 8.x的形式演进同一功能在不同小版本可能变化。因此你的项目里必须有一个明确记录版本的地方。最小可用的版本档案应包含五项project_versions.md建议放在仓库根目录 ------------------------------------------ [产品版本] Phast(TM) 9.x / Safeti(TM) 9.x —— 取值来源Knowledge Centre 发布说明 客户端关于页 [API 目标] https://phastwebservices.dnv.com/api/analytics/v1/ —— 取值来源getAnalyticsApiTarget() [Python ] 3.11 —— 取值来源python --version官方 PyPWS 要求 [PyPWS ] 4.2.25 或本项目锁定版本 —— 取值来源pip show pypws [记录时间] 2026-09-23 —— 每次升级产品、API 构建或 PyPWS 后更新本行铁律 1版本先声明每篇教程都标注适用版本差异处必须点明。在项目里这条铁律的落地形式就是上面这个文件——它让三个月后结果对不上这类问题从玄学变成可查的差分。1.5 学习资源把官方材料用足除文档站外官方还提供 Phast/Safeti/KFX 培训课程、Knowledge Centre 上的网络研讨会录像含Ask the experts - Phast API专题以及面向用户的用户会议议程常含 Phast API 与 CFD 主题。建议把网络研讨会当作 API 变更的第一手来源——它比二手博客可靠得多。二、完整操作与脚本/API 代码逐段剖析2.1 安装与授权核对操作步骤清单步骤 1 登录 Veracity 商店确认本项目的授权形态Individual 还是 Network、付费模式与到期日 步骤 2 打开 Knowledge Centre 的软件下载页下载与授权匹配的 Phast(TM)/Safeti(TM) 安装包 步骤 3 安装并首次启动在关于或标题栏确认显示的版本号例如 9.x 主线 步骤 4 打开 Knowledge Centre 的发布说明页记录你实际安装版本的变更点尤其影响接口与结果的 步骤 5 在安装目录/帮助菜单中找到用户手册入口核对 Study Folder / Study / Scenario 的官方定义 步骤 6 若为 Network 授权确认许可服务器地址已配置并在一台非开发机上试跑验证能否取到许可 步骤 7 若要走 API 通道向 DNV 申请访问令牌确认有效期限与权限范围 步骤 8 把令牌写入本机环境变量不要写进任何文件记录轮换计划 步骤 9 安装 Python 3.11 与 pypws运行本篇的自检脚本把结果归档进版本档案 步骤 10 把上述信息填进 project_versions.md提交进仓库令牌除外2.2 环境自检脚本PowerShell第一道自检在操作系统层完成解释器版本、包版本、令牌变量、网络可达性。# env_check.ps1 —— 二次开发环境自检Windows PowerShell# 用法powershell -ExecutionPolicy Bypass -File env_check.ps1# 1) 解释器版本官方 PyPWS 要求 Python 3.11 及以上python--version# 打印形如 Python 3.11.x低于 3.11 直接不满足官方要求# 2) 官方 Python 库是否已安装及其版本pip show pypws# 关注 Name/Version/Location 三行Location 用于确认装进了哪个环境# 3) 访问令牌是否已配置只判断“有没有”绝不回显内容if($env:PHAST_API_TOKEN){# 环境变量存在即为真Write-OutputPHAST_API_TOKEN: 已配置长度$($env:PHAST_API_TOKEN.Length)字符}else{Write-OutputPHAST_API_TOKEN: 未配置 —— 通道 B 将无法调用见铁律 5}# 4) 官方托管端点可达性只做连通性判断不提交任何业务请求try{$rInvoke-WebRequest-Urihttps://phastwebservices.dnv.com/-MethodHead-TimeoutSec15Write-OutputPhast Web Services 门户可达HTTP 状态:$($r.StatusCode)}catch{Write-OutputPhast Web Services 门户不可达请检查代理/防火墙策略$($_.Exception.Message)}逐行要点python --version与pip show pypws必须在同一个虚拟环境里执行多版本 Python 共存时装上了却导不进几乎都是环境错位令牌检查只输出长度不输出内容是为了让日志可安全归档连通性用HEAD请求避免在自检阶段产生任何计算类调用。2.3 API 目标与授权自检Python第二道自检在 Python 层完成确认脚本侧到底会调用谁。# api_check.py —— 通道 B 的接口目标与授权状态自检只读不产生业务计算importos# 读环境变量避免硬编码令牌frompypws.utilitiesimportgetAnalyticsApiTarget# 官方工具函数返回当前 API 调用目标defmain()-None:targetgetAnalyticsApiTarget()# 打印脚本真实要调用的地址print(f[1] Phast API 目标:{target})expectedphastwebservices.dnv.com# 期望的官方域名片段okexpectedinstr(target)# 用域名片段做粗判防止被代理指到别处print(f[2] 目标是否为官方托管端点:{ok})ifnotok:# 不匹配时给出明确指引而不是静默继续print( 请检查代理、PAC 脚本或 pypws 配置务必回到官方门户核对)tokenos.environ.get(PHAST_API_TOKEN,)# 只从环境变量取铁律 5print(f[3] 访问令牌是否已配置:{bool(token)})print(f[4] 令牌长度:{len(token)})# 打印长度便于判断是否被截断仍不回显内容base_envos.environ.get(PYPWS_BASE_URL,)# 部分部署会通过环境变量覆盖基址print(f[5] 自定义基址是否设置:{bool(base_env)})if__name____main__:main()# 输出五项结论直接抄进项目版本档案逐行要点getAnalyticsApiTarget()是本篇唯一的官方接口调用属于诊断类工具函数域名片段比对是廉价的护栏能拦住在企业代理下悄悄指向测试环境这类事故整个脚本不构造任何计算对象、不消耗计算资源因此可以放进 CI 的启动前检查里。铁律 7改完必验每个自动化结果须与官方 GUI 结果或官方案例做一致性回归。环境自检是回归的前提如果连调的是谁、是什么版本都不确定回归就无从谈起。三、常见报错与排查报错 3-1pip show pypws有输出但脚本from pypws...报ModuleNotFoundError。现象包明明装了导入却失败。根因多解释器共存pip装进了 A 环境的 site-packages而运行脚本的是 B 解释器。解法用python -m pip show pypws让安装和运行强制绑定到同一个解释器长期方案是用虚拟环境并在项目里固定解释器路径。报错 3-2解释器版本低于 3.11。现象安装或导入阶段直接失败。根因官方 PyPWS 要求 Python 3.11 及以上。解法安装 3.11 并重建虚拟环境不要试图在老版本上打补丁——接口兼容性没有官方承诺省下的十分钟会在后面翻倍还回去。报错 3-3桌面许可取不到Network 授权场景。现象客户端启动报许可类错误或长时间卡在正在获取许可。根因许可服务器地址/端口不可达或所有浮动许可都被占用。解法先确认网络与服务器配置再用同网段另一台机器做对照试验在 CI 场景下要为许可竞争做排队与重试设计否则夜间批量会大面积失败。报错 3-4令牌失效401/403 类响应。现象调用被拒。根因令牌过期、权限范围不含目标能力或令牌被写死在代码里且已轮换。解法把令牌统一收到环境变量或密钥管理铁律 5在流水线里加令牌有效期检查这一前置步骤轮换令牌时只改配置不改代码这是判断你的凭据治理是否合格的试金石。报错 3-5脚本结果与昨天不一致但代码没改。现象同一脚本、同一输入输出漂移。根因产品版本、API 构建或 PyPWS 版本在期间被升级API 门户可见构建号会随时间更新而你没有任何记录。解法建立 §1.4 的版本档案并在每次升级后更新排查时先对齐四项版本产品、API 构建、Python、PyPWS再进入物理层面的比对。四、动手练习练习 1授权建档为你的项目写一份project_versions.md至少记录产品版本、API 目标、Python 版本、PyPWS 版本与记录时间五项。判定文件能被另一位同事在五分钟内看懂并复现你的环境。练习 2跑通自检完整执行 §2.2 与 §2.3 两段脚本。判定五项结论全部有输出令牌检查只出现布尔值与长度、日志中不含令牌明文。练习 3版本差异调研打开 Knowledge Centre 的发布说明页找出你当前版本相对上一版本的三条变更判断哪一条会影响后果计算结果、哪一条只影响界面。判定能把影响结果与影响体验的变更分开记录。练习 4凭据审计检查你的工作目录与版本库历史确认没有任何文件包含令牌或许可信息。判定git log历史中也不存在历史泄漏比当前泄漏更危险需要立即轮换令牌。练习 5Network 授权演练可选若具备 Network 授权条件在两台机器上同时启动计算观察许可竞争行为并记录现象。判定能说清许可耗尽时客户端表现是什么为第 13 篇的队列重试设计做铺垫。五、小结与下一篇预告本篇把地基打完了授权形态决定架构能不能落地Knowledge Centre是下载与发布说明的唯一权威入口访问令牌是通道 B 的入场券且必须走环境变量铁律 5版本档案是结果可复现的最小载体铁律 1。请把装得上、授权通、版本对得上、令牌管得住当作启动任何自动化项目前的四个检查项。第 03 篇《界面与数据模型》将正式进入产品内部Study Folder / Study / Scenario 三层数据层次各自承载什么、场景输入区的四类内容物料、源项、气象与地面、结果选项、全局设置与局部覆盖的优先关系、以及结果视图2D 图、3D 视图、地图/plot plan、表格与 Word/Excel 报告各自适合承接什么产物——并给出一张界面层级与可自动化输入项的映射表为第 16 篇的 API 实体做铺垫。本篇认知问题回显FAQQ1Phast™ 与 Safeti™ 的许可形态有哪些为什么安装前必须先问清授权类型A授权对象上分 Individual单机绑定与 Network网络浮动两种形态付费模式上有订阅、租赁与永久之分授权期限可短至 1 天、长至 3 年。必须先问清是因为它决定架构脚本运行在哪台机器上、能否多节点并行、流水线能持续多久全由授权决定。若规划服务器批量流水线却只买 Individual 单机授权脚本会因取不到授权而失败这不是代码问题改代码解决不了。Q2软件从哪买、从哪下、发布说明在哪看客户门户这个词为什么不该再用A购买、订阅与续期走 Veracity 商店如 https://store.veracity.com/phast安装介质、发布说明、技术文档、用户手册、视频与网络研讨会统一由官方 Knowledge Centre 承载。帮助资源历史上曾以客户门户的名义被提及如今统一为 Knowledge Centre因此项目文档里应统一写 Knowledge Centre避免新人在旧称下找不到入口。Q3Phast API 一定要访问令牌吗令牌应该怎么放、怎么轮换APhast API / Phast Web Services 是托管服务形态的接口门户 https://phastwebservices.dnv.com/ 端点形如 https://phastwebservices.dnv.com/api/analytics/v1/调用需向 DNV 获取访问令牌。令牌等价于账号凭证必须走环境变量或密钥管理服务不得写入脚本或仓库铁律 5。它还会过期且带权限范围因此流水线要把有效期检查与轮换当作正常运维动作轮换时只改配置、不改代码。Q4为什么强调版本先声明版本档案在项目里长什么样A官方以主线 9.x 加历史 8.x 的节奏演进同一功能在不同小版本可能变化而 Phast API 门户的构建号也会随时间更新。若不记录版本同一脚本昨天对今天不对就会变成玄学。版本档案的最小形态是一个随仓库提交的文件记录产品版本、API 目标、Python 版本、PyPWS 版本与记录时间五项每次升级产品、API 构建或 PyPWS 后更新升级前先看官方发布说明。Q5除文档外还有哪些官方学习资源A官方提供 Phast/Safeti/KFX 培训课程Knowledge Centre 上有网络研讨会录像其中包括Ask the experts - Phast API专题、Phast 9.1 概览与 Phast 到 Safeti 过渡等主题另有面向用户的用户会议议程常包含 Phast API 与 CFD 主题。建议把网络研讨会作为接口与版本变更的第一手来源优先于任何二手博客。