URLs-LE

URLs-LE：轻松提取 URL

一键提取当前文件中的所有 URL
适用于任何文本文件——Markdown、HTML、CSS、JavaScript、TypeScript、JSON、YAML、Properties、TOML、INI 和 XML，并能识别需要排除的内容

觉得有用？ 点星标或评分能帮助其他开发者发现它—— ★ GitHub · ★ Open VSX · ★ Marketplace

功能

打开文件，运行 URLs-LE: Extract URLs，文档中的所有 URL 都会出现在新的编辑器中，然后可在其中去重和排序。适用于 VS Code 以及基于 VS Code 的编辑器，例如 Cursor 和 VSCodium（可从 Open VSX 安装）。

• 链接审查 — 提取 Markdown 和 HTML 中的所有链接、自动链接和纯文本 URL（排除 Markdown 代码块和 HTML 注释）
• 源代码审查 — 提取 JS/TS 中字符串字面量、模板字面量和注释里的 URL
• 配置文件扫描 — 提取 JSON 字符串、YAML 值、Java 属性、TOML/INI 值以及 XML（Maven POM、信息源）中的 URL

安装

在 AI Agent 中使用

同一提取引擎也作为 MCP 服务运行，因此 Agent 可以直接调用它，无需你运行命令。

extract_urls(content, format?, filename?, dedupe?, maxResults?)

返回每个 URL 及其协议和从 1 开始计数的行号与列号；默认最多返回 500 个，并通过 meta.truncated 标记，避免大型文件内容淹没 Agent 的上下文窗口。

该服务接收内容并返回数据 — 不读取文件，也不会自行发起网络请求。它以 urls-le-mcp 的名称发布在 npm 上，并以 io.github.nolindnaidoo/urls-le 的名称列入 MCP 注册表。

{
  "mcpServers": {
    "urls-le": {
      "command": "npx",
      "args": ["-y", "urls-le-mcp"]
    }
  }
}

npm install -g urls-le-mcp

{
  "mcpServers": {
    "urls-le": { "command": "urls-le-mcp" }
  }
}

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y urls-le-mcp

Extract 会读取当前打开的文档。扫描会从磁盘读取多个文件，并生成一份报告。

• 整个工作区：在命令面板中运行 URLs-LE: Extract URLs from Workspace。
• 一个文件夹：在 Explorer 中右键单击该文件夹，然后选择 Extract URLs from Folder；或者运行 URLs-LE: Extract URLs from Folder 并选择一个文件夹。

项目中同一个 URL 往往会出现在许多地方，因此报告会列出不同的 URL，按使用频率从高到低排列，并显示每个 URL 出现的次数和位置：

# URLs-LE workspace report

`my-project` · 3 file(s) read · 2 distinct URL(s), 5 occurrence(s) in 3 file(s)

| URL | Occurrences | Files |
|---|---|---|
| `https://example.com/docs` | 3 | 2 |
| `https://api.example.com/v1` | 2 | 2 |

## `https://example.com/docs` (3)

- `config.json` · **2:12**
- `docs/a.md` · **1:5**, **1:34**

## `https://api.example.com/v1` (2)

- `docs/a.md` · **2:6**
- `src/b.ts` · **1:14**

以上示例启用了 urls-le.showPositions。该设置默认关闭，此时每行会显示文件和 URL 在其中出现的次数：docs/a.md (2)。剪贴板中的内容遵循 urls-le.clipboardIncludesPositions 设置，与 Extract 的行为相同。

扫描会读取什么。 文件来自磁盘，因此不会读取尚未保存的编辑内容。超过安全大小限制的文件，或不是 UTF-8 文本的文件，都会被跳过。扫描最多处理 5,000 个文件或 10,000 个列出的出现位置。报告末尾会针对每项跳过内容添加一行，避免让人误以为简短的报告代表项目没有问题。

扫描会跳过什么，以及如何更改。 有三个开关默认处于启用状态，可在 Settings 中分别关闭：

还可以通过两个列表调整结果，而无需关闭开关。如需跳过更多内容，请将模式添加到 scanExcludes。如需读取开关原本会跳过的内容，请将其添加到 scanAlwaysInclude：

{
	// Also skip the test fixtures.
	"urls-le.workspace.scanExcludes": ["**/fixtures/**"],
	// Read the vendored code, though the built-in list skips it.
	"urls-le.workspace.scanAlwaysInclude": ["**/vendor/**"]
}

URLs-LE: Open Settings 会在 Settings 编辑器中打开所有这些设置。

影响扫描的设置位于 Settings 下。

CLI

相同的提取操作也可以在终端或 Shell 管道中运行：Rust CLI 位于 crate/，并与扩展共享同一语料库 — crate/fixtures/ — 因此两者读取文档的方式始终一致。可以通过 npm 安装（npm install -g url-le），或使用 npx url-le 运行；也可以通过 crates.io 安装（cargo install urls-le）。两种方式安装的都是同一个 urls-le 命令，输出必须逐字节保持一致。npm 包命名为 url-le，因为 urls-le 在 npm 上已被占用。

urls-le .                     # every URL in the tree; JSON on stdout when piped
urls-le --dedupe docs/        # one line per distinct URL
urls-le mcp                   # the same extraction over MCP on stdio

# the point of the whole thing:
urls-le . | jq -r '.urls[].value' | sort -u | lychee -

可从 npm (url-le) 或 crates.io (urls-le) 安装。 两种方式安装的都是同一个 urls-le 命令。

npm install -g url-le   # or run it once: npx url-le
cargo install urls-le

退出码遵循 grep 的惯例 — 找到 URL 返回 0，未找到返回 1，问题格式错误返回 2 — 因此 if urls-le src/; then … 可以正常工作，而什么都没找到也算是一种结果，不是错误。

它刻意不作任何判断。 不检查链接，不提供不安全协议标记，也不做过滤。在生产配置中，http:// URL 是错误的；在测试夹具中，它却是正确的。替你做决定的工具只会让你去配置它、跟它争论，最后将它静音 — 而静音时，提取功能也一并消失了。把结果传给 lychee，让它来做判断。

支持的格式

不会拒绝任何文档。 上述 11 种格式知道要排除哪些内容；其他所有语言 ID — python、go、shellscript、csv、plaintext、log，以及编辑器中的其他名称 — 都会扫描全文，因为 URL 在任何文本中都含义明确，而且这些格式中没有值得排除的内容。

提取的协议：http、https、ftp、file、mailto（需要包含 @）、tel。每个匹配项都会报告其实际行号和列号 — TOML 的位置会在源文本中向前定位，重复的相同值可能导致位置近似。URL 在空白字符或引号／括号分隔符处结束，因此不会提取相对链接（/docs）和裸域名（example.com）；包含原始空格的 URL 则会被提取为在空格处截断的部分。末尾的 ./, 会保留 — 它们是合法的 URL 字符。

命令

默认情况下，没有命令绑定快捷键。可在编辑器的 Keyboard Shortcuts 中为任意命令设置快捷键。

设置

语言

除英语外，还支持 12 种语言：

德语 · 西班牙语 · 法语 · 印度尼西亚语 · 意大利语 · 日语 · 韩语 · 葡萄牙语（巴西）· 俄语 · 乌克兰语 · 越南语 · 简体中文

两部分内容均已本地化：清单（命令标题、设置名称和说明），以及扩展运行时显示的所有内容（通知、状态栏、排序快速选择器）。扩展会遵循 VS Code 的显示语言，因此会与编辑器当前设置的语言保持一致；扩展本身没有单独的语言设置。

隐私与安全

• 无法访问网络。 扩展不会获取、验证或 ping 它提取的 URL——它只读取当前活动文档的文本。telemetryEnabled 设置会将事件写入本地输出通道，供你检查（URLs-LE Telemetry）；不会有任何数据离开你的设备。
• MCP 服务同样遵循这一原则。 它接收内容作为参数并返回数据：不访问文件系统、不进行网络调用、不收集遥测数据。你的 Agent 已经有读取文件的工具，因此在服务中重复实现这些功能只会增加路径遍历攻击面，却不带来任何新能力。如果服务导入了任何可能触及这两者的内容，check:mcp-bundle 就会导致构建失败。
• 错误通知会对主目录路径和类似凭证的字符串片段进行脱敏。
• 评分提示最多出现两次。 第 3 次成功使用时，扩展会询问你是否愿意评分；如果你选择 稍后 或关闭提示，则会在第 20 次使用时再询问一次。选择 不再询问 后就不会再提示。你自行将 notificationsLevel 设为 important 或 silent，也会关闭提示。计数保存在 VS Code 的扩展存储中，不会发送到任何地方；点击 评分 会在浏览器中打开你安装扩展时使用的市场页面——VS Code Marketplace 或 Open VSX。

文档

性能

在 Apple M5 Pro、24 GB RAM、Node 24.3.0 上预热后运行 7 次所得的中位数。输入由 scripts/benchmark.ts 生成，并未纳入代码库，因此上方列出的大小就是 实际测得的大小。运行 bun run benchmark 即可复现。

这些数据因机器而异，不会在 CI 中作为断言——用基准测试来阻止构建， 只能说明运行器当时有多忙。

测试

35 个文件中共包含 475 个测试用例，此外还有一套在真实 VS Code 扩展宿主中运行的集成测试，以及一项将构建好的 .vsix 安装到干净配置文件中的端到端测试。

覆盖率数据由真实运行生成，来源为 coverage/coverage-summary.json 和 coverage/test-results.json，并由 scripts/coverage-readme.js 生成；如果 本节内容发生偏差，CI 会失败。运行 bun run test:coverage 即可复现；用例 数量以 vitest 打印的数字为准。

LE 系列的更多工具

为每个模型眼前的工作打造的 16 款单一用途工具。每款都附带一个 Rust CLI 和一个 MCP 服务。一页尽览：letools.dev

提取

• String-LE — 提取代码库中的所有字符串，方便人工阅读
• Numbers-LE — 提取代码库中所有硬编码数字，方便人工检查
• Units-LE — 提取所有带单位的数量并统一格式，遇到含义不明确的数量时会按名称拒绝处理
• Dates-LE — 提取所有日期和时间戳，并给出每个日期和时间戳解析出的确切时刻
• IDs-LE — 提取所有 UUID、ULID、NanoID、ObjectId 和 Snowflake，并解码其中的时间
• IPs-LE — 提取所有 IP 地址、CIDR 网段和 MAC 地址，统一格式并按范围分类
• URLs-LE — 提取代码库中的所有 URL，并给出协议和确切位置
• Paths-LE — 提取代码库中的所有文件路径，并说明它们是否仍指向实际内容
• Colors-LE — 提取代码库中的所有颜色，并指出哪些颜色不在你的调色板中

检查

• Regex-LE — 查找代码库中的所有正则表达式，并报告哪些可能导致灾难性回溯
• Versions-LE — 查找某个依赖项在仓库的各个清单文件中受到不同约束的位置
• i18n-LE — 识别项目使用的 i18n 库，然后依据该库的规则审查其目录
• Scrape-LE — 在编写抓取器之前检查网页能否抓取，并说明何时无法判断

防护

• Secrets-LE — 查找代码库中的硬编码凭据，绝不在报告中打印凭据
• EnvSync-LE — 比较目录树中的 dotenv 文件，并指出哪些文件缺少哪些键
• Unicode-LE — 查找那些隐藏含义的 Unicode 字符——双向控制字符、不可见字符、同形异义字符、混合文字系统

每款工具都独立运行：没有共享的 crate，也没有发布的核心库。若有两款工具得出相同结论，那是因为这个答案经得起两次验证。

联系 — nolindnaidoo.com · GitHub · LinkedIn

nolindnaidoo 的其他项目

Rust — pixelcoords 和 pixelactions 构成一个工作循环：pixelcoords 回答 位置，pixelactions 在那里执行操作。它们有各自的工具、各自的风格——不属于 LE 系列。

• pixelcoords — 冻结屏幕，标记区域，获取像素级精确的坐标和裁剪图像 pixelcoords.dev · crates.io · docs.rs
• pixelactions — 使用经过人工验证的坐标执行交互，并确认操作已生效 pixelactions.dev · crates.io · docs.rs

许可证

MIT © nolindnaidoo