批量选择与更新

跨分页选择短链，并批量更新目标 URL、营销活动和 UTM 参数。

入口与权限范围

进入“平台链接”，在原生短链列表下方找到“批量更新 URL”。工作区所有者和管理员可以更新工作区内的短链；Member 只能选择并更新自己创建的短链。外部短链不在此功能的处理范围内。

注意：操作前确认左上角当前工作区。批量更新始终受当前工作区和当前成员权限约束，不会跨工作区处理链接。

从短链列表跨页选择

列表会显示每条短链的创建人，并可将每页行数切换为 500。勾选短链后，选择状态按链接 ID 保存；切换分页、页大小、搜索条件或创建人筛选时，之前勾选的链接仍会保留，页面顶部会持续显示累计选择数量。单次最多选择 500 条。

1先使用短链、目标 URL、创建人或域名筛选缩小列表。
2勾选当前页所需链接；表头复选框只选择或取消当前页可见项。
3切换到其他页继续勾选，直到顶部累计数量符合预期。
4如需重新选择，点击“清除选择”。

提示：只要已选择至少一条链接，本次任务就只处理这些链接；批量表单中的“域名”和“短链正则”会被忽略，防止筛选条件意外扩大选择范围。

批量设置营销活动、UTM 与跳转链接

工作区 owner/admin 可对已选择的原生短链统一设置营销活动、完整跳转链接和 UTM 参数。营销活动可保持不变、改为指定活动或清除；UTM 可合并、替换或全部清除。

合并：只覆盖已填写的 UTM 字段，并保留目标地址上的其他查询参数
替换：移除原有 UTM 字段后写入本次填写的 UTM
清除：移除 utm_source、utm_medium、utm_campaign、utm_term 和 utm_content
完整跳转链接：填写后会把所选短链统一指向该地址，再按所选 UTM 模式处理

注意：批量设置立即生效且最多处理 500 条。Member 可编辑自己创建的单条短链，但不能执行工作区级批量设置。

不手工选择时如何确定范围

未勾选任何链接时，系统按“域名 + 短链正则 + URL 匹配内容”逐层筛选当前工作区的原生短链，再按“上限”处理最近创建的匹配结果。域名和短链正则可以留空，但 URL 匹配内容必填。

域名：仅检查所选域名下的短链；“全部域名”表示当前权限范围内的全部域名
短链正则：对短码（slug）进行匹配，不包含协议和域名
URL 匹配内容：对当前目标 URL 进行文本包含或正则匹配
上限：未手工选择时最多处理的匹配链接数量，允许 1–500，默认 100；文本模式会先在全部可见链接中匹配 URL，再应用此上限

短链正则配置

“短链正则”使用 JavaScript 正则表达式语法，并匹配短码本身。例如短链 https://go.example.com/campaign-2026 的匹配值是 campaign-2026。只填写表达式正文，不要添加两侧斜杠或 g、i 等标志。该字段留空表示不按短码过滤。

^ 和 $：限定必须匹配整个短码，建议在精确筛选时使用
.：匹配任意单个字符；如果要匹配字面量点号，请写 \.
.*：匹配任意长度字符，例如 ^sale-.* 可匹配 sale-a 和 sale-2026
[0-9]+：匹配一个或多个数字，例如 ^ad-[0-9]+$
(a|b)：匹配多个候选，例如 ^(spring|summer)-sale$

^campaign-[0-9]{4}$

注意：不要填写 /campaign-.*/g。正确写法是 campaign-.*。表达式区分大小写，且无效正则会在预览时直接报错，不会修改链接。

URL 匹配模式

“文本”模式把输入内容当作普通字符串，只要目标 URL 包含该文本就会命中，适合替换域名或固定路径。“正则”模式使用 JavaScript 正则语法，适合匹配动态路径并通过捕获组保留其中一部分。正则同样只填写正文，不写两侧斜杠和标志。

文本示例：https://old.example.com
正则示例：^https://old\.example\.com/path/(.*)$
URL 中的点号在正则模式应写成 \.，否则 . 会匹配任意字符
若需要匹配问号，应写成 \?；反斜杠在页面输入框中只需输入一次

替换模式

“替换整个 URL”会把命中的目标完整改成“替换为”中的 URL，因此该值必须是包含协议的有效绝对 URL。“替换匹配片段”只替换文本或正则命中的部分，并保留目标 URL 的其他内容；替换后的最终结果仍必须是有效 URL。

匹配：^https://old\.example\.com/path/(.*)$
替换：https://new.example.com/$1
结果：https://old.example.com/path/product-a → https://new.example.com/product-a

提示：正则替换片段可以使用 $1、$2 引用对应的捕获组，使用 $& 引用完整匹配内容。文本模式只替换第一次出现的匹配文本。

保留查询参数

启用“保留查询参数”后，如果替换得到的新 URL 没有查询参数，系统会把旧 URL 的查询参数复制到新 URL。若新 URL 已经包含查询参数，则以新 URL 为准，不会合并或覆盖。URL 片段（# 后内容）不属于查询参数。

旧地址：https://old.example.com/item?utm_source=ads
替换为：https://new.example.com/product
开启后：https://new.example.com/product?utm_source=ads

注意：如果替换规则本身已经通过捕获组保留了 ? 后内容，通常无需再依赖此选项。请在预览中检查是否产生重复参数。

同时替换其他跳转地址

启用“同时替换设备、应用商店、地理、语言和 A/B 跳转地址”后，同一条短链中的主 URL、桌面/手机/平板/iOS/Android 地址、App Store/Google Play 地址、地理与语言地址以及 A/B 变体地址都会使用同一条替换规则。即使旧地址只存在于附加跳转规则中，该短链也会被匹配。

注意：关闭此选项时只处理主 URL。请先预览并检查“共修改多少个跳转目标”，避免意外修改不希望变更的应用商店或区域落地页。

常用配置示例

更换域名并保留路径：URL 模式选“文本”，匹配填写 https://old.example.com，替换模式选“替换匹配片段”，替换填写 https://new.example.com
只处理活动短链：短链正则填写 ^campaign-.*，再配置 URL 匹配与替换规则
重组动态路径：URL 模式选“正则”，匹配填写 ^https://old\.example\.com/p/([^/?]+)，替换片段填写 https://new.example.com/product/$1
全部指向同一落地页：替换模式选“替换整个 URL”，替换填写完整的新地址

预览并应用

1设置处理范围、URL 匹配模式、替换模式和替换内容。
2点击“预览”，检查匹配、变更、跳过三项数量。
3逐项核对预览表中的短链、原 URL 和新 URL，尤其检查协议、路径、参数和捕获组结果。
4不超过 500 条时可点击“应用”立即更新；文本匹配需要处理更多结果时，点击“异步更新全部匹配项”。
5完成后重新筛选列表，并实际访问少量短链验证跳转。

匹配：范围内且 URL 规则命中的链接数
变更：新旧 URL 不同、实际会被更新的链接数
跳过：规则命中但替换后 URL 与原 URL 相同的链接数
异步全部更新：每批处理 500 条并自动重新入队，关闭浏览器后仍会继续，可在“营销工具 → 批量任务”查看累计进度

限制与常见错误

同步预览和应用一次最多处理 500 条；文本匹配且未手工选择链接时，可使用异步全部更新处理超过 500 条的结果
异步全部更新不支持短链正则或 URL 正则；替换内容也不能再次包含原匹配文本，以保证任务可以收敛并完成
URL 匹配内容最长 1000 个字符，短链正则最长 500 个字符，替换内容最长 2048 个字符
“Invalid slug regex”或“Invalid URL regex”：表达式语法无效，常见原因是括号、方括号未闭合
“Invalid replacement URL”：替换后的某个结果不是有效绝对 URL，请检查协议、捕获组和特殊字符
预览为 0：确认当前工作区、成员权限、已选链接、域名、短链正则和 URL 匹配模式是否正确

安全与恢复建议

注意：“应用”会立即修改线上跳转，没有自动撤销按钮。操作前先导出链接备份；先用少量链接预览并应用，验证成功后再扩大范围。若配置错误，可使用导出文件中的旧 URL 建立反向批量规则，或逐条编辑恢复。