@bitseek/hermes-webui 0.1.0-beta.0 → 0.1.0-beta.1

package/vendor/agent-frontend-shell/bitseek_docs/zh/02-/351/241/265/351/235/242/346/223/215/344/275/234.md

@@ -0,0 +1,463 @@
+# BitSeek Claw 页面操作指南
+
+本指南详细介绍 BitSeek Claw 各个功能模块的具体操作方法。
+
+## 目录
+
+1. [聊天功能](#聊天功能)
+2. [AI 同事](#ai-同事)
+3. [任务管理](#任务管理)
+4. [看板视图](#看板视图)
+5. [技能管理](#技能管理)
+6. [记忆管理](#记忆管理)
+7. [设置配置](#设置配置)
+
+---
+
+## 聊天功能
+
+![聊天界面](images/chat-area.png)
+
+聊天是 BitSeek Claw 的核心功能，用于与 AI 进行对话交流。
+
+### 发送消息
+
+1. **输入消息**
+   - 在底部消息输入框中输入文字
+   - 支持多行输入（按 `Shift + Enter` 换行）
+
+2. **发送消息**
+   - 点击发送按钮 📤
+   - 或按 `Enter` 键发送
+   - 或按 `Ctrl/Cmd + Enter` 发送
+
+3. **快捷操作**
+   - 📎 **选择文件** - 附加文件到消息
+   - 🎤 **听写** - 语音输入
+   - ⚡ **快速命令** - 插入预设命令
+
+### 会话管理
+
+#### 新建对话
+1. 点击左侧边栏的 **"新建对话"** 按钮
+
+#### 切换对话
+1. 在左侧边栏的会话列表中点击要切换的对话
+2. 会话按时间分组显示（今天、昨天、上周等）
+
+#### 筛选对话
+1. 使用搜索框输入关键词筛选
+2. 或使用标签筛选
+
+#### 对话操作
+- **重命名** - 右键对话 → 重命名
+- **删除** - 右键对话 → 删除
+- **导出** - 右键对话 → 导出为 Markdown
+
+### 消息操作
+
+#### 编辑消息
+1. 将鼠标悬停在消息上
+2. 点击编辑图标 ✏️
+3. 修改内容后保存
+
+#### 复制消息
+1. 将鼠标悬停在消息上
+2. 点击复制图标 📋
+3. 消息将复制到剪贴板
+
+#### 引用消息
+1. 将鼠标悬停在消息上
+2. 点击引用图标 💬
+3. 引用内容将添加到输入框
+
+### 上下文信息
+
+底部状态栏显示当前会话的上下文：
+- **模型** - 当前使用的 AI 模型
+- **配置文件** - 当前用户配置
+- **工作区** - 当前工作目录
+- **推理强度** - AI 推理强度设置
+
+---
+
+## AI 同事
+
+![AI 同事界面](images/ai-colleagues.png)
+
+AI 同事功能允许管理和交互多个 AI 代理。
+
+### 查看 AI 同事列表
+1. 点击导航栏的 **"AI 同事"** 按钮
+2. 查看所有可用的 AI 代理
+
+### 与 AI 同事对话
+1. 在列表中选择一个 AI 同事
+2. 点击进入对话界面
+3. 输入消息开始交流
+
+---
+
+## 任务管理
+
+![任务管理界面](images/tasks.png)
+
+任务管理功能帮助您跟踪和管理各种任务。
+
+### 查看任务
+1. 点击导航栏的 **"任务"** 按钮
+2. 查看所有任务列表
+3. 按状态、优先级、负责人筛选
+
+### 创建任务
+1. 点击 **"新建任务"** 按钮
+2. 填写任务信息：
+   - 标题
+   - 描述
+   - 截止日期
+   - 优先级
+   - 负责人
+3. 点击保存
+
+### 任务操作
+- **编辑任务** - 点击任务标题进入编辑
+- **标记完成** - 点击完成按钮
+- **删除任务** - 选择任务后删除
+- **添加评论** - 在任务中添加评论
+
+### 任务视图
+- **列表视图** - 传统列表显示
+- **看板视图** - 看板式显示
+- **时间线视图** - 甘特图显示
+
+---
+
+## 看板视图
+
+![看板界面](images/kanban.png)
+
+看板视图提供直观的任务管理界面。
+
+### 看板列
+看板通常包含以下列：
+- **待办** - 待处理的任务
+- **进行中** - 正在进行的任务
+- **已完成** - 已完成的任务
+- **已归档** - 已归档的任务
+
+### 拖拽任务
+1. 在看板列中找到任务卡片
+2. 按住鼠标左键拖动
+3. 放到目标列中释放
+
+### 管理看板
+- **添加列** - 点击添加列按钮
+- **重命名列** - 双击列标题
+- **删除列** - 右键列 → 删除
+- **调整顺序** - 拖动列标题调整顺序
+
+### 卡片操作
+- **查看详情** - 点击卡片查看详细信息
+- **快速编辑** - 双击卡片快速编辑
+- **添加成员** - 将成员添加到任务
+- **设置标签** - 添加颜色标签
+
+---
+
+## 技能管理
+
+![技能界面](images/skills.png)
+
+技能管理功能管理 AI 可用的技能库。
+
+### 查看技能列表
+1. 点击导航栏的 **"技能"** 按钮
+2. 查看所有可用技能
+3. 按类别、状态筛选
+
+### 技能分类
+- **系统技能** - 内置的核心技能
+- **自定义技能** - 用户创建的技能
+- **社区技能** - 从社区获取的技能
+
+### 使用技能
+1. 在聊天中输入技能命令
+2. 或通过技能面板选择
+3. AI 将执行相应技能
+
+### 管理技能
+- **启用/禁用** - 控制技能是否可用
+- **配置参数** - 修改技能设置
+- **删除技能** - 移除不需要的技能
+
+---
+
+## 记忆管理
+
+![记忆界面](images/memory.png)
+
+记忆管理功能管理 AI 的记忆系统。
+
+### 记忆子菜单
+
+记忆页面提供以下子菜单选项：
+
+#### 1. 我的备注
+
+![我的备注界面](images/memory-notes.png)
+
+- **功能**：管理个人笔记和备忘
+- **操作**：
+  - 点击 **"我的备注"** 进入笔记管理
+  - 点击 **"编辑"** 按钮修改当前笔记
+  - 查看笔记的最后修改时间
+- **使用场景**：
+  - 记录重要信息和想法
+  - 保存待办事项
+  - 记录学习心得
+
+#### 2. 用户画像
+
+![用户画像界面](images/memory-profile.png)
+
+- **功能**：管理 AI 对用户的了解
+- **内容**：
+  - 用户偏好设置
+  - 工作习惯
+  - 沟通风格
+  - 技术栈信息
+- **操作**：
+  - 查看 AI 已学习的用户特征
+  - 手动添加或修改用户信息
+  - 删除不准确的用户画像
+
+#### 3. 智能体灵魂
+
+![智能体灵魂界面](images/memory-soul.png)
+
+- **功能**：定义 AI 的个性和行为模式
+- **配置项**：
+  - **性格特征**：定义 AI 的沟通风格
+  - **专业知识**：指定 AI 的专业领域
+  - **行为准则**：设置 AI 的行为边界
+  - **回复风格**：调整 AI 的回复方式
+- **使用场景**：
+  - 定制个性化 AI 助手
+  - 适应不同工作场景
+  - 优化交互体验
+
+### 记忆类型
+- **用户记忆** - 关于用户的偏好和习惯
+- **会话记忆** - 当前会话的上下文
+- **仓库记忆** - 代码库相关记忆
+
+### 查看记忆
+1. 点击导航栏的 **"记忆"** 按钮
+2. 浏览不同类别的记忆
+3. 搜索特定记忆内容
+
+### 管理记忆
+- **添加记忆** - 手动添加新记忆
+- **编辑记忆** - 修改现有记忆
+- **删除记忆** - 删除不需要的记忆
+- **导出记忆** - 导出记忆为文件
+
+### 记忆搜索
+1. 使用搜索框输入关键词
+2. 按类别筛选记忆
+3. 按时间排序记忆
+
+---
+
+## 设置配置
+
+![设置界面](images/settings.png)
+
+设置功能配置 BitSeek Claw 的各种选项。
+
+### 设置子菜单
+
+设置页面提供以下子菜单选项：
+
+#### 1. 对话
+
+![对话设置界面](images/settings-conversation.png)
+
+- **功能**：管理当前对话的设置和操作
+- **操作选项**：
+  - **记录**：将对话导出为 Markdown 文件
+  - **JSON**：将对话完整导出为 JSON 格式
+  - **导入**：从 JSON 文件导入对话历史
+  - **清空**：清空当前对话中的所有消息
+- **使用场景**：
+  - 备份重要对话
+  - 在不同设备间同步对话
+  - 清理不需要的对话记录
+
+#### 2. 外观
+
+![外观设置界面](images/settings-appearance.png)
+
+- **功能**：自定义界面外观和主题
+- **配置项**：
+  - **主题选择**：
+    - 深色主题（默认）
+    - 浅色主题
+    - 跟随系统
+  - **字体设置**：
+    - 字体大小调整
+    - 字体样式选择
+  - **布局配置**：
+    - 侧边栏显示/隐藏
+    - 面板大小调整
+    - 动画效果开关
+- **使用场景**：
+  - 适应不同光线环境
+  - 个性化界面风格
+  - 优化阅读体验
+
+#### 3. 偏好
+
+![偏好设置界面](images/settings-preferences.png)
+
+- **功能**：设置个人使用偏好
+- **配置项**：
+  - **语言设置**：
+    - 界面语言选择
+    - 时间格式设置
+    - 日期格式设置
+  - **通知设置**：
+    - 桌面通知开关
+    - 声音提醒设置
+    - 通知频率调整
+  - **隐私设置**：
+    - 数据收集选项
+    - 分享偏好设置
+    - 清除历史记录
+- **使用场景**：
+  - 适配本地化需求
+  - 管理通知干扰
+  - 保护个人隐私
+
+#### 4. 提供商
+
+![提供商设置界面](images/settings-providers.png)
+
+- **功能**：管理 AI 模型提供商配置
+- **配置项**：
+  - **API 密钥管理**：
+    - 添加新的 API 密钥
+    - 测试密钥有效性
+    - 删除无效密钥
+  - **模型配置**：
+    - 选择默认 AI 模型
+    - 设置模型参数
+    - 配置模型优先级
+  - **提供商设置**：
+    - OpenAI 配置
+    - Anthropic 配置
+    - Google 配置
+    - 其他提供商配置
+- **使用场景**：
+  - 配置多个 AI 提供商
+  - 优化成本和性能
+  - 测试不同模型效果
+
+#### 5. 插件
+
+![插件设置界面](images/settings-plugins.png)
+
+- **功能**：管理扩展插件和技能
+- **操作选项**：
+  - **查看已安装插件**：浏览当前安装的插件
+  - **安装新插件**：从插件市场安装
+  - **更新插件**：更新到最新版本
+  - **卸载插件**：移除不需要的插件
+  - **插件配置**：调整插件设置
+- **使用场景**：
+  - 扩展 BitSeek Claw 功能
+  - 安装社区插件
+  - 管理插件生命周期
+
+#### 6. 系统
+
+![系统设置界面](images/settings-system.png)
+
+- **功能**：系统级配置和管理
+- **配置项**：
+  - **数据管理**：
+    - 导出所有数据
+    - 导入备份数据
+    - 清除本地数据
+  - **网络设置**：
+    - 代理配置
+    - 防火墙设置
+    - 连接超时设置
+  - **调试和日志**：
+    - 日志级别调整
+    - 调试模式开关
+    - 错误报告设置
+  - **系统信息**：
+    - 版本信息
+    - 系统状态
+    - 资源使用情况
+- **使用场景**：
+  - 数据备份和恢复
+  - 网络问题排查
+  - 系统性能优化
+
+
+
+---
+
+## 快捷操作
+
+### 全局快捷键
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl/Cmd + N` | 新建对话 |
+| `Ctrl/Cmd + /` | 聚焦搜索框 |
+| `Ctrl/Cmd + Enter` | 发送消息 |
+| `Ctrl/Cmd + ,` | 打开设置 |
+| `Esc` | 关闭弹窗 |
+
+### 消息快捷键
+| 快捷键 | 功能 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `Shift + Enter` | 换行 |
+| `↑` | 编辑上一条消息 |
+| `Ctrl/Cmd + C` | 复制选中文本 |
+
+### 导航快捷键
+| 快捷键 | 功能 |
+|--------|------|
+| `1-9` | 切换导航标签 |
+| `←` | 收起侧边栏 |
+| `→` | 展开侧边栏 |
+
+---
+
+## 故障排除
+
+### 常见问题
+
+#### 消息发送失败
+1. 检查网络连接
+2. 检查 API 密钥是否有效
+3. 查看控制台错误信息
+
+#### 界面无响应
+1. 刷新页面（`F5` 或 `Ctrl/Cmd + R`）
+2. 清除浏览器缓存
+3. 重启 BitSeek Claw 服务
+
+#### 文件无法上传
+1. 检查文件大小限制
+2. 检查文件类型是否支持
+3. 检查网络连接
+
+### 获取帮助
+- 查看系统日志（设置 → 日志）
+- 查看控制台错误信息
+- 访问项目文档

package/vendor/agent-frontend-shell/bitseek_docs/zh/README.md

@@ -0,0 +1,61 @@
+# BitSeek Claw 操作文档
+
+本目录包含 BitSeek Claw（Hermes WebUI）的完整操作指南。
+
+## 目录结构
+
+```
+操作文档/
+├── README.md                    # 本文件 - 文档目录
+├── 00-安装启动.md               # 安装和启动说明
+├── 01-整体概览.md               # 界面整体概览
+├── 02-页面操作.md               # 详细页面操作指南
+└── images/                      # 截图和图片资源
+    ├── main-page.png            # 主页面截图
+    ├── navigation-bar.png       # 导航栏截图
+    ├── chat-area.png            # 聊天区域截图
+    ├── sidebar.png              # 侧边栏截图
+    ├── workspace-panel.png      # 工作区面板截图
+    ├── ai-colleagues.png        # AI 同事界面截图
+    ├── tasks.png                # 任务管理界面截图
+    ├── kanban.png               # 看板视图截图
+    ├── skills.png               # 技能管理界面截图
+    ├── memory.png               # 记忆管理界面截图
+    ├── memory-overview.png      # 记忆概览截图
+    ├── memory-notes.png         # 我的备注截图
+    ├── memory-profile.png       # 用户画像截图
+    ├── memory-soul.png          # 智能体灵魂截图
+    ├── settings.png             # 设置界面截图
+    ├── settings-overview.png    # 设置概览截图
+    ├── settings-conversation.png # 对话设置截图
+    ├── settings-appearance.png  # 外观设置截图
+    ├── settings-preferences.png # 偏好设置截图
+    ├── settings-providers.png   # 提供商设置截图
+    ├── settings-plugins.png     # 插件设置截图
+    └── settings-system.png      # 系统设置截图
+```
+
+## 快速导航
+
+1. **[安装启动](00-安装启动.md)** - 如何安装和启动 BitSeek Claw
+2. **[整体概览](01-整体概览.md)** - 界面布局和主要功能区域介绍
+3. **[页面操作](02-页面操作.md)** - 各个页面的详细操作指南
+
+## 关于 BitSeek Claw
+
+BitSeek Claw 是 Hermes Agent 的轻量级 Web 界面，提供与 CLI 完全对等的功能。它采用三栏布局设计，支持深色主题，无需构建步骤或框架。
+
+### 主要特性
+
+- **持久化记忆** - 跨会话保持上下文和记忆
+- **多平台支持** - 支持 10+ 消息平台
+- **自改进技能** - 自动从经验中学习和保存技能
+- **提供商无关** - 支持 OpenAI、Anthropic、Google 等多家提供商
+- **自托管** - 完全控制对话、记忆和硬件
+
+## 获取帮助
+
+如有问题，请查看：
+- 项目根目录的 `README.md`
+- `docs/` 目录下的详细文档
+- `CONTRIBUTING.md` 贡献指南

package/vendor/agent-frontend-shell/build-release.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+# 构建定制版 Release 包
+
+set -e
+
+echo "🔨 开始构建 Hermes WebUI 定制版 Release..."
+
+# 检查分支
+CURRENT_BRANCH=$(git branch --show-current)
+if [[ ! "$CURRENT_BRANCH" =~ ^release/ ]]; then
+    echo "❌ 请在 release/* 分支上构建 Release"
+    echo "   当前分支: $CURRENT_BRANCH"
+    echo "   推荐分支: release/v1.0-custom"
+    exit 1
+fi
+
+# 确保最新代码
+echo "📥 拉取最新代码..."
+git pull origin "$CURRENT_BRANCH"
+
+# 版本信息
+VERSION=$(git describe --tags --abbrev=0 2>/dev/null || echo "v1.0-custom")
+COMMIT=$(git rev-parse --short HEAD)
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+
+# 文件名
+FILENAME="hermes-webui-custom-${VERSION}-${TIMESTAMP}.zip"
+
+echo "📦 打包版本: $VERSION"
+echo "🔧 提交: $COMMIT"
+echo "📁 文件名: $FILENAME"
+
+# 打包 (排除 .git 和其他不需要的文件)
+echo "🗜️ 正在打包..."
+git archive --format=zip --output="$FILENAME" HEAD \
+    --exclude=.git \
+    --exclude=.gitignore \
+    --exclude=.dockerignore \
+    --exclude=tests/ \
+    --exclude=.github/ \
+    --exclude=*.pyc \
+    --exclude=__pycache__/ \
+    --exclude=.pytest_cache/ \
+    --exclude=.coverage
+
+echo "✅ 打包完成: $FILENAME"
+echo ""
+echo "📋 Release 信息:"
+echo "   版本: $VERSION"
+echo "   分支: dev-zkp"
+echo "   提交: $COMMIT"
+echo "   大小: $(du -h "$FILENAME" | cut -f1)"
+echo ""
+echo "🚀 下一步:"
+echo "   1. 在 GitHub 创建 Release: $VERSION"
+echo "   2. 上传文件: $FILENAME"
+echo "   3. 更新 install.sh 中的 DOWNLOAD_URL"
+echo ""
+echo "📝 Release 描述模板:"
+echo "   🎨 Hermes WebUI 定制版 $VERSION"
+echo "   📦 包含所有定制功能和优化"
+echo "   🚀 一键安装: curl -fsSL https://your-domain.com/install.sh | bash"

package/vendor/agent-frontend-shell/ctl.sh

@@ -28,6 +28,7 @@ ensure_home() {
 }
 
 _load_repo_dotenv_preserving_env() {
+  [[ "${HERMES_WEBUI_NO_DOTENV:-0}" == "1" ]] && return 0
   local env_file="${REPO_ROOT}/.env"
   [[ -f "${env_file}" ]] || return 0
 

package/vendor/agent-frontend-shell/docker-compose.local.yml

@@ -0,0 +1,33 @@
+services:
+  hermes-webui-custom:
+    build: .
+    container_name: hermes-webui-custom
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:8787:8787"
+    extra_hosts:
+      # 让 Linux Docker Engine 也能使用 host.docker.internal 访问宿主机
+      - "host.docker.internal:host-gateway"
+    environment:
+      - HERMES_WEBUI_HOST=0.0.0.0
+      - HERMES_WEBUI_PORT=8787
+      - HERMES_WEBUI_PASSWORD=${HERMES_WEBUI_PASSWORD:-}
+      - HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui
+      - HERMES_WEBUI_DEFAULT_WORKSPACE=/workspace
+      - HERMES_WEBUI_EXTENSION_DIR=/app/extensions
+      - HERMES_WEBUI_EXTENSION_STYLESHEET_URLS=${HERMES_WEBUI_EXTENSION_STYLESHEET_URLS:-}
+      - HERMES_WEBUI_EXTENSION_SCRIPT_URLS=${HERMES_WEBUI_EXTENSION_SCRIPT_URLS:-}
+      - HERMES_WEBUI_BOT_NAME=${HERMES_WEBUI_BOT_NAME:-}
+      - HERMES_WEBUI_SKIP_ONBOARDING=${HERMES_WEBUI_SKIP_ONBOARDING:-0}
+      - WANTED_UID=${UID:-1000}
+      - WANTED_GID=${GID:-1000}
+    volumes:
+      # 绑定宿主机的 ~/.hermes，让容器能读取宿主机 hermes-agent 的配置和状态
+      - ${HERMES_HOME:-${HOME}/.hermes}:/home/hermeswebui/.hermes
+      - ${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace
+      - ./extensions:/app/extensions
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://127.0.0.1:8787/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3