链接工具箱为 Halo 站点提供外链跳转提示、下载链接引导、白名单、短链接和访问统计。本指南按后台实际操作顺序介绍安装、配置和日常使用。
配图取自实际后台。新建短链接配图中的内容仅作填写示例；不同版本的表单和菜单可能略有差异。
1. 安装与授权
1.1 环境要求
| 项目 | 要求 |
|---|---|
| Halo | 2.26.0 或以上 |
| 依赖插件 | Lywq 核心插件（LywqPluginCore）3.1.0 或以上 |
| 产品授权 | 已购买链接工具箱，并在核心插件中绑定对应授权中心账号 |
1.2 安装步骤
- 在 Halo 后台安装并启用 Lywq 核心插件。
- 进入核心插件的授权配置，选择 静语工坊 授权中心（标识为
com.webjing.auth，地址为https://auth.webjing.com）。 - 绑定该授权中心账号的 PAT，确认账号具有链接工具箱的购买记录和可用授权。
- 进入 Halo 后台的 插件 页面，上传链接工具箱 JAR 安装包并启用。
- 授权检查通过后，在侧边栏找到 链接工具箱。
从使用旧授权核心的版本升级时，需要在 Lywq 核心插件中重新绑定静语工坊 PAT。旧核心的令牌和本地许可证不会自动迁移，已有购买记录由授权中心校验。
1.3 后台入口
插件启用后，主要使用三个页面：
| 页面 | 用途 |
|---|---|
| 链接扫描记录 | 查看内容的链接扫描配置，识别哪些内容已排除扫描 |
| 短链接 | 创建和维护短链接，查看启用状态、风险等级和访问次数 |
| 链接统计 | 查看展示、点击、设备占比、热门链接和域名分布 |
全局设置位于 插件 → 链接工具箱 → 设置，包括基本功能、跳转提示、白名单、短链接和链接预检配置。
2. 配置外链安全跳转
2.1 设置跳转页面
打开插件设置中的 基本功能与信息配置，按需要调整：
| 配置项 | 作用 |
|---|---|
| 浏览器标题 | 跳转页面在浏览器标签页中显示的标题 |
| 链接跳转页面模版 | 可选择默认展示页面、极客风格、波浪风格、深空背景或主题适配 |
| 波浪风格模版参数配置 | 选择波浪风格后设置两种渐变颜色 |
| 是否开启编辑器超链接卡片的识别 | 控制编辑器超链接卡片是否参与插件处理 |
| 文章发布时是否默认扫描链接 | 设置文章发布时的默认扫描选项；发布后可在单篇文章中核对和调整 |
| 倒计时秒数 | 配置提供倒计时的跳转页面，范围为 0～60 秒，0 表示不显示倒计时 |
| 白名单跳转模式 | 选择直接跳转或显示跳转页面 |
| 启用链接展示统计 | 开启后记录用户悬浮、触摸链接等展示交互 |
首次使用建议先选择内置模版，保存后在前台打开一篇包含外链的文章，确认跳转页面能够正常显示。
2.2 为单篇文章设置扫描规则
- 进入 Halo 后台 文章 列表。
- 打开目标文章的操作菜单，选择 链接安全跳转。
- 在 是否扫描该篇文章的链接 中选择 扫描链接 或 排除扫描。
- 如果文章包含需要下载引导的地址，在 下载链接 中逐条添加完整 URL。
- 点击 确认 保存，再打开前台文章测试。
选择“排除扫描”适用于需要保留原有普通链接行为的文章。单篇文章的扫描设置针对文章内普通链接；编辑器超链接卡片由全局的卡片识别开关单独控制。
2.3 查看链接扫描记录
进入 链接工具箱 → 链接扫描记录，可以搜索内容、按文章或页面筛选，并查看扫描状态。
这里保存的是内容级扫描配置，不是站点所有外链的完整抓取清单。“链接数”为 0 时，也可能只是没有在该配置中登记下载链接，不能据此认定文章没有外链。
删除扫描设置会移除该内容的专属配置。若只是希望某篇文章不再参与处理，应在文章的“链接安全跳转”中选择“排除扫描”。
3. 设置白名单和下载提示
3.1 添加可信域名
进入 白名单配置 → 不需要进行检测的白名单域名，每行填写一个域名，不带协议和路径，例如：
example.com
docs.example.com
*.trusted.example
完整域名用于配置指定站点；通配符用于配置相应域名范围。保存后分别测试普通外链和白名单链接，确认效果符合预期。
3.2 选择白名单跳转模式
- 直接跳转：访问可信链接时无感跳转。插件仍会经过跳转流程记录统计。
- 显示跳转页面：可信链接也显示跳转页面，可配合倒计时使用。
白名单用于减少可信站点的跳转提示。短链接的黑名单和风险预警在“链接预检配置”中单独管理。
3.3 从“链接管理”插件导入白名单
如果站点安装了 链接管理 插件，可以在 白名单配置 → 链接管理插件的数据配置 中启用兼容，将该插件中的链接纳入白名单。
如需排除异常友链等分组，在 排除的链接组别 中选择相应组别后保存。
3.4 配置下载引导
在 链接跳转提示信息配置 中设置：
| 配置项 | 用途 |
|---|---|
| 危险跳转信息提示 | 外链跳转页面的提醒文案 |
| 下载文件提示 | 下载引导页面的提示文案 |
| 微信公众号二维码名片地址 | 下载引导中展示的二维码图片 |
| 下载验证码 | 下载引导中使用的验证码 |
随后在目标文章的 链接安全跳转 → 下载链接 中添加对应地址。
如果使用编辑器超链接卡片，需要先启用卡片识别；下载卡片应在卡片标签上添加 type="download" 属性。配置后检查普通外链、下载链接和卡片链接三种情况。
下载验证码适合做下载前的提示和引导；文件自身的访问权限仍由文件存储或下载服务控制。
4. 创建和管理短链接
短链接将完整目标地址映射到站点内的 /s/{短链码}，便于分享和维护。
4.1 开启短链接服务
进入 短链接配置：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 启用短链接服务 | 开启 | 控制站点的短链接访问入口 |
| 默认短码长度 | 6 | 自动生成短码的长度，范围为 4～16 |
| 新建短链接默认启用 | 开启 | 新建时的默认状态；保存前也应核对表单中的启用选项 |
关闭短链接服务后，已有短链接的访问入口也会提示功能已关闭。
4.2 新建短链接
进入 链接工具箱 → 短链接，点击右上角 新建短链接。
按下表填写：
| 字段 | 是否必填 | 填写方式 |
|---|---|---|
| 目标链接 | 是 | 填写完整网址，例如 https://www.halo.run |
| 标题 | 否 | 便于后台识别，例如“产品下载页” |
| 短链码 | 否 | 留空自动生成；自定义时使用小写字母、数字和连字符 |
| 启用短链接 | — | 勾选后可通过短链接访问 |
例如，目标链接填写 https://www.halo.run，短链码填写 halo，保存后短链接形式为：
https://你的站点域名/s/halo
自定义短链码需在站点内保持唯一。系统会将字母转为小写，并去除不支持的字符；如提示冲突，请换一个短链码。
4.3 编辑、复制和停用
通过每条短链接的操作菜单可以：
- 编辑：修改目标地址、标题和启用状态。
- 复制短链接：复制可分享的短链接地址。
- 重新预检：按当前预检规则刷新后台显示的风险结果。
- 删除：删除映射，原短链接将无法继续访问。
编辑现有短链接时，短链码保持不变。需要暂时停止访问时，编辑并取消“启用短链接”即可。
列表支持关键词搜索、风险等级筛选和按创建时间排序，也会显示启用状态、风险等级与访问次数。
4.4 验证访问效果
保存后复制短链接，在新标签页中打开：
- 安全链接应正常跳转到目标地址。
- 可疑或危险链接可能先出现风险提示，具体取决于预检设置。
- 停用的短链接会提示已停用。
- 返回列表刷新，查看访问次数变化。
短链接访问次数统计的是短链接入口的访问。用户看到风险提示后未继续前往，也可能已计入该次数，因此它与外链“实际点击跳转”的统计口径不同。
5. 配置短链接预检
短链接预检根据本地规则分析目标 URL，提供安全、可疑、危险三种风险结果。
它使用域名、关键词和 URL 特征进行判断，不会抓取目标页面进行实时内容鉴定，也不能替代链接可用性检测。显示“安全”表示未命中当前规则，不代表目标网站永久可信。
5.1 配置项
进入 链接预检配置：
| 配置项 | 默认值 | 作用 |
|---|---|---|
| 启用短链接预检 | 开启 | 控制短链接的本地风险规则检查 |
| 命中高风险规则时强制拦截 | 关闭 | 开启后，危险链接会被拦截；关闭时展示预警并允许继续访问 |
| 可疑链接显示预警 | 开启 | 控制可疑链接是否先显示提醒 |
| 黑名单域名 | 空 | 每行一个域名，支持完整域名和 *. 通配符 |
| 可疑关键词 | 空 | 每行一个关键词，匹配目标域名和路径 |
| 可疑顶级域名 | 空 | 每行一个后缀，例如 .zip |
可按站点需要填写规则，例如：
黑名单域名
blocked.example
*.untrusted.example
可疑关键词
login
verify
wallet
关键词命中只是可疑信号。例如正常的登录页面也可能包含 login，应结合实际用途决定规则。
5.2 风险结果与访问行为
| 风险等级 | 典型原因 | 访问行为 |
|---|---|---|
| 安全 | 未命中当前规则 | 直接跳转 |
| 可疑 | 命中可疑关键词、顶级域名或域名特征规则 | 开启“可疑链接显示预警”时先显示提醒，否则跳转 |
| 危险 | 命中黑名单域名 | 强制拦截开启时阻止访问；关闭时提醒并允许继续 |
内置规则还会关注 Punycode 域名、IP 地址、过长域名和层级过深的域名等特征。
修改规则后，可以在列表中执行 重新预检，刷新保存的风险标签。访问短链接时也会按当前规则执行预检，列表中的旧标签可能与最新规则下的访问结果存在时间差。
6. 查看链接统计
进入 链接工具箱 → 链接统计，查看站点外链的互动情况。
页面包含链接总数、总展示量、总点击量、今日展示和点击、本周点击、转化率、设备占比、热门链接排行和域名分布。
6.1 统计口径
| 指标 | 含义 |
|---|---|
| 展示量 | 插件记录的链接展示交互，例如开启展示统计后的悬浮、触摸等行为 |
| 点击量 | 插件记录的实际执行跳转次数 |
| 转化率 | 点击量与展示量的比值 |
| PC / 移动端 | 根据访问设备信息区分的互动数据 |
| 今日 / 本周 / 本月 / 全部 | 对应时间范围内的统计 |
展示量不等于文章阅读量，展示和点击也不等于去重访客数。关闭展示统计后，应结合这一设置理解转化率。
6.2 排行与详情
- 在 热门链接排行 中切换今日、本周、本月或全部。
- 查看单条链接的展示量、点击量、转化率和设备分布。
- 打开链接详情，查看更具体的统计和来源信息。
- 通过 域名分布统计 了解外链流量集中在哪些站点。
- 新发生访问后，可使用 刷新统计 更新页面。
“清理数据”用于处理历史统计，操作前应先核对弹窗中的范围和条件。
6.3 添加仪表盘小组件
在 Halo 仪表盘的小组件配置中找到 链接工具箱 → 热门外链，可以调整标题、统计周期、显示条数、刷新间隔，以及是否显示概览统计。
适合希望登录后台后快速查看热门外链的站长。
7. 主题适配
使用插件内置跳转模版时，无需编写自定义页面。
如需让跳转页面与主题风格一致：
- 由主题开发者在主题
templates目录中提供jump.html。 - 在插件设置中将 链接跳转页面模版 选择为 主题适配。
- 在自定义页面中接入插件提供的跳转逻辑，并测试普通外链、白名单、下载验证和统计。
- 无自定义模版时，选择任意内置模版使用。
插件提供的前端脚本路径为：
/plugins/PluginLinkTools/assets/static/linkJump.js
主题开发者可使用 LinkJump.doJump() 执行带统计的跳转，并使用插件提供的倒计时、复制链接等方法。自定义页面应保留对应交互和统计逻辑。
8. 常见问题
启用插件时提示缺少依赖或授权失败
确认 Halo 与 Lywq 核心插件达到最低版本要求；检查核心插件是否启用，以及是否绑定了静语工坊授权中心的正确账号。旧版本升级后需要在新核心中重新绑定 PAT。
普通外链没有进入跳转页面
检查文章的“链接安全跳转”是否选择了“排除扫描”，目标域名是否已进入白名单，以及白名单是否使用直接跳转模式。测试时重新加载前台文章页面。
超链接卡片没有生效
先开启“是否开启编辑器超链接卡片的识别”。单篇文章的普通链接设置不会代替卡片识别开关；下载卡片还需要设置 type="download"。
可信链接仍显示跳转提示
核对域名写法是否带了协议或路径、是否需要覆盖子域名，以及白名单跳转模式是否选择了“显示跳转页面”。
下载链接没有要求验证码
确认该地址已添加到文章的“下载链接”中，并检查下载验证码配置是否为空。卡片形式的下载链接还应检查下载类型标记。
短链接提示不存在、停用或功能已关闭
依次检查短链码是否正确、记录是否存在、该记录是否启用，以及全局“启用短链接服务”开关是否开启。
修改预检规则后，列表标签没有变化
对目标短链接执行“重新预检”，然后刷新列表。访问短链接时使用的是当前规则。
统计数据与文章阅读量不一致
两者衡量的行为不同。链接工具箱记录链接展示交互、执行跳转以及短链接入口访问；文章阅读量统计的是文章访问。比较数据时应先区分这些口径。