将 sitemap 从 9.x 升级到 10.x

根据 TypeScript 类型自动比较 sitemap 9.0.1 与 10.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	1
已修改的签名	2
已删除的类或接口成员	4
已修改的类或接口成员	6
新增弃用	3
要求变化（engines、peer 依赖）	1
新增导出	5

已删除的导出

import	export	kind	之前
`sitemap`	`UndefinedTargetFolder`	class	`class`

已修改的签名

export	之前	之后
`sitemap · LIMITS`	{ readonly MAX_URL_LENGTH: 2048; readonly URL_PROTOCOL_REGEX: RegExp; readonly MIN_SITEMAP_ITEM_LIMIT: 1; readonly MAX_SITEMAP_ITEM_LIMIT: 50000; readonly MAX_VIDEO_TITLE_LENGTH: 100; readonly MAX_VIDEO_DESCRIPTION_LENGTH: 2048; readonly MAX_VIDEO_CATEGORY_LENGTH: 256; readonly MAX_TAGS_PER_VIDEO: 32; readonly MAX_NEWS_TITLE_LENGTH: 200; readonly MAX_NEWS_NAME_LENGTH: 256; readonly MAX_IMAGE_CAPTION_LENGTH: 512; readonly MAX_IMAGE_TITLE_LENGTH: 512; readonly MAX_IMAGES_PER_URL: 1000; readonly MAX_VIDEOS_PER_URL: 100; readonly MAX_LINKS_PER_URL: 100; readonly MAX_URL_ENTRIES: 50000; readonly IS…	{ readonly MAX_URL_LENGTH: 2048; readonly URL_PROTOCOL_REGEX: RegExp; readonly MIN_SITEMAP_ITEM_LIMIT: 1; readonly MAX_SITEMAP_ITEM_LIMIT: 50000; readonly MIN_PRIORITY: 0; readonly MAX_PRIORITY: 1; readonly PRIORITY_STRING_REGEX: RegExp; readonly MIN_VIDEO_DURATION: 0; readonly MAX_VIDEO_DURATION: 28800; readonly MIN_VIDEO_RATING: 0; readonly MAX_VIDEO_RATING: 5; readonly MIN_VIDEO_VIEW_COUNT: 0; readonly MAX_VIDEO_TITLE_LENGTH: 100; readonly MAX_VIDEO_DESCRIPTION_LENGTH: 2048; readonly MAX_VIDEO_CATEGORY_LENGTH: 256; readonly MAX_TAGS_PER_VIDEO: 32; readonly MAX_NEWS_TITLE_LENGTH: 200; readon…
`sitemap · simpleSitemapAndIndex`	`({ hostname, sitemapHostname, sourceData, destinationDir, limit, gzip, publicBasePath, xslUrl, }: SimpleSitemapAndIndexOptions): Promise<void>`	`({ hostname, sitemapHostname, sourceData, destinationDir, limit, gzip, publicBasePath, xslUrl, logger, }: SimpleSitemapAndIndexOptions): Promise<void>`

已删除的类或接口成员

member	import	之前
`SitemapStream.smiStream`	`sitemap`	`any`
`SitemapAndIndexStream.currentSitemap`	`sitemap`	`any`
`SitemapAndIndexStream.isCreatingSitemap`	`sitemap`	`any`
`SitemapAndIndexStream.currentSitemapPipeline`	`sitemap`	`any`

已修改的类或接口成员

member	之前	之后
`SitemapStream.errorHandler`	`ErrorHandler \| undefined`	`(error: Error, level: ErrorLevel): void`
`InvalidAttrValue.constructor`	`(key: string, val: any, validator: RegExp): InvalidAttrValue`	`(key: string, val: any, validator: RegExp, url?: string \| undefined): InvalidAttrValue`
`SitemapItemLoose.priority`	`number \| undefined`	`string \| number \| undefined`
`XMLToSitemapItemStream.err`	`any`	`(msg: string): void`
`XMLToSitemapItemStream.logger`	`(level: "log" \| "warn" \| "error" \| "info", ...message: any): void`	`(level: "log" \| "warn" \| "error" \| "info", ...message: any[]): void`
`XMLToSitemapIndexStream.err`	`any`	`(msg: string): void`

新增弃用

export	@deprecated
`sitemap · EmptySitemap`	No longer thrown: since 10.0.0, `SitemapStream` emits an empty `<urlset>` when it ends without items. Kept so existing imports still resolve.
`sitemap · SitemapStream.xmlNS`	Use `xmlns`
`sitemap · XMLToSitemapItemStream.urlCount`	Use entryCount

要求变化（engines、peer 依赖）

	之前	之后
`engines.node`	`>=20.19.5`	`>=22.22.1`

新增导出 (5)

import	export	kind
`sitemap`	`Logger`	type
`sitemap`	`InvalidURLError`	class
`sitemap`	`InvalidVideoYesNo`	class
`sitemap`	`InvalidLinkHreflang`	class
`sitemap`	`SaxParserStreamOptions`	interface

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 sitemap 从 9 升级到 10 有哪些不兼容变更？

在 sitemap 9.0.1 与 10.0.0 之间，Vigia 发现 1 个已删除的导出、2 个已修改的签名，以及 10 个已删除或修改的类或接口成员。

sitemap 10 中弃用了哪些内容？

sitemap 10.0.0 中有 3 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/sitemap/upgrade?from=9.0.1&to=10.0.0