Initial commit: import Operit protocol plugins from xiaoli-cli

scripts/README.md

@@ -0,0 +1,84 @@
+# Operit 脚本目录
+
+此目录存放 **Operit AI 格式**的第三方工具脚本（`.js` / `.ts`）。
+
+`operit_bridge` 插件会自动扫描此目录，解析所有带 `METADATA` 块的脚本，
+并将它们注册为 xiaoli-cli 可调用的工具。
+
+## 如何使用
+
+### 1. 放入 Operit 脚本
+
+将 Operit 格式的 `.js` 或 `.ts` 文件放入此目录即可。脚本必须包含 `/* METADATA ... */` 块。
+
+```bash
+# 从 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 块：
+
+```javascript
+/*
+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