utm-link-generator

UTM 链接生成器

在统一的命名治理体系下生成带 UTM 标记的链接：通过 utm-registry.json 强制执行规范约定、防止重复和命名偏差，并输出适用于 LinkedIn、电子邮件、社交媒体和广告平台的链接。

目录

• references/naming-conventions.md -- 强制规则、UTM 参数参考、规范的来源／媒介列表、活动命名模式。
• references/platform-variants.md -- 各平台的链接模板（LinkedIn、电子邮件、社交媒体、付费广告）。
• references/registry-schema.md -- utm-registry.json 结构，以及验证报告和输出摘要模板。
• references/bulk-and-registry-ops.md -- 批量生成、注册表命令（审计／添加／报告／导出）、错误处理、集成和最佳实践。

功能

1. 生成带有经过验证且一致的参数的 UTM 标记网址。
2. 维护 utm-registry.json，追踪所有链接并强制执行规范。
3. 防止重复——当存在类似链接时发出警告。
4. 为特定平台（LinkedIn、电子邮件、社交媒体、广告）生成格式相符的链接。
5. 批量生成链接变体，用于 A/B 测试或多渠道活动。
6. 验证——拒绝格式错误的网址、空参数和违反规范的内容。
7. 报告——根据注册表生成活动追踪摘要。

工作流

1. 接收输入。 收集目标网址、来源、媒介和活动（均为必填），以及可选的关键词、内容和目标平台。若未明确提供，则从自然语言简介中提取这些信息。
2. 验证并规范化。 转为小写，将空格替换为连字符，移除不属于 [a-z0-9-] 的字符，自动纠正常见别名，拒绝未知的来源／媒介值（并建议最接近的匹配项），验证网址格式，并强制执行 50 个字符的限制。使用 references/registry-schema.md 中的模板报告修正内容。完整规则见 references/naming-conventions.md。
3. 检查注册表中是否存在重复项。 读取 utm-registry.json（若文件不存在则创建）。遇到完全重复项时返回现有链接；遇到近似重复项时允许继续，但发出警告；遇到命名冲突时阻止操作（活动相同，但大小写或连字符用法不同）。
4. 生成链接。 构建 {base_url}?utm_source=&utm_medium=&utm_campaign=[&utm_term=][&utm_content=][&utm_id=]。若基础网址已包含查询参数，则使用 & 追加；对值进行 URL 编码，并保留现有查询参数和片段。
5. 生成平台变体。 使用 references/platform-variants.md 为请求的平台生成优化链接。
6. 更新注册表。 根据 references/registry-schema.md 中的架构，将所有生成的链接追加到 utm-registry.json，并刷新统计数据和时间戳。
7. 输出摘要。 使用 references/registry-schema.md 中的模板提供可直接复制粘贴的摘要。

有关批量运行、注册表命令（审计、添加来源／媒介、活动报告、CSV 导出）、错误处理和集成说明，请参阅 references/bulk-and-registry-ops.md。