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
Fix: 修复 rust CLI 命令中与 python CLI ls/tree 命令不一致的部分;add node limit arg (#193)
MaojiaSheng9ac3e3af2b59
diff --git a/README.md b/README.mdindex b8107d295..8f674818e 100644--- a/README.md+++ b/README.md@@ -581,7 +581,7 @@ Let's work together to define and build the future of AI Agent context managemen### Star Trend-[](https://www.star-history.com/#volcengine/OpenViking&Timeline)+[](https://www.star-history.com/#volcengine/OpenViking&type=timeline&legend=top-left)---diff --git a/README_CN.md b/README_CN.mdindex 0f2e76caa..c09354ed6 100644--- a/README_CN.md+++ b/README_CN.md@@ -457,7 +457,7 @@ OpenViking 目前还处于早期阶段,有许多需要完善和探索的地方### Star 趋势-[](https://www.star-history.com/#volcengine/OpenViking&Timeline)+[](https://www.star-history.com/#volcengine/OpenViking&type=timeline&legend=top-left)---diff --git a/crates/ov_cli/src/client.rs b/crates/ov_cli/src/client.rsindex 53dc3b7be..2c2bcc8be 100644--- a/crates/ov_cli/src/client.rs+++ b/crates/ov_cli/src/client.rs@@ -191,17 +191,27 @@ impl HttpClient {// ============ Filesystem Methods ============- pub async fn ls(&self, uri: &str, simple: bool, recursive: bool) -> Result<serde_json::Value> {+ pub async fn ls(&self, uri: &str, simple: bool, recursive: bool, output: &str, abs_limit: i32, show_all_hidden: bool, node_limit: i32) -> Result<serde_json::Value> {let params = vec![("uri".to_string(), uri.to_string()),("simple".to_string(), simple.to_string()),("recursive".to_string(), recursive.to_string()),+ ("output".to_string(), output.to_string()),+ ("abs_limit".to_string(), abs_limit.to_string()),+ ("show_all_hidden".to_string(), show_all_hidden.to_string()),+ ("node_limit".to_string(), node_limit.to_string()),];self.get("/api/v1/fs/ls", ¶ms).await}- pub async fn tree(&self, uri: &str) -> Result<serde_json::Value> {- let params = vec![("uri".to_string(), uri.to_string())];+ pub async fn tree(&self, uri: &str, output: &str, abs_limit: i32, show_all_hidden: bool, node_limit: i32) -> Result<serde_json::Value> {+ let params = vec![+ ("uri".to_string(), uri.to_string()),+ ("output".to_string(), output.to_string()),+ ("abs_limit".to_string(), abs_limit.to_string()),+ ("show_all_hidden".to_string(), show_all_hidden.to_string()),+ ("node_limit".to_string(), node_limit.to_string()),+ ];self.get("/api/v1/fs/tree", ¶ms).await}diff --git a/crates/ov_cli/src/commands/filesystem.rs b/crates/ov_cli/src/commands/filesystem.rsindex 0034c1a0e..b281f1c73 100644--- a/crates/ov_cli/src/commands/filesystem.rs+++ b/crates/ov_cli/src/commands/filesystem.rs@@ -7,10 +7,14 @@ pub async fn ls(uri: &str,simple: bool,recursive: bool,+ output: &str,+ abs_limit: i32,+ show_all_hidden: bool,+ node_limit: i32,output_format: OutputFormat,compact: bool,) -> Result<()> {- let result = client.ls(uri, simple, recursive).await?;+ let result = client.ls(uri, simple, recursive, output, abs_limit, show_all_hidden, node_limit).await?;output_success(&result, output_format, compact);Ok(())}@@ -18,10 +22,14 @@ pub async fn ls(pub async fn tree(client: &HttpClient,uri: &str,+ output: &str,+ abs_limit: i32,+ show_all_hidden: bool,+ node_limit: i32,output_format: OutputFormat,compact: bool,) -> Result<()> {- let result = client.tree(uri).await?;+ let result = client.tree(uri, output, abs_limit, show_all_hidden, node_limit).await?;output_success(&result, output_format, compact);Ok(())}diff --git a/crates/ov_cli/src/main.rs b/crates/ov_cli/src/main.rsindex 0d2ac0ceb..b98aaf4cb 100644--- a/crates/ov_cli/src/main.rs+++ b/crates/ov_cli/src/main.rs@@ -125,6 +125,16 @@ enum Commands {#[arg(long)]no_vectorize: bool,},+ /// Wait for queued async processing to complete+ Wait {+ /// Wait timeout in seconds+ #[arg(long)]+ timeout: Option<f64>,+ },+ /// Show OpenViking component status+ Status,+ /// Quick health check+ Health,/// System utility commandsSystem {#[command(subcommand)]@@ -152,11 +162,29 @@ enum Commands {/// List all subdirectories recursively#[arg(short, long)]recursive: bool,+ /// Abstract content limit (only for agent output)+ #[arg(long = "abs-limit", short = 'l', default_value = "256")]+ abs_limit: i32,+ /// Show all hidden files+ #[arg(short, long)]+ all: bool,+ /// Maximum number of nodes to list+ #[arg(long = "node-limit", short = 'n', default_value = "1000")]+ node_limit: i32,},/// Get directory treeTree {/// Viking URI to get tree foruri: String,+ /// Abstract content limit (only for agent output)+ #[arg(long = "abs-limit", short = 'l', default_value = "128")]+ abs_limit: i32,+ /// Show all hidden files+ #[arg(short, long)]+ all: bool,+ /// Maximum number of nodes to list+ #[arg(long = "node-limit", short = 'n', default_value = "1000")]+ node_limit: i32,},/// Create directoryMkdir {@@ -363,14 +391,23 @@ async fn main() {Commands::Import { file_path, target_uri, force, no_vectorize } => {handle_import(file_path, target_uri, force, no_vectorize, ctx).await}+ Commands::Wait { timeout } => {+ let client = ctx.get_client();+ commands::system::wait(&client, timeout, ctx.output_format, ctx.compact).await+ },+ Commands::Status => {+ let client = ctx.get_client();+ commands::observer::system(&client, ctx.output_format, ctx.compact).await+ },+ Commands::Health => handle_health(ctx).await,Commands::System { action } => handle_system(action, ctx).await,Commands::Observer { action } => handle_observer(action, ctx).await,Commands::Session { action } => handle_session(action, ctx).await,- Commands::Ls { uri, simple, recursive } => {- handle_ls(uri, simple, recursive, ctx).await+ Commands::Ls { uri, simple, recursive, abs_limit, all, node_limit } => {+ handle_ls(uri, simple, recursive, abs_limit, all, node_limit, ctx).await}- Commands::Tree { uri } => {- handle_tree(uri, ctx).await+ Commands::Tree { uri, abs_limit, all, node_limit } => {+ handle_tree(uri, abs_limit, all, node_limit, ctx).await}Commands::Mkdir { uri } => {handle_mkdir(uri, ctx).await@@ -612,14 +649,16 @@ async fn handle_search(commands::search::search(&client, &query, &uri, session_id, limit, threshold, ctx.output_format, ctx.compact).await}-async fn handle_ls(uri: String, simple: bool, recursive: bool, ctx: CliContext) -> Result<()> {+async fn handle_ls(uri: String, simple: bool, recursive: bool, abs_limit: i32, show_all_hidden: bool, node_limit: i32, ctx: CliContext) -> Result<()> {let client = ctx.get_client();- commands::filesystem::ls(&client, &uri, simple, recursive, ctx.output_format, ctx.compact).await+ let api_output = if ctx.compact { "agent" } else { "original" };+ commands::filesystem::ls(&client, &uri, simple, recursive, api_output, abs_limit, show_all_hidden, node_limit, ctx.output_format, ctx.compact).await}-async fn handle_tree(uri: String, ctx: CliContext) -> Result<()> {+async fn handle_tree(uri: String, abs_limit: i32, show_all_hidden: bool, node_limit: i32, ctx: CliContext) -> Result<()> {let client = ctx.get_client();- commands::filesystem::tree(&client, &uri, ctx.output_format, ctx.compact).await+ let api_output = if ctx.compact { "agent" } else { "original" };+ commands::filesystem::tree(&client, &uri, api_output, abs_limit, show_all_hidden, node_limit, ctx.output_format, ctx.compact).await}async fn handle_mkdir(uri: String, ctx: CliContext) -> Result<()> {@@ -651,3 +690,14 @@ async fn handle_glob(pattern: String, uri: String, ctx: CliContext) -> Result<()let client = ctx.get_client();commands::search::glob(&client, &pattern, &uri, ctx.output_format, ctx.compact).await}++async fn handle_health(ctx: CliContext) -> Result<()> {+ let client = ctx.get_client();+ let system_status: serde_json::Value = client.get("/api/v1/observer/system", &[]).await?;+ let is_healthy = system_status.get("is_healthy").and_then(|v| v.as_bool()).unwrap_or(false);+ output::output_success(&serde_json::json!({ "healthy": is_healthy }), ctx.output_format, ctx.compact);+ if !is_healthy {+ std::process::exit(1);+ }+ Ok(())+}diff --git a/openviking/async_client.py b/openviking/async_client.pyindex b4f48ed5a..84e3c7e10 100644--- a/openviking/async_client.py+++ b/openviking/async_client.py@@ -306,8 +306,13 @@ class AsyncOpenViking:output = kwargs.get("output", "original")abs_limit = kwargs.get("abs_limit", 128)show_all_hidden = kwargs.get("show_all_hidden", True)+ node_limit = kwargs.get("node_limit", 1000)return await self._client.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,)async def mkdir(self, uri: str) -> None:diff --git a/openviking/client/local.py b/openviking/client/local.pyindex 46acca99d..389439ac3 100644--- a/openviking/client/local.py+++ b/openviking/client/local.py@@ -113,10 +113,15 @@ class LocalClient(BaseClient):output: str = "original",abs_limit: int = 128,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Dict[str, Any]]:"""Get directory tree."""return await self._service.fs.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,)async def stat(self, uri: str) -> Dict[str, Any]:diff --git a/openviking/server/routers/filesystem.py b/openviking/server/routers/filesystem.pyindex 5e71fe656..a24e64c67 100644--- a/openviking/server/routers/filesystem.py+++ b/openviking/server/routers/filesystem.py@@ -22,6 +22,7 @@ async def ls(output: str = Query("agent", description="Output format: original or agent"),abs_limit: int = Query(256, description="Abstract limit (only for agent output)"),show_all_hidden: bool = Query(False, description="List all hidden files, like -a"),+ node_limit: int = Query(1000, description="Maximum number of nodes to list"),_: bool = Depends(verify_api_key),):"""List directory contents."""@@ -33,6 +34,7 @@ async def ls(output=output,abs_limit=abs_limit,show_all_hidden=show_all_hidden,+ node_limit=node_limit,)return Response(status="ok", result=result)@@ -43,12 +45,17 @@ async def tree(output: str = Query("agent", description="Output format: original or agent"),abs_limit: int = Query(256, description="Abstract limit (only for agent output)"),show_all_hidden: bool = Query(False, description="List all hidden files, like -a"),+ node_limit: int = Query(1000, description="Maximum number of nodes to list"),_: bool = Depends(verify_api_key),):"""Get directory tree."""service = get_service()result = await service.fs.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,)return Response(status="ok", result=result)diff --git a/openviking/service/fs_service.py b/openviking/service/fs_service.pyindex 72e5526d8..598e0fc04 100644--- a/openviking/service/fs_service.py+++ b/openviking/service/fs_service.py@@ -39,6 +39,7 @@ class FSService:output: str = "original",abs_limit: int = 256,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Any]:"""List directory contents.@@ -49,12 +50,17 @@ class FSService:output: str = "original" or "agent"abs_limit: int = 256 if output == "agent" else ignoreshow_all_hidden: bool = False (list all hidden files, like -a)+ node_limit: int = 1000 (maximum number of nodes to list)"""viking_fs = self._ensure_initialized()if recursive:entries = await viking_fs.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,)else:entries = await viking_fs.ls(@@ -86,11 +92,16 @@ class FSService:output: str = "original",abs_limit: int = 128,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Dict[str, Any]]:"""Get directory tree."""viking_fs = self._ensure_initialized()return await viking_fs.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,)async def stat(self, uri: str) -> Dict[str, Any]:diff --git a/openviking/storage/viking_fs.py b/openviking/storage/viking_fs.pyindex 3f3f173ef..a8e52c72f 100644--- a/openviking/storage/viking_fs.py+++ b/openviking/storage/viking_fs.py@@ -201,9 +201,9 @@ class VikingFS:path = self._uri_to_path(uri)return self.agfs.stat(path)- async def glob(self, pattern: str, uri: str = "viking://") -> Dict:+ async def glob(self, pattern: str, uri: str = "viking://", node_limit: int = 1000) -> Dict:"""File pattern matching, supports **/*.md recursive."""- entries = await self.tree(uri)+ entries = await self.tree(uri, node_limit=node_limit)base_uri = uri.rstrip("/")matches = []for entry in entries:@@ -248,6 +248,7 @@ class VikingFS:output: str = "original",abs_limit: int = 256,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Dict[str, Any]]:"""Recursively list all contents (includes rel_path).@@ -265,19 +266,25 @@ class VikingFS:[{'name': '.abstract.md', 'size': 100, 'modTime': '2026-02-11 16:52:16', 'isDir': False, 'rel_path': '.abstract.md', 'uri': 'viking://resources...', 'abstract': "..."}]"""if output == "original":- return await self._tree_original(uri, show_all_hidden)+ return await self._tree_original(uri, show_all_hidden, node_limit)elif output == "agent":- return await self._tree_agent(uri, abs_limit, show_all_hidden)+ return await self._tree_agent(uri, abs_limit, show_all_hidden, node_limit)else:raise ValueError(f"Invalid output format: {output}")- async def _tree_original(self, uri: str, show_all_hidden: bool = False) -> List[Dict[str, Any]]:+ async def _tree_original(+ self, uri: str, show_all_hidden: bool = False, node_limit: int = 1000+ ) -> List[Dict[str, Any]]:"""Recursively list all contents (original format)."""path = self._uri_to_path(uri)all_entries = []async def _walk(current_path: str, current_rel: str):+ if len(all_entries) >= node_limit:+ returnfor entry in self.agfs.ls(current_path):+ if len(all_entries) >= node_limit:+ breakname = entry.get("name", "")if name in [".", ".."]:continue@@ -297,7 +304,7 @@ class VikingFS:return all_entriesasync def _tree_agent(- self, uri: str, abs_limit: int, show_all_hidden: bool = False+ self, uri: str, abs_limit: int, show_all_hidden: bool = False, node_limit: int = 1000) -> List[Dict[str, Any]]:"""Recursively list all contents (agent format with abstracts)."""path = self._uri_to_path(uri)@@ -305,7 +312,11 @@ class VikingFS:now = datetime.now()async def _walk(current_path: str, current_rel: str):+ if len(all_entries) >= node_limit:+ returnfor entry in self.agfs.ls(current_path):+ if len(all_entries) >= node_limit:+ breakname = entry.get("name", "")if name in [".", ".."]:continuediff --git a/openviking_cli/cli/commands/filesystem.py b/openviking_cli/cli/commands/filesystem.pyindex 9b7765627..27c7c44a4 100644--- a/openviking_cli/cli/commands/filesystem.py+++ b/openviking_cli/cli/commands/filesystem.py@@ -26,6 +26,9 @@ def register(app: typer.Typer) -> None:),abs_limit: int = typer.Option(256, "--abs-limit", "-l", help="Abstract content limit"),show_all_hidden: bool = typer.Option(False, "--all", "-a", help="Show all hidden files"),+ node_limit: int = typer.Option(+ 1000, "--node-limit", "-n", help="Maximum number of nodes to list"+ ),) -> None:"""List directory contents."""run(@@ -37,6 +40,7 @@ def register(app: typer.Typer) -> None:output=output_format,abs_limit=abs_limit,show_all_hidden=show_all_hidden,+ node_limit=node_limit,),)@@ -49,6 +53,9 @@ def register(app: typer.Typer) -> None:),abs_limit: int = typer.Option(128, "--abs-limit", "-l", help="Abstract content limit"),show_all_hidden: bool = typer.Option(False, "--all", "-a", help="Show all hidden files"),+ node_limit: int = typer.Option(+ 1000, "--node-limit", "-n", help="Maximum number of nodes to list"+ ),) -> None:"""Get directory tree info.@@ -56,7 +63,11 @@ def register(app: typer.Typer) -> None:run(ctx,lambda client: client.tree(- uri, output=output_format, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output_format,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,),)diff --git a/openviking_cli/client/base.py b/openviking_cli/client/base.pyindex b72d4f3a0..7882b5852 100644--- a/openviking_cli/client/base.py+++ b/openviking_cli/client/base.py@@ -68,6 +68,7 @@ class BaseClient(ABC):output: str = "original",abs_limit: int = 256,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Any]:"""List directory contents."""...@@ -79,6 +80,7 @@ class BaseClient(ABC):output: str = "original",abs_limit: int = 128,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Dict[str, Any]]:"""Get directory tree."""...diff --git a/openviking_cli/client/http.py b/openviking_cli/client/http.pyindex a8ae37266..395266029 100644--- a/openviking_cli/client/http.py+++ b/openviking_cli/client/http.py@@ -278,6 +278,7 @@ class AsyncHTTPClient(BaseClient):output: str = "original",abs_limit: int = 256,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Any]:"""List directory contents."""response = await self._http.get(@@ -289,6 +290,7 @@ class AsyncHTTPClient(BaseClient):"output": output,"abs_limit": abs_limit,"show_all_hidden": show_all_hidden,+ "node_limit": node_limit,},)return self._handle_response(response)@@ -299,6 +301,7 @@ class AsyncHTTPClient(BaseClient):output: str = "original",abs_limit: int = 128,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Dict[str, Any]]:"""Get directory tree."""response = await self._http.get(@@ -308,6 +311,7 @@ class AsyncHTTPClient(BaseClient):"output": output,"abs_limit": abs_limit,"show_all_hidden": show_all_hidden,+ "node_limit": node_limit,},)return self._handle_response(response)diff --git a/openviking_cli/client/sync_http.py b/openviking_cli/client/sync_http.pyindex fdfa450f5..97a9e0f25 100644--- a/openviking_cli/client/sync_http.py+++ b/openviking_cli/client/sync_http.py@@ -160,6 +160,7 @@ class SyncHTTPClient:output: str = "original",abs_limit: int = 256,show_all_hidden: bool = False,+ node_limit: int = 1000,) -> List[Any]:"""List directory contents."""return run_async(@@ -170,6 +171,7 @@ class SyncHTTPClient:output=output,abs_limit=abs_limit,show_all_hidden=show_all_hidden,+ node_limit=node_limit,))@@ -179,11 +181,16 @@ class SyncHTTPClient:output: str = "original",abs_limit: int = 128,show_all_hidden: bool = False,- ) -> Dict:+ node_limit: int = 1000,+ ) -> List[Dict[str, Any]]:"""Get directory tree."""return run_async(self._async_client.tree(- uri, output=output, abs_limit=abs_limit, show_all_hidden=show_all_hidden+ uri,+ output=output,+ abs_limit=abs_limit,+ show_all_hidden=show_all_hidden,+ node_limit=node_limit,))