# xiaoli-cli-plugins

**Repository Path**: shuiyu1123/xiaoli-cli-plugins

## Basic Information

- **Project Name**: xiaoli-cli-plugins
- **Description**: 小狸 CLI 官方插件仓库
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xiaoli-cli-plugins

🔌 **小狸 CLI 官方插件仓库**

为 [xiaoli-cli](https://gitee.com/shuiyu1123/xiaoli-cli) 提供可一键安装的扩展插件。

## 快速安装

在 xiaoli-cli 中使用 `/plugin` 命令：

```
/plugin list              查看所有可用插件
/plugin install <插件码>   一键安装
/plugin remove <插件名>    卸载
```

示例：
```
> /plugin list
🔌 可用插件列表:
  dglab           ○ 未安装  DG-Lab 郊狼 WebSocket 控制
  onebot          ○ 未安装  OneBot v11 QQ 机器人

> /plugin install dglab
📥 正在安装: DG-Lab 郊狼 WebSocket 控制
   ✓ 文件已保存
   ✓ 已启用: ENABLE_DGLAB_WS = True
   ✓ 插件已加载
🎉 安装完成!
```

## 插件列表

### dglab — DG-Lab 郊狼控制

> 插件码: `dglab`

基于 [DG-LAB-OPENSOURCE](https://github.com/DG-LAB-OPENSOURCE/DG-LAB-OPENSOURCE) 官方 Socket V2 协议，通过 WebSocket 远程控制郊狼 3.0 脉冲主机。

- A/B 双通道强度控制（增加/减少/设置）
- 波形生成与发送
- APP 扫码配对
- 附带模拟器，无需真机即可测试

```bash
# 自然语言控制（AI 自动调用）
> 帮我把通道A强度调到50
> 发个波形，频率30强度50持续5秒

# 或直接命令
/dglab connect ws://192.168.1.100:9999
/dglab strength a + 10
/dglab pulse a 30 50 5
```

📄 [详细文档](./dglab_ws/README.md) | [DG-LAB 官方开源](https://github.com/DG-LAB-OPENSOURCE)

---

### onebot — QQ 机器人

> 插件码: `onebot`

让 xiaoli-cli 成为 QQ 机器人，通过 OneBot v11 协议连接 QQ 消息平台。

- 支持 go-cqhttp / Lagrange / LLOneBot / NapCat
- 正向/反向 WebSocket 连接
- @机器人 / 前缀 / 全部消息 三种触发
- 群白名单、管理员配置
- QQ 消息 → AI 处理 → 自动回复

```bash
# 启动
/onebot connect ws://127.0.0.1:8080
/onebot config trigger_mode at

# 之后 QQ 里 @机器人 发消息即可，AI 自动回复
```

📄 [详细文档](./onebot/README.md) | [OneBot 标准](https://github.com/botuniverse/onebot)

---

## 目录结构

```
xiaoli-cli-plugins/
├── README.md                   ← 本文件
├── plugin_registry.json        ← 插件码注册表（/plugin 命令读取）
├── .gitignore
│
├── dglab_ws/
│   ├── dglab_ws.py             ← 插件代码
│   ├── dglab_app_simulator.py  ← APP 模拟器（测试用）
│   └── README.md               ← 使用教程
│
└── onebot/
    ├── onebot.py               ← 插件代码
    └── README.md               ← 使用教程
```

每个插件一个文件夹，包含插件代码和人读的教程。

## 插件码注册表

`plugin_registry.json` 是 `/plugin` 命令的数据源。格式：

```json
{
  "plugins": {
    "插件码": {
      "name": "显示名称",
      "description": "一句话描述",
      "version": "1.0.0",
      "file": "插件文件名.py",
      "url": "下载地址",
      "docs": "文档地址",
      "deps": ["必须依赖"],
      "optional_deps": ["可选依赖"],
      "keywords": ["搜索关键词"]
    }
  }
}
```

添加远程源：
```
/plugin add-source https://example.com/plugin_registry.json
```

## 开发插件

### 1. 创建插件文件

```python
class Liugin:
    """插件主类（兼容 Plugin 类名）"""

    def get_tool_info(self):
        """返回插件元信息（必须）"""
        return {
            "name": "my_plugin",
            "description": "我的插件",
            "keywords": ["关键词"],
            "usage": "使用说明"
        }

    def handle(self, args):
        """处理命令（必须），返回结果字符串"""
        return "结果"

    def set_cli(self, cli):
        """注册 CLI 斜杠命令（可选）"""
        if hasattr(cli, 'register_liugin_command'):
            cli.register_liugin_command('my', self._cmd)

    def get_mcp_definition(self):
        """MCP 工具定义（可选）"""
        return {}

    def convert_mcp_args(self, arguments):
        """MCP 参数转换（可选）"""
        return ""
```

### 2. 编写教程

在插件文件夹内创建 `README.md`，包含：
- 功能说明
- 安装依赖
- 使用示例
- 命令速查
- 常见问题

### 3. 注册到注册表

在 `plugin_registry.json` 中添加条目，提交推送即可。

### 4. AI 如何调用插件

xiaoli-cli 的 AI 会自动发现已安装的插件：

```
用户: "帮我把通道A强度调到50"
  ↓
AI 看到系统提示词中的 dglab_ws 工具
  ↓
AI 返回: {"action": "use_tool", "tool": "dglab_ws", "args": "strength a = 50"}
  ↓
插件执行，结果返回 AI
  ↓
AI 回复: "已将通道A强度设为50"
```

用户不需要手动输入命令，自然语言即可。

## 主仓迁入插件（2026-09-24）

以下 8 个插件原内置在 xiaoli-cli 主仓库，现剥离至此，按需 `/plugin install <插件码>` 装回：

| 插件码 | 名称 | 说明 | 依赖 |
|--------|------|------|------|
| `operit_loader` | Operit 脚本转译层 | Operit Android API 兼容层，运行 Operit 市场插件脚本（附 operit_scripts 脚本集） | requests（可选 httpx/pyautogui/android_pyapi） |
| `operit_translate` | Operit TS→PY 转换器 | 把 Operit 市场 .ts 插件翻译成 .py 插件 | 无 |
| `gui_auto` | Windows GUI 自动化 | 桌面点击/输入/窗口操作（ctypes） | 无 |
| `browser_auto` | 浏览器自动化 | 导航/取页面内容/元素操作 | 无 |
| `speech_recognition` | 语音识别 | 语音转文字，多引擎自动降级 | 可选 SpeechRecognition/pyaudio |
| `ai_image` | AI 图像（ComfyUI） | ComfyUI 工作流生图，自然语言/Tag 双模式 | requests, websocket-client |
| `image_generator` | 图像生成器 | websockets 通道生图 | websockets |
| `audio_player` | 音频播放器 | 音频文件播放 | colorama（可选 pygame） |

> 主仓保留强 agent 核心能力：py_detect（代码体检）、code_editor（代码编辑）、workflow、auto_engineer、markdown_tool、ai_search 等均内置不缺。

## 相关仓库

| 仓库 | 说明 |
|------|------|
| [xiaoli-cli](https://gitee.com/shuiyu1123/xiaoli-cli) | 小狸 CLI 主程序 |
| [xiaoli-cli-plugins](https://gitee.com/shuiyu1123/xiaoli-cli-plugins) | 本仓库 — 插件集合 |

## License

MIT