Skip to content

docs: Add basic usage example and Chinese documentation for examples#979

Merged
MaojiaSheng merged 2 commits intovolcengine:mainfrom
xingzihai:main
Mar 26, 2026
Merged

docs: Add basic usage example and Chinese documentation for examples#979
MaojiaSheng merged 2 commits intovolcengine:mainfrom
xingzihai:main

Conversation

@xingzihai
Copy link
Contributor

@xingzihai xingzihai commented Mar 25, 2026

Summary

This PR adds:

  1. A comprehensive basic usage example for developers to quickly get started with OpenViking Python SDK
  2. Chinese translations (README_CN.md) for example directories that were missing Chinese documentation

Changes

New: Basic Usage Example (examples/basic-usage/)

  • README.md: Comprehensive English documentation with code examples and use cases
  • README_CN.md: Chinese version of the documentation
  • basic_usage.py: Runnable Python script demonstrating core features:
    • Initialization (embedded mode and HTTP client mode)
    • Adding resources (URLs, files, directories)
    • Browsing the virtual filesystem (ls, tree, glob)
    • Semantic search and retrieval
    • Tiered context loading (L0/L1/L2)
    • Session management for memory

Chinese Translations Added

  • examples/claude-memory-plugin/README_CN.md - Claude Code memory plugin documentation
  • examples/k8s-helm/README_CN.md - Kubernetes Helm Chart deployment guide
  • examples/mcp-query/README_CN.md - MCP Server usage documentation

Motivation

The existing examples focus on integration with specific tools. This PR adds a beginner-friendly example demonstrating core Python SDK functionality.

Testing

cd examples/basic-usage && python basic_usage.py

感谢审核此贡献!

- Add README_CN.md for claude-memory-plugin
- Add README_CN.md for k8s-helm
- Add README_CN.md for mcp-query

These translations help Chinese users understand the example usage and configuration.
@CLAassistant
Copy link

CLAassistant commented Mar 25, 2026

CLA assistant check
All committers have signed the CLA.

- Add comprehensive README.md with code examples
- Add Chinese version README_CN.md
- Add basic_usage.py demonstrating core features:
  - Initialization (embedded mode and HTTP client mode)
  - Adding resources (URLs, files, directories)
  - Browsing the virtual filesystem
  - Semantic search and retrieval
  - Tiered context loading (L0/L1/L2)
  - Session management for memory

This example helps developers quickly get started with OpenViking.
@xingzihai xingzihai changed the title docs: Add Chinese documentation for example READMEs docs: Add basic usage example and Chinese documentation for examples Mar 26, 2026
@MaojiaSheng MaojiaSheng merged commit 2cc3761 into volcengine:main Mar 26, 2026
2 checks passed
@github-project-automation github-project-automation bot moved this from Backlog to Done in OpenViking project Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants