dsh-url-tools

DSH URL 工具插件。注册一个 url_tool 工具，提供 URL 解析、跟踪参数清理、字符串编解码、重定向展开四种能力。零依赖、纯 ESM、无构建。

简介

• 工具名：url_tool
• 能力：parse（解析）/ clean（清理跟踪参数）/ decode（解码）/ encode（编码）/ expand（展开重定向）。
• 行为：永不抛异常。参数错误、非法 URL、网络错误、非法 % 序列都折叠为 { ok: false, error }；成功返回 { ok: true, ... }，且始终带回 action 回显。

安装

dsh plugin --profile  add file:./plugins/dsh-url-tools
# 或发布后：
dsh plugin --profile  add dsh-url-tools

参数

参数	类型	必填	说明
action	enum	✅	parse/clean/decode/encode/expand
url	string	✅	目标 URL（decode/encode 时是待处理字符串）

action 表

action	输入	输出（ok: true）	失败
parse	任意合法 URL	{ scheme, host, port, pathname, search, hash, username, params }；params 为 key → [值...]，重复键合并为数组	ok: false + error（非法 URL）
clean	含跟踪参数的 URL	{ url, removed, search }：url 清理后完整 URL、removed 被删参数键数组、search 原始 query 串	ok: false + error（非法 URL）
decode	百分号编码串	{ input, output }，整串 decodeURIComponent	ok: false + error（非法 % 序列）
encode	任意字符串	{ input, output }，整串 encodeURIComponent	—