@ dualmark/ cli (英语)
dualmark verify <url> - AEO规格的合格测试跑手.
安装
bun add -d @dualmark/cli
# or run directly:
bunx @dualmark/cli verify https://example.com/blog/hello
使用量
dualmark verify https://example.com/blog/hello
dualmark verify https://example.com/blog/hello.md --skip-negotiation
dualmark verify https://example.com --json
dualmark verify https://example.com --timeout 5000
旗帜
| 旗帜 | 效果 |
|---|---|
--json | Emit 机器可读 JSON (AEO Spec v1.0) , 而不是人可读文本; 无法与 --quiet 或者说 --color |
--quiet | 禁止成功文本输出( 失败仍为打印报告) |
--color | 启用文本输出的颜色模式( 保留; 目前不开放) |
--no-color | 禁用文本输出的颜色模式( 保留; 目前没有) |
--skip-negotiation | 跳过接受标题 / 链接标题 / 406 检查 。 仅用于在 .md 不进行运行时间内容谈判的 URL( 如仅静态部署) |
--timeout <ms> | 按请求超时( 默认为 1 000) |
JSON 输出计划( AEO spec v1.0)
何时 --json 设置, CLI 打印此对象:
{
"url": "https://example.com/blog/hello",
"markdownUrl": "https://example.com/blog/hello.md",
"score": 95,
"max": 100,
"level": "advanced",
"skippedNegotiation": false,
"durationMs": 123,
"checks": [
{
"id": "md.fetch",
"points": 20,
"max": 20,
"passed": true,
"message": "OK"
}
]
}
注释:
level这是其中之一none, (中文(简体) ),basic, (中文(简体) ),standard, (中文(简体) ),advanced。 。 。 .skippedNegotiation显示是否--skip-negotiation当时使用了.checks[].points实值0当检查失败时,否则等于checks[].max。 。 。 .checks保留符合要求的跑者发出的犬科检查评价令.
退出代码
0通过(最高分的80%)1失败( 低于阈值或任何必要的检查失败)2— CLI 使用错误
关于 GitHub 动作、 GitLab CI 和 Docker 示例,请参见 CI 指南中的使用。 。 。 .
程序用途
import { verifyUrl } from "@dualmark/cli";
const report = await verifyUrl("https://example.com/blog/hello");
console.log(report.score, "/", report.maxScore);
检查什么
md.fetch——可被标记的双子 URL( 2xx)md.contentType—— 说text/markdown; charset=utf-8md.tokensHeader—— 说X-Markdown-Tokens是正整数md.noindex—— 说X-Robots-Tag包含noindexmd.vary—— 说Vary包含Acceptmd.body——身体不空虚md.aeoVersion—— 说X-AEO-Version广告(建议)md.nosniff—— 说X-Content-Type-Options: nosniff(建议)
当允许谈判时( 默认) :
html.reachable— HTML URL 为 2xxhtml.linkAlternate– HTML 响应通过 mark-down two 发布广告Link rel="alternate"html.vary— HTML 响应Vary: Accept(建议)negotiation.botUa——GPTBot UA收到减分negotiation.acceptHeader—— 说Accept: text/markdown接受减记negotiation.notAcceptable—— 接受排除 html+ markdown 返回406(建议)
许可证
Apache 2.0 (英语)