fluid-network-analysis

该 Skill 面向 schema 1.0 稳态不可压缩流体网络，依据 TOML 或自然语言需求建立模型，调用内置 Python 脚本验证并求解，输出压力、流量、流速以及显式场景下的确定性可用性分析；不适用于瞬态、可压缩、热力或概率可靠性仿真。

zhang1jing2

热度 13.02

最近更新 2026-08-18 21:18:28

分类：数据依赖：代码执行 / 读写文件应用场景：数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add fluid-network-analysis

Metadata

name: fluid-network-analysis
description: Design, validate, solve, and analyze schema 1.0 steady-state incompressible fluid networks from TOML or natural-language requirements. Use for pressure, flow, velocity, explicit operating-scenario, and deterministic function-availability analysis; do not use for transient, compressible, thermal, or probabilistic reliability simulation.
metadata: {"openclaw":{"requires":{"anyBins":["python3","python"]},"emoji":"💧"}}

Fluid Network Analysis

Use the bundled runtime and schema instead of calculating nontrivial networks informally. The runtime requires Python 3.9 or newer and does not require the source repository or third-party Python packages.

Workflow

Read references/schema.md when creating or modifying TOML.
Preserve the distinction between a load inlet and its downstream sink boundary. Measure inlet pressure at the load node and flow on its declared measurement edge.
Convert user units to SI before writing TOML and retain the original values in explanatory text when useful.
Represent only explicitly requested operating conditions. Apply scenario actions as state overrides; never generate a Cartesian product of all failures unless the user asks for it.
Resolve <skill-folder> to the directory containing this SKILL.md, then validate before solving:
```
python <skill-folder>/scripts/fluid_network.py validate <network.toml>
```

Analyze all declared scenarios or one selected scenario:

python <skill-folder>/scripts/fluid_network.py analyze <network.toml> --format markdown
python <skill-folder>/scripts/fluid_network.py analyze <network.toml> --scenario <scenario-id> --format json

Report assumptions, validation errors, solver convergence and mass-balance residuals. Do not present unresolved pressures or flows as physical results.

Modeling decisions

Use pressure_boundary with role source for supplies and role sink for ambient or return pressure.
Use junction for ordinary unknown-pressure nodes.
Use load only at the load inlet and provide both pressure and flow thresholds.
Use ΔP = RQ for linear resistance and ΔP = RQ|Q| for quadratic resistance.
Model a pump as fixed pressure rise plus positive internal resistance. Do not silently approximate a supplied pump curve as fixed head.
Treat reliability results as deterministic availability within the named scenario, not as failure probability.

If topology, source pressure, sink pressure, resistance data, or load thresholds are absent, state the minimum assumptions required for a runnable model. Do not hide those assumptions inside generated values.

Use assets/simple_network.toml as a minimal starting template and assets/redundant_supply.toml for main/backup path analysis. Copy an asset to the user's workspace before modifying it; do not edit the installed asset in place.