归属主体：爱皮科宇(IPCUN)科技集团北京智捷通云科技有限公司 产品名称：Vibe IPC - 云边协同智能工业控制系统 版本号：V1.0

---

文档	说明	适用对象
产品白皮书	产品概述、核心优势、应用场景	产品经理、客户
技术设计文档 (IPD)	IPD 敏捷开发框架、技术架构、质量标准	架构师、开发人员
开发指南	环境搭建、开发流程、调试技巧	开发人员

文档	说明
环境准备完成	环境状态、快速启动指南
快速开始	快速部署和入门

脚本	说明	使用方法
完整环境准备脚本	一键安装 Beremiz + Fuxa + AI 环境	bash scripts/setup_complete_env.sh
测试脚本	运行完整测试套件	bash scripts/run_tests.sh
服务启动脚本	管理 Beremiz 和 Fuxa 服务	bash scripts/start_services.sh [命令]

路径: /workspace/Beremiz

功能	说明
IDE	图形化开发环境 (Beremiz.py)
CLI	命令行工具 (Beremiz_cli.py)
Runtime	PLC 运行时 (Beremiz_service.py)
MatIEC	IEC 编译器 (/workspace/matiec/iec2c)

快速启动:

# CLI 模式
python3 /workspace/Beremiz/Beremiz_cli.py --help

# GUI 模式 (需要 VNC)
bash /start-vnc.sh
python3 /workspace/Beremiz/Beremiz.py

路径: /workspace/fuxa

功能	说明
后端	Node.js + Express (server/main.js)
前端	Angular + TypeScript (client/)
设备集成	Modbus, OPC UA, MQTT 等

快速启动:

# 启动服务
cd /workspace/fuxa/server && npm start

# 访问地址
http://localhost:1881

路径: /workspace/.claude/skills/

核心能力:

• 自然语言 → IEC 61131-3 代码
• IO 表解析
• P&ID 图纸识别
• 批次工艺卡转化

---

# 一键安装
bash /workspace/scripts/setup_complete_env.sh

# 验证环境
bash /workspace/scripts/run_tests.sh

# 启动所有服务
bash /workspace/scripts/start_services.sh all

# 或单独启动
bash /workspace/scripts/start_services.sh beremiz-gui  # Beremiz GUI
bash /workspace/scripts/start_services.sh fuxa           # Fuxa SCADA

服务	访问地址	说明
Beremiz GUI	http://localhost:6080	noVNC 桌面 (密码: zjty@eos.hk)
Fuxa SCADA	http://localhost:1881	Web 界面 (用户: admin/admin)
Code Server	http://localhost:8080	在线 VS Code

---

[概念阶段] → [计划阶段] → [开发阶段] → [验证阶段] → [发布阶段]
     │           │           │           │           │
     ▼           ▼           ▼           ▼           ▼
   需求分析   架构设计   迭代开发   系统测试   交付上线

详细说明请参考: 技术设计文档 (IPD)

main (生产分支)
  ↑
develop (开发分支)
  ↑
feature/* (功能分支)
hotfix/* (修复分支)

Beremiz 开发:

# CLI 模式
python3 /workspace/Beremiz/Beremiz_cli.py build --project /path/to/project

# GUI 模式
python3 /workspace/Beremiz/Beremiz.py

Fuxa 开发:

# 后端开发
cd /workspace/fuxa/server
npm install && npm start

# 前端开发
cd /workspace/fuxa/client
npm install && npm start

AI Skill 开发:

# 创建新 Skill
mkdir -p /workspace/.claude/skills/my-skill
cd /workspace/.claude/skills/my-skill
# 创建 SKILL.md 和 skill.json

---

bash /workspace/scripts/run_tests.sh

测试内容包括:

• ✅ 环境基础测试 (Python, Node.js, npm)
• ✅ Beremiz 组件测试 (wxPython, 依赖, 编译器)
• ✅ Fuxa 组件测试 (后端, 前端)
• ✅ 可选模块测试 (Modbus, CanFestival)
• ✅ 功能测试 (项目创建, 单元测试)

Beremiz:

# CLI 测试
python3 /workspace/Beremiz/Beremiz_cli.py --help

# 编译器测试
/workspace/matiec/iec2c -h

Fuxa:

# 后端测试
cd /workspace/fuxa/server
npm test

---

# 查看服务状态
bash /workspace/scripts/start_services.sh status

# 启动所有服务
bash /workspace/scripts/start_services.sh all

# 停止所有服务
bash /workspace/scripts/start_services.sh stop

# 运行环境诊断
bash /workspace/pac_debug_tools/ai_diagnose.sh

# 验证环境设置
python3 /workspace/pac_debug_tools/verify_setup.py

# Beremiz 日志
tail -f /tmp/beremiz.log

# Fuxa 日志
tail -f /tmp/fuxa.log

---

组件	状态	版本
Python	✅	3.11.14
wxPython	✅	4.2.1 gtk3
Node.js	✅	v22.14.0
npm	✅	9.x.x
MatIEC	✅	0.1
Beremiz	✅	Latest
Fuxa	✅	1.3.0-2671

Python:

• ✅ lxml, matplotlib, cryptography
• ✅ Twisted, pyOpenSSL, zeroconf
• ✅ asyncua, autobahn, erpc, Nevow

Node.js:

• ✅ Express, Socket.IO
• ✅ node-opcua, modbus-serial
• ✅ InfluxDB, SQLite3

---

• Beremiz 官方文档
• Fuxa GitHub
• IEC 61131-3 标准

• Beremiz GitHub
• Fuxa GitHub
• MatIEC GitHub

• Beremiz YouTube
• Fuxa Discord

---

版本	日期	修改内容
v1.0	2026-01-19	初始版本，建立文档体系

---

遇到问题？

1. 运行诊断: bash /workspace/pac_debug_tools/ai_diagnose.sh
2. 查看开发指南: 开发指南
3. 查看技术设计: 技术设计文档 (IPD)

---

文档版本: v1.0 最后更新: 2026-01-19 维护者: Vibe IPC 开发团队