文档
推荐给好友,福利领不停!好友同步开通最高 1000 万词元额度 · 后续消费分佣最高 30%。
+50万 Token生成链接

插件与技能事实边界

插件文档改为对齐真实代码:Plugin 管提供方和市场状态,Skill 管可调用工具定义、包分发和认证。

真实模型

当前代码把扩展体系拆成两层:

事实来源作用
Pluginbackend/internal/model/plugin.go提供方、职责、MCP/HTTP/Workflow/Native 来源、启用状态、市场审核和执行入口
Skillbackend/internal/model/skill.go具体可调用工具定义、输入输出 schema、ZIP 包、公共商店、认证和安全评分

这意味着文档不能再把一个泛化的 package manifest 写成唯一入口。创建私有工具走 POST /api/v4/plugins;分发技能走 /api/v4/skill-store;MCP 工具导入走 /api/v4/plugins/mcp/*

可证明入口

  • GET /api/v4/plugins
  • GET /api/v4/plugins/market
  • GET /api/v4/plugins/:id
  • POST /api/v4/plugins
  • PUT /api/v4/plugins/:id
  • PUT /api/v4/plugins/:id/toggle
  • DELETE /api/v4/plugins/:id
  • POST /api/v4/plugins/sync
  • POST /api/v4/plugins/:id/execute
  • POST /api/v4/plugins/pre-check
  • POST /api/v4/plugins/:id/health-check
  • PUT /api/v4/plugins/:id/toggle-enabled
  • PUT /api/v4/plugins/:id/unpublish
  • DELETE /api/v4/plugins/presets
  • POST /api/v4/plugins/:id/publish-to-market
  • PUT /api/v4/plugins/:id/withdraw-market
  • POST /api/v4/plugins/:id/resubmit-market
  • GET /api/v4/plugins/:id/usage-stats
  • POST /api/v4/plugins/mcp/test
  • POST /api/v4/plugins/mcp/import
  • GET /api/v4/plugins/mcp/resources
  • POST /api/v4/plugins/mcp/resources/read
  • GET /api/v4/plugins/mcp/prompts
  • POST /api/v4/plugins/mcp/oauth/authorize
  • GET /api/v4/plugins/mcp/oauth/callback
  • POST /api/v4/plugins/bocha/test
  • POST /api/v4/plugins/bocha/create
  • POST /api/v4/plugins/zhipu/test
  • POST /api/v4/plugins/zhipu/create
  • POST /api/v4/plugins/dashscope-search/test
  • POST /api/v4/plugins/dashscope-search/create
  • POST /api/v4/plugins/skill-generator/test
  • POST /api/v4/plugins/skill-generator/create
  • public GET /api/v4/public/plugins
  • public GET /api/v4/public/plugins/:id
  • skill-store GET /api/v4/skill-store
  • skill-store GET /api/v4/skill-store/:id
  • skill-store GET /api/v4/skill-store/:id/certification
  • skill-store GET /api/v4/skill-store/:id/download
  • skill-store GET /api/v4/skill-store/admin/detail/:id
  • skill-store GET /api/v4/skill-store/admin/dump
  • skill-store GET /api/v4/skill-store/admin/list
  • skill-store GET /api/v4/skill-store/admin/subcategory-stats
  • skill-store GET /api/v4/skill-store/admin/unprocessed
  • skill-store GET /api/v4/skill-store/pending
  • skill-store GET /api/v4/skill-store/resolve/:key
  • skill-store POST /api/v4/skill-generator/generate
  • skill-store POST /api/v4/skill-generator/optimize
  • skill-store POST /api/v4/skill-generator/validate
  • skill-store POST /api/v4/skill-store/:id/certify
  • skill-store POST /api/v4/skill-store/:id/install
  • skill-store POST /api/v4/skill-store/admin/archive
  • skill-store POST /api/v4/skill-store/admin/batch-delete
  • skill-store POST /api/v4/skill-store/admin/batch-update
  • skill-store POST /api/v4/skill-store/admin/restore
  • skill-store POST /api/v4/skill-store/audit
  • skill-store POST /api/v4/skill-store/publish
  • skill-store POST /api/v4/skill-store/upload

SDK surface

  • Skill store: browseSkillStore, browseSkills, browseSkillsList, certifySkill, downloadSkill, generateSkill, getCertificationStatus, getSkillDetail, getSkillSummary, installSkill, optimizeSkill, resolveSkill, uploadSkill, validateSkill
  • Tools: getTool, listTools

当前边界

  • 私有插件创建后是 status=APPROVEDmarketStatus=NONE,不会自动上公共市场。
  • 公共插件浏览要求 status=APPROVEDmarket_status=APPROVEDis_enabled=true
  • Skill ZIP 包必须通过 ZIP 安全检查,最多 50 个文件、解压上限 50 MB。