在流程图编辑器中，每个节点端口对外暴露的连接往往不是无限制的。比如某个输出端口每秒只能推送五百KB数据，与之相连的输入端口必须声明自己能承受的带宽上限与缓冲策略。用TypeScript做静态建模时，核心目标是把“端口能力”和“流量控制规则”变成可检查的类型，而不是散落在运行时的普通对象。
带宽与流量控制的核心概念
带宽限制通常指单位时间内允许通过的最大数据量，例如每秒多少KB或MB。流量控制则更关注调度方式，比如是否使用令牌桶、漏桶，或者简单的固定阈值丢弃。在类型系统里，我们需要把这些概念转成可辨识的结构。
如果不加约束，开发者可能写出这样的对象：const port = { id: 'out1', limit: 999 }，其中的limit单位完全不清楚，也无法区分是带宽还是并发数。通过TypeScript的类型声明，可以让编辑器在补全时直接提示合法字段，减少协作中的歧义。
用字面量类型锁定单位
带宽单位应当被限制为固定集合，避免字符串随意拼写。我们可以使用字面量联合类型来约束。
type BandwidthUnit = 'B/s' | 'KB/s' | 'MB/s';
interface BandwidthLimit {
value: number;
unit: BandwidthUnit;
}
上面的代码把单位收敛为三种常见值。任何赋值时写了'GB/s'以外的非法字符串，编译器都会报错。这种小约束在大型流程图配置里非常实用。
定义端口连接类型
端口连接不仅要描述自身带宽，还要说明采用的流量控制算法。我们可以用 discriminated union 来区分不同策略。
流量控制策略的联合类型
下面给出令牌桶与漏桶两种典型控制的类型定义，它们共享部分字段但通过type字段区分。
interface TokenBucketControl {
type: 'token_bucket';
bucketSize: number;
refillRate: number;
bandwidth: BandwidthLimit;
}
interface LeakyBucketControl {
type: 'leaky_bucket';
queueCapacity: number;
leakRate: number;
bandwidth: BandwidthLimit;
}
type FlowControl = TokenBucketControl | LeakyBucketControl;
这种写法让调用方在使用时必须通过类型守卫或分支处理不同算法，不会漏掉对queueCapacity之类字段的校验。在流程图连线校验逻辑中，类型收窄能大幅降低出错概率。
端口与连接的交叉类型
真实的节点端口连接还需要源端口ID、目标端口ID等信息。我们把流量控制嵌入到连接类型中。
interface PortRef {
nodeId: string;
portId: string;
}
interface PortConnection {
from: PortRef;
to: PortRef;
control: FlowControl;
}
function validateConnection(conn: PortConnection): boolean {
if (conn.control.bandwidth.value <= 0) {
return false;
}
return true;
}
在validateConnection中，由于control是联合类型，访问bandwidth是安全的，但访问bucketSize前必须用类型判断。这样的结构既灵活又安全。
完整可运行示例
下面示例展示如何声明一个带令牌桶限制的输出端口连接，并在模拟调度中读取配置。
const connection: PortConnection = {
from: { nodeId: 'nodeA', portId: 'out1' },
to: { nodeId: 'nodeB', portId: 'in1' },
control: {
type: 'token_bucket',
bucketSize: 1024,
refillRate: 256,
bandwidth: { value: 500, unit: 'KB/s' }
}
};
if (validateConnection(connection)) {
const ctrl = connection.control;
if (ctrl.type === 'token_bucket') {
console.log('令牌桶容量:' + ctrl.bucketSize);
}
}
该示例中所有字段都被类型约束，若把unit误写成'GB/s'会立即报错。同时，类型守卫保证了ctrl.bucketSize的访问合法。
类型扩展与最佳实践
当流程图需要支持更多算法，比如加权公平队列，只需在FlowControl联合类型中增加新接口。这种开放方式不会破坏已有连接声明。
建议在项目里把上述类型集中放在flow-types.ts中，并通过类型别名导出，方便节点组件与画布引擎共享。配合JSON Schema生成工具，还能把TypeScript类型直接转成后端校验规则，实现前后端带宽限制的一致性。
最后注意，端口连接类型不应过度嵌套，否则类型推断会变慢。保持带宽、控制策略、端口引用三层结构，是清晰与表达力之间的较好平衡。
TypeScript流程图节点带宽限制修改时间：2026-08-11 16:42:32