v0.2.9

What's Changed

• fix(resource): enforce agent-level watch task isolation by @lyfmt in #762
• feat(embedder): use summary for file embedding in semantic pipeline by @yangxinxin-7 in #765
• Fix/bot readme by @chenjw in #774
• Fix/increment update dir vector store by @myysy in #773
• fix(plugin): restore bug fixes from #681 and #688 lost during #662 merge by @qin-ctx in #779
• docs: add docker compose instructions and mac port forwarding tip to … by @fengluodb in #781
• Update docs by @zhoujh01 in #782
• feat(ci): add comprehensive Qodo PR-Agent review rules by @chethanuk in #780
• feat:Add mode config, add debug mode, add /remember cmd by @yeshion23333 in #757
• fix(vectordb): share single adapter across account backends to prevent RocksDB lock contention by @ahmedhesham6 in #777

New Contributors

• @fengluodb made their first contribution in #781
• @ahmedhesham6 made their first contribution in #777

Full Changelog: v0.2.8...v0.2.9

v0.2.8

OpenViking v0.2.8 发布公告

OpenViking v0.2.8 现已发布。

这是一次围绕 上下文工程能力、插件生态、检索与记忆链路、可观测性以及工程兼容性 持续增强的版本更新。
整体来看，v0.2.8 以功能补强和稳定性修复为主，适合现有用户升级；如果你在使用 OpenClaw / OpenCode 插件、长会话记忆、资源同步或自定义模型接入，本次更新尤其值得关注。

本次更新亮点

1. 插件生态继续升级，OpenClaw / OpenCode 集成更完整

• openclaw-plugin 升级到 2.0，从 memory plugin 进一步演进为 context engine。
  • 相关 PR：#662
• 新增并完善 OpenCode memory plugin example，补充 attribution 与后续插件更新。
  • 相关 PR：#569、#588、#678
• 支持 多智能体 memory isolation，可基于 hook context 中的 agentId 做记忆隔离。
  • 相关 PR：#637
• 修复插件自动 recall 可能导致 agent 长时间挂起的问题，并补强 legacy commit 兼容。
  • 相关 PR：#688、#697
• MCP 查询服务补充 api_key 支持与默认配置能力，降低接入成本。
  • 相关 PR：#691、#611

2. Session / Memory 链路增强，长期记忆能力更稳

• 新增 memory cold-storage archival，通过 hotness scoring 管理长期记忆冷热分层。
  • 相关 PR：#620
• 新增长记忆 chunked vectorization，改善超长内容的向量化处理能力。
  • 相关 PR：#734
• 增加 used() 接口，用于上下文 / skill 使用追踪。
  • 相关 PR：#684
• 修复 async commit 过程中的上下文透传、批次内重复写入、非标准 LLM 响应处理等问题。
  • 相关 PR：#610、#618、#701
• Bot 场景下改用 commit_async()，减少阻塞风险，提升长会话稳定性。
  • 相关 PR：#728、#733

3. 检索与 Embedding 能力持续增强

• 分层检索中正式集成 rerank，并修复无 rerank 场景下的检索可用性问题。
  • 相关 PR：#599、#754
• 新增 RetrievalObserver，可用于检索质量指标观测，并已接入 ov observer。
  • 相关 PR：#622、#623
• Embedding 侧新增：
  • Ollama 本地 embedding provider 支持（#644）
  • Voyage dense embedding 支持（#635）
  • OpenAI-compatible provider 的 extra HTTP headers 支持（#694）
  • query / document 非对称 embedding 支持（#608、#702）
  • OpenAI embedder 的 key=value 参数解析能力（#711）
• 修复 CJK token 估算偏低等问题，提升多语言场景下的稳定性。
  • 相关 PR：#661、#658

4. 资源、存储与解析链路更完善

• 新增 resource watch scheduling 与状态跟踪能力，资源同步流程更可控。
  • 相关 PR：#709
• 新增 reindex endpoint，支持内容手动修改后的重新 embedding。
  • 相关 PR：#631
• 解析能力新增对 legacy .doc / .xls 格式的支持。
  • 相关 PR：#652
• 修复从 URL 导入文件时文件名与扩展名丢失的问题。
  • 相关 PR：#619
• 存储层新增 path locking 与选择性 crash recovery，进一步提升写入安全性。
  • 相关 PR：#431
• 修复 tenant API 的隐式 root fallback、文件系统接口路径处理、工作目录 ~ 展开等问题。
  • 相关 PR：#716、#647、#725

5. VLM、Trace 与可观测性能力加强

• 新增 request-level trace metrics 与对应 API 支持。
  • 相关 PR：#640
• 新增 memory extract telemetry breakdown，帮助更细粒度地分析记忆提取过程。
  • 相关 PR：#735
• OpenAI VLM 支持 streaming response handling。
  • 相关 PR：#756
• 补充 max_tokens 参数以避免 vLLM 拒绝请求，并支持 OpenAI-compatible VLM 的自定义 HTTP headers。
  • 相关 PR：#689、#723
• 自动清理模型输出中的 <think> 标签，减少推理内容污染存储结果。
  • 相关 PR：#690

6. 工程兼容性与交付体验继续改进

• 修复 Windows zip 路径、代码仓库索引、Rust CLI 版本等跨平台问题。
  • 相关 PR：#577
• agfs Makefile 完成跨平台兼容性重构。
  • 相关 PR：#571
• Vectordb engine 支持按 CPU variant 拆分。
  • 相关 PR：#656
• Docker 构建链路持续修复，补齐 build_support/ 拷贝逻辑。
  • 相关 PR：#699、#705
• Release workflow 支持发布 Python 3.14 wheels。
  • 相关 PR：#720

7. 文档与社区内容持续补强

• README、INSTALL、INSTALL-ZH 等文档持续更新。
  • 相关 PR：#581、#582、#663、#666、#692
• 新增 日文文档，进一步提升国际化支持。
  • 相关 PR：#755
• 补充 OpenClaw 插件升级说明与新链接修复。
  • 相关 PR：#758、#761
• 更新社区微信群二维码等资料，方便用户加入交流。
  • 相关 PR：#649

升级建议

• 如果你在使用 OpenClaw 旧版 memory plugin，建议重点阅读 2.0 升级说明后再升级。https://github.com/volcengine/OpenViking/blob/main/examples/openclaw-plugin/INSTALL-ZH.md
• 如果你依赖 OpenAI-compatible 模型网关 / 本地模型服务，建议关注本次新增的 headers、max_tokens、api_key 与 embedding 参数能力。
• 如果你在生产环境中使用 长会话记忆、资源自动同步或多智能体场景，建议升级后重点验证 memory commit、resource watch 和检索观测链路。

总结

v0.2.8 是一次面向真实智能体应用场景的持续演进版本。
这次更新重点集中在：

• 插件生态升级，OpenClaw / OpenCode 集成更成熟
• Session / Memory 长链路能力增强
• 检索、Embedding 与观测能力进一步完善
• 资源、解析、存储链路稳定性提升
• 跨平台、Docker、CI 与发布体验持续优化

欢迎大家升级体验，并继续反馈问题与建议。

致谢

感谢所有贡献者参与本次版本更新，也欢迎本版本中的多位新贡献者加入社区。
从累计变更来看，v0.2.6 -> v0.2.8 期间共有 20 位新贡献者 完成首次贡献。

Full Changelog

• v0.2.7...v0.2.8
  v0.2.7...v0.2.8

• v0.2.6...v0.2.8
  v0.2.6...v0.2.8

What's Changed

• docs: add MCP integration guide (EN + ZH) by @r266-tech in #518
• Add Trendshift badge to README by @qin-ctx in #536
• fix(session): propagate extractor failures to async task error by @dr3243636-ops in #511
• feat(openclaw-memory-plugin): add default log configuration by @qin-ctx in #541
• Add files via upload by @yuyaoyoyo-svg in #543
• Update install.sh by @qin-ptr in #545
• Revert "Update install.sh" by @qin-ptr in #547
• refactor(openclaw-memory-plugin): use openclaw CLI for plugin configuration by @qin-ctx in #550
• fix: correct Volcengine sparse/hybrid embedder and update sparse model docs by @yangxinxin-7 in #561
• feat: CLI sub-command optimization by @MaojiaSheng in #560
• fix(storage): reject traversal segments before VikingFS access checks by @lyfmt in #557
• feat(resource): implement incremental update with COW pattern by @myysy in #535
• build(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #556
• build(deps): bump docker/build-push-action from 6 to 7 by @dependabot[bot] in #555
• build(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #554
• build(deps): bump docker/metadata-action from 5 to 6 by @dependabot[bot] in #553
• feat(bot):Feishu channel mention, support PIC conversation, per-channel workspace, by @yeshion23333 in #567
• feat: add --sender parameter to chat commands by @chenjw in #562
• fix(Dockerfile): add rust ov by @zhoujh01 in #570
• Fix: change Role.ROOT to Role.USER, and mirror the HTTP server behavior (sessions.py:94-95) by calling initialize_user_directories() and initialize_agent_directories() at the start of create_session(). by @yangxinxin-7 in #572
• fix: use normalized path in ClassifiedFile for cross-platform consistency by @sponge225 in #574
• fix(session): remove redundant parameters from archive call by @myysy in #575
• feat:Add OpenCode memory plugin example by @LittleLory in #569
• Update README.md by @Soda-Wong in https://github.com/volcengine/OpenViking/pull...

v0.2.6

OpenViking v0.2.6 发布公告

OpenViking v0.2.6 已发布。

这是一次聚焦体验优化和稳定性增强的小版本更新。相比 v0.2.5，这一版不仅带来了更顺手的命令行交互和全新的 Console，也补齐了会话异步提交、后台任务跟踪、资源导入目录结构保留等关键能力，同时在 openclaw memory plugin、安装流程、跨平台兼容性和 CI 稳定性上做了大量修复与打磨。

重点更新

1. CLI 与对话体验进一步升级

• ov chat 现在基于 rustyline 提供更完整的行编辑体验，终端交互更自然，不再出现常见的方向键控制字符问题。
• 新增 Markdown 渲染能力，终端中的回答展示更清晰，代码块、列表等内容可读性更好。
• 支持聊天历史记录，同时提供关闭格式化和关闭历史记录的选项，便于在不同终端环境中按需使用。

2. 服务端异步能力增强，长任务不再轻易阻塞

• Session commit 新增异步提交能力，并支持通过 wait 参数控制是否同步等待结果。
• 当选择后台执行时，OpenViking 现在会返回可追踪的任务信息，调用方可以通过任务接口查询状态、结果或错误。
• 服务端新增可配置 worker count，进一步缓解单 worker 场景下长任务阻塞请求的问题。

这意味着在记忆提取、归档总结等耗时操作较多的场景下，服务端的可用性和可观测性都有明显提升。

3. 新增 Console，并持续增强 Bot 与资源操作能力

• 本版本新增独立的 OpenViking Console，提供更直观的 Web 控制台入口，方便调试、调用和查看接口结果。
• Bot 能力继续增强，新增 eval 能力，开放 add-resource 工具，并支持飞书进度通知等扩展能力。
• 资源导入支持 preserve_structure 选项，扫描目录时可以保留原始目录层级，适合更复杂的知识组织方式。
• 同时修复了 grep、glob、add-resource 等场景下的一些响应问题，提升日常使用稳定性。

4. openclaw memory plugin 能力和稳定性大幅完善

• openclaw memory plugin 在这一版中获得了较大幅度增强，补充了更完整的插件能力与相关示例。
• 插件安装链路进一步完善，现已支持通过 npm 包方式安装 setup-helper，部署和升级都更直接。
• 修复了本地运行、端口管理、配置保留、缺失文件下载、配置覆盖等一系列影响安装和使用体验的问题。
• Memory consolidation 与 skill tool memory 相关问题也得到修复，进一步提升记忆链路的稳定性。
• Vikingbot 作为 OpenViking 可选依赖的集成方式也做了完善，降低了插件和 bot 协同使用时的接入门槛。

对于希望将 OpenViking 与 memory / agent 工作流结合使用的开发者来说，这一版的可用性提升会比较明显。

5. 安装、跨平台与工程质量继续补强

• 新增 Linux ARM 支持，进一步扩展了 OpenViking 的部署平台范围。
• 修复了 Windows 下 UTF-8 BOM 配置文件的兼容问题，减少配置读取失败的情况。
• 修复了 install.sh、ov.conf.example、setup 失败退出等问题，并补充了 openclaw memory plugin 的 npm 包安装路径，提升首次安装和配置过程的成功率。
• CI 侧将 GitHub Actions runner 固定到明确 OS 版本，减少环境漂移带来的构建与发布不确定性。

总结

v0.2.6 是一个兼顾新能力与稳定性的版本。

如果你主要通过 CLI 或 Bot 使用 OpenViking，这一版会带来更顺手的交互体验；如果你在服务端接入中依赖会话提交、记忆提取和后台任务执行，这一版会带来更好的异步能力与可观测性；如果你在尝试 openclaw memory plugin 或跨平台部署，这一版也补上了不少过去容易踩坑的细节。

欢迎社区继续反馈使用体验、提交 Issue 和 PR，一起把 OpenViking 打磨得更稳、更好用。

New Contributors

• @markwhen 首次贡献于 #474
• @dr3243636-ops 首次贡献于 #472
• @ctudoudou 首次贡献于 #487
• @lixingjia77 首次贡献于 #494

感谢所有参与 v0.2.6 开发、修复、文档和工程改进的贡献者。

Full Changelog

v0.2.5...v0.2.6

What's Changed

• feat: improve ov chat UX with rustyline and markdown rendering by @chenjw in #466
• fix: grep for binding-client by @markwhen in #474
• feat(server): add configurable worker count to prevent single-worker blocking by @r266-tech in #470
• feat(sessions): add async commit support with wait parameter by @dr3243636-ops in #472
• [feat]: openclaw-memory-plugin: 新增插件功能 by @qin-ptr in #479
• fix: openclaw plugin local run by @qin-ptr in #480
• feat: support linux arm by @zhoujh01 in #482
• fix: fix ov.conf.example by @zhoujh01 in #488
• fix vikingbot grep/glob/add_resource get response issue by @typeck in #491
• docs: translate VLM providers section in README to English by @ctudoudou in #487
• refactor: remove agfs port configuration by @qin-ctx in #483
• fix: add-resource --to and --parent by @MaojiaSheng in #475
• fix: fix err log by @zhoujh01 in #495
• fix: remve emtpy merge by @zhoujh01 in #496
• fix(search): use session summaries in search and cap intent summary l… by @lixingjia77 in #494
• fix: improve file type detection and C/C++ AST extraction by @yangxinxin-7 in #497
• Revert "refactor: remove agfs port configuration" by @Soda-Wong in #498
• Fix/bot Fix Memory Consolidation Issues and Integrate Vikingbot as OpenViking Optional Dependency by @chenjw in #492
• fix(config): handle UTF-8 BOM in config files on Windows (#499) by @r266-tech in #500
• fix #477 by @chenjw in #503
• fix(setup): quit setup when fail by @zhoujh01 in #504
• feat(tasks): add async task tracking API for background operations by @dr3243636-ops in #476
• fix(openclaw-memory-plugin): improve port management and preserve existing config by @qin-ctx in #513
• docs: OpenViking Skills for search, add, operate by @MaojiaSheng in #510
• fix(openclaw-memory-plugin): add missing files and merge config instead of overwriting by @qin-ctx in #516
• fix install.sh by @qin-ptr in #517
• feat: Add console by @zhoujh01 in #383
• feat(bot):Add eval function(support locomo, skillsbench), open add-resource tool, add feishu progress notification capability by @yeshion23333 in #506
• Fix/skill tool memory by @BytedanceFu in #514
• feat(resource): add preserve_structure option for directory scanning by @r266-tech in #509
• ci: pin GitHub Actions runners to explicit OS versions by @zhoujh01 in #508
• feat(setup-helper): 用 install.js 替换 cli.js，发布为 npm 包 by @LinQiang391 in #524

New Contributors

• @markwhen made their first contribution in #474
• @dr3243636-ops made their first contribution in #472
• @ctudoudou made their first contribution in #487
• @lixingjia77 made their first contribution in #494

Full Changelog: v0.2.5...v0.2.6

v0.2.5

What's Changed

• docs: use openviking-server to launch server by @MaojiaSheng in #398
• fix: Session.add_message() support parts parameter by @qin-ctx in #399
• feat: support GitHub tree/ URL for code repository import by @yangxinxin-7 in #400
• fix: improve ISO datetime parsing by @zztdandan in #404
• feat(pdf): extract bookmarks as markdown headings for hierarchical parsing by @r266-tech in #403
• feat: add index control to add_resource and refactor embedding logic by @Jay-ju in #401
• fix: support short-format URIs in VikingURI and VikingFS access control by @r266-tech in #402
• fix: handle None data in skill_processor._parse_skill() by @r266-tech in #405
• fix: fix add-resource by @zhoujh01 in #409
• fix: treat only .zip as archive; avoid unzipping ZIP-based container … by @sponge225 in #410
• fix(cli): support git@ SSH URL format in add-resource by @myysy in #411
• feat(pdf): add font-based heading detection and refactor PDF/Markdown parsing by @qin-ctx in #413
• 支持通过curl方式安装部署openclaw+openviking插件 by @LinQiang391 in #415
• Feature/vikingbot_opt： OpenAPI interface standardization；Feishu multi-user experience; observability enhancements; configuration system modernization. by @chenjw in #419
• docs: pip upgrade suggestion by @MaojiaSheng in #418
• feat: define a system path for future deployment by @MaojiaSheng in #423
• chore: downgrade golang version limit, update vlm version to seed 2.0 by @MaojiaSheng in #425
• [fix]: 修复通过curl命令安装场下下ubuntu/debian等系统触发系统保护无法安装的openviking的问题 by @LinQiang391 in #426
• fix(session): trigger semantic indexing for parent directory after memory extraction by @qin-ctx in #429
• feat(bot):Refactoring, New Evaluation Module, Feishu channel Opt & Feature Enhancements by @yeshion23333 in #428
• chore: agfs-client默认切到binding-client模式 by @chuanbao666 in #430
• feat(agfs): add ripgrep-based grep acceleration and fix vimgrep line parser by @yangxinxin-7 in #432
• [WIP] ci: add automated PR review workflow using Doubao model by @qin-ctx in #434
• fix(ci): use OPENAI_KEY instead of OPENAI.KEY in pr-review workflow by @qin-ctx in #435
• build(deps): bump actions/download-artifact from 7 to 8 by @dependabot[bot] in #442
• build(deps): bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #441
• build(deps): bump docker/login-action from 3 to 4 by @dependabot[bot] in #440
• build(deps): bump docker/setup-qemu-action from 3 to 4 by @dependabot[bot] in #438
• build(deps): bump docker/setup-buildx-action from 3 to 4 by @dependabot[bot] in #439
• fix(packaging): sdist 排除运行时二进制 by @zhoujh01 in #447
• ci: enhance PR review with severity classification and checklist by @qin-ctx in #437
• enable injection for Collection and CollectionAdaptor by @zhougit86 in #414
• chore: 编译子命令失败报错, golang版本最低要求1.22+ by @chuanbao666 in #444
• feat(viking_fs) support async grep by @typeck in #448
• OpenViking Plugin Exception Handling & Fixing by @wlff123 in #449
• feat(agfs): make binding client optional, add server bootstrap, tune logging and CI by @qin-ctx in #451
• fix: rust compile in uv pip install -e . by @MaojiaSheng in #452
• [wip]Enhance OpenViking Status Checks in the OpenClaw Plugin by @wlff123 in #453
• FIX: fixes multiple issues in the OpenViking chat functionality and unifies session ID generation logic between Python and Rust CLI implementations. by @chenjw in #446
• chore: 增加Makefile,方便build by @chuanbao666 in #450
• fix(bot): fix Telegram channel init crash and empty content for Claude by @ponsde in #421
• fix: suport uv pip install openviking[bot] by @chenjw in #457
• fix: agfs-client默认使用http-client by @chuanbao666 in #459
• fix(agfs): fix agfs binding-client import error by @chuanbao666 in #458
• openclaw-memory-plugin: ov.conf backend/agfs, default embedding 25121… by @LinQiang391 in #460
• vikingbot version to 3.10 by @chenjw in #461
• update vikingbot version to 0.1.3 by @chenjw in #462
• fix: github zip download timeout by @MaojiaSheng in #463

New Contributors

• @zztdandan made their first contribution in #404
• @Jay-ju made their first contribution in #401
• @sponge225 made their first contribution in #410
• @zhougit86 made their first contribution in #414
• @typeck made their first contribution in #448

Full Changelog: v0.2.3...v0.2.5

v0.2.3

Breaking Change

After upgrading, datasets/indexes generated by historical versions are not compatible with the new version and cannot be reused directly. Please rebuild the datasets after upgrading (a full rebuild is recommended) to avoid retrieval anomalies, inconsistent filtering results, or runtime errors.
Stop the service -> rm -rf ./your-openviking-workspace -> restart the service with the openviking-server command.

What's Changed

• Feat: CLI optimization by @MaojiaSheng in #389
• Update README.md by @Soda-Wong in #392
• Update README_CN.md by @Soda-Wong in #391
• feat: support glob -n and cmd echo by @MaojiaSheng in #395
• fix: fix release by @zhoujh01 in #396

New Contributors

• @Soda-Wong made their first contribution in #392

Full Changelog: v0.2.2...v0.2.3

v0.2.2

Breaking Change

Warning: This Release includes Breaking Chage! Before upgrading, you should stop VikingDB Server and clear workspace dir first.

What's Changed

• fix ci by @zhoujh01 in #363
• 在readme补充千问使用方法 by @BytedanceFu in #364
• feat(parse): Add C# AST extractor support by @suraciii in #366
• chore: bump CLI version to 0.2.1 by @ZaynJarvis in #370
• fix: normalize OpenViking memory target paths by @wlff123 in #373
• fix: fix filter when multi tenants by @zhoujh01 in #374
• docs/update_wechat by @qin-ctx in #377
• Fix retriever by @zhoujh01 in #382
• fix(git): support git@ SSH URLs with regression-safe repo detection (#317) by @r266-tech in #385
• fix(agfs): 预编译agfs所依赖的lib/bin,无需安装时构建 by @chuanbao666 in #388

New Contributors

• @suraciii made their first contribution in #366
• @wlff123 made their first contribution in #373

Full Changelog: v0.2.1...v0.2.2

v0.2.1

This is a core feature preview release. Please note that performance and consistency have not been fully optimized, so use with caution.

Before you upgrade, please remove old ov.conf and old data directory, and then follow the new README.md to deploy!

1. Core Capability Upgrades: Multi-tenancy, Cloud-Native & OpenClaw/OpenCode Adaptation

• Multi-tenancy: Implemented foundational multi-tenancy support at the API layer (#260, #283), laying the groundwork for isolated usage across multiple users/teams.
• Cloud-Native Support: Added support for cloud-native VikingDB (#279), improved cloud deployment documentation and Docker CI workflows (#320), expanding from local deployment to cloud-edge integration.
• OpenClaw Integration: Added official installation for the openclaw-openviking-plugin (#307), strengthening integration with OpenClaw.
• OpenCode Support: Introduced the opencode plugin and updated documentation (#351), extending capabilities for code-related scenarios.

2. Deep Optimization of the Database Storage Foundation

• Architecture Refactor: Refactored the vector database interface (#327) and removed the with_vector parameter from query APIs (#338) to simplify the interface design.
• Performance Optimizations:
  • Integrated KRL to optimize vector search on ARM Kunpeng architectures (#256).
  • Enabled AVX2 by default and disabled AVX512 for x86 builds (#291), balancing compatibility and performance.
• BugFixes: Resolved missing Volcengine URI prefixes for VikingDB, invalidated is_leaf filters (#294), and fixed vector storage lock contention during fast restarts (#343).
• AGFS Enhancements: Added AGFS binding client (#304), fixed AGFS SDK installation/import issues (#337, #355), and improved filesystem integration.
• Code Scenario Improvements: Added AST-based code skeleton extraction mode (#334), supported private GitLab domains for code repositories (#285), and optimized GitHub ZIP download (#267).

3. Improved CLI Toolchain (Greatly Enhanced Usability)

Numerous UX improvements for the ov CLI to lower barriers to usage:

• Added ov command wrapper (#325) and fixed bugs in the CLI wrapper, repo URI handling, and find command (#336, #339, #347).
• Enhanced add-resource functionality with unit tests (#323) and added ZIP upload support for skills via the add_skill API (#312).
• Configuration Extensions: Added timeout support in ovcli.conf (#308) and fixed agent_id issues in the Rust CLI (#308).
• Version Support: Added the --version flag to openviking-server (#358) for easy version validation.

What's Changed

• docs : update wechat by @qin-ctx in #264
• feat: 多租户 Phase 1 - API 层多租户能力 by @qin-ctx in #260
• 增加openviking/eval模块，用于评估测试 by @chuanbao666 in #265
• feat(vectordb): integrate KRL for ARM Kunpeng vector search optimization by @Mijamind719 in #256
• feat: concurrent embedding, GitHub ZIP download, read offset/limit by @yangxinxin-7 in #267
• fix: claude code memory-plugin example:add_message改为写入TextPart列表，避免session解析异常 by @Mijamind719 in #268
• Feat/add parts support to http api by @SeanZ in #270
• tests(parsers): add unit tests for office extensions within add_resou… by @shaoeric in #273
• feat: break change, remove is_leaf scalar and use level instead by @MaojiaSheng in #271
• fix(api): complete parts support in SDK layers and simplify error handling by @SeanZ in #275
• feat: support cloud vikingDB by @baojun-zhang in #279
• Fix image_summary bug by @BytedanceFu in #277
• feat(config): expose embedding.max_concurrent and vlm.max_concurrent … by @yangxinxin-7 in #282
• Multi tenant by @kkkwjx07 in #283
• feat: allow private gitlab domain for code repo by @MaojiaSheng in #285
• fix(storage): idempotent rm/mv operations with vector index sync by @SeanZ in #284
• refactor(filter): replace prefix operator with must by @kkkwjx07 in #292
• fix: VikingDB volcengine URI prefix loss and stale is_leaf filter by @qin-ctx in #294
• fix(vectordb): default x86 build to AVX2 and disable AVX512 by @kkkwjx07 in #291
• 对齐 docs 和代码里 storage config 的 workspace 属性 by @myysy in #289
• fix: correct storage.update() call signature in _update_active_counts() by @ponsde in #280
• feat(memory): add hotness scoring for cold/hot memory lifecycle (#296) by @r266-tech in #297
• feat(client): ovcli.conf 支持 timeout 配置 + 修复 Rust CLI agent_id by @qin-ctx in #308
• fix(server): 未配置 root_api_key 时仅允许 localhost 绑定 by @qin-ctx in #310
• fix: resolve Gemini 404, directory collision, and Unicode decoding er… by @honjiaxuan in #314
• feat(skill): support zip upload for add_skill API by @SeanZ in #312
• feat(agfs): agfs新增binding client by @chuanbao666 in #304
• fix(parser): remove redundant mkdir in DirectoryParser by @honjiaxuan in #318
• fix: use original directory name for temp URI lookup in TreeBuilder by @ponsde in #319
• fix: handle is_healthy() AttributeError when not initialized (closes #298) by @r266-tech in #322
• feat(docs,ci): 完善云上部署文档与 Docker CI 流程 by @qin-ctx in #320
• fix(agfs): import AGFSBindingClient error不阻塞http client使用 by @chuanbao666 in #324
• feat: Enhance add-resource functionality in cli and add unit tests by @shaoeric in #323
• feat: expose session(must_exist) and session_exists() on public API by @ponsde in #321
• feat: wrapper ov command by @MaojiaSheng in #325
• Feat/vectordb interface refactor by @kkkwjx07 in #327
• build(deps): bump docker/build-push-action from 5 to 6 by @dependabot[bot] in #313
• docs: add storage configuration guide by @baojun-zhang in #329
• fix: 修复单测以适配 vectordb 接口重构，统一测试数据路径 by @qin-ctx in #333
• feat(parse): add AST-based code skeleton extraction mode by @yangxinxin-7 in #334
• 添加openclaw-openviking-plugin插件安装方式 by @LinQiang391 in #307
• fix: bugfix ov cli wrapper by @MaojiaSheng in #336
• refactor: remove with_vector from query APIs by @kkkwjx07 in #338
• fix: ov cmd and repo uri by @MaojiaSheng in #339
• fix(agfs): 修复agfs binding-client安装问题, 清理agfs lib文件 by @chuanbao666 in #337
• feat/vikingbot: viking bot mvp based on openviking by @yeshion23333 in #335
• docs: add uv prerequisites to bot readme by @Tsan1024 in #341
• fix(storage): 修复快速重启时向量存储锁竞争问题 by @qin-ctx in #343
• fix: fix cli find by @kkkwjx07 in #347
• (Bug fix) to tool memory merge by @BytedanceFu in #346
• Fix/reminderbug 修复定时任务的bug by @chenjw in #349
• Update Python version requirement to 3.10 by @qppq54s in #348
• Validate ovpack ZIP member paths during import and add tests to reject unsafe entries by @13ernkastel in #344
• fix(client): 修复单文件在远程server部署时上传失败问题 by @qin-ctx in #352
• fix(test): 修复测试稳定性问题，清理废弃代码 by @qin-ctx in #353
• fix(agfs): agfs sdk默认从本地安装 by @chuanbao666 in #355
• eat(opencode): add opencode plugin and update docs by @yangxinxin-7 in #351
• docs: 修复 openviking serve 命令引用并更新贡献文档 by @qin-ctx in #357
• feat: update README.md by @MaojiaSheng in #356
• fix: 为 openviking-server 添加 --version 并修复 AGFS 模式判断 by @qin-ctx in #358
• chore: remove unsupported examples by @MaojiaSheng in #359
• fix: tag by @qin-ctx in #361

New Contributors

• @yangxinxin-7 made their first contribution in https://github.c...

CLI v0.2.0

OpenViking CLI v0.2.0

Installation

Quick Install (macOS/Linux)

curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/refs/tags/cli@0.2.0/crates/ov_cli/install.sh | bash

Manual Installation

Download the appropriate binary for your platform below, extract it, and add it to your PATH.

The CLI command is simply ov:

# After extraction
chmod +x ov  # Unix only
mv ov /usr/local/bin/  # or any directory in your PATH

# Verify installation
ov --version

Checksums

SHA256 checksums are provided for each binary for verification.

Changes

See the commit history for details.

v0.1.18

What's Changed

• feat: add Rust CLI implementation [very fast] by @ZaynJarvis in #162
• feat: make -o and --json global param by @ZaynJarvis in #172
• feat: provide a test_ov.sh scripts as reference by @ZaynJarvis in #173
• fix: short markdown parse filename by @MaojiaSheng in #176
• Update 03-quickstart-server.md-en version by @yuyaoyoyo-svg in #177
• feat: add markitdown-inspired file parsers (Word, PowerPoint, Excel, EPub, ZIP) by @ZaynJarvis in #128
• feat: rename for consistency by @ZaynJarvis in #179
• 上传最新的微信群二维码 by @yuyaoyoyo-svg in #183
• Update 03-quickstart-server.md by @yuyaoyoyo-svg in #174
• Update 01-about-us.md-微信群二维码地址更新 by @yuyaoyoyo-svg in #184
• fix: build target name by @ZaynJarvis in #181
• fix: fix handle github url right by @fatelei in #180
• Update README_CN.md-新增云端部署跳转链接与说明 by @yuyaoyoyo-svg in #186
• Update README.md-新增英文版readme云端部署内容 by @yuyaoyoyo-svg in #187
• Update 01-about-us.md-英文版微信群二维码更新 by @yuyaoyoyo-svg in #185
• fix: fix the difference of python CLI and rust CLI by @MaojiaSheng in #188
• Feat/support multi providers ， OpenViking支持多providers by @BytedanceFu in #192
• Fix: 修复 rust CLI 命令中与 python CLI ls/tree 命令不一致的部分；add node limit arg by @MaojiaSheng in #193
• feat: add_memory cli with ov-memory SKILL by @ZaynJarvis in #195
• feat: add directory parsing support to OpenViking by @shaoeric in #194
• fix: auto-rename on duplicate filename conflict by @DevEverything01 in #197
• fix: guard against None candidate in search_by_id by @DevEverything01 in #198
• fix bugs 修复provider为openai，但api_key并不是https://api.openai.com/v1而引起的大模型调用失败情况 by @BytedanceFu in #200
• Update open_viking_config.py by @qin-ptr in #206
• fix(parser): hash & shorten filenames that exceed filesystem limit by @DevEverything01 in #205
• test: add comprehensive edge case tests by @aeromomo in #208
• fix: invalid Go version format in agfs-server go.mod by @aeromomo in #207
• fix: add input validation to search_by_id method by @aeromomo in #209
• fix: improve binary content detection and null byte handling by @aeromomo in #210
• suggestion: align grep and glob options by @ZaynJarvis in #217
• suggestion: fix empty in --simple ls response by @ZaynJarvis in #220
• feat: support basic ov tui for fs navigator, boost version 0.2.0 by @ZaynJarvis in #213
• build(deps): bump actions/download-artifact from 4 to 7 by @dependabot[bot] in #221
• build(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #222
• build(deps): bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in #223
• refactor(memory): redesign extraction/dedup flow and add conflict-a… by @kkkwjx07 in #225
• fix: target directories retrieve by @mildred522 in #227
• fix: skill search ranking - use overview for embedding and fix visited set filtering by @ZaynJarvis in #228
• fix: use frontmatter description for skill vectorization instead of overview by @ZaynJarvis in #229
• build(deps): bump actions/cache from 4 to 5 by @dependabot[bot] in #224
• feat: update media parsers by @MaojiaSheng in #196
• fix: update memory by @kkkwjx07 in #231
• fix: resolve -o option conflict between global output and filesystem output-format by @haosenwang1018 in #240
• feat: add memory, resource and search skills by @ZaynJarvis in #214
• fix(memex): add Feishu OAuth support, fix async deadlock, and adapt for local dev by @A11en0 in #237
• feat(examples): simplify k8s Helm chart to MVP by @ZaynJarvis in #234
• fix: convert Session.load() and get_context_for_search() to async to prevent deadlock by @haosenwang1018 in #235
• feat: add Jina AI embedding provider by @hanxiao in #245
• feat(docker): init by @simonsmh in #238
• feat(examples): add Claude memory plugin example for OpenViking by @Mijamind719 in #246
• fix(fs): ls --simple skips abstract fetching and returns only URIs by @DevEverything01 in #236
• fix(tui): correct root scopes in filesystem tree by @ZaynJarvis in #250
• fix Invalid isoformat string on Windows due to high-precision timestamps by @kscale in #252
• feat: support dynamic project_name config in VectorDB / volcengine by @baojun-zhang in #253
• feat: support tos oss by @baojun-zhang in #255
• fix: When the AGFS backend is s3, the error "pyagfs.exceptions.AGFSClientError: parent directory does not exist" occurs. by @baojun-zhang in #254
• fix: handle >6-digit fractional seconds in ISO timestamps on Windows by @haosenwang1018 in #257
• fix: use reason as instruction fallback in resource processing by @haosenwang1018 in #258
• feat: openviking upload zip and extract on serverside, for add-resource a local dir by @MaojiaSheng in #249
• feat: wrap log configs in LogConfig, add log rotation by @MaojiaSheng in #261

New Contributors

• @yuyaoyoyo-svg made their first contribution in #177
• @fatelei made their first contribution in #180
• @BytedanceFu made their first contribution in #192
• @DevEverything01 made their first contribution in #197
• @qin-ptr made their first contribution in #206
• @aeromomo made their first contribution in #208
• @haosenwang1018 made their first contribution in #240
• @hanxiao made their first contribution in #245
• @simonsmh made their first contribution in #238
• @kscale made their first contribution in #252

Full Changelog: v0.1.17...v0.1.18

v0.1.17

What's Changed

• Revert "feat: support dynamic project_name config in VectorDB / volcengine" by @MaojiaSheng in #167
• Fix/ci clean workspace by @kkkwjx07 in #170
• fix: tree uri output error, and validate ov.conf before start by @MaojiaSheng in #169

Full Changelog: v0.1.16...v0.1.17