LeoAI

环境要求

无需单独安装数据库：内置 SQLite，首次启动自动初始化。 无需额外部署前端：Web 界面已打包至 JAR 文件中。

---

快速开始

Docker 启动

如果你不想折腾 Java 环境，直接用 Docker 一条命令启动即可。镜像构建时会自动从 Release 页面下载 JAR，不需要在本机装 JDK/Maven，也不会编译源码。

第一步：安装 Docker

安装完成后打开终端验证（任意目录均可）：

docker --version
docker compose version

只要能看到版本号即可。

提示：以下命令不需要 sudo 时尽量不用。Linux 下若提示 permission denied，把当前用户加入 docker 组（sudo usermod -aG docker $USER 后重新登录），或者命令前加 sudo。

第二步：获取项目代码

任选一种方式：

```bash

锁定到特定版本的 JAR；默认值以 docker-compose.yml / Dockerfile 为准

Java/PHP 双运行时

Java 与 PHP 是平等的 Puppet Runtime。共享模块只定义协议、会话和能力契约，具体实现分别位于 javacore 与 phpcore，web 负责最终组装。

PHP 目标的具体能力取决于其扩展与系统函数：数据库需要相应 PDO Driver，压缩需要 ZipArchive，持续代理/隧道 Worker 至少需要 shell_exec、exec 或 popen 之一。更完整的模块边界与能力矩阵见 docs/runtime-modules.md。

---

第二步：启动

java --add-opens java.base/java.lang=ALL-UNNAMED -jar LeoAi-2.1.1.jar

--add-opens java.base/java.lang=ALL-UNNAMED 参数不可省略，用于开放 Java 模块系统内部访问权限。

方式 A：使用 git（推荐，便于后续更新）

git clone https://github.com/cha0upup/LeoAI.git cd LeoAI

查看运行状态

docker compose ps

查看实时日志（Ctrl+C 退出，容器继续运行）

docker compose logs -f

重新启动

docker compose start

数据库（SQLite，路径相对于运行目录）

spring.datasource.url=jdbc:sqlite:data.db

```

---

使用指南

配置说明

配置 AI 模型

LeoAI 的 AI 功能从管理后台读取 Provider 与模型配置：

1. 登录后进入「管理后台 → AI 配置」
2. 点击「添加通道」
3. 填写通道名称、API Key、Base URL、模型名称
4. 点击「测试连接」验证后保存

主要配置项参考

web/src/main/resources/application.properties：

```properties

插件与脚本执行

• 统一执行控制台：「脚本与插件」模块同时承载脚本编辑与字节码执行
• 脚本编辑器：支持 JavaScript / Groovy / Python，临时执行无需保存；可一键「保存为插件」
• Java Class 执行：拖拽 .class 文件或直接粘贴 base64 字节码（自动清洗 URL-safe / 空白 / padding，自动校验 cafebabe magic），临时执行不持久化；可保存为 Java 插件
• 统一插件库：Java 字节码与 js/groovy/python 脚本插件并存，按类型徽章区分；脚本插件可一键「载入编辑器」再编辑后执行
• Java 插件热加载：动态加载和执行自定义 Java 插件
• AI Skills 内置插件：脚本执行、命令执行、WebLogic 密码获取、堆转储分析等开箱即用
• 导入/导出：单条 .plugin 或批量 .zip，导入时支持跳过/覆盖冲突策略

<img src="docs/images/screenshot-plugin-manager.png" alt="扩展管理" width="800" />

扩展管理：Java 与脚本插件目录、元数据、参数模板和导入导出

常见问题

Q：启动时报 InaccessibleObjectException

必须添加 --add-opens 参数，不可省略：

java --add-opens java.base/java.lang=ALL-UNNAMED -jar LeoAi-2.1.1.jar

---

Q：AI 功能无响应或报错

1. 进入「管理后台 → AI 配置」检查通道配置
2. 点击「测试连接」验证 API Key 和 Base URL
3. 确认 API 配额和请求限制
4. 查看服务端日志获取详细错误信息

---

Q：节点连接失败

按以下顺序排查：

1. 确认目标 URL 可访问（curl 测试）
2. 确认通信协议与 Shell 实现一致
3. 确认节点密钥与 Shell 端配置一致
4. 若使用流量伪装，确认模板两端编解码逻辑匹配
5. 查看浏览器 Network 面板和服务端日志

---

Q：如何重置管理员密码

停止应用 → 删除（或备份）data.db → 重新启动 → 使用账号 admin 和初始密码 54ikun 登录。

---

Q：支持 HTTPS 吗

建议通过前置 Nginx / Apache 反向代理层配置 SSL，将 HTTPS 请求转发至 LeoAI。

---

Q：data.db 文件在哪里

默认在 JAR 的运行目录下，可通过启动参数指定自定义路径：

--spring.datasource.url=jdbc:sqlite:/custom/path/data.db

---