feat(capability): 转码能力包（vendor 纯 Go AMR-NB 解码器 + 黄金向量逐样本对照 + 8 哨兵 + 注册面）

internal/capability/transcode/limits.go

@@ -0,0 +1,71 @@
+package transcode
+
+import "time"
+
+// 三层上限 + 并发 + 超时的默认取值（design/25 §2.5，取值照设计，不得自行改）。
+// 全部具名：本包不存在裸数字。
+const (
+	// DefaultMaxInputBytes 是单次转码的输入字节上限（5 MiB）。取值与
+	// mediafetch.MaxVoiceBytes 相同但**不共用常量**：一个是「入站内联上限」，
+	// 一个是「转码输入上限」，共用会让「改一个静默改另一个」（design/25 §2.5）。
+	DefaultMaxInputBytes = 5 << 20
+	// DefaultMaxOutputBytes 是解码产物的字节上限（64 MiB）。AMR-NB 是唯一会放大的
+	// 那条路：12.2 kbps ≈ 1525 B/s → 8 kHz 单声道 PCM16 = 16000 B/s ≈ 10.5×，
+	// 加帧头最坏约 12.8×，5 MiB 输入最坏 ⇒ ≈64 MiB。没有这条闸就是
+	// 「上传 5 MB、内存里长到 64 MB」。
+	DefaultMaxOutputBytes = 64 << 20
+	// DefaultMaxDuration 是可确证的时长上限（10 分钟）：「正常语音」与「把整段录音
+	// 伪装成语音」的分界。可从 AMR 帧数确证（一帧 20ms），绝不估算。
+	DefaultMaxDuration = 10 * time.Minute
+	// DefaultConcurrency 是全局并发槽数（信号量容量）。
+	DefaultConcurrency = 2
+	// DefaultTimeout 是单次调用的 ctx 超时上限。
+	DefaultTimeout = 10 * time.Second
+)
+
+// Limits 是一次转码的资源约束（design/25 §2.5）。零值字段由 Engine 用上面的
+// 具名默认补足，因此 `Limits{}` 是安全的「全默认」。
+type Limits struct {
+	// MaxInputBytes 输入字节上限；命中即 ErrInputTooLarge（解码前拒绝）。
+	MaxInputBytes int
+	// MaxOutputBytes 产物字节上限；命中即 ErrOutputTooLarge。
+	MaxOutputBytes int
+	// MaxDuration 可确证的时长上限；命中即 ErrInputTooLarge。
+	MaxDuration time.Duration
+	// Concurrency 全局并发槽数；槽满即 ErrBusy（快速失败，不排队）。
+	Concurrency int
+	// Timeout 单次调用的超时；命中即 ErrTimeout。
+	Timeout time.Duration
+}
+
+// DefaultLimits 返回一组全默认的限额（design/25 §2.5 的取值）。
+func DefaultLimits() Limits {
+	return Limits{
+		MaxInputBytes:  DefaultMaxInputBytes,
+		MaxOutputBytes: DefaultMaxOutputBytes,
+		MaxDuration:    DefaultMaxDuration,
+		Concurrency:    DefaultConcurrency,
+		Timeout:        DefaultTimeout,
+	}
+}
+
+// withDefaults 用默认值补足零值字段。负数与零一并按「未配置」处理：限额的
+// 零值若照字面生效会变成「一字节都不许」，那不是任何调用方想要的行为。
+func (l Limits) withDefaults() Limits {
+	if l.MaxInputBytes <= 0 {
+		l.MaxInputBytes = DefaultMaxInputBytes
+	}
+	if l.MaxOutputBytes <= 0 {
+		l.MaxOutputBytes = DefaultMaxOutputBytes
+	}
+	if l.MaxDuration <= 0 {
+		l.MaxDuration = DefaultMaxDuration
+	}
+	if l.Concurrency <= 0 {
+		l.Concurrency = DefaultConcurrency
+	}
+	if l.Timeout <= 0 {
+		l.Timeout = DefaultTimeout
+	}
+	return l
+}