说明

如何本地运行

创建虚拟环境并同步所有依赖： 在项目根目录运行：

uv sync

直接运行命令行工具： 因为我们在 [project.scripts] 里配置了 ldsau，可以直接使用：

# 使用 uv 运行 CLI 工具
uv run ldsau bypass "测试.wav" --semi 1.0
uv run ldsau mix -d "./tracks" -o "伴奏.wav"
uv run ldsau process "录音.wav" --auto_norm 1

如何使用 uv 打包并发布到 PyPI？

打包项目（构建 wheel 和 sdist）：

uv build

发布到 PyPI：

uv publish

需要输入 PyPI 的 API Token。输入后，几秒钟之内，你的工具就会上线 PyPI！

从 PyCharm 一键发布到 PyPI

在 PyCharm 的右上角点击编辑配置

添加一个新配置，选择 Shell Script。

按照以下内容进行配置：

• Name (名称)：填入 Build & Publish (uv)

• Execute (执行)：选择 Script text

• Script text (脚本内容)：

  • Windows 系统：

  rmdir /s /q dist
  uv build
  uv publish
  

  • Mac/Linux：

    rm -rf dist && uv build && uv publish
    

    (注：前面加 rm 删除旧的 dist 文件夹防止把历史版本的包重复上传导致报错)

• Script working directory (工作目录)： pyproject.toml 所在的目录

• Environment variables (环境变量)：点击旁边的表格图标，添加一个环境变量：

  • Name: UV_PUBLISH_TOKEN
  • Value: 以 pypi- 开头的 Token。