Home

StackPanel 开发者指南

本指南说明 StackPanel 内核对外承诺的扩展契约、开放平台与官方工具。业务插件自身的商品模型、配置、部署和使用说明由该插件仓库的 Wiki 维护；本指南不重复它们。

StackPanel 是 API-first、微内核插件化的自托管业务平台。内核通过统一的 Capability 模型把同一项业务能力投影为 Web、Open Platform API、MCP 工具和内核 Agent 可调用的 Surface。 权限、审批、幂等和审计属于这个模型的一部分，不由调用方自行补齐。

文档与版本

本目录是 GitHub Wiki 的唯一源。当前内核契约版本为 0.4.0，宿主前端 ABI 为 1.0.0；兼容规则见版本与兼容性。版本、接口和 schema 的最终事实 来源是 @stackpanel/spec、运行时 capability registry 和契约快照，而不是本页中的示例。

修改本目录后执行：

node tools/publish-wiki.mjs --wiki /tmp/stackpanel-wiki
node tools/publish-wiki.mjs --wiki /tmp/stackpanel-wiki --check

发布器会生成全部 Wiki 页面和 _Sidebar.md。不要直接修改 Wiki。 完整发布要求见开发文档治理。

从这里开始

目标	入口
参与内核开发	准备工作、架构概览、版本与兼容性
编写内核扩展协议兼容的插件	插件介绍、Capability、Agent Surface
编写主题或前端包	主题介绍、前端包快速上手
让外部程序调用平台	Open Platform API v1、MCP
对接渠道/合作方业务	StackPanel Partner API v1
理解和扩展 AI 自动化	内核 Agent、Agent Surface

开发边界

• 内核只定义插件生命周期、权限、存储、扩展点、能力投影和打包信任边界。
• 插件仓库拥有其业务域文档；内核 Wiki 可以链接到插件 Wiki，但不维护其业务 API 细节。
• 公开 API、MCP 与 Agent 不得绕过插件自身的 route guard、权限、配额、幂等或审计。
• 新增可自动化的公开操作，必须先定义其 Agent Surface，再实现路由和调用界面。