OpenRobot.Litegraph.Common 1.0.0

OpenRobot.Litegraph.Common

Litegraph 流程引擎的基础模型层（net8.0）：画布图模型 + JS 语义取值 + 共享文本工具。 只描述「一张图画的是什么」，不含解析、校验与执行。

• 只读图模型：FlowGraph / FlowNode / FlowLink / FlowPort / FlowPropertyBag 是解析产物，也是节点处理器的输入。 集合在装配期一次写入、运行期只读，对外只暴露 IReadOnlyList 视图。
• 节点类型常量集中：NodeTypes 收全部 46 个 nodeType 字面量，PortTypeMap 给数据类型到端口类型 / 显示后缀的映射。 宿主与处理器一律引用常量，不手写字符串。
• JS 语义对齐：Js 实现前端 Litegraph 依赖的那套取值语义（松散比较、真值判断、类型强转、整数值不带小数尾巴）， 保证同一份画布在浏览器里和在 C# 里算出同一个结果。
• 零外部依赖：nuspec 依赖 group 为空。不引日志、不引 DI、不读配置，任何形态的宿主都能直接引用。

安装

<PackageReference Include="OpenRobot.Litegraph.Common" Version="1.0.0" />

包由本仓库产出：

dotnet pack Litegraph/OpenRobot.Litegraph.Common/OpenRobot.Litegraph.Common.csproj -c Release

依赖：无。包内只用 BCL 的 System.Text.Json 与 System.Globalization。

数字与日期格式化一律走 CultureInfo.InvariantCulture，不随宿主区域设置变化。

快速开始

图模型由解析器产出（OpenRobot.Litegraph.Core 的 FlowGraphParser / LitegraphService）， 本包提供类型与只读视图。拿到 FlowGraph 之后按 nodeType 分发、用类型化 getter 读配置：

using OpenRobot.Litegraph.Common.Models;
using OpenRobot.Litegraph.Common.Text;

foreach (var node in graph.Nodes)
{
    if (node.NodeType == NodeTypes.TriggerTimer)
    {
        // 缺键、类型不对都回落默认值，不抛
        var interval = node.Properties.GetInt("interval", 1000);
        Console.WriteLine($"#{node.Id} {node.Title} 每 {ValueFormat.Duration(interval)} 触发一次");
    }
}

查上下级

FlowGraph 自带邻接查询，不必自己遍历 Links：

var node = graph.GetNode(7)!;

foreach (var link in graph.IncomingLinks(node))
{
    var origin = graph.OriginOf(link);                          // 上游节点
    var connected = graph.IsInputConnected(node, link.TargetSlot);
}

格式化日志

ValueFormat 统一了截断与时间口径，避免各处自己拼字符串：

ValueFormat.Format(7000.0);                        // "7000"
ValueFormat.Format(null);                           // "<null>"
ValueFormat.FormatList(new object?[] { 1, "a" });   // 1, "a"
ValueFormat.Duration(420);                          // "420ms"
ValueFormat.Duration(1234.5);                       // "1.234s"
ValueFormat.Time(DateTimeOffset.Now);               // "14:03:22.517"

API 速查

图模型

常量与目录

文本与取值

已知限制

1. 不能在图模型上造图：FlowGraph.Nodes / Links 与 FlowNode.Inputs / Outputs 的 setter 是 internal， 只有 OpenRobot.Litegraph.Core 写得进去。要在进程里得到一张图，走 FlowGraphParser.Parse / LitegraphService.Load，不要指望 new FlowGraph { Nodes = ... }。
2. 不做连线合法性判断：PortTypeMap 只给映射与显示后缀，端口类型能不能连由 Core 的校验器判。
3. Snapshot() 不保留原始 JSON：它给的是深拷贝字典，数值统一成 double。 需要逐字保留原文（例如把画布原样回存云端）时，请自己留着原始字符串，不要在包里往返。
4. Js 不是 JS 引擎：只覆盖画布节点用到的那几个转换与比较，不要拿它求值任意表达式。

版本历史

1.0.0（首次发布）

• 画布图模型 FlowGraph / FlowNode / FlowPort / FlowLink / FlowPropertyBag
• NodeTypes 46 个节点类型常量、PortTypeMap、VariableCatalog、ConditionRule
• Js JS 语义取值、ValueFormat 文本格式化、LitegraphJson 共享 JSON 选项
• 零外部依赖