Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
feat: wrapper ov command (#325)
MaojiaSheng7ae7bfb5dd20
diff --git a/.github/workflows/_build.yml b/.github/workflows/_build.ymlindex 8266ae6eb..ae8b145d6 100644--- a/.github/workflows/_build.yml+++ b/.github/workflows/_build.yml@@ -182,12 +182,15 @@ jobs:echo "LD_LIBRARY_PATH=${PYTHON_PREFIX}/lib:${LD_LIBRARY_PATH}" >> "$GITHUB_ENV"export LD_LIBRARY_PATH="${PYTHON_PREFIX}/lib:${LD_LIBRARY_PATH}""$PYTHON_BIN" -V-- name: Set up Gouses: actions/setup-go@v6with:go-version: '1.25.1'+ - name: Set up Rust+ uses: dtolnay/rust-toolchain@v1+ with:+ toolchain: stable- name: Install uvuses: astral-sh/setup-uv@v7with:@@ -205,6 +208,14 @@ jobs:- name: Install build dependenciesrun: uv pip install setuptools setuptools_scm pybind11 cmake wheel build+ - name: Build Rust CLI (Linux)+ run: cargo build --release --target x86_64-unknown-linux-gnu -p ov_cli++ - name: Copy Rust CLI binary (Linux)+ run: |+ mkdir -p openviking/bin+ cp target/x86_64-unknown-linux-gnu/release/ov openviking/bin/+ chmod +x openviking/bin/ov- name: Clean workspace (force ignore dirty)shell: bashrun: |@@ -298,6 +309,10 @@ jobs:with:go-version: '1.25.1'+ - name: Set up Rust+ uses: dtolnay/rust-toolchain@v1+ with:+ toolchain: stable- name: Install uvuses: astral-sh/setup-uv@v7with:@@ -319,6 +334,25 @@ jobs:- name: Install build dependenciesrun: uv pip install setuptools setuptools_scm pybind11 cmake wheel build+ - name: Build Rust CLI (macOS/Windows)+ shell: bash+ run: |+ if [[ "${{ matrix.os }}" == "windows-latest" ]]; then+ cargo build --release --target x86_64-pc-windows-msvc -p ov_cli+ else+ cargo build --release -p ov_cli+ fi++ - name: Copy Rust CLI binary (macOS/Windows)+ shell: bash+ run: |+ mkdir -p openviking/bin+ if [[ "${{ matrix.os }}" == "windows-latest" ]]; then+ cp target/x86_64-pc-windows-msvc/release/ov.exe openviking/bin/+ else+ cp target/release/ov openviking/bin/+ chmod +x openviking/bin/ov+ fi- name: Clean workspace (force ignore dirty)shell: bashrun: |diff --git a/openviking/cli.py b/openviking/cli.pynew file mode 100644index 000000000..34adc3d8a--- /dev/null+++ b/openviking/cli.py@@ -0,0 +1,86 @@+"""ov 命令的极简 Python 包装器++设计原则:+1. 职责单一:仅负责查找二进制并 execv+2. 无网络依赖:不实现下载功能+3. 极简代码:尽可能减少启动开销+4. 快速失败:找不到立即提示用户++性能说明:+- Python 虚拟机启动 + 导入基础模块:约 30-50ms+- 一旦 execv 执行,后续为纯 Rust 二进制,零开销++Rust CLI 独立发布能力完全保留,用户可通过以下方式获取:+- 官方安装脚本(零开销)+- GitHub Releases 手动下载(零开销)+- cargo install(零开销)+- 包管理器(未来)+"""++import os+import sys+from pathlib import Path+from shutil import which+++def main():+ """+ 极简入口点:查找 ov 二进制并执行++ 按优先级查找:+ 1. Wheel 自带:{package_dir}/openviking/bin/ov+ 2. PATH 查找:系统全局安装的 ov+ """+ # 1. 检查 Wheel 自带(不导入 openviking,避免额外开销)+ try:+ # __file__ is openviking/cli.py, so parent is openviking directory+ package_dir = Path(__file__).parent+ package_bin = package_dir / "bin"+ for binary_name in ["ov", "ov.exe"]:+ binary = package_bin / binary_name+ if binary.exists() and os.access(binary, os.X_OK):+ # 找到后立即 execv,不返回+ args = [str(binary)] + sys.argv[1:]+ os.execv(str(binary), args)+ except Exception:+ pass++ # 2. 检查 PATH,但跳过当前 Python 脚本+ path_binary = which("ov")+ if path_binary:+ # 检查文件是否是 Python 脚本(避免无限循环)+ try:+ candidate_path = Path(path_binary).resolve()+ with open(candidate_path, "rb") as f:+ first_bytes = f.read(2)+ # Skip if it starts with #! (shebang, likely Python script)+ if first_bytes != b"#!":+ args = [path_binary] + sys.argv[1:]+ os.execv(path_binary, args)+ except Exception:+ pass++ # 都找不到,提示用户+ print(+ """错误: 未找到 ov 二进制文件。++ 请选择以下方式之一安装:++ 1. 使用预构建 wheel(推荐):+ pip install openviking++ 2. 使用官方安装脚本(零 Python 开销):+ curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash++ 3. 从 GitHub Releases 下载(零 Python 开销):+ https://github.com/volcengine/OpenViking/releases++ 4. 从源码构建(零 Python 开销):+ cargo install --git https://github.com/volcengine/OpenViking ov_cli""",+ file=sys.stderr,+ )+ return 1+++if __name__ == "__main__":+ sys.exit(main())diff --git a/pyproject.toml b/pyproject.tomlindex 25050f2a5..dc4b6628a 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -89,7 +89,8 @@ Repository = "https://github.com/volcengine/openviking"Issues = "https://github.com/volcengine/openviking/issues"[project.scripts]-openviking = "openviking_cli.cli.main:app"+ov = "openviking.cli:main" # Rust CLI 入口(极简包装器)+# openviking = "openviking_cli.cli.main:app" # 可选:保留或移除openviking-server = "openviking.server.bootstrap:main"[tool.setuptools_scm]@@ -103,7 +104,13 @@ include = ["openviking*"]exclude = ["tests*", "docs*", "examples*"][tool.setuptools.package-data]-openviking = ["prompts/templates/**/*.yaml"]+openviking = [+ "prompts/templates/**/*.yaml",+ "bin/agfs-server",+ "bin/agfs-server.exe",+ "bin/ov", # 新增+ "bin/ov.exe" # 新增+][tool.mypy]python_version = "3.10"diff --git a/setup.py b/setup.pyindex 8a8089c4a..a39f01d60 100644--- a/setup.py+++ b/setup.py@@ -198,6 +198,8 @@ setup("bin/libagfsbinding.so","bin/libagfsbinding.dylib","bin/libagfsbinding.dll",+ "bin/ov", # 新增+ "bin/ov.exe", # 新增],},include_package_data=True,