Plugins

GitHub

Plugins 官方组件库 是 Polaris AGI 的官方扩展插件库，完全兼容并支持以下工业界主流插件协议：

Anthropic MCP (Model Context Protocol) — stdio JSON-RPC 2.0 (2024-11-05 版本)
OpenAI Codex Plugin — 当前标准协议插件

核心插件库

1. Computer Use (电脑操控)

能力: 截图、鼠标移动/点击/拖拽、键盘输入。
技术栈: mss, pynput, pywinauto

原生与跨平台：纯 Python 编写，原生调用操作系统底层 API（支持 macOS / Windows / Linux）。
健壮性与卫生：内置状态缓存 TTL，宏级别的防焦点劫持机制，并具有自动截图垃圾回收功能，保证磁盘零泄露。
安全性：基于 config.json 的严格 App 黑/白名单拦截器。
宏适配器：专用的自动化处理器，用以绕过复杂的 GUI 限制（例如微信剪贴板注入，智能 UI OCR 漂移恢复）。

2. Browser Use (浏览器操控)

能力: 导航 URL，点击页面元素，填写表单，捕获屏幕截图。
技术栈: Python & uv 包管理器

亮点: 允许 AI Agent 通过纯 Python 脚本直接驱动并自动化控制浏览器，用于爬虫、网页操作或复杂的信息检索。

3. Knowledge Base (本地知识库读取)

能力: 列出目录内容，读取文件内容用于 RAG 检索生成。
技术栈: Python os 与 pathlib 原生模块

亮点: 无外部依赖；支持通过 POLARISAGI_KB_ALLOWED_DIR 环境变量对读取路径进行沙盒限制隔离。

安装与配置

步骤一：前置依赖

请确保系统中已安装 Python 3.10+ 和 uv (Astral 开发的极速 Python 包管理器)。

步骤二：在 Agent 中配置插件

对于 Claude Code / Claude Desktop

在 ~/.claude.json 中添加以下 MCP Server 配置：

{
  "mcpServers": {
    "polarisagi-computer-use": {
      "command": "uv",
      "args": ["run", "/绝对路径/polarisagi-plugins-official/plugins/computer_use/src/main.py"]
    },
    "polarisagi-browser-use": {
      "command": "uv",
      "args": ["run", "/绝对路径/polarisagi-plugins-official/plugins/browser_use/src/main.py"]
    },
    "polarisagi-knowledge-base": {
      "command": "uv",
      "args": ["run", "/绝对路径/polarisagi-plugins-official/plugins/knowledge_base/src/main.py"],
      "env": { "POLARISAGI_KB_ALLOWED_DIR": "/your/allowed/dir" }
    }
  }
}

对于 PolarisAGI AI Agent

PolarisAGI 底层会通过 pkg/extensions/marketplace/ 自动发现并安装此代码库中的插件，实现开箱即用的生态。

仓库结构

plugins/
  computer_use/
    .codex-plugin/plugin.json   # Codex 插件清单
    .mcp.json                    # MCP Server 配置
    src/main.py                  # Python MCP 服务器入口
    pyproject.toml
  browser_use/
    .codex-plugin/plugin.json
    .mcp.json
    src/main.py
    pyproject.toml
  knowledge_base/
    .codex-plugin/plugin.json
    .mcp.json
    src/main.py
    pyproject.toml

.agents/plugins/
  marketplace.json               # 整体的插件市场目录文件