Question 1

在使用 Google Cloud TTS/STT 时如何修复 Leon AI 中的音频或视频错误?

Accepted Answer

在 .env 文件中,提供商的错误名称会导致音频/视频故障。 将其明确设置为:“bash LEON_TTS_PROVIDER=google-cloud-tts LEON_STT_PROVIDER=google-cloud-stt” 并确认“GOOGLE_APPLICATION_CREDENTIALS”指向您的服务帐户密钥文件。

Question 2

在 Windows 上安装 Leon 时，如何修复 npm 的 'ENOENT package.json'、'missing script: postinstall' 和 'No module named tinydb' 错误？

Accepted Answer

这些错误表示你运行 npm 所在的文件夹中并不包含 Leon 真正的 `package.json`，或者你跳过了依赖安装步骤。运行 `npm init` 只会创建一个空的 package，并不会添加 Leon 的 `postinstall` 脚本。

1. 重新下载/克隆最新版本的 Leon，并进入其根目录：
```sh
cd A:\Lexa\Lexa-Test
git clone https://github.com/leon-ai/leon.git leon-latest
cd leon-latest
```
2. 确认 Leon 的 `package.json` 存在：
```sh
dir package.json
```
3. 在项目根目录下安装依赖。这还会运行 Leon 的 `postinstall`，并安装 Pipenv 所需的 Python 依赖：
```sh
npm install
```
4. 再次运行检查：
```sh
npm run check
```

不要使用由 `npm init` 创建的空白 `package.json`；如果它覆盖了 Leon 的文件，请将其删除或重新克隆。如果仍然缺少 `tinydb`，请直接安装 Python 依赖：
```sh
cd bridges\python
pipenv sync
cd ..\..
npm run check
```
如果不存在 `Pipfile.lock`，请使用 `pipenv install` 代替 `pipenv sync`。

Question 3

如何在 Windows 10 上安装 Leon AI 时修复“TypeError: Invalid Version: 3.7.6rc1”?

Accepted Answer

此错误发生,因为 semver npm 包无法解析 Python 的发布候选版本字符串(例如, `3.7.6rc1`)。 要解决以下问题: 1. 安装一个稳定的 Python 版本(例如, 3.7.6 或 3.8.1)并确保它被 pipenv 使用。 2. 另一种方式是,切换到 `develop` 分支,该问题可能会被修复: ``bash git checkout develop npm install npm run check `` 3. 要快速启动而无需本地设置,请使用 Gitpod: [https://gitpod.io/#https://github.com/leon-ai/leon](https://gitpodio/#https://github.com/leon-ai)

Question 4

如何修复 Leon 的 /download model 命令中的路径遍历漏洞(任意文件写入)?

Accepted Answer

该缺陷位于 `server/src/built-in-command/commands/download-command/download-command.ts` 中的 `getModelFileNameFromURL()`:它执行的是 `decodeURIComponent(path.basename(parsedURL.pathname))`,因此 `basename` 只能看到百分号编码后的字符串,从而遗漏了 `%2f` 和 `..` 这类编码后的分隔符。修复方法是先解码,再提取 basename 并去除目录引用,例如 `const fileName = path.basename(decodeURIComponent(parsedURL.pathname))`,最好还应对照白名单(例如 `/^[a-zA-Z0-9._-]+$/`)验证结果,并使用 `path.resolve` 确认最终目标路径仍位于 models 目录之内。在升级到修复版本之前:(1) 切勿将 Leon 服务器暴露给不受信任的用户/网络,因为 `/download model <url>` 命令就是攻击面;(2) 只向该命令传递可信的模型 URL;(3) 以低权限用户身份运行 Leon,或在具有只读/受限文件系统的容器中运行,以限制任意文件写入和自动创建父目录(`mkdir recursive`)的行为。

Leon

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐