Hermes Agent: 插件

# 安装 Jira 插件
hermes plugin install hermes-plugin-jira

# 安装 Notion 插件
hermes plugin install hermes-plugin-notion

# 现在可以直接对话
me: 查一下 PROJ-123 的状态
Agent: [Jira Plugin] PROJ-123: In Progress, 优先级 High

hermes-plugin-jira/
├── manifest.yaml         # 插件清单
├── tools/                # 插件提供的工具
│   ├── jira_search.py
│   ├── jira_create.py
│   └── jira_update.py
├── skills/               # 插件提供的技能
│   └── sprint-review.yaml
├── templates/            # 输出模板
└── config.yaml           # 插件配置

# manifest.yaml
name: "hermes-plugin-jira"
version: "1.2.0"
description: "Jira integration for Hermes Agent"
author: "community"
license: "MIT"

dependencies:
  hermes_version: ">=1.0.0"
  python_packages:
    - "jira>=3.5.0"

tools:
  - name: "jira_search"
    description: "Search Jira issues"
    category: "communication"
  - name: "jira_create"
    description: "Create Jira issue"
    category: "communication"
  - name: "jira_update"
    description: "Update Jira issue"
    category: "communication"

skills:
  - name: "sprint-review"
    description: "Generate sprint review report"

permissions:
  - network: ["*.atlassian.net"]
  - filesystem: []
  - env_vars: ["JIRA_URL", "JIRA_TOKEN"]

# 从插件市场安装
hermes plugin install hermes-plugin-jira

# 从 Git 仓库安装
hermes plugin install git+https://github.com/user/hermes-plugin-jira

# 从本地路径安装
hermes plugin install ./my-plugin

# 安装指定版本
hermes plugin install hermes-plugin-jira@1.2.0

# 列出已安装插件
hermes plugin list

# 输出示例：
# ┌─────────────────────┬─────────┬──────────┬─────────┐
# │ Plugin              │ Version │ Status   │ Tools   │
# ├─────────────────────┼─────────┼──────────┼─────────┤
# │ jira                │ 1.2.0   │ ✅ Active│ 3       │
# │ notion              │ 0.9.1   │ ✅ Active│ 4       │
# │ figma               │ 0.5.0   │ ⏸️ Paused│ 2       │
# └─────────────────────┴─────────┴──────────┴─────────┘

# 更新插件
hermes plugin update jira

# 禁用插件（不卸载）
hermes plugin pause figma

# 启用插件
hermes plugin resume figma

# 卸载插件
hermes plugin uninstall figma

# 安装
hermes plugin install hermes-plugin-github

# 配置
hermes config set plugins.github.token "${GITHUB_TOKEN}"
hermes config set plugins.github.default_repo "myorg/myrepo"

# 使用
me: 列出待审查的 PR
Agent: [GitHub Plugin] 找到3个待审查PR：
  - #42: Fix auth flow (alice, 2h ago)
  - #43: Add rate limiting (bob, 5h ago)
  - #44: Update dependencies (carol, 1d ago)

# my_plugin/tools/hello.py
from hermes import Tool, ToolResult

class HelloTool(Tool):
    name = "hello"
    description = "Say hello to someone"
    category = "custom"
    
    parameters = {
        "name": {"type": "str", "required": True}
    }
    
    def execute(self, name: str) -> ToolResult:
        return ToolResult(
            success=True,
            data={"message": f"Hello, {name}!"},
            summary=f"Greeted {name}"
        )

# my_plugin/manifest.yaml
name: "my-plugin"
version: "0.1.0"
description: "My custom plugin"
author: "me"

tools:
  - name: "hello"
    description: "Say hello"
    category: "custom"

permissions:
  - network: []
  - filesystem: []

# stock-plugin/tools/stock_query.py
from hermes import Tool, ToolResult
import httpx

class StockQueryTool(Tool):
    name = "stock_query"
    description = "Query stock price and metrics"
    category = "finance"
    
    parameters = {
        "symbol": {
            "type": "str",
            "required": True,
            "description": "Stock symbol (e.g., AAPL)"
        },
        "metric": {
            "type": "str",
            "required": False,
            "default": "price",
            "enum": ["price", "pe", "volume", "market_cap"]
        }
    }
    
    def execute(self, symbol: str, metric: str = "price") -> ToolResult:
        api_key = self.get_env("STOCK_API_KEY")
        response = httpx.get(
            f"https://api.stock.com/quote",
            params={"symbol": symbol, "apikey": api_key}
        )
        data = response.json()
        
        return ToolResult(
            success=True,
            data=data,
            summary=f"{symbol} {metric}: {data.get(metric, 'N/A')}"
        )

# 安装前审查插件权限
hermes plugin audit hermes-plugin-xxx

# 输出示例：
# ⚠️ 权限审查：
# - network: *.example.com ✅
# - filesystem: /tmp ⚠️ (建议限制范围)
# - subprocess: true ❌ (建议禁用或审查代码)
# - env_vars: API_KEY ✅