Phynexis CLI
phynexis-v0 命令行负责管理原生安装、运行仿真与许可激活。由一键
安装（CLI 包 + 原生包）一并安装。
命令
| 命令 | 用途 |
|---|---|
install <压缩包> | 安装原生包（--prefix 指定安装根） |
upgrade [版本] | 更新 CLI/库包与本地原生包 |
prefix | 打印安装根（默认 /opt/phynexis） |
run [-np N] <命令> | 在 phynexis 环境下运行命令 |
shell [目录] | 交互式 shell（OpenFOAM + phynexis 环境） |
| `python <脚本 | -c>` |
job <子命令> | 后台任务（submit/status/log/kill/prune） |
paraview <子命令> | ParaView pvserver 生命周期（server/version/connect） |
license <子命令> | 许可管理（status/activate/deactivate） |
completion bash|zsh | 安装补全 |
运行 phynexis-v0 help 查看完整用法。
示例
安装已下载的原生包：
phynexis-v0 install phynexis-v0-0.3.6-linux-x86_64.tar.gz -p ~/opt/phynexis
升级到最新发布版本（经下载站）：
phynexis-v0 upgrade
运行仿真脚本：
phynexis-v0 run python3 examples/00_random_packing/1_gjk_solver.py
phynexis-v0 run -np 4 python3 examples/cfddem/case.py
进入 OpenFOAM + phynexis 交互环境：
phynexis-v0 shell .
用 netdem 模块运行 Python：
phynexis-v0 python -c "import netdem; print(netdem.__version__)"
提交后台任务：
phynexis-v0 job submit python3 examples/00_random_packing/1_gjk_solver.py
phynexis-v0 job status
后台任务
phynexis-v0 job 管理长时间运行的仿真（基于用户级 pueue 守护进程，任务在
ssh 断开后仍存活）。
| 子命令 | 用途 |
|---|---|
submit [-np N] <命令> | 后台运行命令 |
status [id] | 列出任务（排队 / 运行中 / 成功 / 失败） |
log [id] | 查看任务输出（默认最新） |
kill <id> | 停止运行中的任务 |
remove <id> | 移除排队中的任务 |
prune | 清理队列中的已完成任务 |
setup [--install] | 初始化 pueue 守护进程 |
phynexis-v0 job submit -np 4 python3 examples/00_random_packing/1_gjk_solver.py
phynexis-v0 job status
phynexis-v0 job log 3
任务在干净的运行环境中执行：提交时冻结 PATH，PYTHONPATH/LD_LIBRARY_PATH
取自 source 的 bashrc——需要额外路径时，在提交的命令里导出。
ParaView 服务器
phynexis-v0 paraview 管理 ParaView pvserver，用于远程可视化。
| 子命令 | 用途 |
|---|---|
server start [--port N] [-np N] [--offscreen] | 后台启动 pvserver |
server stop | 停止 pvserver |
server status | 状态 + cs:// 连接地址 |
server restart [...] | 停止后重新启动 |
version | pvserver 路径与版本 |
connect [--port N] | 展示客户端如何连接 |
phynexis-v0 paraview server start
phynexis-v0 paraview server status
phynexis-v0 paraview connect
在客户端机器上：phynexis-v0 paraview connect --host <服务器> 会显示可在
ParaView 中打开的 cs:// 地址。
许可
运行求解器需激活许可：
phynexis-v0 license activate <许可密钥>
phynexis-v0 license status
在 Xiaohe Accounts 获取许可。完整 CLI 参考见 项目技术站。