海康 Vision Master 方案分析

概述

海康 VM 方案分析

把难以直接阅读的 VisionMaster .sol 方案转换成普通用户能理解的说明报告和忠实的交互流程图。整个过程严格只读，不写回或修改原方案。

默认交付

用户要求“分析方案”或“看懂流程”时，优先同时生成：

• *-report.md：先给通俗结论和分步骤说明，再附完整技术证据。
• *-flow.html：从上往下展示真实执行拓扑。
• *-flow.workflow.json：与 HTML 对应的 Archify IR，便于审计。

除非用户明确只要某一种产物，不要只交付模块清单或原始 JSON。

python scripts/sol_inspect.py solution.sol 
  --report solution-report.md 
  --diagram solution-flow.html

回答用户时

先用普通语言回答：

1. 方案从哪里取得输入。
2. 按什么步骤处理。
3. 在哪里分支或并行。
4. 在哪里汇合。
5. 最终输出什么。
6. 哪些含义可从 SOL 确认，哪些只是根据模块名称做的保守归纳。

不要把 IMVSBlobFindModu、参数路径、C#、XAML 或 ZIP 条目当作主要结论。只有用户追问技术细节时，再引用报告附录。

流程图正确性要求

Archify 图必须遵守：

• 所示模块之间的执行连接集合必须与 SOL 解析结果一致。
• 不得为了首屏紧凑而删除分支、汇合、跨层连接或回路。
• 不得使用模块保存顺序判断执行先后；保存顺序只能作为同层稳定排序依据。
• 全局相机、全局变量、通信管理、光源和触发器等系统资源与主执行步骤分开显示。
• 参数订阅不与执行箭头混画，避免把“数据来源”误读成“执行先后”。
• 节点底色只表示功能类型；分支含义由连线颜色和路线标签表达。
• 能从节点名称、连接关系或参数订阅确认时，明确标注 OK、NG、识别结果、空盘、忙碌等路线，并将路线颜色沿独占路径持续到汇合、下一分支或结束。
• 证据不足时只使用中性的“路线 A/B”，不得为了好看而猜测 OK/NG。
• 交叉连线使用桥接效果；几何交叉不应被误读成模块连接。
• 页面副标题必须如实说明显示的节点数和保留的连接数。

overview 显示全部流程模块及其全部执行连接，隐藏系统资源；all 在此基础上补充系统资源。详细规则见 references/archify-output.md。

报告正确性要求

报告采用“读者优先、证据随后”的层次：

• 首屏：方案规模、入口、结果和一句话说明。
• 正文：按真实拓扑分步骤说明，明确分支与汇合。
• 阅读边界：区分确定事实与保守归纳。
• 技术附录：模块类型、完整执行连接、参数订阅、C#、XAML 和容器条目。

详细格式见 references/report-output.md。

常用选项

--report FILE              输出通俗报告和折叠技术附录
--json FILE                输出完整解析 JSON
--xaml FILE                单独提取运行时页面 XAML
--strings                  在技术附录中加入 UiParamData 可读字符串
--diagram FILE             输出 Archify HTML 或 workflow JSON
--diagram-detail overview  完整流程拓扑，不显示系统资源（默认）
--diagram-detail all       完整流程拓扑，并显示系统资源
--diagram-quality LEVEL    standard 或 showcase
--trace                    为一条真实连续路径启用有限追踪动画

生成 HTML 需要 Node.js 18+；报告、XAML、完整 JSON 和 workflow JSON 只依赖 Python 标准库。Archify 运行时已经随 Skill 打包，不需要安装 npm 包。

交付前检查

1. 运行解析并确认没有 parse_error。
2. 确认 workflow 中显示的节点集合符合所选 detail 模式。
3. 确认 workflow 边集合与相同节点范围内的 SOL 执行连接集合完全一致。
4. 确认 HTML 通过 Archify 产物检查且没有穿节点、裁切或非有限坐标。
5. 抽读报告首屏；普通用户应能在不展开技术附录的情况下复述主流程。

不能满足第 2 或第 3 项时，不得把“HTML 已生成”描述为“流程分析完成”。

重要解读

• 普通模块索引通常从 0 开始；全局变量常见于 13000+，流程常见于 10000+，运行时页面常见于 70000+。
• ModuStatus 常被条件分支订阅：通常 0 表示 NG，非 0 表示 OK，但具体分支含义仍应以模块配置为准。
• OK/NG 控件实际绑定以 BindingPath 为准，DataSourceInfo 主要是设计器元数据。
• 绑定路径可能使用索引风格或中文全名风格，新旧方案保存方式可能不同。

只读边界

必须遵守：

1. 不修改、不重写、不另存 SOL 文件。
2. 算法参数和全局变量值应通过 VM 官方 SDK 修改，再由 VM 自己保存。
3. UI 页面应优先在 VM 设计器内修改。
4. 不在 MoudleFrame、.mdata 或 UiParamData 二进制中猜测并替换参数。
5. 外部修改 XAML 可能触发“界面设计不兼容”提示；这属于设计器一致性问题，不代表修改安全。
6. 用户要求改写 SOL 时，说明该操作超出本 Skill 边界，并给出 VM SDK/设计器方向。

参考资料

• references/report-output.md：需要解释报告结构、用户语言或技术附录时读取。
• references/archify-output.md：需要生成、检查或排查 Archify 产物时读取。
• references/sol-format.md：需要解释 SOL 容器、模块类型、XAML 或 SDK 边界时读取。

本 Skill 支持 VisionMaster V4.x 已验证格式。遇到其他版本或缺失 VmServer.xml 的方案时，应明确标注兼容性不确定，不把退化解析结果描述为完整结果。