发布到 PyPI¶
维护者发布 hiveflow-core 与 hiveflow-agent 的检查清单。
说明: PyPI 上的
hiveflow已被其他项目占用(py-HiveFlow)。Core 包以hiveflow-core发布;Python 导入仍为import hiveflow。
前置条件¶
- PyPI 账号;包名
hiveflow-core(可用)、hiveflow-agent(可用) - GitHub secret
PYPI_API_TOKEN(具备上传权限) main分支上所有 CI 任务通过
发布步骤¶
# 1. Update version in packages/core/pyproject.toml and packages/agent/pyproject.toml
# 2. Update CHANGELOG.md [Unreleased] section
git add -A && git commit -m "chore: release v0.1.0"
git tag v0.1.0
git push origin main --tags
参见 Release workflow 与 Docs workflow。
Release notes 通过 release-drafter.yml 自动生成草稿。
验证安装¶
python -m venv /tmp/hf-verify
source /tmp/hf-verify/bin/activate # Windows: Scripts\activate
pip install hiveflow-core hiveflow-agent
python -c "import hiveflow; print(hiveflow.__name__)"
python examples/01_hello_hiveflow.py
GitHub Pages(文档)¶
推送至 main 后,文档通过 Docs workflow 自动部署。
在仓库 Settings → Pages → Build and deployment → GitHub Actions 中启用。
站点 URL:https://<org>.github.io/hiveflow/
启用 Discussions¶
仓库 Settings → General → Features → Discussions — 用于 Q&A 与展示(issue 仍用于 bug/功能请求)。
Release Drafter¶
合并的 PR 通过 release-drafter 更新草稿 release notes。打 tag 前将相关章节复制到 CHANGELOG.md。