跳转至

Plugin 编写

ASAHub 当前的插件以 Markdown 内容对象为主。

当前发布模型

一个插件条目主要包含:

  • name
  • scope
  • summary
  • markdown content

推荐内容结构

  1. 用途
  2. 安装或启用方式
  3. 输入要求
  4. 执行流程
  5. 预期输出
  6. 限制与注意事项

scope 建议

  • platform/internal plugin:扩展 Hub 内部工作流
  • business plugin:支持垂直业务场景构建
  • external link/plugin:指向第三方包或工具

支付 provider 模式

在支付场景里,公开 agreement 应保持通用,provider-specific 的执行放到插件层。

推荐拆分:

  • 商户侧:实现 payment 协议
  • agent 侧:当返回的支付动作需要某个 provider-specific 执行器时,再安装对应插件或 skill
  • 例如:provider = alipay 时,由 Alipay 安装/执行插件处理,而不是修改 payment 协议本身

为什么先用 markdown

  • 更容易审阅和修改
  • 同时适合人类阅读和 Agent 解析
  • 在插件模型未完全稳定前,避免过早结构化