Surl 外链管理插件 · 功能清单

适用版本：v1.2（Typecho 1.2+ / 1.3，PHP 7.4+，兼容 PHP 8.3）
插件定位：站内统一管理外部链接 —— 别名跳转、访问统计、二维码生成、前台链接导航页、撰写页一键插入

---

一、外链管理（后台面板）

控制台入口：控制台 → 外链管理（仅管理员可见）

1.1 新增外链

字段	必填	说明
标题	✓	外链名称，如「XX保险产品详情」
分类	—	输入框自动补全已有分类，支持新建
别名	—	留空自动生成（如 plan-001）；全站唯一，重复时提示更换
标签	—	多个标签用逗号分隔，自动补全已有标签
外链网址	✓	需以 http:// 或 https:// 开头，格式校验

1.2 外链列表（每页条数可在设置中调整，默认 20）

• 展示列：标题 / 分类 / 别名与跳转地址 / 标签 / 外链网址 / 访问次数 / 二维码 / 操作
• 支持关键词搜索（匹配标题、别名、分类、标签、网址）与分类筛选
• 操作：编辑（弹窗修改全部字段）、删除（二次确认，提示二维码将失效）

1.3 编辑弹窗

• 修改目标网址：二维码保持不变，已印出的二维码依然有效
• 修改别名：跳转地址与二维码随之变化（页面有明确提示）

1.4 分类页签 / 标签页签

• 分别列出全部分类、标签：名称 / 外链数 / 前台页面地址 / 二维码

1.5 二维码

• 每条链接、每个分类页、每个标签页均可生成二维码
• 列表内小图，点击弹出大图
• 二维码内容为站内跳转地址（/go/别名/），目标网址后续更换不影响二维码

二、外链跳转

• 跳转地址：http://站点/index.php/go/别名/（开启伪静态后为 http://站点/go/别名/）
• 访问计数：每次跳转自动 +1，后台列表可见
• 防搜索引擎索引：跳转地址输出 X-Robots-Tag: noindex, nofollow

• 两种跳转方式（后台可选）：

  • 直接跳转（默认）：302 重定向到目标网址
  • 提示页跳转：展示品牌中转页，停留 N 秒后自动跳转，页面含醒目「立即跳转」按钮（青绿渐变），可自定义标题文字（支持 %s 标题占位符）与说明文案
• 不存在的别名返回 404

三、前台链接导航页（v1.2 全新独立外壳）

3.1 页面与路由

页面	地址（未开启伪静态）	地址（开启伪静态）
总览页（全部链接）	/index.php/surl/	/surl/
分类页	/index.php/surl/category/分类名/	/surl/category/分类名/
标签页	/index.php/surl/tag/标签名/	/surl/tag/标签名/
搜索	/index.php/surl/?q=关键词	/surl/?q=关键词

• 搜索匹配：标题 / 别名 / 分类 / 标签 / 网址
• 中文分类、标签名地址自动 URL 编码，可直接访问

3.2 页面结构

• 顶部栏：站点品牌 + 搜索框 + 图标按钮
• 分类导航栏：横向展示「全部 + 各分类」（带外链数量角标），当前项高亮
• Hero 区：页面标题与描述
• 链接卡片：主信息（标题、分类、标签、简介区）+ 二维码左右并排；含「复制链接」按钮（点击反馈"已复制"）与「访问链接」按钮
• 二维码点击弹出大图，Esc 关闭

3.3 响应式

断点	分类导航	搜索	卡片布局
大屏（>767px）	横向导航栏完整显示	顶部搜索框完整显示	左右布局
小屏（≤767px）	收纳为菜单按钮，点击展开抽屉（全部链接 + 各分类，当前项高亮，可点击跳转）	收纳为搜索按钮，点击展开搜索条	保持与大屏一致的左右布局（仅缩小二维码与内边距）

• 两个抽屉互斥展开，Esc 可关闭；小屏无横向滚动溢出

3.4 三套前台主题

主题	标识	风格
青绿	teal（默认）	青绿渐变头部 + 浅色页面，清新专业
橙红	orange	橙红渐变头部，热情醒目
白净	plain	纯白头部，极简素雅

• 切换即时生效，全站前台页面（总览/分类/标签/搜索）统一换肤

3.5 文案去品牌化（v1.2）

• 前台所有页面不再出现「外链」字样，以「链接导航」「全部链接」「访问链接」「搜索链接」等中性文案呈现

四、撰写页面板

在撰写文章与撰写页面编辑页的右侧栏（与自定义字段同区域）注入「链接库」面板：

• 搜索：按标题 / 别名 / 分类 / 标签 / 网址实时检索已有链接

• 新建：展开表单即可新建链接（标题、分类、别名、标签、外链网址），无需跳转后台

  • 别名重复、网址格式错误均有即时错误提示
• 删除：列表内可直接删除链接（二次确认）

• 插入：点击「插入」按钮，在编辑器光标处插入 [标题](站内跳转地址) Markdown 链接

  • 文章中使用跳转地址：后续在后台修改目标网址，已发布文章无需改动，跳转目标即时更新
  • 插入按钮有「已插入」反馈；列表重渲染（搜索/新建/删除后）仍可正常插入

五、插件设置（后台「设置」中的插件配置）

设置项	默认值	说明
前台主题	青绿	前台配色：青绿 / 橙红 / 白净（v1.2 新增）
伪静态	关闭	开启后跳转与前台地址去除 index.php；切换会改变二维码内容，已印制的二维码请谨慎操作
每页显示条数	20	后台外链列表分页大小
跳转方式	直接跳转	直接跳转 / 提示页跳转
提示页停留时间	3 秒	提示页跳转方式下停留秒数
中转页标题文字	空	支持 %s 占位符（替换为链接标题），留空使用「正在为您跳转：%s」
中转页提示文字	空	留空使用「您即将离开本站，前往外部链接」
禁用插件时	保留数据表	保留 / 删除（删除后数据无法恢复）

六、可靠性与安全

• 配置自动备份恢复：禁用插件时自动备份全部配置，重新启用时自动还原，升级插件无需重新配置
• 数据表独立（typecho_surl_links），禁用是否删表由设置项控制
• 后台动作（增删改查）仅管理员可操作，请求带安全 Token 校验
• 所有输出经 HTML 转义，中转页跳转地址 JSON 安全注入，无 XSS 注入面
• 跳转地址、中转页均对搜索引擎 noindex/nofollow，避免 SEO 权重流失