指南 · VS Code 扩展

VS Code 扩展怎么被 AI 推荐?

更新于 2026-11-09 · kagentx

短答案

把 package.json 的 description 和 README 第一段写好。2026-11-09 实测:VS Code Marketplace 的扩展详情页没被 robots.txt 禁止,页面 title 是显示名,meta description 是固定前缀加 package.json 的 description,README 正文直接在 HTML 里;Open VSX 的扩展页只有约 4.9 KB 的空壳,数据在公开接口里,robots.txt 没有点名 AI 爬虫。官方文档说 keywords 最多 30 个,只写真实支持的内容。官网落地页补上商店页放不了的结构化数据和对比。AI 是否引用这些商店页,官方没有说明,我们未核实。

VS Code Marketplace 的页面,AI 读得到吗?

读得到的比较多。2026-11-09 我们读了 Marketplace 的 robots.txt 和一个扩展详情页(Prettier):详情页没有被 robots.txt 禁止,每个扩展有自己的 title 和描述,README 正文直接写在 HTML 里。AI 是否读取并引用这些页面,官方没有说明,我们未核实。

我们查到的结果(2026-11-09)能说明什么
robots.txtUser-agent *: Disallow /_apis/ , /publishers/ ; Sitemap扩展详情页可抓;发布者页不可抓;没有点名 AI 爬虫
titlePrettier - Code formatter - Visual Studio Marketplace扩展的显示名加商店名,每个扩展不同
meta description / og:descriptionExtension for Visual Studio Code - Code formatter using prettier固定前缀加 package.json 的 description,所以 description 就是页面的描述
README 正文直接在 HTML 里(服务端渲染);README 里的外链带 nofollow不需要执行脚本就能读到 README
结构化数据没有 JSON-LD页面标记里没有 SoftwareApplication 之类的数据

这和 Chrome 应用商店不同:那边的 title 和分享标签是整个商店通用的(见 Chrome 扩展怎么被 AI 推荐?)。VS Code 扩展的 displayName、description 和 README 就是页面标题、描述和正文,所以要认真写。

Open VSX 的页面,AI 读得到吗?

页面本身读不到什么,但数据是公开的。Open VSX 的扩展页只有约 4.9 KB,title 是通用的 “Open VSX Registry”,没有描述,内容靠脚本渲染。同一个扩展的公开接口会返回名称、描述、分类、标签、仓库和下载数的 JSON。AI 爬虫是否读这个接口,未核实。

我们查到的结果(2026-11-09)
robots.txt点名一长串老爬虫和采集工具(如 MJ12bot、Wget、HTTrack)Disallow: /;其余爬虫 Allow: /,Crawl-delay: 2;没有点名 GPTBot、ClaudeBot、PerplexityBot
/extension/esbenp/prettier-vscodeHTTP 200, 4,885 bytes, title: Open VSX Registry
/api/esbenp/prettier-vscodeJSON: displayName, description, categories, tags, repository, homepage, license, downloadCount, averageRating, reviewCount, verified
tags来自 package.json 的 keywords(另有 __ext_ 开头的内部标签)

在 Prettier 这个例子里,Open VSX 接口里的名称、描述和标签,与 package.json 的 displayName、description、keywords 对得上。所以同一份 package.json 写好,两边的页面都受益;Open VSX 的 README 是否同样展示,我们未核实。

package.json 里哪几个字段会影响 AI 看到的内容?

displayName、description、keywords、categories、repository、homepage。下面是官方文档(2026-11-09 查看)的要求和我们的写法建议。

字段官方说明怎么写
displayName在商店里必须唯一名字加一个词说清功能,如 “Example SQL Formatter”;它会成为页面 title
description一句话说明扩展是什么、做什么一句话,含对象和能力:“Format SQL files in VS Code with one command; supports PostgreSQL, MySQL and SQLite.” 它会成为页面的 meta description
keywords最多 30 个,会并入商店标签只写真实支持的语言、框架、任务,5–10 个;不堆无关的热门词
categories只能从 17 个固定值里选选真正符合的一两个;Language Packs 只给显示语言扩展
repository / homepage显示在商店的 Resources 栏repository 填公开仓库(也用于改写 README 相对链接);homepage 填官网落地页
iconPNG,至少 128x128用 PNG,不用 SVG
{
  "name": "example-sql-formatter",
  "displayName": "Example SQL Formatter",
  "description": "Format SQL files in VS Code with one command; supports PostgreSQL, MySQL and SQLite dialects.",
  "version": "1.4.0",
  "publisher": "example-publisher",
  "categories": ["Formatters"],
  "keywords": ["sql", "formatter", "postgresql", "mysql", "sqlite"],
  "repository": { "type": "git", "url": "https://github.com/example/sql-formatter.git" },
  "homepage": "https://example.com/sql-formatter/",
  "icon": "images/icon.png"
}

上面是示例,名字和网址是占位。官方文档只说 description 和 displayName 有助于商店内搜索,没有写它们对 AI 回答有没有作用,这一点未核实。

README 开头怎么写?

README.md 就是商店页的正文(官方文档),所以第一段要像一个能直接引用的答案。

  1. 1. 第一段写定义

    “Example SQL Formatter 是一个 VS Code 扩展,用一个命令格式化 SQL 文件,支持 PostgreSQL、MySQL、SQLite。”不写“强大”“革命性”。

  2. 2. 紧接一张表:支持什么

    支持的语言或方言、需要的 VS Code 最低版本、是否支持 Open VSX 的编辑器。

  3. 3. 一个可复制的最小例子

    命令面板里的命令名、设置项 JSON,用代码块。

  4. 4. 设置项列出来

    每个设置项的名字、默认值、作用,写成表格。

  5. 5. 图片用 https,并写 alt

    官方要求 README 里的图片是 https 网址,SVG 只允许受信任的徽章。重要的信息不要只放在截图里。

  6. 6. 链到官网和更新日志

    更新日志见 更新日志页对 AI 搜索有用吗?;README 的通用写法见 GitHub README 会被 AI 搜索引用吗?。

官网还需要吗?

需要。商店页的版式你改不了,也不能放结构化数据;官网落地页能放一句话定义、对比页、结构化数据和更新日期。把 homepage 字段指向它。落地页的写法、对比页和 AI 抓取检查见 开发者文档怎么被 AI 搜索引用?、开源项目怎么被 AI 推荐? 和 结构化数据对 AI 搜索有用吗?。

先用 AI 爬虫检查 确认官网没拦 AI 爬虫(规则见 AI 爬虫的 robots.txt 怎么写?),再确认正文不靠脚本(见 AI 爬虫会执行 JavaScript 吗?)。

扩展如果是 AI 编程助手类,特有的问题见 AI 工具类产品怎么被 ChatGPT 推荐?。

做的是 Raycast 扩展的话,商店页和 package.json 怎么写,见 Raycast 扩展怎么被 AI 搜索找到?。

做的是 JetBrains 插件的话,Marketplace 插件页的 robots.txt、sitemap 和字段实测见 JetBrains 插件怎么被 AI 搜索找到?Marketplace 插件页实测。

做的是 Figma 插件的话,Figma 社区插件页的 robots.txt、sitemap 和官方上架要求见 Figma 插件怎么被 AI 搜索找到?社区插件页的 robots、sitemap 与官方要求。

常见问题

VS Code Marketplace 的页面会被 ChatGPT 引用吗?

我们没有找到官方说明,也没有拿到实际引用的证据,未核实。能确认的是:扩展详情页没有被 robots.txt 禁止,页面里有扩展自己的 title、描述和 README 正文(2026-11-09 实测)。

keywords 最多可以写几个?

官方的扩展清单文档(2026-11-09 查看)写明最多 30 个。建议只写 5–10 个真实支持的语言、框架和任务。

description 写在哪里,有什么用?

写在 package.json 的 description 字段。Marketplace 页面的 meta description 就是固定前缀 “Extension for Visual Studio Code - ” 加这句话,所以用一句话说清扩展做什么。

Open VSX 要单独发布吗?

Open VSX 是和 Marketplace 分开的网站,有自己的页面和接口。是否需要单独发布,以 Open VSX 自己的文档为准,我们未核实;VS Code 官方的发布文档没有提到 Open VSX。无论哪边,同一份 package.json 和 README 都会用到。

和 Chrome 扩展的做法有什么不同?

Chrome 应用商店详情页的 title 和分享标签是整个商店通用的,扩展的描述在内嵌脚本数据里;VS Code Marketplace 的 title、描述和 README 正文都是扩展自己的。所以 VS Code 扩展的 package.json 和 README 比 Chrome 扩展的商店字段更值得认真写。

出处

kagentx

你的页面,爬虫读得到吗?
让评测告诉你

评测检查爬虫能不能进、正文是否直出,再把买家的问题拿去问 ChatGPT、Perplexity、Claude(开联网搜索),看有没有提到你。基础版 $1,一般 2–3 分钟出结果。