Link Checker_知识管理 skill-PHP中文网

Link Checker

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

抓取网页并检测断链、重定向和HTTP错误。适用于审计站点链接、发现404错误及上线前验证URL。

链接检查器 : 检查 HTTP 状态代码的 URL, 在文档中找到断开的链接, 并跟踪链接的健康

功能概述

链接检查器 : 检查 HTTP 状态代码的 URL, 在文档中找到断开的链接, 并跟踪链接的健康是一项面向实际任务的技能，主要用于给它一个 URL, 完整的文件, 或一个批次地址 —— 它点击 ea。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

链接检查器（Link Checker）

检查 URL 的 HTTP 状态码，定位文档中的失效链接，并长期跟踪链接健康状况。可向其输入单个 URL、包含多个链接的文件，或一批地址列表 —— 它将使用 curl 逐一发起请求，记录响应状态码，并明确告知哪些链接有效、哪些已失效。所有结果均保存在 ~/.link-checker/ 目录下，便于回溯历史记录、提取统计信息及导出报告。

命令

`check`

检查单个 URL。发送 HTTP HEAD 请求并返回状态码。

link-checker check

输出内容包括状态码、人类可读的标签（如 OK、REDIRECT、CLIENT_ERROR 等）以及对应图标。

`scan`

从文件中提取全部 URL（支持 Markdown、HTML、纯文本等任意含 http:// 或 https:// 链接的格式），并对每个链接执行检查。

link-checker scan

使用 grep 提取 URL，自动去重后逐条检测。最终输出汇总统计，含成功与失败数量。

`batch`

一次性检查多个 URL。将待检 URL 作为参数传入即可。

link-checker batch    ...

`report`

基于当前会话的结果生成报告，支持三种格式。

link-checker report [txt|csv|json]

默认格式为 txt。报告将保存至 ~/.link-checker/report.。

`history`

显示历史日志中最近 50 条检查结果。

link-checker history

每条记录包含时间戳、状态码、状态标签及对应 URL。

`broken`

筛选并仅显示失败链接 —— 包括状态码为 4xx、5xx、超时及连接错误的情况。

link-checker broken

`stats`

展示全部检查记录的统计信息：总请求数、各状态类别（2xx、3xx、4xx、5xx、timeout、error）分布、成功率百分比，以及最常出现的状态码。

link-checker stats

`export`

将完整历史日志导出为文件，支持 csv、json 和 txt 格式。

link-checker export

导出文件将附带时间戳，并保存至 ~/.link-checker/ 目录。

`config`

查看当前配置或修改设置项。

link-checker config
link-checker config set

可用配置项包括：timeout（每次请求的超时秒数）、retries（失败时重试次数）、user_agent。

`help`

显示使用说明及所有可用命令。

link-checker help

`version`

输出当前版本号。

link-checker version

示例

# 检查某个 URL 是否可达
link-checker check https://example.com

# 扫描 Markdown 文件中的失效链接
link-checker scan ./README.md

# 批量检查多个 URL
link-checker batch https://example.com https://httpstat.us/404 https://httpstat.us/500

# 仅显示失效链接
link-checker broken

# 获取统计概览
link-checker stats

# 生成 JSON 格式报告
link-checker report json

# 将完整历史日志导出为 CSV
link-checker export csv

# 设置请求超时时间为 15 秒
link-checker config set timeout 15

# 设置失败重试次数为 3
link-checker config set retries 3

配置

所有配置项以键值对形式存储于 ~/.link-checker/config 文件中。

键（Key）	默认值	说明
`timeout`	`10`	每次请求的连接超时时间（单位：秒）
`retries`	`2`	发生超时或错误时的重试次数
`user_agent`	`LinkChecker/1.0.0`	随请求发送的 User-Agent 请求头

可通过 link-checker config set 修改任意配置项。

数据存储

所有数据均存放于 ~/.link-checker/ 目录下：

文件	用途
`results.log`	当前会话结果（管道符分隔）
`history.log`	所有历史检查记录的累积日志
`config`	配置键值对文件
`report.*`	生成的报告文件（txt/csv/json）
`export_.`	带时间戳的导出文件