docs: bootstrap guide 引用了不存在的示例文件，且缺少 ACP 依赖说明 #107

New Issue

2026-06-05T10:58:54Z

xiaonuo commented

2026-06-05 10:58:54 +00:00

问题 1：示例文件不存在

uwf prompt bootstrap 的 Step 4（Verify end-to-end）引用了 examples/eval-simple.yaml：

uwf thread start examples/eval-simple.yaml -p "Hello, test run"

但这个文件没有随 npm 包发布，用户执行会得到 project workflow file not found。实际可用的示例只在包的 src/__tests__/fixtures/ 里（如 e2e-linear.workflow.yaml）。

建议：要么把示例 workflow 打包到 npm 发布产物里并提供清晰的引用路径，要么在 bootstrap guide 里引导用户自己写一个简单的 workflow。

问题 2：uwf-hermes adapter 的 ACP 依赖未提及

Bootstrap Step 1 让用户安装 @united-workforce/agent-hermes，但没有提到 hermes CLI 本身需要 ACP 支持（pip install hermes-agent[acp] 或 pip install -e .[acp]）。

实际执行 uwf thread exec 时报错：

agent run failed: hermes acp exited unexpectedly with code 1 stderr=...
ACP dependencies not installed.
Install them with: pip install -e .[acp]

建议：在 bootstrap guide 的 uwf-hermes adapter 安装步骤里加上 ACP 依赖的说明。

环境

uwf v0.2.1-rc.0
agent-hermes v0.1.2
hermes-agent v0.15.1

## 问题 1：示例文件不存在 `uwf prompt bootstrap` 的 Step 4（Verify end-to-end）引用了 `examples/eval-simple.yaml`： ```bash uwf thread start examples/eval-simple.yaml -p "Hello, test run" ``` 但这个文件没有随 npm 包发布，用户执行会得到 `project workflow file not found`。实际可用的示例只在包的 `src/__tests__/fixtures/` 里（如 `e2e-linear.workflow.yaml`）。 **建议**：要么把示例 workflow 打包到 npm 发布产物里并提供清晰的引用路径，要么在 bootstrap guide 里引导用户自己写一个简单的 workflow。 ## 问题 2：uwf-hermes adapter 的 ACP 依赖未提及 Bootstrap Step 1 让用户安装 `@united-workforce/agent-hermes`，但没有提到 hermes CLI 本身需要 ACP 支持（`pip install hermes-agent[acp]` 或 `pip install -e .[acp]`）。实际执行 `uwf thread exec` 时报错： ``` agent run failed: hermes acp exited unexpectedly with code 1 stderr=... ACP dependencies not installed. Install them with: pip install -e .[acp] ``` **建议**：在 bootstrap guide 的 uwf-hermes adapter 安装步骤里加上 ACP 依赖的说明。 ## 环境 - uwf v0.2.1-rc.0 - agent-hermes v0.1.2 - hermes-agent v0.15.1

xiaoju referenced this issue from a commit

2026-06-05 11:06:42 +00:00

fix: preset base-url auto-fill, bootstrap ACP docs, friendlier errors

xiaoju referenced a pull request that will close this issue

2026-06-05 11:06:57 +00:00

fix: preset base-url auto-fill, bootstrap ACP docs, friendlier errors #109

xiaomo referenced this issue

2026-06-05 11:16:29 +00:00

fix: preset base-url auto-fill, bootstrap ACP docs, friendlier errors #109

xiaomo closed this issue

2026-06-05 11:16:31 +00:00

Sign in to join this conversation.