指南 · 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 分鐘出結果。