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

package/vendor/agent-frontend-shell/bitseek_docs/md_to_docx.py

@@ -0,0 +1,351 @@
+#!/usr/bin/env python3
+"""
+Markdown to Word Converter for BitSeek Claw Documentation
+Generates two Word documents: one English, one Chinese
+"""
+
+import re
+import os
+from pathlib import Path
+from docx import Document
+from docx.shared import Inches, Pt, RGBColor, Cm
+from docx.enum.text import WD_ALIGN_PARAGRAPH
+from docx.enum.style import WD_STYLE_TYPE
+from docx.oxml.ns import qn
+
+# Base directory
+BASE_DIR = Path(__file__).parent
+
+
+def parse_markdown_table(lines):
+    """Parse a markdown table into rows of cells."""
+    rows = []
+    for line in lines:
+        line = line.strip()
+        if line.startswith('|') and line.endswith('|'):
+            # Skip separator line
+            if re.match(r'^\|[\s\-:|]+\|$', line):
+                continue
+            cells = [cell.strip() for cell in line.split('|')[1:-1]]
+            rows.append(cells)
+    return rows
+
+
+def add_table_to_doc(doc, rows):
+    """Add a table to the document from parsed rows."""
+    if not rows:
+        return
+    
+    num_cols = len(rows[0])
+    table = doc.add_table(rows=len(rows), cols=num_cols, style='Table Grid')
+    
+    for i, row_data in enumerate(rows):
+        for j, cell_text in enumerate(row_data):
+            cell = table.cell(i, j)
+            cell.text = ''
+            p = cell.paragraphs[0]
+            # Use bold for header row
+            run = p.add_run(cell_text)
+            if i == 0:
+                run.bold = True
+                run.font.size = Pt(10)
+            else:
+                run.font.size = Pt(10)
+    
+    doc.add_paragraph()  # Add space after table
+
+
+def parse_markdown(md_content, doc, lang_dir='en'):
+    """Parse markdown content and add to Word document.
+    
+    Args:
+        md_content: Markdown text content
+        doc: Word document object
+        lang_dir: Language subdirectory ('en' or 'zh') for image path resolution
+    """
+    lines = md_content.split('\n')
+    i = 0
+    in_code_block = False
+    code_lines = []
+    in_table = False
+    table_lines = []
+    image_refs = []
+    
+    while i < len(lines):
+        line = lines[i]
+        
+        # Handle code blocks
+        if line.strip().startswith('```'):
+            if in_code_block:
+                # End of code block
+                code_text = '\n'.join(code_lines)
+                if code_text.strip():
+                    p = doc.add_paragraph()
+                    p.style = doc.styles['Normal']
+                    run = p.add_run(code_text)
+                    run.font.name = 'Courier New'
+                    run.font.size = Pt(9)
+                    run.font.color.rgb = RGBColor(0x33, 0x33, 0x33)
+                code_lines = []
+                in_code_block = False
+            else:
+                # Start of code block
+                in_code_block = True
+            i += 1
+            continue
+        
+        if in_code_block:
+            code_lines.append(line)
+            i += 1
+            continue
+        
+        # Handle tables
+        if line.strip().startswith('|') and line.strip().endswith('|'):
+            table_lines.append(line)
+            i += 1
+            continue
+        elif table_lines:
+            # End of table
+            rows = parse_markdown_table(table_lines)
+            add_table_to_doc(doc, rows)
+            table_lines = []
+        
+        # Handle images
+        img_match = re.match(r'!\[([^\]]*)\]\(([^\)]+)\)', line.strip())
+        if img_match:
+            alt_text = img_match.group(1)
+            img_path = img_match.group(2)
+            # Try to add the image - resolve path relative to language subdirectory
+            full_img_path = BASE_DIR / lang_dir / img_path
+            if full_img_path.exists():
+                try:
+                    from PIL import Image as PILImage
+                    with PILImage.open(str(full_img_path)) as pil_img:
+                        w_px, h_px = pil_img.size
+                    # Calculate width to fit within max height of 300pt (~400px at 96dpi)
+                    max_height = Pt(300)
+                    aspect = w_px / h_px if h_px > 0 else 1
+                    target_height = min(h_px, 300 * 96 / 72)  # 300pt -> px
+                    target_width = target_height * aspect
+                    from docx.shared import Emu
+                    # Use width as primary constraint, cap height at 300pt
+                    pic = doc.add_picture(str(full_img_path), width=Inches(5))
+                    # Scale down if height exceeds 300pt
+                    if pic.height > max_height:
+                        scale = max_height / pic.height
+                        pic.width = int(pic.width * scale)
+                        pic.height = max_height
+                    last_paragraph = doc.paragraphs[-1]
+                    last_paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
+                except ImportError:
+                    # Fallback: just insert without PIL
+                    doc.add_picture(str(full_img_path), width=Inches(5))
+                    last_paragraph = doc.paragraphs[-1]
+                    last_paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
+                except Exception as e:
+                    # If image fails, add alt text as caption
+                    p = doc.add_paragraph(f'[{alt_text}]')
+                    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+            else:
+                p = doc.add_paragraph(f'[{alt_text}]')
+                p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+            i += 1
+            continue
+        
+        # Handle headings
+        if line.startswith('#'):
+            level = len(line.split(' ')[0])
+            text = line.lstrip('#').strip()
+            if level == 1:
+                p = doc.add_heading(text, level=0)
+            elif level == 2:
+                p = doc.add_heading(text, level=1)
+            elif level == 3:
+                p = doc.add_heading(text, level=2)
+            elif level == 4:
+                p = doc.add_heading(text, level=3)
+            else:
+                p = doc.add_heading(text, level=4)
+            i += 1
+            continue
+        
+        # Handle horizontal rules
+        if line.strip() in ('---', '***', '___'):
+            # Add a thin line
+            p = doc.add_paragraph()
+            p.paragraph_format.space_before = Pt(6)
+            p.paragraph_format.space_after = Pt(6)
+            i += 1
+            continue
+        
+        # Handle empty lines
+        if not line.strip():
+            i += 1
+            continue
+        
+        # Handle ordered lists
+        ol_match = re.match(r'^(\s*)\d+\.\s+(.*)', line)
+        if ol_match:
+            text = ol_match.group(2)
+            p = doc.add_paragraph(style='List Number')
+            parse_inline_formatting(p, text)
+            i += 1
+            continue
+        
+        # Handle unordered lists
+        ul_match = re.match(r'^(\s*)[-*+]\s+(.*)', line)
+        if ul_match:
+            text = ul_match.group(2)
+            p = doc.add_paragraph(style='List Bullet')
+            parse_inline_formatting(p, text)
+            i += 1
+            continue
+        
+        # Handle regular paragraphs
+        p = doc.add_paragraph()
+        parse_inline_formatting(p, line)
+        i += 1
+    
+    # Process any remaining table lines
+    if table_lines:
+        rows = parse_markdown_table(table_lines)
+        add_table_to_doc(doc, rows)
+
+
+def parse_inline_formatting(p, text):
+    """Parse inline markdown formatting (bold, code, links) and add to paragraph."""
+    # Pattern to match **bold**, `code`, and [link](url)
+    pattern = r'(\*\*[^*]+\*\*|`[^`]+`|\[[^\]]+\]\([^)]+\))'
+    
+    parts = re.split(pattern, text)
+    
+    for part in parts:
+        if not part:
+            continue
+        
+        # Bold text
+        if part.startswith('**') and part.endswith('**'):
+            run = p.add_run(part[2:-2])
+            run.bold = True
+        # Inline code
+        elif part.startswith('`') and part.endswith('`'):
+            run = p.add_run(part[1:-1])
+            run.font.name = 'Courier New'
+            run.font.size = Pt(9)
+            run.font.color.rgb = RGBColor(0xC7, 0x25, 0x4E)
+        # Link
+        elif part.startswith('['):
+            link_match = re.match(r'\[([^\]]+)\]\(([^)]+)\)', part)
+            if link_match:
+                run = p.add_run(link_match.group(1))
+                run.font.color.rgb = RGBColor(0x00, 0x66, 0xCC)
+                run.underline = True
+        # Regular text
+        else:
+            p.add_run(part)
+
+
+def create_document(title, subtitle, md_files, output_path, lang_dir='en'):
+    """Create a Word document from markdown files.
+    
+    Args:
+        title: Document title
+        subtitle: Document subtitle
+        md_files: List of markdown file paths (relative to BASE_DIR)
+        output_path: Output Word file path
+        lang_dir: Language subdirectory ('en' or 'zh') for image resolution
+    """
+    doc = Document()
+    
+    # Set default font
+    style = doc.styles['Normal']
+    font = style.font
+    font.name = 'Arial'
+    font.size = Pt(11)
+    
+    # Configure heading styles
+    for i in range(1, 5):
+        heading_style = doc.styles[f'Heading {i}']
+        heading_font = heading_style.font
+        heading_font.color.rgb = RGBColor(0x1A, 0x1A, 0x2E)
+    
+    # Add title page
+    p = doc.add_paragraph()
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    run = p.add_run(title)
+    run.bold = True
+    run.font.size = Pt(28)
+    run.font.color.rgb = RGBColor(0x1A, 0x1A, 0x2E)
+    
+    p = doc.add_paragraph()
+    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    run = p.add_run(subtitle)
+    run.font.size = Pt(14)
+    run.font.color.rgb = RGBColor(0x66, 0x66, 0x66)
+    
+    doc.add_paragraph()
+    doc.add_paragraph()
+    
+    # Add each markdown file as a section
+    for md_file in md_files:
+        md_path = BASE_DIR / md_file
+        if md_path.exists():
+            with open(md_path, 'r', encoding='utf-8') as f:
+                content = f.read()
+            
+            # Add page break before each section (except the first)
+            if md_files.index(md_file) > 0:
+                doc.add_page_break()
+            
+            # Parse and add content
+            parse_markdown(content, doc, lang_dir)
+    
+    # Save document
+    doc.save(output_path)
+    print(f'Created: {output_path}')
+
+
+def main():
+    # English document
+    en_files = [
+        'en/README.md',
+        'en/00-Installation.md',
+        'en/01-Overview.md',
+        'en/02-Page-Operations.md',
+    ]
+    
+    # Chinese document
+    zh_files = [
+        'zh/README.md',
+        'zh/00-安装启动.md',
+        'zh/01-整体概览.md',
+        'zh/02-页面操作.md',
+    ]
+    
+    output_dir = BASE_DIR
+    
+    # Generate English document
+    create_document(
+        title='BitSeek Claw',
+        subtitle='Operation Manual',
+        md_files=en_files,
+        output_path=output_dir / 'BitSeek_Claw_Operation_Manual_EN.docx',
+        lang_dir='en'
+    )
+    
+    # Generate Chinese document
+    create_document(
+        title='BitSeek Claw',
+        subtitle='操作文档',
+        md_files=zh_files,
+        output_path=output_dir / 'BitSeek_Claw_Operation_Manual_ZH.docx',
+        lang_dir='zh'
+    )
+    
+    print('\nDone! Generated:')
+    print('  - BitSeek_Claw_Operation_Manual_EN.docx')
+    print('  - BitSeek_Claw_Operation_Manual_ZH.docx')
+
+
+if __name__ == '__main__':
+    main()

package/vendor/agent-frontend-shell/bitseek_docs/zh/00-/345/256/211/350/243/205/345/220/257/345/212/250.md

@@ -0,0 +1,174 @@
+# 安装和启动 BitSeek Claw
+
+本指南介绍如何安装和启动 BitSeek Claw（Hermes WebUI）。
+
+## 系统要求
+
+- **操作系统**：macOS、Linux 或 WSL2（Windows 需通过 WSL2）
+- **Python**：3.8 或更高版本
+- **Hermes Agent**：需要预先安装 Hermes Agent
+
+## 安装步骤
+
+### 1. 克隆仓库
+
+```bash
+git clone https://github.com/your-repo/agent-frontend-shell.git
+cd agent-frontend-shell
+```
+
+### 2. 环境配置
+
+#### 方法一：使用 `.env` 文件（推荐）
+
+```bash
+# 复制示例环境文件
+cp .env.example .env
+
+# 编辑 .env 文件配置必要参数
+nano .env
+```
+
+#### 方法二：直接设置环境变量
+
+```bash
+export HERMES_WEBUI_HOST=127.0.0.1
+export HERMES_WEBUI_PORT=8787
+export HERMES_HOME=~/.hermes
+```
+
+### 3. 启动服务
+
+#### 方法一：使用启动脚本（推荐）
+
+```bash
+# 使用 start.sh 启动
+./start.sh
+```
+
+#### 方法二：使用 Python 启动器
+
+```bash
+# 使用 bootstrap.py 启动（会自动检查依赖）
+python3 bootstrap.py
+```
+
+#### 方法三：使用控制脚本
+
+```bash
+# 使用 ctl.sh 管理服务
+./ctl.sh start
+```
+
+## 启动参数
+
+### 环境变量配置
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `HERMES_WEBUI_HOST` | `127.0.0.1` | 监听地址 |
+| `HERMES_WEBUI_PORT` | `8787` | 监听端口 |
+| `HERMES_HOME` | `~/.hermes` | Hermes 主目录 |
+| `HERMES_WEBUI_STATE_DIR` | - | 状态目录路径 |
+| `HERMES_WEBUI_DEFAULT_WORKSPACE` | - | 默认工作区路径 |
+
+### 启动选项
+
+```bash
+# 指定端口启动
+HERMES_WEBUI_PORT=8888 ./start.sh
+
+# 指定主机和端口
+HERMES_WEBUI_HOST=0.0.0.0 HERMES_WEBUI_PORT=8787 ./start.sh
+
+# 使用自定义状态目录
+HERMES_WEBUI_STATE_DIR=/tmp/hermes-state ./start.sh
+```
+
+## 访问界面
+
+启动成功后，在浏览器中访问：
+
+```
+http://localhost:8787
+```
+
+### 首次访问
+
+1. 打开浏览器访问上述地址
+2. 首次访问会进入**首次运行向导**
+3. 按照向导提示配置：
+   - AI 提供商设置（如 OpenAI、Anthropic 等）
+   - API 密钥配置
+   - 基本偏好设置
+
+## Docker 部署
+
+### 单容器部署
+
+```bash
+# 使用 Docker Compose
+docker-compose up -d
+
+# 或使用自定义配置
+docker-compose -f docker-compose.custom.yml up -d
+```
+
+### 多容器部署
+
+```bash
+# 三容器架构
+docker-compose -f docker-compose.three-container.yml up -d
+
+# 两容器架构
+docker-compose -f docker-compose.two-container.yml up -d
+```
+
+## 常见问题
+
+### 端口被占用
+
+```bash
+# 检查端口占用
+lsof -i :8787
+
+# 使用其他端口
+HERMES_WEBUI_PORT=8788 ./start.sh
+```
+
+### 权限问题
+
+```bash
+# 确保脚本有执行权限
+chmod +x start.sh
+chmod +x ctl.sh
+chmod +x bootstrap.py
+```
+
+### 依赖缺失
+
+```bash
+# 安装 Python 依赖
+pip install -r requirements.txt
+
+# 或使用虚拟环境
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+
+## 停止服务
+
+```bash
+# 使用控制脚本停止
+./ctl.sh stop
+
+# 或查找进程并终止
+pkill -f "python.*server.py"
+```
+
+## 下一步
+
+安装启动完成后，请查看：
+- **[整体概览](01-整体概览.md)** - 了解界面布局
+- **[页面操作](02-页面操作.md)** - 学习具体操作

package/vendor/agent-frontend-shell/bitseek_docs/zh/01-/346/225/264/344/275/223/346/246/202/350/247/210.md

@@ -0,0 +1,128 @@
+# BitSeek Claw 整体概览
+
+BitSeek Claw 采用现代化的三栏布局设计，提供直观的用户界面。以下是界面的整体结构介绍。
+
+## 界面布局
+
+![整体布局](images/main-page.png)
+
+BitSeek Claw 的界面分为三个主要区域：
+
+1. **顶部导航栏** - 功能模块切换
+2. **左侧边栏** - 会话管理和导航
+3. **中央主区域** - 聊天和工作区
+4. **右侧面板** - 文件浏览（可选）
+
+## 顶部导航栏
+
+![导航栏](images/navigation-bar.png)
+
+导航栏位于页面顶部，包含以下功能模块：
+
+| 图标 | 名称 | 功能描述 |
+|------|------|----------|
+| 💬 | 聊天 | 与 AI 进行对话交流 |
+| 👥 | AI 同事 | 管理和交互多个 AI 代理 |
+| 📋 | 任务 | 查看和管理任务列表 |
+| 📊 | 看板 | 任务看板视图 |
+| ⚡ | 技能 | 管理 AI 技能库 |
+| 🧠 | 记忆 | 查看和管理 AI 记忆 |
+| 📁 | 工作区 | 文件和项目管理 |
+| ⚙️ | 配置 | 代理配置管理 |
+| ✅ | 待办 | 待办事项管理 |
+| 📈 | 统计 | 使用统计和洞察 |
+| 📊 | Hermes 仪表盘 | 系统监控面板 |
+| 📝 | 日志 | 系统日志查看 |
+| ⚙️ | 设置 | 系统设置 |
+
+## 左侧边栏
+
+![侧边栏](images/sidebar.png)
+
+左侧边栏提供会话管理和快速导航：
+
+### 会话管理
+- **新建对话** - 创建新的聊天会话
+- **筛选对话** - 按关键词筛选会话
+- **会话列表** - 显示所有历史会话
+  - 按时间分组（今天、昨天、上周等）
+  - 每个会话显示标题和最后活跃时间
+  - 右键菜单提供更多操作
+
+### 项目管理
+- **所有** - 查看所有会话
+- **未分配** - 查看未分配项目的会话
+- **新建项目** - 创建新项目分组
+
+## 中央主区域
+
+![聊天区域](images/chat-area.png)
+
+中央主区域是主要工作区，根据当前选择的功能模块显示不同内容：
+
+### 聊天界面
+- **欢迎消息** - 显示引导问题
+- **消息输入框** - 输入消息与 AI 交流
+- **快捷操作** - 文件选择、听写等功能
+- **上下文信息** - 显示当前模型、工作区等
+
+### 其他功能界面
+- 任务管理、看板视图、技能管理等
+- 每个功能模块都有专门的界面布局
+
+## 右侧工作区面板
+
+![工作区面板](images/workspace-panel.png)
+
+右侧工作区面板提供文件管理功能：
+
+### 文件浏览器
+- **文件列表** - 显示工作区中的文件和文件夹
+- **文件操作** - 新建文件、文件夹、刷新等
+- **文件预览** - 点击文件可预览内容
+
+### 功能标签
+- **Files** - 文件浏览器
+- **Artifacts** - 生成的工件和内容
+
+## 底部控制栏
+
+底部控制栏提供会话级别的控制：
+
+### 模型选择
+- **AI 模型** - 切换不同的 AI 模型
+- **推理强度** - 调整 AI 推理强度
+- **配置文件** - 切换用户配置文件
+
+### 消息操作
+- **发送按钮** - 发送输入的消息
+- **文件附件** - 附加文件到消息
+- **听写功能** - 语音输入支持
+
+## 主题和外观
+
+BitSeek Claw 支持多种主题：
+
+- **深色主题** - 默认主题，护眼舒适
+- **浅色主题** - 明亮清爽的界面
+- **自定义主题** - 支持自定义颜色方案
+
+## 响应式设计
+
+界面支持不同屏幕尺寸：
+- **桌面端** - 完整三栏布局
+- **平板端** - 可折叠侧边栏
+- **移动端** - 单栏布局，适配手机屏幕
+
+## 快捷键
+
+常用快捷键：
+- `Ctrl/Cmd + N` - 新建对话
+- `Ctrl/Cmd + /` - 聚焦搜索框
+- `Ctrl/Cmd + Enter` - 发送消息
+- `Esc` - 关闭弹窗或取消操作
+
+## 下一步
+
+了解整体布局后，请查看：
+- **[页面操作](02-页面操作.md)** - 各个功能模块的详细操作指南