URL 解析器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-cn-url-parser。
技能介绍
调试时 URL 到底拆成了什么
在联调接口、排查重定向或核对埋点参数时,你经常需要确认:协议和主机是否正确、路径有没有多一层斜杠、query 里每个键值是否按预期编码。肉眼扫长串很容易漏掉 &、重复参数或 %E4%B8%AD 这类编码,日志里复制的 URL 也常带着不可见字符。
核心能力怎么用
本技能围绕「读—改—造」三类操作:
- URL 分解:把完整地址拆成协议、域名、端口、路径、查询串与锚点,便于逐项对照环境配置。
- 参数提取:按 key-value 列出
query参数,方便核对分页、搜索词、追踪 ID 等字段。 - 编码 / 解码:处理
%XX形式的中文与特殊字符,避免「页面上显示正常、服务端解析错位」的隐性 bug。 - URL 构建:从各部分组装成合法完整 URL,用于构造测试用例或对比 canonical 形式。
- 批量解析:一次输入多条 URL,适合对比多条跳转链或批量校验营销链接。
实现侧仅需 Python 3.6+,无外部依赖,适合在本地脚本或 Agent 工作流里快速调用,而不必再开浏览器开发者工具逐项点选。
适用边界
它解决的是结构化解析与编解码,不负责发起 HTTP 请求、校验证书或判断链接是否可访问。若你需要的是爬虫、短链展开或 OAuth 回调的完整安全审计,应配合网络层与安全审查工具使用。对非标准 scheme 或极度畸形的输入,解析结果应以「辅助判断」为准,关键路径仍建议对照 RFC 3986 与业务约定。
使用场景
- 联调搜索或列表接口时,从浏览器复制完整请求 URL,逐项核对 path 与 `q`、`page` 等 query 是否与服务端约定一致
- 排查 302 跳转后参数丢失,需要把 Location 里的 URL 拆开并解码 `%XX`,确认中文关键词是否被二次编码
- 上线前批量检查投放落地页链接,一次解析多条 URL,对照 UTM、渠道 ID 等追踪参数是否齐全
- 用路径、主机、query 各部分组装测试用 URL,对比 canonical 形式是否与生产环境生成的分享链接一致
适合人员
- 负责 OAuth 或支付回调的后端工程师,需要在不改代码的情况下核对 redirect_uri 的 query 结构与编码
- 维护 H5 分享与深链的前端工程师,经常要确认含中文标题的 URL 在 encode 后各端解析是否一致
- 测试多步跳转与埋点参数的 QA,需要把日志里一长串 URL 拆成可对照的键值列表做回归
- 整理外链与联盟链接的运营,要在发版前批量校验同一活动下多条链接的参数模板是否统一