核心概念

理解 OpenVort 的核心架构和设计理念。

架构概览

OpenVort 的架构围绕以下核心概念构建：

用户 -> IM 平台 -> Channel 适配器 -> Dispatcher -> Agent Runtime -> Plugin Tools -> 外部系统

Agent Runtime

Agent Runtime 是 OpenVort 的核心引擎，负责执行 AI Agent 的推理和工具调用循环（Agentic Loop）。

Agentic Loop

基于 Claude 的 Tool Use API，Agent 遵循以下循环：

  1. 接收消息 — 从 Dispatcher 获取用户消息
  2. 推理 — Claude 分析消息，决定需要调用哪些工具
  3. 执行 — 调用对应的 Plugin Tool
  4. 反馈 — 将工具执行结果返回给 Claude
  5. 回复 — Claude 基于结果生成最终回复

这个循环会持续进行，直到 Claude 认为任务完成。

Plugin 体系

Plugin 是 OpenVort 的核心扩展单元。每个 Plugin 包含：

  • Tools — 可被 AI Agent 调用的工具函数
  • Prompts — 增强 AI 理解能力的 System Prompt 片段
  • 配置 — 插件所需的配置项

注册机制

插件通过 Python entry_points 自动发现：

# pyproject.toml
[project.entry-points."openvort.plugins"]
my_plugin = "openvort_plugin_xxx:MyPlugin"

安装方式

方式说明
pip install传统的 PyPI 安装
openvort marketplace install plugin author/slug从市场安装（支持 Bundle 和 PyPI）
管理面板一键安装在 Web UI 中点击安装

Dispatcher

Dispatcher 负责消息路由，包括：

  • 防抖 — 合并短时间内的连续消息
  • 去重 — 过滤重复的 Webhook 回调
  • 路由 — 将消息分发给正确的 Agent Session

Session

每个对话会维持一个 Session，包含：

  • 对话历史
  • 当前激活的 Plugins
  • 用户权限上下文

Skill 体系

Skill 是注入给 AI 的领域知识，分三级：

  1. 内置 Skill — 引擎自带（QA、PM、开发者等）
  2. 公共 Skill — 团队共享的自定义知识
  3. 个人 Skill — 个人私有的知识片段
  4. 市场 Skill — 从扩展市场安装的 Skill

Skill 内容类型

  • 角色 (Role) — 定义 AI 的身份和行为模式
  • 工作流 (Workflow) — 定义特定任务的执行流程
  • 知识 (Knowledge) — 注入领域专业知识

Bundle 模式

Skill 不只是一段 Markdown 文本。通过 Bundle 模式，Skill 可以包含：

  • SKILL.md — 核心内容（注入到 AI Agent）
  • README.md — 详细说明文档
  • templates/ — 配置模板
  • examples/ — 示例文件
  • scripts/ — 辅助脚本

扩展市场

统一的扩展市场整合了 Skill 和 Plugin，提供：

  • 搜索与发现 — 按类型、分类、标签筛选
  • 一键安装 — CLI 或 Web UI 安装
  • 版本管理 — 语义化版本 + 内容 Hash 自动检测
  • 低门槛发布 — 开发者可以通过网页表单、Bundle 上传或 CLI 发布
  • 社区互动 — 评论、收藏、下载统计