logo
ipcun2025/pac
Public
0
0
WeChat Login
CodeIssuesPull requestsEventsPackagesInsights
main
pac/README.md
Garry YAN
升级项目为vibe-ipc
45c9e2aa

Vibe IPC - 云边协同智能工业控制系统

📌 AI 驱动的云边协同边缘开放系统（EOS）核心工业过程控制组件

归属主体：爱皮科宇(IPCUN)科技集团北京智捷通云科技有限公司
版本号：V1.0
更新日期：2026-01-15

🚀 快速开始

一键部署（推荐）

bash /workspace/beremiz_debug_tools/ai_deploy.sh

快速诊断

bash /workspace/beremiz_debug_tools/ai_diagnose.sh

缓存恢复（30秒）

bash /workspace/beremiz_debug_tools/fast_deploy.sh cache-restore

📋 产品概述

Vibe IPC 是一款面向流程控制与批次控制的云边协同智能控制组件，集成 AI 自然语言编程引擎、软 PLC 控制内核、SCADA 可视化监控模块、多工具链兼容体系及智能装备运维赋能模块，深度适配 EOS 边缘开放系统架构。

核心特性

  • ✅ AI 智能体聊天式编程：基于 OpenCode + vLLM，自然语言直接生成控制代码
  • ✅ 全工具链兼容：VS Code 风格 IDE + Beremiz IDE + Fuxa 组态画布
  • ✅ 流程与批次控制：水处理、化工、医药、乳品饮料等行业全覆盖
  • ✅ 云边协同架构：边缘实时控制 + 云端智能优化
  • ✅ 智能运维赋能：设备档案管理、工艺参数优化、报表智能分析

🔧 核心组件

1. 系统 APT 包

sudo apt-get update
sudo apt-get install -y libffi-dev libsdl2-2.0-0 libpython3.11-dev build-essential \
    automake autoconf libtool bison flex

2. 解压 Beremiz 源码

cd /workspace && tar -xzf beremiz_cache/beremiz.tar.gz

3. 安装 Beremiz Python 依赖（requirements.txt）

pip3 install --break-system-packages -r /workspace/beremiz/requirements.txt

4. wxPython 预编译

pip3 install --break-system-packages /workspace/beremiz_cache/wxPython-4.2.1-cp311-cp311-linux_x86_64.whl

5. 修复 _ctypes 模块（关键！）

python3 -c "import ctypes" || {
    sudo cp /usr/lib/python3.11/lib-dynload/_ctypes.cpython-311-x86_64-linux-gnu.so \
            /usr/local/python3.11/lib/python3.11/lib-dynload/
}

6. 编译 MatIEC 编译器（可选）

cd /workspace
git clone https://github.com/beremiz/matiec
cd /workspace/matiec
autoreconf -i
./configure
make -j$(nproc)

7. 编译 Modbus 库（可选）

cd /workspace
git clone https://github.com/beremiz/Modbus
cd /workspace/Modbus
make

8. 验证部署

python3 /workspace/beremiz_debug_tools/verify_setup.py

⚠️ 关键陷阱

陷阱解决
依赖顺序错误严格遵循 APT → Beremiz 源码 → requirements.txt → wxPython
requirements.txt 之前安装依赖先解压 Beremiz 源码再安装 requirements.txt
编译 wxPython使用预编译 wheel
忽略 _ctypes步骤 5 必须执行
Python 版本不匹配确认 Python 3.11.x

📊 验证标准

python3 --version                                  # Python 3.11.x
python3 -c "import ctypes"                        # 无错误
python3 -c "import wx; print(wx.version())"          # 4.2.1 gtk3
python3 -c "import features; import ProjectController" # 无错误
python3 /workspace/beremiz/Beremiz_cli.py --version
/workspace/matiec/iec2c --version                  # MatIEC 编译器
ls -l /workspace/Modbus/libmb.so                   # Modbus 库
bash /start-vnc.sh                                 # VNC 服务启动

验证 noVNC 环境

# 检查 VNC 服务
ps aux | grep -E 'Xvfb|x11vnc|websockify'

# 检查端口监听
netstat -tlnp | grep -E '5901|6080'

# 访问 noVNC
# 浏览器打开: http://localhost:6080

🛠️ 工具说明

工具用途
ai_deploy.sh一键部署脚本（AI 优化）
ai_diagnose.sh环境诊断脚本（10秒）
fast_deploy.sh快速部署（支持缓存）
beremiz_deploy.sh完整部署脚本
verify_setup.py环境验证脚本

📚 文档

文档说明
README.md本文档
BEREMIZ_DEPLOYMENT_BEST_PRACTICES.md部署最佳实践
BEREMIZ_DEBUG_TROUBLESHOOTING.md故障排查指南
README_AI.mdAI 智能体专用文档
AI_USAGE_GUIDE.mdAI 使用指南

🎯 使用 Beremiz

CLI 模式

# 查看帮助
python3 /workspace/beremiz/Beremiz_cli.py --help

# 创建项目
python3 /workspace/beremiz/Beremiz_cli.py create-project /workspace/my_project

# 构建项目
python3 /workspace/beremiz/Beremiz_cli.py build --project /workspace/my_project

GUI 模式（推荐用于桌面调试）

方式 1: 通过 noVNC 访问（推荐）

# 启动 VNC 桌面环境
bash /start-vnc.sh

# 在浏览器中访问（密码：cnbdev123）
# http://localhost:6080

# 在桌面环境中打开终端，启动 Beremiz IDE
python3 /workspace/beremiz/Beremiz.py

noVNC 访问信息:

  • 访问地址: http://localhost:6080
  • VNC 密码: cnbdev123
  • 分辨率: 1920x1080
  • 桌面环境: XFCE4

方式 2: 本地 X11 显示

# 设置 DISPLAY 环境变量
export DISPLAY=:0

# 启动图形界面
python3 /workspace/beremiz/Beremiz.py

# 打开项目
python3 /workspace/beremiz/Beremiz.py /workspace/my_project

📂 目录结构

/workspace/
├── beremiz/                    # Beremiz 源码
│   ├── Beremiz.py              # GUI 主程序
│   ├── Beremiz_cli.py          # CLI 主程序
│   ├── ProjectController.py      # 项目控制器
│   └── features.py             # 特性配置
├── matiec/                     # MatIEC IEC 61131-3 编译器
│   └── iec2c                   # IEC 编译成 C 代码
├── Modbus/                     # Modbus 通信库
│   ├── libmb.a                 # 静态库
│   └── libmb.so                # 动态库
├── beremiz_cache/              # 持久化缓存
│   ├── beremiz.tar.gz          # 源码备份
│   ├── wxPython-4.2.1-*.whl  # wxPython wheel
│   └── index.json              # 缓存索引
├── .ide/                       # 开发环境配置
│   ├── Dockerfile              # Docker 镜像（含 noVNC）
│   └── start-vnc.sh            # VNC 启动脚本
└── beremiz_debug_tools/        # 部署和调试工具
    ├── ai_deploy.sh           # 一键部署
    ├── ai_diagnose.sh        # 环境诊断
    ├── fast_deploy.sh        # 快速部署
    ├── README_AI.md         # AI 文档
    └── ...

1. 系统 APT 包

sudo apt-get update
sudo apt-get install -y libffi-dev libsdl2-2.0-0 libpython3.11-dev build-essential \
    automake autoconf libtool bison flex

2. 解压 Beremiz 源码

cd /workspace && tar -xzf beremiz_cache/beremiz.tar.gz

3. 安装 Beremiz Python 依赖（requirements.txt）

pip3 install --break-system-packages -r /workspace/beremiz/requirements.txt

4. wxPython 预编译

pip3 install --break-system-packages /workspace/beremiz_cache/wxPython-4.2.1-cp311-cp311-linux_x86_64.whl

5. 修复 _ctypes 模块（关键！）

python3 -c "import ctypes" || {
    sudo cp /usr/lib/python3.11/lib-dynload/_ctypes.cpython-311-x86_64-linux-gnu.so \
            /usr/local/python3.11/lib/python3.11/lib-dynload/
}

6. 编译 MatIEC 编译器（可选）

cd /workspace
git clone https://github.com/beremiz/matiec
cd /workspace/matiec
autoreconf -i
./configure
make -j$(nproc)

7. 编译 Modbus 库（可选）

cd /workspace
git clone https://github.com/beremiz/Modbus
cd /workspace/Modbus
make

8. 验证部署

python3 /workspace/beremiz_debug_tools/verify_setup.py

🖥️ 核心工具

工具用途组件
Beremiz.py软 PLC GUI 开发环境控制内核
Beremiz_cli.py命令行工具CLI 接口
FuxaSCADA 可视化监控监控模块
VS Code集成开发环境开发工具链

⚠️ 关键陷阱

陷阱解决
依赖顺序错误严格遵循 APT → Beremiz 源码 → requirements.txt → wxPython
requirements.txt 之前安装依赖先解压 Beremiz 源码再安装 requirements.txt
编译 wxPython使用预编译 wheel
忽略 _ctypes步骤 5 必须执行
Python 版本不匹配确认 Python 3.11.x

📊 验证标准

python3 --version                                  # Python 3.11.x
python3 -c "import ctypes"                        # 无错误
python3 -c "import wx; print(wx.version())"          # 4.2.1 gtk3
python3 -c "import features; import ProjectController" # 无错误
python3 /workspace/beremiz/Beremiz_cli.py --version
/workspace/matiec/iec2c --version                  # MatIEC 编译器
ls -l /workspace/Modbus/libmb.so                   # Modbus 库
bash /start-vnc.sh                                 # VNC 服务启动

验证 noVNC 环境

# 检查 VNC 服务
ps aux | grep -E 'Xvfb|x11vnc|websockify'

# 检查端口监听
netstat -tlnp | grep -E '5901|6080'

# 访问 noVNC
# 浏览器打开: http://localhost:6080

🛠️ 开发工具

工具用途
ai_deploy.sh一键部署脚本（AI 优化）
ai_diagnose.sh环境诊断脚本（10秒）
fast_deploy.sh快速部署（支持缓存）
beremiz_deploy.sh完整部署脚本
verify_setup.py环境验证脚本

🎯 使用 Vibe IPC

CLI 模式

# 查看帮助
python3 /workspace/beremiz/Beremiz_cli.py --help

# 创建项目
python3 /workspace/beremiz/Beremiz_cli.py create-project /workspace/my_project

# 构建项目
python3 /workspace/beremiz/Beremiz_cli.py build --project /workspace/my_project

GUI 模式（推荐用于桌面调试）

方式 1: 通过 noVNC 访问（推荐）

# 启动 VNC 桌面环境
bash /start-vnc.sh

# 在浏览器中访问（密码：cnbdev123）
# http://localhost:6080

# 在桌面环境中打开终端，启动 Beremiz IDE
python3 /workspace/beremiz/Beremiz.py

noVNC 访问信息:

  • 访问地址: http://localhost:6080
  • VNC 密码: cnbdev123
  • 分辨率: 1920x1080
  • 桌面环境: XFCE4

方式 2: 本地 X11 显示

# 设置 DISPLAY 环境变量
export DISPLAY=:0

# 启动图形界面
python3 /workspace/beremiz/Beremiz.py

# 打开项目
python3 /workspace/beremiz/Beremiz.py /workspace/my_project

📂 目录结构

/workspace/
├── beremiz/                    # Beremiz 源码
│   ├── Beremiz.py              # GUI 主程序
│   ├── Beremiz_cli.py          # CLI 主程序
│   ├── ProjectController.py      # 项目控制器
│   └── features.py             # 特性配置
├── matiec/                     # MatIEC IEC 61131-3 编译器
│   └── iec2c                   # IEC 编译成 C 代码
├── Modbus/                     # Modbus 通信库
│   ├── libmb.a                 # 静态库
│   └── libmb.so                # 动态库
├── beremiz_cache/              # 持久化缓存
│   ├── beremiz.tar.gz          # 源码备份
│   ├── wxPython-4.2.1-*.whl  # wxPython wheel
│   └── index.json              # 缓存索引
├── .ide/                       # 开发环境配置
│   ├── Dockerfile              # Docker 镜像（含 noVNC）
│   └── start-vnc.sh            # VNC 启动脚本
├── beremiz_debug_tools/        # 部署和调试工具
│   ├── ai_deploy.sh           # 一键部署
│   ├── ai_diagnose.sh        # 环境诊断
│   ├── fast_deploy.sh        # 快速部署
│   ├── README.md             # 工具说明
│   └── verify_setup.py       # 环境验证
└── beremiz_fixes/             # Bug 修复记录
    ├── README.md             # 修复记录索引
    ├── QUICK_START.md        # 快速开始
    ├── scripts/              # 自动修复脚本
    ├── patches/              # 补丁文件
    ├── logs/                 # 修复日志
    └── records/              # 详细修复记录

🏭 应用场景

化工行业批次反应过程控制

  • 反应釜升温-保温-降温全自动批次控制
  • 温度超限泄压联锁
  • 批次数据记录与质量追溯

水处理行业连续流程控制

  • 浊度自动调节加药泵频率
  • 全厂水处理流程监控
  • 加药成本与水质分析报表

医药行业批次配方生产

  • 原料自动投料-搅拌-升温-保温控制
  • GMP 追溯要求的批次台账
  • 配方参数优化建议

乳品饮料行业批次杀菌与灌装

  • 巴氏杀菌温度闭环控制
  • 自动灌装触发与产量记录
  • 能耗分析与节能建议

🔧 常见问题

_ctypes 模块缺失

错误: ModuleNotFoundError: No module named '_ctypes'

解决:

sudo cp /usr/lib/python3.11/lib-dynload/_ctypes.cpython-311-x86_64-linux-gnu.so \
        /usr/local/python3.11/lib/python3.11/lib-dynload/

wxPython 导入失败

错误: ImportError: libSDL2-2.0.so.0: cannot open shared object file

解决:

sudo apt-get install -y libsdl2-2.0-0 libsdl2-dev

noVNC 无法访问

检查服务:

# 检查 VNC 相关进程
ps aux | grep -E 'Xvfb|x11vnc|websockify'

# 检查端口
netstat -tlnp | grep -E '5901|6080'

重启 VNC:

# 停止现有服务
pkill -f 'Xvfb|x11vnc|websockify'

# 重新启动
bash /start-vnc.sh

📚 文档资源

文档说明
README.md本文档
Vibe-IPC产品白皮书.md产品详细说明
REPOSITORY_INDEPENDENCE.md仓库独立说明
beremiz_debug_tools/README.md部署和调试工具说明
beremiz_fixes/README.mdBug 修复记录
beremiz_fixes/QUICK_START.md快速开始指南

📞 技术支持

遇到问题？

  1. 运行诊断: bash /workspace/beremiz_debug_tools/ai_diagnose.sh
  2. 查看产品白皮书: cat /workspace/Vibe-IPC产品白皮书.md
  3. 查看工具说明: cat /workspace/beremiz_debug_tools/README.md
  4. 查看修复记录: cat /workspace/beremiz_fixes/README.md

🖥️ 桌面调试环境

快速启动指南

  1. 启动 VNC 桌面

    bash /start-vnc.sh

  2. 访问桌面界面

    • 打开浏览器访问: http://localhost:6080
    • 输入密码: cnbdev123

  3. 启动 Beremiz IDE

    • 在桌面环境的终端中执行:
    python3 /workspace/beremiz/Beremiz.py

服务端口

服务端口用途
noVNC6080浏览器访问桌面
VNC5901VNC 协议
Code Server8080VS Code 在线版

版本: v1.0 | 更新: 2026-01-15 性能: 首次部署 2.5 分钟 | 缓存恢复 30 秒 环境: Ubuntu 22.04.5 LTS + Python 3.11.14 产品: Vibe IPC - 云边协同智能工业控制系统 公司: 爱皮科宇(IPCUN)科技集团北京智捷通云科技有限公司

© 2026 Tencent, Inc. Supported by Tencent Cloud
About Us
Privacy Policy
Terms of Service
SLA
API
Docs
Showcase
Feedback
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
京ICP备11018762号-111
粤公网安备44030002006058号粤公网安备44030002006058号