芯逻辑（XinLogic）—— MyOpenLab 鸿蒙 PC 适配版

芯逻辑（XinLogic）— MyOpenLab 鸿蒙 PC 适配版

本仓库是 MyOpenLab（Java/Swing 图形化编程 IDE）的 HarmonyOS PC（鸿蒙电脑，2in1）适配工程，不是原始项目。 上架名称格式（Harmony PC 开发者社区规范）：芯逻辑（based on MyOpenLab）。上游基准：reference/myopenlab（只读快照，commit 57d08b32，GPLv3）。仓库命名遵循社区规范 ohos_项目名称（本目录 ohos-MyOpenLab）。

简介

芯逻辑是 MyOpenLab 的鸿蒙 PC 适配版。MyOpenLab 是事件驱动的图形化编程环境（类似 LabVIEW），广泛用于树莓派 / Arduino 的工控与教学程序。本适配版目标是让既有 .vlogic 工程可以在鸿蒙 PC 上打开、编辑、仿真与发布，UI 布局与交互范式与原版保持一致。

不把 Swing/AWT 程序封装成鸿蒙应用；不做任意 Java 类动态加载、不做脚本执行、不做在线元素仓库。

当前状态（2026-10-19）

V1 规格全部实现，真机终验收全项通过，进入发布阶段（版本 1.0.0）。详见 workflow-status.md。

✅ M0：DevEco 工程 myopenlab-harmony（bundle com.von.myopenlab，2in1）+ C++ N-API 桥接（libmyopenlab.so）+ 20 个脱敏 fixtures；签名 HAP 真机安装启动成功
✅ M1：.vlogic 编解码器（解析 + 序列化严格互逆），595/595 样本字节级往返一致；真机 20/20 通过
✅ M2：工作台（原版布局：工具栏/元素栏/双画布/属性/校验/控制台）+ 35 元素注册表 + 编辑操作（建删元素含双面板配对、连线校验、删除级联）
✅ M3/M5：复制粘贴、多选批量属性编辑、网格吸附、最近项目、项目属性/变量对话框、崩溃恢复、日志导出、窗口响应式
✅ M4：仿真引擎（事件驱动、时钟、类型推导、24+ 元素执行、面板交互、风暴保护）+ 运行/暂停/继续/停止四态控制
✅ 真机终验收（HAD-W32）：编辑闭环、仿真四态、保存回传字节校验、崩溃恢复强杀还原、旧项目迁移零丢失、窗口缩放
📦 发布材料：原创图标、16:10 标准截图集、AGC 提交信息包、隐私政策（见 docs/listing）

已确认决策

事项	结论
应用名称	芯逻辑（XinLogic），区别于上游"MyOpenLab"；上架名称按社区规范为"芯逻辑（based on MyOpenLab）"
目标架构	仅 arm64-v8a。鸿蒙 PC 实机（HAD-W32）与官方模拟器镜像均为 ARM64；C++ 核心保持架构无关，将来如需 x86_64 只增构建目标
`.vlogic` 兼容	旧文件尽力打开；未支持组件只读降级（占位节点 + 迁移报告），已确认接受
首批元素	约 35 个（依据官方示例使用频率调研，见调研文档 §3）
真串口 / USB	V1 不实现、不申请权限（当前无硬件可测）。不影响上架；V2 用官方 `@ohos.usbManager.serial`（API 19+）接入
UI	与原始版本保持一致为硬约束；不添加原版没有的功能（画布缩放、元素栏搜索等）

下载安装

发布版本 1.0.0（versionCode 1000000）面向鸿蒙 PC（2in1，arm64-v8a）分发，上架华为应用市场（AppGallery）。本地构建与真机安装步骤见 myopenlab-harmony/README.md（含签名与 hdc install 命令）。

使用示例

安装后从桌面启动"芯逻辑"，即进入工作台：新建/打开 .vlogic 项目 → 在元素栏选择分类与元素 → 在画布点击放置 → 从输出引脚拖拽到输入引脚连线 → 右侧属性编辑 → "校验"检查 → "运行"启动仿真（面板按钮/LED/显示可交互）→ "保存/另存为"输出 .vlogic。主机侧可用 myopenlab-harmony/tools/run_host_check.sh 一键运行全部核心测试（595 样本往返 + 编辑操作 + 仿真场景）。

接口说明

ArkTS ↔ C++（N-API，模块 libmyopenlab.so）：
- 基础：getCoreVersion() / selfTest() / parseVlogic(data)（解析+往返校验报告）
- 项目：openProject(data)（→ 文档 JSON）/ saveProject(docJson)（→ 字节）/ newProject(title) / validateProject(docJson)
- 编辑：createElement(docJson,key,isFront,x,y) / deleteElement(docJson,id) / createWire(...) / deleteWire(...) / listElements()（元素目录含引脚明细）
- 仿真：simStart(docJson) / simTick(ms) / simStop() / simSetBool/ simToggle / simSetNumber / simSetString（面板交互）
文件格式：.vlogic 为自定义二进制容器（索引表 + 大端记录流），完整字节级规范见调研文档 §1；实现见 myopenlab-harmony/entry/src/main/cpp/core/。
错误模型：解析失败返回结构化 error{code,message,record,offset}（错误码清单见 vlogic_codec.cpp 头部注释）。

约束与限制

设备形态：仅 2in1（鸿蒙 PC）；C++ 原生库仅构建 arm64-v8a。
SDK：编译/目标 SDK 26.0.0，最低兼容 HarmonyOS 5.0.0（API 12）。
网络：无后台网络行为；不实现自更新通道。串口/USB（V2）将按最小权限申请。
权限：当前版本不申请任何敏感权限。
开发状态：V1 规格全部实现并通过真机终验收；未知元素按只读降级设计（保存不丢失）。

仓库结构

ohos-MyOpenLab/
├── README.md / README.OpenSource / CHANGELOG.md / LICENSE
├── workflow-status.md            # 工作流进度记录（每轮更新）
├── docs/
│   ├── architecture/myopenlab-harmonyos-pc/
│   │   └── architecture-design.md    # 架构设计（含已确认决策更新）
│   └── research/
│       └── 2026-10-13-upstream-research.md   # 上游调研（格式/元素/UI/安全）
├── myopenlab-harmony/            # 鸿蒙工程（DevEco，2in1，Stage 模型）
│   ├── entry/src/main/ets/       # ArkUI 外壳（M1 设备端 .vlogic 验证页）
│   ├── entry/src/main/cpp/       # C++ 便携运行时核心（binary_io / project_model / vlogic_codec / N-API）
│   ├── entry/src/main/resources/rawfile/fixtures/  # 设备端 20 个 .vlogic 样本
│   ├── tools/                    # 主机校验工具（run_host_check.sh）
│   └── tests/fixtures/vlogic/    # 20 个脱敏 .vlogic 兼容样本（含 INDEX.md）
└── reference/
    └── myopenlab/                # 上游源码只读快照（GPLv3，勿修改）

贡献代码

上游项目：https://github.com/sPyOpenSource/myopenlab（MyOpenLab 本体问题请向上游反馈）
社区仓库（正式维护地址）：https://gitcode.com/OpenHarmonyPCDeveloper/ohos_myopenlab
开发分支仓库：https://gitcode.com/VON-/ohos_myopenlab
隐私政策：PRIVACY.md（应用完全离线，不收集任何用户数据）

开源协议

本适配版是 GPLv3 衍生作品，以 GPL-3.0 发布，发布时同源开放（见 LICENSE）。
修改文件保持原始许可证条款；新增文件采用相同条款。
上游权利归 Carmelo Salafia / Javier Velásquez 等原作者所有；品牌与图标的使用在上架材料阶段单独核查。

开发环境

项	当前值
IDE / 构建	DevEco Studio 26.0.0（本机 `/Applications/DevEco-Studio.app`）
目标设备	HAD-W32 华为鸿蒙 PC（arm64-v8a，API 24），已通过 `hdc` 连接
模拟器	HarmonyOS 6.1.1 / 7.0.0 PC 镜像（`pc_all_arm`）

文档索引

文档	内容
docs/architecture/myopenlab-harmonyos-pc/architecture-design.md	总体架构、MVP 范围、N-API 契约、数据模型、实施阶段（M0–M5）与验收标准
docs/research/2026-10-13-upstream-research.md	`.vlogic` 字节级格式规范、元素体系与 V1 清单、UI 复刻基线、安全红线
myopenlab-harmony/README.md	工程结构、构建 / 签名 / 真机安装命令
workflow-status.md	进度记录：当前阶段、已完成、验证、后续工作、变更记录