@bitseek/hermes-webui 0.1.0 → 0.1.2

package/README.md

@@ -1,9 +1,6 @@
-# Bitseek Hermes WebUI
+# BitSeek Claw WebUI
 
-`@bitseek/hermes-webui` 用来在本机启动和管理 Bitseek Hermes WebUI。
-
-它是一个轻量级 npm 包装器，负责进程生命周期、健康检查、日志和运行时状态。
-WebUI 本体来自 vendored `agent-frontend-shell` 运行时。
+`@bitseek/hermes-webui` 用来在本机启动和管理 BitSeek Claw WebUI。
 
 ## 快速开始
 
@@ -39,7 +36,7 @@ hermes-webui start --port 8788 --open
 - 如果 WebUI 要调用 Hermes Agent，需要准备 Hermes Agent checkout，并确保其中有
   `run_agent.py`。
 
-默认情况下，包装器会尝试从以下位置查找 Hermes Agent：
+默认情况下，WebUI 会尝试从以下位置查找 Hermes Agent：
 
 ```text
 $HERMES_HOME/hermes-agent
@@ -79,12 +76,13 @@ hermes-webui doctor
 
 ## 首次启动会做什么
 
-第一次运行 `hermes-webui start` 时，包装器会：
+第一次运行 `hermes-webui start` 时，WebUI 会：
 
 - 创建运行时状态目录。
 - 创建并管理 Python venv。
-- 按 vendored WebUI 的 `requirements.txt` 安装 Python 依赖。
-- 启动 vendored `agent-frontend-shell/server.py`。
+- 安装 WebUI 所需的 Python 依赖。
+- 默认启用 BitSeek 外观和扩展入口，包括 “AI 同事” 页面。
+- 启动 BitSeek Claw WebUI 服务。
 - 等待 `/health` 健康检查通过。
 - 把 PID、日志路径和运行时信息写入状态目录。
 
@@ -130,6 +128,18 @@ HERMES_WEBUI_HOST        默认 127.0.0.1
 HERMES_WEBUI_PORT        默认 8787
 ```
 
+BitSeek 扩展默认值：
+
+```text
+HERMES_WEBUI_EXTENSION_DIR                默认 ./extensions
+HERMES_WEBUI_EXTENSION_STYLESHEET_URLS    默认 /extensions/themes/bitseek/index.css
+HERMES_WEBUI_EXTENSION_SCRIPT_URLS        默认 /extensions/themes/bitseek/index.js,/extensions/index.js
+HERMES_WEBUI_BOT_NAME                     默认 BitSeek Claw
+```
+
+这些默认值在 macOS、Linux、Windows 上都可用。显式设置同名环境变量可以覆盖
+默认值。
+
 示例：
 
 ```bash
@@ -138,7 +148,7 @@ export HERMES_WEBUI_AGENT_DIR="$HERMES_HOME/hermes-agent"
 hermes-webui start --port 8787 --open
 ```
 
-如果不想使用包装器管理的 venv，可以指定已有 Python：
+如果不想使用默认 venv，可以指定已有 Python：
 
 ```bash
 export HERMES_WEBUI_PYTHON=/usr/bin/python3
@@ -160,23 +170,11 @@ hermes-webui doctor
   `HERMES_WEBUI_PYTHON`。
 - `Hermes Agent dir: not found`：设置 `HERMES_WEBUI_AGENT_DIR` 指向包含
   `run_agent.py` 的 Hermes Agent 目录。
-- `Vendored agent-frontend-shell runtime is missing`：发布包缺少 vendored
-  运行时，需要维护者重新同步并发布包。
+- `WebUI runtime is missing`：发布包缺少必要文件，需要维护者重新打包并发布。
 
 ## 维护者说明
 
-打包的 WebUI 运行时来自：
-
-```text
-repo: adv-org/agent-frontend-shell
-branch: dev-zkp
-source checkout: /home/boj/hermes/agent-frontend-shell
-```
-
-该包装器不会把 Python + 原生 JavaScript WebUI 重写成 Node 应用，只负责用 npm
-包形式分发和启动 vendored 运行时。
-
-更新 vendored 运行时：
+同步 WebUI 文件：
 
 ```bash
 npm run sync:vendor
@@ -195,7 +193,7 @@ npm pack --dry-run
 bin/
 scripts/
 templates/
-vendor/agent-frontend-shell/
+vendor/
 README.md
 ```
 

package/bin/hermes-webui.mjs

@@ -27,6 +27,12 @@ const packageJson = JSON.parse(readFileSync(resolve(packageRoot, 'package.json')
 
 const DEFAULT_HOST = '127.0.0.1'
 const DEFAULT_PORT = 8787
+const BITSEEK_DEFAULT_ENV = {
+  HERMES_WEBUI_EXTENSION_DIR: './extensions',
+  HERMES_WEBUI_EXTENSION_STYLESHEET_URLS: '/extensions/themes/bitseek/index.css',
+  HERMES_WEBUI_EXTENSION_SCRIPT_URLS: '/extensions/themes/bitseek/index.js,/extensions/index.js',
+  HERMES_WEBUI_BOT_NAME: 'BitSeek Claw',
+}
 
 function usage() {
   console.log(`@bitseek/hermes-webui v${packageJson.version}
@@ -250,6 +256,9 @@ function buildEnv(python, options) {
   const paths = statePaths()
   const env = {
     ...process.env,
+    ...Object.fromEntries(
+      Object.entries(BITSEEK_DEFAULT_ENV).filter(([key]) => !process.env[key]),
+    ),
     HERMES_HOME: hermesHome(),
     HERMES_WEBUI_STATE_DIR: paths.dir,
     HERMES_WEBUI_HOST: options.host,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bitseek/hermes-webui",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "description": "Npm wrapper for Bitseek Hermes WebUI runtime.",
+  "description": "BitSeek Claw WebUI launcher.",
   "bin": {
     "hermes-webui": "bin/hermes-webui.mjs"
   },