ROFilter 反渗透膜系统设计助手 — 系统帮助
覆盖：登录 / 分析 / 设计 / 运行与结果 / 后处理 / 成本分析 / 文件与单位 / MCP 服务 / 水处理工具库 / 常见问题（不含管理端功能）
一、快速开始（三步出结果）
- 登录：输入账号密码登录（右上角 EN 可切换中英文界面）。
- 录入水质 + 设计参数：在「分析」页输入进水离子与 pH/温度；在「设计」页选择膜元件、填写回收率与产水流量。
- 运行：点击设计页右下角 ▶ 运行，系统自动计算并跳转「结果」页，查看压力、通量、产水水质、饱和度与逐年老化等全部结果。
二、项目信息行（顶部）
位于横幅菜单下方，贯穿所有页面：
| 字段 | 说明 |
|---|---|
| 项目 / 客户名 / 设计者 | 工程档案信息，会写入计算书报告。 |
| 温度 | 进水温度，影响渗透压、通量与脱盐率计算；单位跟随系统选项全局单位（°C/°F）。 |
| 水类型 | 8 种水源。决定设计导则通量上限与回收率建议；废水类水源会自动把通量衰减模式切换为「首年」。 |
| 预处理 | 传统 / MF/UF / MF/UF+活性炭。浊度预警会参考该选项。 |
| 日期 | 默认今天，写入报告。 |
三、分析页 — 进水水质
3.1 离子录入
按水质化验单填写阳离子（Ca/Mg/Na/K/NH4/Ba/Sr）与阴离子（HCO3/SO4/Cl/F/NO3/PO4/SiO2/B）的 mg/l 浓度；右侧 mg/l CaCO3 列自动按当量换算，也可直接输入 CaCO3 值反向换算。CO2、CO3、电导率、NH3、渗透压等由系统自动计算（灰底斜体）。
- 阴阳离子平衡：输入后自动计算总 meq/l；差值大于 10% 时点击「⚖ 自动平衡」（或点击带下划线的离子名称指定调整对象）。
- 自定义离子：下拉选择内置槽位（Fe/Mn/Cu/Al 等），引擎全链路参与计算。
- Feed Softener：勾选后按软水器出水处理（Ca/Mg 置换为等当量 Na）。
3.2 水质档案
- 💾 保存水质：当前水质导出为 .water 文件。
- 📂 读取水质：读取 .water 水质文件。
四、设计页 — 系统设计
4.1 设计基础（左列）
| 参数 | 说明 |
|---|---|
| 进水 pH | 目标进水 pH；与分析页 pH 的差值驱动化学投加量计算。 |
| 产水回收率 % | 常规 1 段 ≤50%、2 段 60~75%、3 段可达 80~85%。 |
| 产水流量 | 单套产水流量；右侧单位下拉可单独切换（默认跟随系统选项全局单位）。 |
| 平均水通量 / 进水流量 / 浓水流量 | 自动联动计算（灰底），无需填写。 |
4.2 膜老化参数（右列）
- 膜运行时间 年：0~10 年；驱动「通量衰减 → 污染系数」与「透盐率增长 → 盐透过倍数」换算，结果页「每年运行情况」面板分年展示影响。
- 水通量衰减：单位统一为百分比，%/年（复利）或 %/首年（标准老化曲线）两种模式。
- 污染系数：由年限与衰减率自动换算（0.35~1.0），也可手动覆盖。
4.3 系统规格（段表）
- 每段填写膜元件类型（点击输入框打开选型，可对比多型号）、元件数/压力容器（1~8）与压力容器数量。
- 「自动排列」按目标通量 15 lmh 自动反算容器数（如 2 段 2:1）。
- 勾选产水压力/段间增压行可逐段输入（bar，跟随全局单位）。
4.4 系统面板（右侧）
总产水流量（自动）、系统套数、段间管道损失、进水压力(手动)、产水混合、浓水循环——按勾选启用输入。
4.5 工具栏
| 按钮 | 功能 |
|---|---|
| ⇉ 常规两级 | 两级系统（级1产水→级2进水），级2 段表与参数独立。 |
| ⚡ PE/WE · Turbo | 能量回收装置（ERD）配置，结果页显示回收功率与净功率。 |
| ⚙ 混合膜 | 段内混合膜（同段两种元件按比例混装）。 |
| 💡 智能推荐 | 按水质/流量/回收率自动推荐膜型号与排列。 |
| 📁 通用方案 | 行业常用方案一键写入参数（能源/医药/电子/海水淡化等）。 |
| ▶ 运行 | 执行计算并跳转结果页。 |
4.6 膜元件与浓度衰减
膜元件的产水量与脱盐率都随进水含盐量变化：含盐量越高，渗透压越高、盐透过越多。软件用「浓度衰减曲线」表达这种变化，并在选膜时优先推荐已标定的元件。
五、运行与结果页
结果页自上而下：项目情况 → 系统情况 → 功能选项 → 系统拓扑图 → 计算摘要 → 进水与产水 → 每级 → 浓水饱和度 → 每段 → 段级流股 → 膜元件明细 → 每年运行情况 → 运行预警。
- 系统拓扑图：P&ID 风格流程图，标注压力、流量、TDS；管线颜色：蓝=给水/浓水，绿=产水。
- 计算摘要：对整个报告的描述总结（项目/水质/设计/结果/饱和度/预警/老化/结论）。
- 每年运行情况：行=年份（新膜→运行年限），列=污染系数/进水压力/产水 TDS/泵功率，括号内为相对新膜变化。
- 运行预警：对进水水质、系统设计与计算结果自动检查（结垢饱和度、浓差极化 β、水通量、压力/温度/pH 限值、流量分布），按严重/警告/提示分级。
- 点击膜元件明细任一行，弹窗查看该元件进水/浓水/产水的完整离子。
六、后处理页 — 产水调质
基于最近一次 RO 计算的产水进行调质评估，所有输入实时联动计算：
- 基础水质参数（顶栏）：pH/CO3/CO2/NH3/电导率均可直接输入——直改 CO2/CO3/NH3 时系统按平衡常数反推 HCO3/NH4 重算；碱度/离子强度/渗透压自动计算（渗透压点击 bar⇄psi 切换）。
- 阳/阴离子表：mg/l 与 mg/l CaCO3 两列均可输入、互相换算。
- 后处理化学消耗（转置面板）：按药剂列填写溶液浓度 % / 比重 / 溶液价格 USD/l，系统按产水流量实时估算消耗量（kg/h ⇄ l/h 点击切换）与成本 USD/h。公式：kg/h = 流量(m³/h)×投加(mg/l)÷1000÷浓度(%)×100。
- 化学药品投加量：8 种药剂（NaOH/NaHCO3/Na2CO3/Ca(OH)2/H2SO4/HCl/CO2/NaOCl）以 100% 浓度计的投加量，驱动 pH/碱度/离子增量计算。
- 脱气：勾选后 CO2 投加量 = 出口目标 − 当前 CO2（负值即脱除）。
- ↺ 恢复投加：药剂清零，回到产水原始水质。
七、成本分析页 — 制水成本核算
按当前系统设计估算吨水成本。所有输入改动即时重算，无需点运行。页面自上而下五个板块：① 设备成本 → ② 膜元件成本 → ③ 电力消耗 → ④ 药品消耗 → ⑤ 合计。
7.1 自动带入（灰底只读）
以下参数取自设计页与最近一次计算结果，不能在本页修改；改了设计需重新运行再回本页：
| 参数 | 来源 |
|---|---|
| 单套产水能力 / 系统套数 | 设计页「产水流量」与「系统套数」 |
| 单套膜元件数 | 设计页各段元件数合计（含级 2，不含套数） |
| 单套泵功率 / 单位电耗 | 最近一次运行结果（含 ERD 净功率）；单位电耗 = 泵功率 ÷ 单套产水 |
| 加酸投加量 | 设计页化学投加量，未启用为 0 |
| 系统回收率 | 设计页回收率 |
7.2 需要填写的经济参数
| 板块 | 参数 | 默认值 | 说明 |
|---|---|---|---|
| ① 设备 | 吨水投资 | 5000 ¥/(m³/h) | 设备投资不含膜元件（膜单列在 ②），按产水能力折算 |
| 年利率 | 4.5 % | 用于投资摊销 | |
| 设备利用率 | 90 % | 年实际运行时间占比 | |
| 使用年限 | 15 年 | 驱动膜更换次数与摊销 | |
| 维护率 | 3 %/年 | 占投资百分比，每年 | |
| 单套投资，自动 | — | 吨水投资 × 单套产水能力 | |
| ② 膜元件 | 膜平均单价 | 2500 ¥/支 | 全部膜元件采购均单价 |
| 膜寿命 | 5 年 | 按设备年限内所需膜代数摊销 | |
| 膜安装次数，含初装 | 自动 | ⌈设备使用年限 ÷ 膜寿命⌉，含初装 1 次 | |
| 单套膜总价，含初装 | 自动 | 元件数 × 单价 × 安装次数 | |
| ③ 电力 | 电价 | 0.8 ¥/kWh | 电力成本 = 单位电耗 × 电价 |
| 单位电耗 | 自动 | 单套泵功率 ÷ 单套产水流量 | |
| ④ 药品 | 酸单价 | 0.15 ¥/kg | 配合设计页加酸投加量 |
| 阻垢剂投加量 / 单价 | 3 mg/l / 2.2 ¥/kg | 按投加浓度折算到产水 | |
| 系统回收率 | 自动 | 药品按投加浓度折算到产水，因此与回收率挂钩 | |
| 单位成本与套数无关 | — | 套数只影响合计总量 |
7.3 结果与导出
- 各板块底部给 ¥/m³ 与 ¥/年；板块 ⑤ 按成本构成列示单套与多套合计、占比、合计制水成本。
- 📤 导出：导出本页成本分析，可选 Excel / Word / PDF；🖨 打印：打印报告或另存为 PDF。
八、文件菜单
| 菜单项 | 说明 |
|---|---|
| 新建项目 | 清空并恢复默认输入（水质仅 HCO3=0.1/pH 7/温度 25；设计仅段1 预选 ESPA2-LD、元件数/容器数为 0，回收率/产水流量留空）。 |
| 保存项目 (.prj) | 把项目设置 + 水质 + 设计 + 后处理全部输入保存为本地 .prj 文件（不含自动计算结果）。 |
| 读取项目 (.prj) | 读取 .prj 项目文件，恢复以上全部输入；随后点「运行」重新计算。 |
| 导出计算书 | 将当前计算结果导出为 Excel（.xlsx 7 工作表）/ PDF / Word（.docx 含拓扑图），报告与结果页同构并包含运行预警。 |
| 打印 | 调用浏览器打印（可另存为 PDF）。 |
九、单位系统（全局）
- 位置：系统 → 系统选项 → 单位（纵向排列）。四组单位：压力（bar/psi）、流量（m³/h/gpm/gpd/mgd/migd/m³/d/mld）、温度（°C/°F）、水通量（lmh/gfd）。
- 切换后全局实时换算（不刷新页面）：顶部温度、设计页各压力/流量输入与自动联动列、结果页全部压力/流量/温度/通量数字与单位。
- 引擎内部始终按 bar/m³/h/°C/lmh 计算，仅显示与输入层换算；设计页产水流量可用局部单位下拉临时覆盖。
- 单位选择保存在浏览器本地，下次登录自动生效。
十、MCP 服务接入（AI 客户端调用）
MCP 服务让 Claude Desktop、Cursor 等支持 MCP 的 AI 客户端直接调用本站计算引擎，把「查元件—算水质—跑方案」交给 AI 代劳。入口是顶栏的 MCP服务 按钮。
10.1 生成与查看令牌
- 首次打开点 生成令牌：明文只在那一次完整显示，请立即复制保存；之后页面只显示前缀 rfmcp_••••，需要再看时点 显示令牌。
- 重新生成会使旧令牌立即失效，已配置的客户端需同步更新（系统会二次确认）。
- 令牌有效期 90 天；默认每日 1000 次调用额度，具体以面板显示为准。管理员账号签发的令牌长期有效。面板同时显示该账号的累计调用次数与今日用量，以及各工具的调用分布。
10.2 IP 绑定与额度
| 额度设置 | 行为 |
|---|---|
| 有限额度（默认 1000 次/日） | 首次调用时自动绑定当前 IP，之后来自其他 IP 的请求会被拒绝并提示「该令牌已绑定 IP xxx」 |
| 不限次数 | 不限制 IP，适合换网络环境或由平台侧统一调用 |
10.3 客户端配置
面板下方提供可直接复制的配置片段，粘贴到客户端的 MCP 配置中即可。要点：
- 传输方式为 Streamable HTTP（服务端不提供 SSE 推送流），端点 https://rofilter.cn/mcp。
- 支持自定义请求头的客户端，把令牌放在 Authorization: Bearer rfmcp_...。
- 不支持自定义请求头的客户端，可用 URL 携带令牌的方式（面板会一并给出）。
10.4 可用的五个工具
| 工具 | 作用 |
|---|---|
| list_elements | 按品牌/系列/关键词/TDS 筛选膜元件，返回面积、产水量、脱盐率与测试条件 |
| get_element | 取单个元件的完整参数与适用边界（温度、pH、最大压差） |
| analyze_water | 由离子组成算 TDS、渗透压、电导率、LSI/CCPP 与碳酸平衡 |
| run_design | 跑完整系统设计计算，返回进水压力、产水 TDS、浓水浓度、能耗与逐段结果 |
| list_schemes | 列出行业通用方案模板（电力/制药/电子/食品/海淡等） |
十一、水处理工具库
与水处理相关的通用在线计算器，共 16 个，分五类：
| 分类 | 典型工具 |
|---|---|
| 膜与脱盐 | 膜分离 MWCO、海水淡化能耗等 |
| 污水处理 | 活性污泥、MBR、滴滤池、人工湿地 |
| 消毒与氧化 | 臭氧、紫外消毒 |
| 环境水质 | 河流水质等 |
| 通用计算 | 常用单位与工艺换算 |
- 入口：站点导航「水处理工具库」（/tools.html），不需要登录，不占用 MCP 额度。
- 右上角 EN 可切换中英文；每个工具的结果都可展开图表查看。
十二、常见问题
Q1：点「运行」提示请先输入 pH / 回收率 / 产水流量？
新建项目默认这些项留空（对齐行业软件习惯），填入合法值即可；黄色底色即未填提示。
Q2：阴阳离子不平衡，计算被阻止？
点击「⚖ 自动平衡」或手动修正主要离子，平衡差 ≤10% 才能运行。
Q3：为什么切换到 psi/gpm 后数字变了？
单位切换是等量换算（如 100 m³/h ≈ 440.33 gpm），引擎计算基准不变，结果物理等价。
Q4：后处理改 CO2 后又跳回原值？
输入 CO2 后系统按碳酸平衡反推 HCO3 并重算，显示值是平衡收敛后的结果；如需固定 CO2，可改用「脱气」出口目标控制。
Q5：每年运行情况面板没有出现？
该面板仅在设计页「膜运行时间 年」大于 0 时显示。
Q6：.prj 项目文件包含计算结果吗？
不包含。项目文件只保存输入（项目设置/水质/设计/后处理），读取后需点「运行」重新计算。
Q7：成本分析页的泵功率是空的，或结果全是 0？
成本页的电耗、膜数、产水量全部取自最近一次运行结果。先在设计页点「运行」，再回到成本页；只改设计不重跑，成本页拿到的还是上一次的数据。
Q8：浓度衰减曲线为什么只能看、不能改？
曲线代表该元件在厂商标准测试条件下的产水量/脱盐率随含盐量的变化，属于元件固有特性，只读展示。需要自定义曲线时，请用管理端的浓度衰减方案功能（普通用户无此权限）。
Q9：MCP 调用报「该令牌已绑定 IP」？
令牌在有限额度下会绑定首次调用的出口 IP，换网络后即失效。重新生成令牌，或联系管理员将该账号额度设为「不限」（不限额度时不绑定 IP）。
Q10：导出的计算书和结果页内容一致吗？
一致。Excel / Word / PDF 三种格式与结果页同构，并始终包含全部面板——即使你在「系统选项 → 显示选项」里关闭了某些面板，导出件也不受影响。