feat: 使用 graalpy-maven-plugin 自动安装 requests pip 包

- parser/pom.xml: 添加 packages 配置让 Maven 自动安装 requests 及其依赖
  - 移除手动 pip 安装依赖,改为 Maven 构建时自动安装
  - 添加注释说明 python-lsp-server 仍需 setup-graalpy-packages.sh

- README.md: 更新本地构建文档
  - Maven 现在自动安装 requests 核心包
  - setup-graalpy-packages.sh 变为可选(仅 Playground 代码提示需要)

- PyContextPool.java: 更新注释和错误消息
  - 说明 pip 包来源变化
  - 更新 requests 不可用时的提示信息
This commit is contained in:
q
2026-01-12 18:59:19 +08:00
parent ca2444db65
commit adff2bab89
3 changed files with 65 additions and 15 deletions

View File

@@ -318,13 +318,51 @@ json返回数据格式示例:
## 开发和打包
```shell
# 环境要求: Jdk17 + maven;
mvn clean
mvn package -DskipTests
### 环境要求
- JDK 17+
- Maven 3.x
- Python 3.x可选仅当需要 Playground 代码智能提示功能时)
### 本地构建步骤
#### 1. Maven 打包
```shell
# 清理并打包(跳过测试)
mvn clean package -DskipTests
# 如果遇到代理问题,可以禁用代理
mvn clean package -DskipTests -Dhttp.proxyHost= -Dhttps.proxyHost=
```
打包好的文件位于 web-service/target/netdisk-fast-download-bin.zip
> **说明:**
> - Maven 构建时会自动安装 **requests** 等核心 Python 包(由 graalpy-maven-plugin 处理)
> - 打包好的文件位于 `web-service/target/netdisk-fast-download-bin.zip`
#### 2. (可选)安装 Python LSP 服务器
如果需要使用 **Playground 代码智能提示功能**,需要额外安装 python-lsp-server
```shell
# 进入 parser 目录
cd parser
# 运行 pip 包安装脚本
chmod +x setup-graalpy-packages.sh
./setup-graalpy-packages.sh
# 返回项目根目录
cd ..
```
该脚本会将以下包安装到 `parser/src/main/resources/graalpy-packages/`
- **python-lsp-server** 及其依赖jedi, python-lsp-jsonrpc, pluggy- Python LSP 服务器(代码智能提示)
- **pylsp 可选功能**pyflakes, pycodestyle, autopep8, rope, yapf- 代码检查和格式化
> **注意:**
> - 这些包需要用系统 pip 安装,因为 python-lsp-server 依赖 ujson需编译 C 扩展)
> - 安装后的包会被打包进 jar 文件,不会被 `mvn clean` 清理
> - 如果不需要 Playground 的代码智能提示功能,可以跳过此步骤
## 🚀 快速部署