Reference
Plugin catalog schema Plugin market catalog schema v1: 18 row fields, 3 builtin rows and 6 error codes.
The plugin market catalog schema version is 1. A remote index is a JSON document: either an array, or an object { schemaVersion, plugins, updatedAt }.
{
"schemaVersion" : 1 ,
"updatedAt" : "1970-01-01T00:00:00Z" ,
"plugins" : [
{
"id" : "@scope/dsh-plugin" ,
"displayName" : "Example plugin" ,
"category" : "Collaboration" ,
"tags" : [
"team"
]
}
]
}
Field Type Notes schemaVersionnumberDefaults to 1; any other value is rejected pluginsarrayRows, capped at 500 updatedAtstringISO timestamp; dropped when unparsable, without affecting rows
When the source is builtin, readiness fields are also accepted. A remote document cannot declare them; this is a trust boundary, not an option.
Field Type Limit Required Notes idstring120 Yes Package name; also the dedupe key. installSpecstring140 Yes Install spec; defaults to id. displayNamestring80 No Market row title; defaults to id. descriptionstring400 No One-line summary, truncated. categorystring24 No Grouping; defaults to 其他. tagsstring[]8 × 24 No Deduped then truncated. featuredboolean— No Only true counts. experimentalboolean— No Renders the beta badge. capabilitiesstring[]12 × 40 No Capability labels. homepagehttps URL400 No Non-HTTPS is dropped. repositoryhttps URL400 No Non-HTTPS is dropped. authorstring60 No Display credit. icon`glyph \ https URL` 8 字符 No origin``builtin` \ `remote`` — Yes expectedEntriesstring[]12 × 60 No builtin only: entries probed for readiness.service{name, methods, probe?}16 methods No builtin only: Host service probed for readiness.readinessNotestring200 No builtin only: readiness hint.defaultEnabledboolean— No builtin only: enabled after install.
3 curated rows ship with the product and work offline. Readiness probes read Host services; when absent they surface a hint instead of blocking install.
Plugin id displayName category capabilities Badge expectedEntries @deepseek-ai/dsh-experimental-agent-team-profileAgent Teams 协作 4 betaagent-team tool-agent-team ui-agent-team@deepseek-ai/dsh-experimental-voice-input-bundle语音输入 输入 3 betaspeech-to-text speech-to-text-sensevoice api-speech-to-text ui-voice-input@deepseek-ai/dsh-experimental-auto-reviewAuto Review 权限 3 betaauto-review
Item Value Environment AGENTKIT_STUDIO_DSH_PLUGIN_INDEXAliases DSH_PLUGIN_INDEX_URLProtocol https:; http: only for localhost / 127.0.0.1 / ::1Rejected URLs with a username or password, non-HTTP(S) schemes, unparsable URLs Merge Builtin rows reserve the id; a remote row overrides copy fields but not readiness fields; new ids append Failure A failed refresh keeps the last good document as stale; the market never empties
Code Source DSH_PLUGIN_CATALOG_INVALIDsrc/dsh-plugin-catalog.mjs:184DSH_PLUGIN_CATALOG_VERSION_UNSUPPORTEDsrc/dsh-plugin-catalog.mjs:187DSH_PLUGIN_CATALOG_TOO_LARGEsrc/dsh-plugin-catalog.mjs:191DSH_PLUGIN_INDEX_TIMEOUTsrc/dsh-plugin-index.mjs:57DSH_PLUGIN_INDEX_UNAVAILABLEsrc/dsh-plugin-index.mjs:58DSH_PLUGIN_INDEX_URL_REJECTEDsrc/dsh-plugin-index.mjs:107
Item Value Notes Schema version 1An incompatible change must bump it Row cap 500Exceeding it throws DSH_PLUGIN_CATALOG_TOO_LARGE Builtin rows 3Ship with the product, no network Readiness probes Builtin only A remote document cannot declare probes
Item Source Catalog normalization src/dsh-plugin-catalog.mjsRemote index refresh src/dsh-plugin-index.mjsPlugin discovery src/dsh-plugin-discovery.mjsPlugin market UI src/client/state/plugins.mjs
Related tests:
Test file Location dsh-plugin-catalog.test.mjs tests/dsh-plugin-catalog.test.mjsdsh-plugin-index.test.mjs tests/dsh-plugin-index.test.mjs