客户项目与对接示例入口
Projects/ 保存客户专用流程、判定、配置和结果出口。本页将问题路由到拥有这些代码的项目主题;具体协议字段、完成判据与验证缺口只在对应主题维护,不因“业务使用”和“源码开发”再保留两份正文。
按代码责任定位
| 责任与问题 | 项目主题 | 首查入口 |
|---|---|---|
| AR/VR 流程组、Recipe、历史图像回退 | ProjectARVRPro | Projects/ProjectARVRPro/ARVRWindow.xaml.cs、ResultImagePresentation.cs;宿主入口为 PluginConfig/ProjectARVRWindowHost.cs |
| ARVRPro TCP/JSON 客户端、RunAll ACK 与最终结果 | Integration Demo | Projects/ProjectARVRPro.IntegrationDemo/Program.cs、MainWindow.xaml.cs、Contracts/ |
| 键盘背光、Modbus 触发、MES 返回码与键位结果 | ProjectKB | Projects/ProjectKB/ProjectKBWindow.xaml.cs;宿主入口为 PluginConfig/KBProjectPlugin.cs |
| LUX 文本 Socket、VID 与光通量 | ARVRPro 的 LUX 协议 | Projects/ProjectARVRPro/Services/LuxSocketDispatcher.cs、ARVRWindow.Lux.cs |
尚未确定业务归属,或要比较协议、触发与结果出口时,查独立的项目横向速查(projects.capabilities),再进入具体项目主题。ProjectARVR、ProjectARVRLite、ProjectBlackMura、ProjectHeyuan、ProjectShiyuan 和 ProjectLUX 属于已停用项目。归档标签、原版本和源码取回步骤统一见仓库 Projects/ARCHIVED.md;恢复源码不包含外部依赖或运行环境,也不代表旧包兼容当前宿主。
项目包与独立示例的边界
ProjectARVRPro、ProjectKB 各有自己的 .csproj、manifest.json 和 PluginConfig/ 宿主入口,manifest 的 dllpath 指向各自主 DLL。它们通过插件装载机制进入宿主,但业务所有权仍在对应项目,不是另一套“项目装载器”。运行装载及兼容门禁见插件装载契约。
ProjectARVRPro.IntegrationDemo 则是独立的 net48 WPF/命令行对接程序,项目文件没有 ColorVision 项目引用,不按 .cvxp 插件交付。其公开 Contracts/、样例、参数和结果解析属于客户端契约,不能因类型命名相似而直接引入 Engine、数据库或客户项目内部实现。
客户专用流程组织、Recipe/Fix、外部触发、结果判定与导出字段留在拥有该业务的项目中;仅当多个项目确实复用且形成稳定边界时,再考虑下沉 Engine/UI。并非每个项目都有相同的 ProcessGroup、ProcessMeta 或目录结构,不能把一个项目的流程模型套给另一个。
本地构建与发布不是同一动作
各项目页保留自己的构建与交付命令,本入口不复制命令。项目包的 VersionPrefix 独立于宿主版本;打包器按已构建主 DLL 的文件版本同步 manifest,不能以主程序版本或 manifest 文本单独证明当前交付内容。
- 本地构建不上传,但会写入编译产物;KB 的
PluginProject.HostCopy.targets在SolutionDir有效时复制宿主输出,ARVRPro 自有 PostBuild 还可从项目路径回推仓库目录。不要把构建理解为不会触碰宿主bin/.../Plugins/。 - 常规
Scripts/package_project.bat <ProjectName>调用强制加--build,随后打包并上传包与版本文件;--no-upload被拒绝。进入上传阶段后,package_cvxp.py在finally清理本地.cvxp,上传失败也可能清理。只有明确发布授权才走此入口,问答、排障和本地编译不构成授权。 - Demo 的客户产物使用其专题中的
dotnet publish路径,不调用项目包上传 wrapper。真实 Socket、Modbus、MES 或设备联调要另行确认操作范围,不能为了验证文档执行。
包结构、依赖裁剪与安装/恢复边界见插件产物与交付;发布是否完成仍需核对对应项目要求的远端元数据和可下载产物,不能只凭本地构建成功。
维护与验证责任
- 项目主题维护客户对象、实际入口、外部触发、流程/模板绑定、判定与结果出口,并提供源码入口;客户口头要求或未落地方案不得写成当前实现承诺。
- 新增可装载项目包时维护
.csproj、README、CHANGELOG、manifest、配置/资源和 docs 主题;独立示例按自身产物与公开契约维护,不强行为它添加插件 manifest。 - 修改协议、流程组、Recipe/Fix、导出字段、依赖或打包行为时,同步对应项目主题和项目自有说明;跨项目变化再更新
projects.capabilities,不要在本入口复制实现细节。
各项目按实际外部协议和设备链路验收。
