FUXA Desktop CS客户端2 使用手册

FUXA C/S 客户端

去年有个CS客户端了，今年有个用户有要求用.NET技术搞了一个FUXA的CS客户端。

简介

FUXA Desktop CS 是一个基于 C# + WebView2 的 FUXA 桌面客户端应用程序。它将 FUXA 服务器和浏览器客户端打包成一个独立的 Windows 桌面应用，无需安装 Node.js 或其他依赖即可运行。

系统要求

• 操作系统: Windows 10 或 Windows 11 (64位)
• 运行时: .NET 10.0 或更高版本（已包含在发布包中）
• 浏览器组件: Microsoft Edge WebView2 Runtime（已自动安装或包含）

快速开始

1. 启动应用程序

双击 FUXADesktop.exe 启动应用程序。

2. 启动过程

应用程序启动时会显示加载界面，包含以下步骤：

1. 正在启动 FUXA 服务器... - 启动内置的 Node.js 服务器
2. 正在初始化浏览器... - 初始化 WebView2 浏览器组件
3. 正在加载 FUXA... - 加载 FUXA 界面

3. 访问 FUXA

启动完成后，应用程序会自动显示 FUXA 界面。默认访问地址为 http://localhost:1881。

配置说明

配置文件位置

配置文件 app-config.json 位于应用程序根目录，与 FUXADesktop.exe 同级。

配置文件查找顺序：

1. 首先查找当前工作目录下的 app-config.json
2. 如果找不到，则使用应用程序目录下的 app-config.json

配置文件 (app-config.json)

{
"appName":"FUXA",
"windowTitle":"FUXA - Process Visualization",
"windowSettings":{
"width":1400,
"height":900,
"minWidth":800,
"minHeight":600
},
"serverSettings":{
"nodePath":"nodejs/node.exe",
"serverScript":"server/main.js",
"port":1881,
"host":"localhost"
},
"logoPath":"fuxa-logo.ico",
"versionText":"v1.3.0",
"loadingMessages":{
"startingServer":"正在启动 {AppName} 服务器...",
"initializingBrowser":"正在初始化浏览器...",
"loadingApp":"正在加载 {AppName}...",
"serverRestarting":"服务器连接丢失，正在重启...",
"reloadingApp":"正在重新加载 {AppName}..."
},
"colors":{
"backgroundColor":"#F5F7FA",
"textColor":"#3C3C3C",
"spinnerColor":"#007BFF",
"versionColor":"#969696"
}
}

配置项说明

基本设置

窗口设置 (windowSettings)

服务器设置 (serverSettings)

界面设置

日志查看

应用程序日志存储在 log/ 目录下，文件命名格式为 server_YYYYMMDD_HHMMSS.log。

日志内容包括：

• 服务器启动/停止记录
• HTTP 请求记录
• 错误和异常信息
• 调试信息

故障排除

1. 应用程序无法启动

问题: 双击 FUXADesktop.exe 没有反应

解决方案:

1. 检查是否安装了 .NET 10.0 运行时
2. 检查 nodejs/node.exe 是否存在
3. 检查 server/main.js 是否存在
4. 查看 log/ 目录下的日志文件

2. 服务器启动失败

问题: 显示"服务器启动失败"错误

解决方案:

1. 检查端口 1881 是否被其他程序占用
2. 查看日志文件了解详细错误信息
3. 检查 _appdata/settings.js 配置文件是否正确

3. 界面显示空白

问题: 加载完成后界面空白

解决方案:

1. 检查 client/dist/ 目录是否存在前端文件
2. 查看日志文件是否有错误信息
3. 尝试刷新页面（按 F5）

4. 应用程序闪退

问题: 应用程序启动后很快退出

解决方案:

1. 检查系统是否满足最低要求
2. 检查 WebView2 Runtime 是否已安装
3. 查看 Windows 事件查看器中的错误信息

5. 服务器连接丢失

问题: 运行过程中显示"服务器连接丢失"

解决方案:

1. 应用程序会自动尝试重启服务器
2. 如果自动重启失败，请手动重启应用程序
3. 检查系统资源是否充足（内存、CPU）

高级功能

自动健康检查

应用程序每 5 秒检查一次服务器状态。如果连续 3 次检查失败，会自动尝试重启服务器。

服务器重启

如果服务器意外停止，应用程序会：

1. 显示加载界面
2. 尝试重新启动服务器
3. 重新加载 FUXA 界面

多实例支持

如果端口 1881 已被其他 FUXA 实例占用，应用程序会直接连接到现有服务器，不会强制终止其他进程。

打印功能

应用程序支持打印功能：

• 快捷键: 按 Ctrl+P 打开打印对话框

数据存储

FUXA 的数据存储在 _appdata/ 目录下：

• settings.js - 应用程序设置
• projects/ - 项目文件
• log/ - FUXA 内部日志

更新说明

更新应用程序

1. 备份 _appdata/ 目录
2. 下载新版本并解压
3. 将备份的 _appdata/ 复制到新版本目录
4. 启动新版本

更新 FUXA 服务器

1. 停止应用程序
2. 备份 _appdata/ 目录
3. 替换 server/ 和 client/ 目录
4. 启动应用程序

技术说明

架构

• 前端: WebView2 (Microsoft Edge 内核)
• 后端: Node.js + Express + Socket.IO
• 进程通信: HTTP/WebSocket

端口使用

• 1881: FUXA Web 服务器端口
• 随机端口: WebView2 调试端口（如启用调试）

进程管理

• 主进程: FUXADesktop.exe (C# WinForms)
• 子进程: node.exe (FUXA 服务器)
• 子进程在父进程退出时会自动终止

安全说明

1. 默认监听 127.0.0.1:1881，仅本地可访问
2. 如需远程访问，请修改 _appdata/settings.js 中的 uiHost 配置
3. 建议在生产环境中使用反向代理和 HTTPS

支持与反馈

如有问题，请查看日志文件或联系技术支持。

版本: v1.3.1 最后更新: 2026-02-24