xiaoli-cli-operit-plugins/scripts/README.md

Operit 脚本目录

此目录存放 Operit AI 格式的第三方工具脚本（.js / .ts）。

operit_bridge 插件会自动扫描此目录，解析所有带 METADATA 块的脚本， 并将它们注册为 xiaoli-cli 可调用的工具。

如何使用

1. 放入 Operit 脚本

将 Operit 格式的 .js 或 .ts 文件放入此目录即可。脚本必须包含 /* METADATA ... */ 块。

# 从 Operit 社区下载脚本
cp ~/Downloads/some_tool.js plugins/operit/

# 或从 Operit 仓库克隆
git clone https://github.com/AAswordman/Operit.git /tmp/operit-repo
cp /tmp/operit-repo/examples/*.ts plugins/operit/

2. 脚本格式要求

每个脚本头部必须有 METADATA 块：

/*
METADATA
{
    "name": "ToolName",
    "display_name": { "zh": "工具名", "en": "Tool Name" },
    "description": "工具描述",
    "author": ["作者"],
    "category": "Utility",
    "tools": [
        {
            "name": "function_name",
            "description": "功能描述",
            "parameters": [
                {
                    "name": "param1",
                    "description": "参数说明",
                    "type": "string",
                    "required": true
                }
            ]
        }
    ]
}
*/

3. 在 xiaoli-cli 中使用

operit_bridge list              # 查看已加载的 Operit 工具
operit_bridge scan plugins/operit  # 手动重新扫描
operit_bridge info ToolName__function_name  # 查看工具详情

AI 也可以直接通过 Function Calling 调用这些工具。

支持的 category

• Automatic - 自动化
• Chat - 对话
• Development - 开发
• Draw - 绘图
• File - 文件
• Life - 生活
• Map - 地图
• Media - 媒体
• Memory - 记忆
• Network - 网络
• Search - 搜索
• System - 系统
• Utility - 工具
• Workflow - 工作流

参考

• Operit 脚本开发指南: https://github.com/AAswordman/Operit/blob/main/docs/SCRIPT_DEV_GUIDE.md
• Operit 示例脚本: https://github.com/AAswordman/Operit/tree/main/examples