自定义作品链接模板配置说明

# 自定义作品链接模板配置说明

## 一、功能简介

在作品分享设置弹窗中，「自定义作品链接」Tab 会根据后台配置的模板，自动生成一个或多个可复制、可直接打开的作品分享链接。

> 自定义作品链接配置位置

![](/media/202606/2026-06-22_115245_0222860.11011039191340122.png)
> 自定义作品链接配置后展示效果

![](/media/202606/2026-06-22_115206_3651200.5043615674941727.png)

每条链接由两部分组成：

- **链接标题**：展示在列表中的名称
- **链接模板**：含占位符的 URL 模板，系统会按当前作品、当前登录用户及其所属企业信息自动替换占位符

![](/media/202606/2026-06-22_114114_4807180.7914756651991467.png)

## 二、配置字段说明

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `linkTitle` | string | 是 | 链接标题，展示在每条链接上方，用于区分不同模板 |
| `linkTemplate` | string | 是 | 链接模板，含占位符的 URL，解析后生成最终分享链接 |

**配置示例（单条）**：

```json
{
  "linkTitle": "企业标准写法推荐",
  "linkTemplate": "https://www.baidu.com/a/custom/${sys.corp.openId|encodeURI}/h5redirect?url=${sys.creation.shareUrl|fullUrl|default:https://www.baidu.com/home}"
}
```

## 三、模板语法

### 3.1 占位符格式

```
${ <变量路径> [| <过滤器>[:<参数>] ]* }
```

- 以 `${` 开头、`}` 结尾
- 内部用 `|` 分隔：第一段是变量路径，后续段是过滤器
- 过滤器按声明顺序依次执行

### 3.2 变量路径

模板支持三种数据源：**作品信息**（`sys.creation.*`）、**我的信息**（`sys.user.*`）、**企业信息**（`sys.corp.*`）。三种数据源可在同一个模板中混用。

#### `sys.creation.*`（作品信息）

取自当前作品对象（`scene`），常用变量：

| 变量路径 | 含义 | 示例值 |
| --- | --- | --- |
| `sys.creation.id` | 作品 ID | `123456` |
| `sys.creation.code` | 作品码 | `abc123` |
| `sys.creation.shareUrl` | 作品分享链接 | `https://www.eqxiu.cn/c/abc` |
| `sys.creation.title` | 作品标题 | `我的作品` |
| `sys.creation.type` | 作品类型 | `h5` / `hd` |
| `sys.creation.cover` | 作品封面地址 | `https://file.eqxiu.cn/xxx.png` |
| `sys.creation.createTime` | 创建时间 | `2026-06-22 10:00:00` |

#### `sys.user.*`（我的信息）

取自当前登录用户信息（`userInfo`），常用变量：

| 变量路径 | 含义 | 示例值 |
| --- | --- | --- |
| `sys.user.id` | 用户 ID | `10086` |
| `sys.user.staffId` | 员工 ID | `20001` |
| `sys.user.corpId` | 当前企业 ID | `10001` |
| `sys.user.nickName` | 昵称 | `张三` |
| `sys.user.mobile` | 手机号 | `13800138000` |
| `sys.user.avatar` | 头像地址 | `https://file.eqxiu.cn/avatar.png` |
| `sys.user.country` | 国家 | `CN` |

#### `sys.corp.*`（企业信息）

取自当前登录用户所属企业信息，常用变量：

| 变量路径 | 含义 | 示例值 |
| --- | --- | --- |
| `sys.corp.id` | 企业 ID | `10001` |
| `sys.corp.name` | 企业名称 | `某某科技有限公司` |
| `sys.corp.openId` | 企业 OpenID | `o_abc123` |
| `sys.corp.productId` | 所属产品 ID | `0` |

> 变量路径支持多级取值，例如 `sys.creation.property.xxx`、`sys.corp.xxx.yyy`。若中间某一级为空，整段占位符解析为空字符串。实际可用字段以后端接口返回为准。

### 3.3 管道过滤器

| 过滤器 | 作用 | 适用场景 |
| --- | --- | --- |
| `encodeURI` | 对值做 `encodeURIComponent` 编码（编码所有非字母数字字符） | 编码 URL 中的单段参数，如企业 OpenID、作品码 |
| `fullUrl` | 对值做 `encodeURI` 编码（保留 `:` `/` `?` `=` `&` 等合法 URL 字符） | 编码完整 URL，作为查询参数传递 |
| `base64` | 对值做 Base64 编码（兼容 UTF-8 中文） | 需要把 URL 整体编码后传递 |
| `default:<值>` | 当变量为空时使用兜底值 `<值>` | 防止链接失效，`<值>` 可包含 `:` `/` `?` 等字符 |

**过滤器对比示例**（假设 `sys.creation.shareUrl = https://h5.eqxiu.com/g/abc?id=1`）：

| 写法 | 结果 |
| --- | --- |
| `${sys.creation.shareUrl}` | `https://h5.eqxiu.com/g/abc?id=1` |
| `${sys.creation.shareUrl\|encodeURI}` | `https%3A%2F%2Fh5.eqxiu.com%2Fg%2Fabc%3Fid%3D1` |
| `${sys.creation.shareUrl\|fullUrl}` | `https://h5.eqxiu.com/g/abc?id=1`（合法字符不编码） |
| `${sys.creation.shareUrl\|base64}` | `aHR0cHM6Ly9oNS5lcXhpdS5jb20vZy9hYmM/aWQ9MQ==` |

## 四、配置示例

### 示例 1：企业标准写法推荐

**模板**：

```
https://www.baidu.com/a/custom/${sys.corp.openId|fullUrl}/h5redirect?url=${sys.creation.shareUrl|encodeURI|default:https://m-bms.cmsk1979.com/home}
```

**解析过程**（假设 `corp.openId = o_abc+/=`，`creation.shareUrl = https://h5.eqxiu.com/g/abc`）：

- `${sys.corp.openId|fullUrl}` → `o_abc+/=`
- `${sys.creation.shareUrl|encodeURI|default:...}` → `'https%3A%2F%2Fh5.eqxiu.com%2Fg%2Fabc'`

**最终结果**：

```
https://www.baidu.com/a/custom/o_abc+/=?url='https%3A%2F%2Fh5.eqxiu.com%2Fg%2Fabc'
```

### 示例 2：Base64 加密跳转

**模板**：

```
https://www.baidu.com/r?u=${sys.creation.shareUrl|base64}
```

**最终结果**：

```
https://www.baidu.com/r?u=aHR0cHM6Ly9oNS5lcXhpdS5jb20vZy9hYmM=
```

### 示例 3：带作品 ID 和码的简单拼接

**模板**：

```
https://www.baidu.com/view?id=${sys.creation.id}&code=${sys.creation.code}
```

**最终结果**：

```
https://www.baidu.com/view?id=123456&code=abc123
```

### 示例 4：混用作品、用户、企业信息

**模板**：

```
https://www.baidu.com/tracker?corpId=${sys.corp.id}&userId=${sys.user.id}&creationId=${sys.creation.id}&title=${sys.creation.title|encodeURI}
```

**解析过程**（假设 `corp.id = 10001`，`user.id = 10086`，`creation.id = 123456`，`creation.title = 我的作品`）：

- `${sys.corp.id}` → `10001`
- `${sys.user.id}` → `10086`
- `${sys.creation.id}` → `123456`
- `${sys.creation.title|encodeURI}` → `%E6%88%91%E7%9A%84%E4%BD%9C%E5%93%81`

**最终结果**：

```
https://www.baidu.com/tracker?corpId=10001&userId=10086&creationId=123456&title=%E6%88%91%E7%9A%84%E4%BD%9C%E5%93%81
```

## 五、常见问题

### Q1：模板写好后展示为空或报错？

- 检查 `linkTemplate` 字段名是否拼写正确
- 检查 `${}` 是否闭合，`|` 是否成对

### Q2：变量名写错了会怎样？

占位符会原样保留或解析为空字符串（取决于变量路径是否能取到值）。建议上线前用真实作品验证一次。

### Q3：作品还没有分享链接时怎么处理？

用 `default` 过滤器兜底，例如：

```
${sys.creation.shareUrl|fullUrl|default:https://www.baidu.com/home}
```

当 `shareUrl` 为空时，会使用 `https://www.baidu.com/home` 作为参数值。

### Q4：过滤器顺序有要求吗？

有。过滤器按声明顺序依次执行，建议：

- **编码类**（`encodeURI` / `fullUrl` / `base64`）放在前面
- **`default`** 放在最后，避免兜底值再被编码

错误示例：`${sys.creation.shareUrl|default:https://x.com|encodeURI}` —— 兜底值 `https://x.com` 会被 `encodeURI` 编码成 `https%3A%2F%2Fx.com`。

### Q5：`default` 的兜底值能包含特殊字符吗？

可以。`default:` 后到下一个 `|` 或 `}` 之间的所有字符都是兜底值，可包含 `:` `/` `?` `=` `&` 等，例如 `default:https://www.baidu.com/home?id=1`。

## 六、截图占位清单
1.  分享设置弹窗中「自定义作品链接」Tab 的展示效果
![](/media/202606/2026-06-22_114952_1900200.3007183997036844.png)
2. 系统参数管理后台中的配置界面
![](/media/202606/2026-06-22_115030_8915350.33402463239094304.png)