razel-py-cli

razel-py-cli：基于 Typer，命令 razel-py-cli 或 python -m razel_py_cli。 使用前请先执行 razel-py-cli init，生成 ~/.razel/config.json 并配置密钥（见 config）。

子命令文档

顶层命令包括 init、config、speech-to-text、acceptance-toolkit、ppt、meeting-prd。选项与示例在对应源码目录的 README 中：

Stashed changes

• init
• config
• speech-to-text
• acceptance_toolkit
• ppt - PPT 演示文稿生成工具
• meeting_prd

基本使用

razel-py-cli init              # 首次使用前执行
razel-py-cli --help
razel-py-cli speech-to-text --help
razel-py-cli acceptance-toolkit --help
razel-py-cli acceptance-toolkit run --help
razel-py-cli ppt --help
razel-py-cli ppt doctor        # 检查 PPT Master 环境
razel-py-cli meeting-prd --help
razel-py-cli meeting-prd notes --help
razel-py-cli meeting-prd prd --help
razel-py-cli meeting-prd export-docx --help

开发

uv sync --group dev
uv run razel-py-cli --help
uv run pytest

新增顶层子命令时，请在 tests/ 下补充对应测试（约定见 tests/conftest.py 顶部说明）。

依赖版本以 uv.lock 为准；修改 pyproject.toml 的依赖后，请同时刷新 uv.lock 并一起提交，这样本地、CI 和发布构建看到的解析结果才会保持一致。

构建与发布（仅发布 wheel）

统一脚本放在仓库根目录 scripts/：

• macOS / Linux:
  • bash scripts/build.sh
  • bash scripts/publish_pypi.sh
• Windows (PowerShell):
  • powershell -ExecutionPolicy Bypass -File scripts/build.ps1
  • powershell -ExecutionPolicy Bypass -File scripts/publish_pypi.ps1

制品在 dist/（仅 *.whl）。版本号以 pyproject.toml 为准；安装示例中的文件名请按实际构建结果替换。

本地 wheel 安装：

pip install /path/to/razel_py_cli-<version>-py3-none-any.whl

发布前需要先设置 PyPI token（不要写入仓库）：

• macOS / Linux:
  • export UV_PUBLISH_TOKEN="pypi-xxxx"
• Windows PowerShell:
  • $env:UV_PUBLISH_TOKEN="pypi-xxxx"

publish_pypi 脚本会执行 uv publish dist/*.whl（PowerShell 版本等价），只上传 wheel，不上传 sdist。