ProjectForge v0.1.1
维护版本:打包依赖闭包、测试套件迁移、sandbox 网络修复。v0.1.0 行为契约不变。
主要内容
移除遗留线
- 删除 video pipeline(providers / render / pipeline)、12 个未使用 agent 与死代码 schema,约 -4000 行
执行链路修复
run_control执行桥正确传入ProjectMap(此前字段名错误会被 pydantic 静默吞掉)- orchestrator 支持注入 validator 并透传 workspace
- Hermes sandbox 不再使用
--unshare-all(会掐断 LLM API 连接):保留宿主网络命名空间,bind 进/etc/resolv.conf、hermes CLI 与配置目录,已用真实 Hermes 运行端到端验证
测试套件
- 全量迁移到当前执行/路由契约;本地 302 passed / 19 skipped
- 真实 Hermes 用例统一
requires_hermes门控;在具备 hermes + bwrap 的主机上全部真实执行(验证环境 321 passed, 0 skipped) - GitHub Actions CI(Python 3.10 / 3.11 / 3.12)绿灯
文档与打包
pyproject.toml补齐运行时依赖,pip install -e .后即可使用projectforge命令- README 新增安装、快速开始与 Hermes/bwrap 前置要求章节
已知问题(v0.1.2+ 候选)
- 纯执行层失败(agent 崩溃 / 超时,无 validation 结果)目前无法进入 replan 流程
- API/CLI replan 的 artifact store 使用 CWD 相对路径,
--base-dir不传导 - run 执行期间持有全局锁,
cancel仅设置标记、实际不中断执行 - sandbox 隔离文件系统与 pid/ipc,但共享宿主网络(真正网络隔离需 slirp4netns)
- 执行超时最坏情况 900s × 3 次重试
运行真实执行的环境要求
Hermes CLI(已认证)+ bubblewrap;Ubuntu 24.04+ 需为 bwrap 配置允许 unprivileged user namespace 的 AppArmor profile(详见 README)。