@bitseek/hermes-webui 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -28
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,9 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# BitSeek Claw WebUI
|
|
2
2
|
|
|
3
|
-
`@bitseek/hermes-webui` 用来在本机启动和管理
|
|
4
|
-
|
|
5
|
-
它是一个轻量级 npm 包装器，负责进程生命周期、健康检查、日志和运行时状态。
|
|
6
|
-
WebUI 本体来自 vendored `agent-frontend-shell` 运行时。
|
|
3
|
+
`@bitseek/hermes-webui` 用来在本机启动和管理 BitSeek Claw WebUI。
|
|
7
4
|
|
|
8
5
|
## 快速开始
|
|
9
6
|
|
|
@@ -39,7 +36,7 @@ hermes-webui start --port 8788 --open
|
|
|
39
36
|
- 如果 WebUI 要调用 Hermes Agent，需要准备 Hermes Agent checkout，并确保其中有
|
|
40
37
|
`run_agent.py`。
|
|
41
38
|
|
|
42
|
-
|
|
39
|
+
默认情况下，WebUI 会尝试从以下位置查找 Hermes Agent：
|
|
43
40
|
|
|
44
41
|
```text
|
|
45
42
|
$HERMES_HOME/hermes-agent
|
|
@@ -79,13 +76,13 @@ hermes-webui doctor
|
|
|
79
76
|
|
|
80
77
|
## 首次启动会做什么
|
|
81
78
|
|
|
82
|
-
第一次运行 `hermes-webui start`
|
|
79
|
+
第一次运行 `hermes-webui start` 时，WebUI 会：
|
|
83
80
|
|
|
84
81
|
- 创建运行时状态目录。
|
|
85
82
|
- 创建并管理 Python venv。
|
|
86
|
-
-
|
|
83
|
+
- 安装 WebUI 所需的 Python 依赖。
|
|
87
84
|
- 默认启用 BitSeek 外观和扩展入口，包括 “AI 同事” 页面。
|
|
88
|
-
- 启动
|
|
85
|
+
- 启动 BitSeek Claw WebUI 服务。
|
|
89
86
|
- 等待 `/health` 健康检查通过。
|
|
90
87
|
- 把 PID、日志路径和运行时信息写入状态目录。
|
|
91
88
|
|
|
@@ -140,9 +137,8 @@ HERMES_WEBUI_EXTENSION_SCRIPT_URLS 默认 /extensions/themes/bitseek/inde
|
|
|
140
137
|
HERMES_WEBUI_BOT_NAME 默认 BitSeek Claw
|
|
141
138
|
```
|
|
142
139
|
|
|
143
|
-
这些默认值在 macOS、Linux、Windows
|
|
144
|
-
|
|
145
|
-
可以覆盖默认值。
|
|
140
|
+
这些默认值在 macOS、Linux、Windows 上都可用。显式设置同名环境变量可以覆盖
|
|
141
|
+
默认值。
|
|
146
142
|
|
|
147
143
|
示例：
|
|
148
144
|
|
|
@@ -152,7 +148,7 @@ export HERMES_WEBUI_AGENT_DIR="$HERMES_HOME/hermes-agent"
|
|
|
152
148
|
hermes-webui start --port 8787 --open
|
|
153
149
|
```
|
|
154
150
|
|
|
155
|
-
|
|
151
|
+
如果不想使用默认 venv，可以指定已有 Python：
|
|
156
152
|
|
|
157
153
|
```bash
|
|
158
154
|
export HERMES_WEBUI_PYTHON=/usr/bin/python3
|
|
@@ -174,23 +170,11 @@ hermes-webui doctor
|
|
|
174
170
|
`HERMES_WEBUI_PYTHON`。
|
|
175
171
|
- `Hermes Agent dir: not found`：设置 `HERMES_WEBUI_AGENT_DIR` 指向包含
|
|
176
172
|
`run_agent.py` 的 Hermes Agent 目录。
|
|
177
|
-
- `
|
|
178
|
-
运行时，需要维护者重新同步并发布包。
|
|
173
|
+
- `WebUI runtime is missing`：发布包缺少必要文件，需要维护者重新打包并发布。
|
|
179
174
|
|
|
180
175
|
## 维护者说明
|
|
181
176
|
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
```text
|
|
185
|
-
repo: adv-org/agent-frontend-shell
|
|
186
|
-
branch: dev-zkp
|
|
187
|
-
source checkout: /home/boj/hermes/agent-frontend-shell
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
该包装器不会把 Python + 原生 JavaScript WebUI 重写成 Node 应用，只负责用 npm
|
|
191
|
-
包形式分发和启动 vendored 运行时。
|
|
192
|
-
|
|
193
|
-
更新 vendored 运行时：
|
|
177
|
+
同步 WebUI 文件：
|
|
194
178
|
|
|
195
179
|
```bash
|
|
196
180
|
npm run sync:vendor
|
|
@@ -209,7 +193,7 @@ npm pack --dry-run
|
|
|
209
193
|
bin/
|
|
210
194
|
scripts/
|
|
211
195
|
templates/
|
|
212
|
-
vendor/
|
|
196
|
+
vendor/
|
|
213
197
|
README.md
|
|
214
198
|
```
|
|
215
199
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bitseek/hermes-webui",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "BitSeek Claw WebUI launcher.",
|
|
6
6
|
"bin": {
|
|
7
7
|
"hermes-webui": "bin/hermes-webui.mjs"
|
|
8
8
|
},
|