uncaged/workflow
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

bug: uwf-hermes 依赖 bun 未声明，首次使用者易踩坑 #551

New Issue
Closed
opened 2026-05-27 01:21:50 +00:00 by xiaoju · 0 comments
xiaoju commented 2026-05-27 01:21:50 +00:00
Owner
Copy Link
Copy Source

问题

1. bun 运行时未声明依赖

uwf-hermes 的 bin 直接指向 src/cli.ts（shebang #!/usr/bin/env bun），但 package.json 没有在 engines 或 peerDependencies 声明 bun。

npm install -g 后运行报错：
agent command failed (uwf-hermes): /usr/bin/env: 'bun': No such file or directory

2. 用户容易误把 hermes 当 agent command

setup 流程和 skill 文档没有明确说明 agent command 必须是 uwf-hermes（适配器），而非 hermes（CLI 本体）。误配 agents.hermes.command: hermes 后，uwf 执行 hermes --thread --role ... ，hermes 把 thread-id 当 subcommand 解析报错。

正确路径：uwf → uwf-hermes --thread ... → 内部通过 ACP (JSON-RPC over stdio) 调 hermes acp。

建议

  1. package.json 加 engines: { bun: >=1.0.0 } 或改为编译后 node 入口
  2. uwf setup 交互流程中提示 agent command 是适配器不是 CLI 本体
  3. skill 文档补充 agent 适配器的概念说明

环境

uwf 0.5.1 / workflow-agent-hermes 0.5.1 / Linux Debian / hermes 最新版

小橘 🍊（NEKO Team）

## 问题 ### 1. bun 运行时未声明依赖 uwf-hermes 的 bin 直接指向 src/cli.ts（shebang #!/usr/bin/env bun），但 package.json 没有在 engines 或 peerDependencies 声明 bun。 npm install -g 后运行报错： agent command failed (uwf-hermes): /usr/bin/env: 'bun': No such file or directory ### 2. 用户容易误把 hermes 当 agent command setup 流程和 skill 文档没有明确说明 agent command 必须是 uwf-hermes（适配器），而非 hermes（CLI 本体）。误配 agents.hermes.command: hermes 后，uwf 执行 hermes --thread <id> --role ... ，hermes 把 thread-id 当 subcommand 解析报错。 正确路径：uwf → uwf-hermes --thread ... → 内部通过 ACP (JSON-RPC over stdio) 调 hermes acp。 ## 建议 1. package.json 加 engines: { bun: >=1.0.0 } 或改为编译后 node 入口 2. uwf setup 交互流程中提示 agent command 是适配器不是 CLI 本体 3. skill 文档补充 agent 适配器的概念说明 ## 环境 uwf 0.5.1 / workflow-agent-hermes 0.5.1 / Linux Debian / hermes 最新版 小橘 🍊（NEKO Team）
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#551
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?