AI 生成规格书 · v1.0 · Windows 桌面一体化工作台

RoboHub Workbench 机器人行业一站式工作台

面向机器人行业从业者的 Windows 桌面一体化工作台。把研发、调试、维修、仿真、编程、研学演示涉及的各类软件与高频工具，统一收纳到一个主程序——聚合不重写，一键唤起并自动带入项目参数。

🚀 打开交互原型（工作台） 探索核心功能 版本规划
9功能模块 M01–M09
3多端互联 / Win·Web·Android
8600内嵌 Kestrel 服务端口
AES-GCM密码加密 · DPAPI 保护
M04 · 硬件调试中心
CH1·CH2
100Hz示波器刷新
HEX/ASCII串口收发
CAN错误帧统计
JWT多端鉴权
01 · 核心目标

一个主程序，收纳机器人全链路工具

RoboHub Workbench 不复制第三方软件功能，只做统一入口、配置托管、参数自动带入与日志归档，并在后期扩展为 Windows + 网页 + 安卓多端互联。

G01

聚合入口

RealVNC、Motorevo Studio、VSCode、Vendterm 及建模/仿真/切片软件统一为可视化启动器，一键唤起并自动带入项目参数。

G02

统一工程

URDF、3D 模型、G 代码、固件、脚本、电机参数、日志、研学课件集中管理与版本化，一个项目库贯穿全部工具。

G03

内置工具

串口/CAN 调试、嵌入式终端（Vendterm 平替）、实时示波器、URDF 预览等高频小工具直接内嵌，无需来回切换窗口。

G04

多端互联

Windows 作为主机节点内置轻量 Web 服务，网页端与安卓端可查看配置、日志、脚本，并下发简单指令。

02 · 目标用户

为机器人全角色团队而生

从研发、维修到研学演示与管理，覆盖一线工程师到只读学员的完整协作链路。

机器人研发工程师

URDF 建模、运动仿真、代码开发、固件烧录——在统一工作区里打开 VSCode、仿真器与 3D 预览。

维修调试工程师

远程连接机器人主机、电机整定、底层终端、传感器排障——串口/CAN/终端一站式排查。

研学 / 演示人员

人形机器人语音脚本、演示流程编排、课件素材管理——脚本编辑器 + 语音台词表一键播放。

管理者 / 学员

通过网页 / 平板端查看设备状态、日志与项目资料（只读为主），随时随地掌握现场进度。

03 · 功能模块总览

M01 – M09 · 九大模块全景

桌面客户端 + 内置轻量服务 + 可插拔外部进程，三层结构覆盖从工程管理到多端互联的完整闭环。

M01

首页工作台

项目总览、最近工程、快捷工具栏。

实现：自研
M02

项目资源管理器

全类型工程文件统一管理。

实现：自研
M03

外部工具启动器

RealVNC / Motorevo Studio / VSCode / Vendterm 及建模仿真软件唤起。

实现：进程调用 + 配置托管
M04

硬件调试中心

串口/CAN 调试、嵌入式终端、示波器、电机档案。

实现：自研
M05

仿真与预览

URDF 预览、关节拖动、唤起 Webots/MuJoCo/CoppeliaSim。

实现：自研预览 + 外部唤起
M06

代码脚本模块

VSCode 联动、脚本预览、语音动作脚本编辑器。

实现：自研 + 进程调用
M07

研学演示模块

演示流程编排、课件素材库。

实现：自研
M08

多端互联服务

内网 Web 服务、设备管理、账号权限、日志同步。

实现：自研（Kestrel）
M09

系统设置

路径配置、主题、日志存储、更新。

实现：自研
04 · 核心功能需求明细

聚合不重写 · 内置高频 · 多端互联

三个核心模块构成本产品的骨架：外部工具统一入口、硬件调试高频内嵌、Windows 主机驱动的多端协同。

M03

外部工具启动器

// 聚合不重写 · 统一入口 + 配置托管 + 参数自动带入 + 日志归档
工作台不复制第三方软件功能，只做统一入口、配置托管、参数自动带入与日志归档。支持的工具及集成契约如下：
RealVNC远程
远程连接机器人主机 / 工控机
保存多组 VNC 连接档案（名称/IP/端口/密码/分辨率/色彩），点击"连接"调用本机 VNC Viewer 并自动带入参数；密码加密存储；连接时长与截图归档到项目。
Motorevo Studio电机
伺服电机整定 / 故障读取 / 零点标定
登记程序路径一键启动；电机档案（编号/减速比/零点标定时间/故障备注）在库内记录；参数文件与故障日志归入项目库。
VSCode代码
机器人代码 / URDF / 脚本开发
选中项目文件夹一键用 VSCode 打开工作区；保存工作区配置；内置简易代码预览窗口。
Vendterm终端
底层命令行终端
双模式：A) 唤起本机原版 Vendterm 并带入连接配置；B) 使用内置嵌入式终端（M04），支持 TCP/串口连接、会话日志入库。
SolidWorks / UG / Creo / Fusion360建模
机械结构 CAD
用户登记路径后显示在启动器，绑定项目文件一键打开。
Cura / PrusaSlicer切片
3D 打印切片
一键唤起并打开当前项目 STL，G 代码归档。
Webots / MuJoCo / Gazebo / CoppeliaSim仿真
机器人仿真
唤起并加载当前项目世界 / 模型文件。
M04

硬件调试中心

// 自研高频小工具直接内嵌，无需来回切换窗口

多串口调试面板

支持多串口并行、波特率可配、收发 HEX/ASCII、日志保存。

CAN 总线调试

CAN 设备接入、收发帧、错误帧统计。

嵌入式终端

对标 Vendterm 轻量版，TCP/串口连接、命令历史、会话日志入库。

实时示波器

绘制关节温度/电压/电流/位置等曲线，可暂停与导出。

电机档案

编号、型号、减速比、零点标定时间、故障备注，关联 Motorevo Studio 调试记录。

M08

多端互联服务

// Windows 内置 Kestrel Web 服务（默认端口 8600）· 局域网访问

能力 / Capabilities

  • 项目文件查看
  • 终端日志查看
  • 脚本编辑
  • 电机档案
  • 设备状态
  • 下发简单指令

限制与权限 / Limits & Access

  • VNC 画面、电机整定、复杂仿真由 Windows 主机承担
  • 移动端只读或轻操作
  • 基于角色账号体系，默认关闭公网，仅内网访问
  • 多端登录使用 Token（JWT）并设置过期时间
05 · 技术架构设计

桌面客户端 + 内置轻量服务 + 可插拔外部进程

三层结构：Avalonia 桌面承担全部功能，内嵌 Kestrel 提供局域网多端访问，外部进程管理器统一唤起第三方软件。

桌面客户端 · RoboHub.App (Avalonia / WPF) Windows 10/11 x64
M01 首页 M02 工程 M04 调试 M05 仿真/预览 M06 脚本 M07 研学
公共层 / Common Layer
配置中心 数据库 SQLite 日志 权限
M03 外部进程管理器 · System.Diagnostics.Process
RealVNC Motorevo Studio VSCode Vendterm CAD 切片 仿真器
M08 内嵌 Web 服务 · Kestrel 端口 8600
REST + JSON JWT SignalR 实时日志
▼ 局域网 HTTP   |   串口 / USB / CAN ▼
多端 / Multi-Terminal
网页端（浏览器） 安卓端（APP） 机器人硬件 / 工控机 （VNC / 串口 / 网络）
桌面框架
Avalonia.NET 8 · C#
一套代码可编译 Windows / Linux / macOS / WebAssembly，天然支持多端演进；桌面性能优于 Electron。
Web 服务
ASP.NET Core Kestrel
与 C# 同栈，进程内托管，低资源开销。
数据库
SQLite
零配置、单文件、适合本地工程库。
串口通信
System.IO.Ports/ SerialPortStream
成熟稳定，支持波特率与奇偶校验。
3D / URDF
HelixToolkit
支持 STL / OBJ / URDF 网格展示与相机操控。
密码加密
AES-GCM密钥由 DPAPI 保护
DPAPI 绑定当前 Windows 用户，无需明文密钥文件。
06 · 安全设计

不落明文 · 默认内网 · 角色隔离

从密钥保护、日志脱敏到公网管控与路径登记，安全贯穿全链路。

密钥保护

VNC 密码与用户密码 AES-GCM 加密，密钥由 Windows DPAPI（CurrentUser）保护，不落明文。

日志脱敏

终端 / 串口日志对敏感信息（IP、账号）脱敏后再入库。

默认内网

Web 服务默认仅监听内网地址（127.0.0.1 + 局域网网卡），公网访问需显式开启并强口令。

JWT 鉴权

多端登录使用 Token（JWT）并设置过期时间；按角色控制 API 权限。

路径不硬编码

外部程序路径不做硬编码，全部由用户在设置中登记，降低伪装程序风险。

07 · 版本规划

V1.0 → V2.0 → V3.0

从桌面单机骨架，到内网多端互联，再到安卓端与离线扩展。

VERSION 01

V1.0 · 桌面骨架

  • 工程管理
  • 外部工具聚合
  • 串口 / 终端 / 示波器
  • URDF 预览
  • 脚本编辑
VERSION 02

V2.0 · 多端互联

  • 内网多端互联
  • 账号权限
  • 日志同步
VERSION 03

V3.0 · 扩展

  • 安卓端
  • 离线同步
  • 研学报表
08 · AI 生成任务清单

六阶段分步生成，每阶段可独立验收

可分发给 AI 编程工具的分阶段生成指令。严格遵循"聚合不重写"原则，第三方软件一律以路径登记 + 进程唤起实现；所有外部路径用户可改；所有交互使用中文文案。

01
阶段一 · V1.0 骨架
按目录结构生成完整解决方案，实现三栏布局、Tab 工作区、SQLite 数据层与配置中心。
验收：可编译启动，空工程可新建项目
02
阶段二 · 外部工具聚合
实现 ExternalProcessManager 与外部工具面板，登记并唤起 RealVNC、Motorevo Studio、VSCode、Vendterm，含 VNC 密码加密。
验收：登记后可正确启动并带入参数
03
阶段三 · 硬件调试
实现串口/CAN 面板、嵌入式终端、示波器与电机档案，日志入库。
验收：收发数据完整入库
04
阶段四 · 仿真与脚本
实现 URDF 预览与关节拖动、脚本/语音编辑器、研学演示编排。
验收：加载样例 URDF 可拖动关节
05
阶段五 · V2.0 多端互联
实现 Kestrel 服务、鉴权、工程/日志/脚本 API，网页端可访问。
验收：手机浏览器可登录查看
06
阶段六 · V3.0 扩展
安卓端封装、权限细化、离线同步与报表导出。
验收：安卓端只读访问生效