必须用“uv pip install .”安装当前目录本地包，路径须指向含pyproject.toml或setup.py的根目录；可编辑模式用“-e .”，子目录安装需确保其含配置文件且不误加-e。
要用 uv pip install 安装本地 Python 包（比如当前目录下有 pyproject.toml 或 setup.py 的项目），必须确保路径指向包根目录，且不能遗漏 【.】 符号——漏掉它就会报错“no such package”，而不是自动识别当前目录。
安装当前目录的本地包
在包根目录下执行：
uv pip install .
这会读取当前目录的 pyproject.toml（优先）或 setup.py，构建并安装为可运行的包。如果 pyproject.toml 中定义了 `build-backend`，uv 会调用对应构建器；若无配置，uv 默认使用 PEP 517 兼容方式处理。
以可编辑模式安装本地包
方法一：使用 -e 参数（推荐）
uv pip install -e .
这等价于 pip 的 editable install，安装后修改源码立即生效，无需重新安装。适用于开发调试阶段，【必须在包根目录执行】，否则会找不到 pyproject.toml 并报错 “No pyproject.toml found”。
方法二：显式指定路径（适合子目录结构）
uv pip install -e ./src/mypackage
构建并发布在 Quartz 平台上的韩语网络小说连载（草稿→封面→webp→章节 md→lint→发布），使用 Nano Banana Pro + ffmpeg。
仅当 pyproject.toml 位于上层目录、而源码在 src/mypackage 时才需要这样写。此时需确认该路径下存在 pyproject.toml 或 setup.py，否则 uv 无法解析元数据。
安装指定子目录的本地包
第一步：确认子目录中存在有效的构建配置文件
uv 不支持直接安装纯代码目录，必须有 pyproject.toml 或 setup.py。若子目录（如 ./lib/utils）没有这些文件，先将其提升为独立包或软链到根目录。
第二步：用相对路径指向含配置文件的目录
uv pip install ./lib/utils
注意：这里不能加 -e，除非该子目录本身是可编辑包结构。加了但无配置文件会失败，错误信息模糊，容易误判为权限问题。
第三步：验证是否安装成功
uv pip list | grep utils
若未出现，说明路径错误或构建失败；此时检查 pyproject.toml 中的 [project] 段是否定义了 name 字段——uv 依赖它生成包名，缺失会导致静默跳过安装。
