AgentKit Studio
参考

插件市场目录 Schema

插件市场目录 schema v1:18 个条目字段、3 条内置条目与 6 个错误码。

目录文档结构

插件市场目录的 schema 版本是 1。远程索引是一个 JSON 文档,可以是数组,也可以是 { schemaVersion, plugins, updatedAt } 对象。

{
  "schemaVersion": 1,
  "updatedAt": "1970-01-01T00:00:00Z",
  "plugins": [
    {
      "id": "@scope/dsh-plugin",
      "displayName": "示例插件",
      "category": "协作",
      "tags": [
        "team"
      ]
    }
  ]
}
字段类型说明
schemaVersionnumber缺省按 1 处理;其他值直接拒绝
pluginsarray条目数组,上限 500 条
updatedAtstringISO 时间;无法解析时丢弃,不影响条目

条目字段

source 为 builtin 时额外接受就绪校验字段;远程文档不能声明它们,这是信任边界,不是可选项。

字段类型上限必填说明
idstring120是插件包名,同时作为去重键。
installSpecstring140是安装规格,缺省等于 id。
displayNamestring80否市场行标题,缺省等于 id。
descriptionstring400否一行说明,超长截断。
categorystring24否分组,缺省 其他。
tagsstring[]8 × 24否去重后截断。
featuredboolean—否仅 true 生效。
experimentalboolean—否渲染 beta 徽章。
capabilitiesstring[]12 × 40否能力标签。
homepagehttps URL400否非 HTTPS 丢弃。
repositoryhttps URL400否非 HTTPS 丢弃。
authorstring60否展示用署名。
icon`glyph \https URL`8 字符否
origin``builtin` \`remote``—是
expectedEntriesstring[]12 × 60否仅 builtin:就绪校验的条目名。
service{name, methods, probe?}16 methods否仅 builtin:就绪校验的 Host 服务。
readinessNotestring200否仅 builtin:就绪提示。
defaultEnabledboolean—否仅 builtin:安装后默认启用。

内置条目

产品自带 3 条精选条目,离线可用。就绪校验读取 Host 服务,未就绪时只给提示,不阻塞安装。

插件 iddisplayNamecategorycapabilities标记expectedEntries
@deepseek-ai/dsh-experimental-agent-team-profileAgent Teams协作4betaagent-team tool-agent-team ui-agent-team
@deepseek-ai/dsh-experimental-voice-input-bundle语音输入输入3betaspeech-to-text speech-to-text-sensevoice api-speech-to-text ui-voice-input
@deepseek-ai/dsh-experimental-auto-reviewAuto Review权限3betaauto-review

索引地址与合并

项值
环境变量AGENTKIT_STUDIO_DSH_PLUGIN_INDEX
别名DSH_PLUGIN_INDEX_URL
协议https:;http: 只允许 localhost / 127.0.0.1 / ::1
拒绝带用户名或密码的 URL、非 HTTP(S) 协议、无法解析的 URL
合并内置条目优先占位;远程同 id 覆盖文案字段,不覆盖就绪校验字段;新 id 追加
失败刷新失败保留上一次成功文档并标记为 stale,市场不清空

错误码

错误码源码位置
DSH_PLUGIN_CATALOG_INVALIDsrc/dsh-plugin-catalog.mjs:184
DSH_PLUGIN_CATALOG_VERSION_UNSUPPORTEDsrc/dsh-plugin-catalog.mjs:187
DSH_PLUGIN_CATALOG_TOO_LARGEsrc/dsh-plugin-catalog.mjs:191
DSH_PLUGIN_INDEX_TIMEOUTsrc/dsh-plugin-index.mjs:57
DSH_PLUGIN_INDEX_UNAVAILABLEsrc/dsh-plugin-index.mjs:58
DSH_PLUGIN_INDEX_URL_REJECTEDsrc/dsh-plugin-index.mjs:107

版本与兼容性

项值说明
schema 版本1不兼容变更必须升版本
条目上限500超出抛 DSH_PLUGIN_CATALOG_TOO_LARGE
内置条目3随产品发布,不联网
就绪校验仅内置远程文档无法声明探针

开发者入口

内容源码位置
目录归一化src/dsh-plugin-catalog.mjs
远程索引刷新src/dsh-plugin-index.mjs
插件发现src/dsh-plugin-discovery.mjs
插件市场 UIsrc/client/state/plugins.mjs

相关测试:

测试文件位置
dsh-plugin-catalog.test.mjstests/dsh-plugin-catalog.test.mjs
dsh-plugin-index.test.mjstests/dsh-plugin-index.test.mjs

本页导航