mirror of
https://github.com/qaiu/netdisk-fast-download.git
synced 2026-01-13 09:54:12 +00:00
Compare commits
4 Commits
copilot/ad
...
feature/gr
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0f28dc2896 | ||
|
|
adff2bab89 | ||
|
|
ca2444db65 | ||
|
|
1da2044a75 |
48
README.md
48
README.md
@@ -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 的代码智能提示功能,可以跳过此步骤
|
||||
|
||||
## 🚀 快速部署
|
||||
|
||||
|
||||
@@ -152,16 +152,28 @@
|
||||
<build>
|
||||
<plugins>
|
||||
|
||||
<!-- GraalPy Maven Plugin - 仅创建 Python Home,不使用 pip 安装 -->
|
||||
<!-- pip 包手动安装到 src/main/resources/graalpy-packages/,可打包进 jar -->
|
||||
<!-- 安装方法: ./setup-graalpy-packages.sh -->
|
||||
<!-- GraalPy Maven Plugin - 创建 Python Home 和 venv,自动安装 pip 包 -->
|
||||
<!--
|
||||
注意: python-lsp-server 依赖 ujson(需编译 C 扩展),GraalPy pip 无法安装。
|
||||
如需 python-lsp-server 功能,请运行 setup-graalpy-packages.sh 使用系统 pip 安装。
|
||||
|
||||
此处只配置 requests 及其纯 Python 依赖,Maven 构建时会自动安装到
|
||||
target/classes/org.graalvm.python.vfs/venv/lib/python3.11/site-packages/
|
||||
-->
|
||||
<plugin>
|
||||
<groupId>org.graalvm.python</groupId>
|
||||
<artifactId>graalpy-maven-plugin</artifactId>
|
||||
<version>${graalpy.version}</version>
|
||||
<configuration>
|
||||
<!-- 不声明 packages,避免代理问题 -->
|
||||
<!-- pip 包从 resources/graalpy-packages 加载 -->
|
||||
<!-- pip 包列表 - 仅纯 Python 包 -->
|
||||
<packages>
|
||||
<!-- requests 及其依赖 - HTTP 客户端 (解析器核心功能必需) -->
|
||||
<package>requests</package>
|
||||
<package>urllib3</package>
|
||||
<package>charset_normalizer</package>
|
||||
<package>idna</package>
|
||||
<package>certifi</package>
|
||||
</packages>
|
||||
</configuration>
|
||||
<executions>
|
||||
<execution>
|
||||
|
||||
@@ -448,13 +448,13 @@ public class PyContextPool {
|
||||
* 配置 Python 路径,确保能够加载 pip 包
|
||||
* 使用路径缓存机制,避免重复检测文件系统
|
||||
*
|
||||
* pip 包安装在 src/main/resources/graalpy-packages/ 中,会打包进 jar。
|
||||
* 运行时从 classpath 或文件系统加载。
|
||||
* pip 包安装来源:
|
||||
* 1. Maven 构建时 graalpy-maven-plugin 自动安装 requests 等核心包到
|
||||
* target/classes/org.graalvm.python.vfs/venv/lib/python3.11/site-packages/
|
||||
* 2. 可选:运行 parser/setup-graalpy-packages.sh 安装 python-lsp-server(Playground 代码提示)
|
||||
*
|
||||
* 注意:GraalPy 的 NativeModules 限制 - 只有进程中的第一个 Context 可以使用原生模块。
|
||||
* 后续 Context 会回退到 LLVM 模式,这可能导致某些依赖原生模块的库无法正常工作。
|
||||
*
|
||||
* 安装方法:运行 parser/setup-graalpy-packages.sh
|
||||
*/
|
||||
private void setupPythonPath(Context context) {
|
||||
try {
|
||||
@@ -541,7 +541,7 @@ public class PyContextPool {
|
||||
} else {
|
||||
String error = bindings.getMember("_error_msg").asString();
|
||||
log.warn("Python 环境配置: requests 不可用 ({}), sys.path长度: {}. " +
|
||||
"请运行: ./setup-graalpy-packages.sh", error, pathLength);
|
||||
"检查 Maven 构建是否正常完成 (graalpy-maven-plugin)", error, pathLength);
|
||||
}
|
||||
|
||||
} catch (Exception e) {
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# 要激活的配置: app-配置名称.yml
|
||||
active: local
|
||||
active: dev
|
||||
# 控制台输出的版权文字
|
||||
copyright: QAIU
|
||||
|
||||
Reference in New Issue
Block a user