OPEN PLATFORM

开放平台 · 开放是写进宪法的

HiBuddy 与外部能力之间唯一的集成协议是 MCP（Model Context Protocol）。把你的服务挂载进来成为事件源或工具源；也可以把 HiBuddy 的能力接进你的系统。

MCP 服务接入

将你已有的 AI 助手、业务系统、数据库包装为 MCP 服务，挂载到 HiBuddy 即可被角色工作流调用。参考标杆：中船党校 AI 助手（M01）。

接入指南 →

Core API

事件注入、角色编排、轻应用版本、凭证保险库、审计日志——全部 REST 开放，OpenAPI 3.1 契约先行。

API 参考 →

轻应用 / Skill 市场

把经过业务验证的角色模板、轻应用、Skill 上架到市场，跨组织复用（预览，002 版本开放）。

上架预告 →

三步挂载你的 MCP 服务

# 1. 实现标准 MCP 服务（Streamable HTTP）
#    参考官方 mcp SDK：https://modelcontextprotocol.io

# 2. 在 HiBuddy 管理控制台登记（或调用 Core API）
POST /api/v1/mcp-services
{
  "name": "你的服务名",
  "endpoint": "https://your-service.example.com/mcp",
  "authType": "token",
  "credentialId": "vault://credentials/your-cred"   # 凭证存保险库，不留明文
}

# 3. HiBuddy 自动同步 tools/list，按角色授权后即可在
#    事件流 / 轻应用 AI 边缘 / Agent 执行中被调用（全程审计）

事件注入（你的系统 → HiBuddy）

任何系统都可以把事项注入 HiBuddy 事件总线，AI 富化后按角色分派，人确认后回执：

POST /api/v1/events
{
  "type": "external.yoursystem.review_request",
  "source": "system",
  "roleTargets": ["role_teacher"],
  "title": "一份材料待审阅",
  "payload": { "...": "结构化业务数据" }
}

开放承诺

承诺	内容
开放生态	企业微信 / 钉钉 / 飞书 / 邮件 / 自有系统多生态并存接入，统一调度，一视同仁
协议标准	唯一集成协议 MCP；不发明私有连接协议
资产可导出	角色 / 轻应用 / Skill / 知识库配置可导出 JSON，写进合同
模型自由	多模型路由 + BYOM；私有化默认适配国产模型
审计透明	每一次 MCP 调用、AI 处理、人工操作全程留痕可回溯

创建组织，开始接入