FIX: fixes multiple issues in the OpenViking chat functionality and unifies session ID generation logic between Python and Rust CLI implementations. (#446)

* refactor(sandbox): remove docker/aiosandbox backends, simplify SRT config

- Remove docker and aiosandbox from available backends
- Remove settings_path from SrtBackendConfig (now auto-generated in workspace)
- Update SRT settings path to workspace/sandboxes/{session}-srt-settings.json
- Update README examples to use srt backend and remove settingsPath

* refactor(sandbox): remove docker/aiosandbox backends, simplify SRT config

- Remove docker and aiosandbox from available backends
- Remove settings_path from SrtBackendConfig (now auto-generated in workspace)
- Update SRT settings path to workspace/sandboxes/{session}-srt-settings.json
- Update README examples to use srt backend and remove settingsPath

* fix: remove unused handle_chat_direct function and fix unused logs variable

* Fix UTF-8 issues in chat command

* Add tab indentation to Think, Calling, and Result lines in CLI output

* Add first release workflow

* Update release workflow with correct working directory

* 修改 SessionKey 构建逻辑：统一使用 type="cli"，channel_id 默认 "default"，chat_id 作为 session_id 使用

* Implement machine unique ID as default session ID for ov chat

* Remove unsupported --logs parameter from chat command

* 统一 Python 和 Rust CLI 的默认 session ID 生成逻辑

* 修改日志

* 去掉log依赖

* docs: add VikingBot quick start section to READMEs

* fix: use vikingbot chat instead of ov chat in READMEs

* Revert "fix: use vikingbot chat instead of ov chat in READMEs"

This reverts commit 59f4e87.

* fix: use UUID v4 for machine ID generation in both Rust and Python

* refactor: move truncate_utf8 to utils, fix chat history path, and use BotProcess dataclass

* refactor: update machine ID generation and remove unused chat_v2

- Update Python to use py-machineid library
- Update Rust to use machine-uid crate
- Remove unused chat_v2.rs
- Move machine ID from file storage to system-provided IDs
- Add fallback to "default" if system ID is unavailable

* 优化格式

* ruff format .

Author: chenjw

.github/workflows/release-vikingbot-first.yml

@@ -0,0 +1,29 @@
+name: First Release to PyPI
+
+on:
+  workflow_dispatch:  # 手动触发
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: bot
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.VIKINGBOT_PYPI_API_TOKEN }}
+          packages-dir: bot/dist/

README.md

@@ -437,6 +437,21 @@ ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/zh
 
 Congratulations! You have successfully run OpenViking 🎉
 
+### VikingBot Quick Start
+
+VikingBot is an AI agent framework built on top of OpenViking. Here's how to get started:
+
+```bash
+# Install VikingBot from source (in OpenViking root directory)
+uv pip install -e bot/
+
+# Start OpenViking server with Bot enabled
+openviking-server --with-bot
+
+# In another terminal, start interactive chat
+ov chat
+```
+
 ---
 
 ## Server Deployment Details

README_CN.md

@@ -436,6 +436,21 @@ ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/zh
 
 恭喜！您已成功运行 OpenViking 🎉
 
+### VikingBot 快速开始
+
+VikingBot 是构建在 OpenViking 之上的 AI 智能体框架。以下是快速开始指南：
+
+```bash
+# 在 OpenViking 源码根目录下安装 VikingBot
+uv pip install -e bot/
+
+# 启动 OpenViking 服务器（同时启动 Bot）
+openviking-server --with-bot
+
+# 在另一个终端启动交互式聊天
+ov chat
+```
+
 ---
 
 ## 服务器部署详情

bot/.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build dependencies
+        run: |
+          pip install build
+
+      - name: Build package
+        run: |
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

bot/README.md

@@ -461,7 +461,7 @@ You only need to add sandbox configuration when you want to change these default
 {
   "bot": {
     "sandbox": {
-      "backend": "opensandbox",
+      "backend": "srt",
       "mode": "per-session"
     }
   }
@@ -472,10 +472,8 @@ You only need to add sandbox configuration when you want to change these default
 | Backend | Description |
 |---------|-------------|
 | `direct` | (Default) Runs code directly on the host |
-| `docker` | Uses Docker containers for isolation |
 | `opensandbox` | Uses OpenSandbox service |
 | `srt` | Uses Anthropic's SRT sandbox runtime |
-| `aiosandbox` | Uses AIO Sandbox service |
 
 **Available Modes:**
 | Mode | Description |
@@ -543,7 +541,6 @@ You only need to add sandbox configuration when you want to change these default
       "backend": "srt",
       "backends": {
         "srt": {
-          "settingsPath": "~/.vikingbot/srt-settings.json",
           "nodePath": "node",
           "network": {
             "allowedDomains": [],

bot/README_CN.md

@@ -475,10 +475,8 @@ vikingbot 支持沙箱执行以增强安全性。
 | 后端 | 描述 |
 |---------|-------------|
 | `direct` | （默认）直接在主机上运行代码 |
-| `docker` | 使用 Docker 容器进行隔离 |
 | `opensandbox` | 使用 OpenSandbox 服务 |
 | `srt` | 使用 Anthropic 的 SRT 沙箱运行时 |
-| `aiosandbox` | 使用 AIO Sandbox 服务 |
 
 **可用模式：**
 | 模式 | 描述 |
@@ -521,23 +519,6 @@ vikingbot 支持沙箱执行以增强安全性。
 }
 ```
 
-**Docker 后端：**
-```json
-{
-  "bot": {
-    "sandbox": {
-      "backend": "docker",
-      "backends": {
-        "docker": {
-          "image": "python:3.11-slim",
-          "networkMode": "bridge"
-        }
-      }
-    }
-  }
-}
-```
-
 **SRT 后端：**
 ```json
 {
@@ -546,7 +527,6 @@ vikingbot 支持沙箱执行以增强安全性。
       "backend": "srt",
       "backends": {
         "srt": {
-          "settingsPath": "~/.vikingbot/srt-settings.json",
           "nodePath": "node",
           "network": {
             "allowedDomains": [],
@@ -569,22 +549,6 @@ vikingbot 支持沙箱执行以增强安全性。
 }
 ```
 
-**AIO Sandbox 后端：**
-```json
-{
-  "bot": {
-    "sandbox": {
-      "backend": "aiosandbox",
-      "backends": {
-        "aiosandbox": {
-          "baseUrl": "http://localhost:18794"
-        }
-      }
-    }
-  }
-}
-```
-
 **SRT 后端设置：**
 
 SRT 后端使用 `@anthropic-ai/sandbox-runtime`。

bot/pyproject.toml

@@ -41,6 +41,8 @@ dependencies = [
     "openviking>=0.1.18",
     "ddgs>=9.0.0",
     "gradio>=6.6.0",
+    "py-machineid>=1.0.0",
+    "ruff>=0.15.1",
 ]
 
 [project.optional-dependencies]

bot/scripts/clean_vikingbot.py

@@ -0,0 +1,19 @@
+#!/bin/bash
+BOT_DIR="$HOME/.openviking/data/bot"
+
+echo "🧹 Cleaning VikingBot data directory..."
+echo "📂 Cleaning contents of: $BOT_DIR"
+
+if [ -d "$BOT_DIR" ]; then
+    echo "🗑️  Deleting items:"
+    for item in "$BOT_DIR"/*; do
+        if [ -e "$item" ]; then
+            echo "   - $(basename "$item")"
+            rm -rf "$item"
+        fi
+    done
+    echo "✅ Done!"
+else
+    echo "⚠️  Directory does not exist: $BOT_DIR"
+fi
+