中文
重点修复：资源 write
修正资源 write 与父目录刷新的衔接：同一目录下的文件分别完成自身摘要和索引，目录刷新只合并目录工作，避免替代尚未完成的文件索引。文件自身处理完成后即可释放文件锁，父目录摘要独立刷新。#7383
例如更新 viking://resources/docs/a.md：wait=true 等待 a.md 的摘要和索引完成；docs 的 L0/L1 与目录索引随后独立刷新，不属于这次 write 的等待范围。请求参数不变。
相关修复与改进
- 目录摘要：待刷新期间复用已有文件摘要；恢复
semantic.overview_sample_limit默认 32 项的稳定采样，文件自身仍完整建立索引。#7380、#7387 - 存储稳定性：修复
stat按记录 ID 查询的兼容性、向量 Collection 生命周期，以及多写元数据不完整时的启动问题。#7377、#7355、#7381 - Connector 与流式响应：支持带作用域的 OAuth 引用，原生导入保留 Connector Watch；修复 Gateway 流式错误的结束标记。#7259、#7364、#7010
本版从最新 main 发布，同时包含多写 backup 动态切换、账户管理的 global 系统 Skill 目录、火山引擎浏览器授权配置，以及 Console、FileBrowser、Wiki 和 Agent 体验界面更新。详见完整变更。
升级说明
pip install --upgrade 'openviking==0.5.4.1'- 目录
stat/ls的count现在只统计可见的 L2 记录，不再把 L0/L1 摘要记录计入。#7264 - OIDC 的非法账户或用户标识会被拒绝，不再通过字符替换映射为其他身份。#7116
- 本次只发布主包
openviking；独立 Python SDK、CLI 和 React 包保持各自的发布版本。源码集成 React 模块的项目需关注本范围内标记为 breaking 的组件接口变更。
English
Main fix: resource write
Correct the coordination between resource write and parent-directory refresh. Files in the same directory retain their own summary and indexing work; directory refreshes coalesce only directory work and cannot supersede pending file indexing. The file lock is released once the file's own processing completes, while parent summaries refresh independently. #7383
For example, when updating viking://resources/docs/a.md, wait=true waits for the summaries and index of a.md. The L0/L1 summaries and index of docs refresh separately and are outside that write's wait scope. Request parameters are unchanged.
Related fixes and improvements
- Directory summaries: Reuse existing file summaries during pending refreshes and restore stable sampling through
semantic.overview_sample_limit, with a default of 32 entries. Each file still receives its own index. #7380, #7387 - Storage stability: Fix
statcompatibility for record IDs, vector Collection lifecycle handling, and startup with incomplete multiwrite metadata. #7377, #7355, #7381 - Connectors and streaming: Support scoped OAuth references, retain Connector Watches on native imports, and preserve Gateway stream error terminators. #7259, #7364, #7010
This release is built from the latest main and also includes dynamic multiwrite backup switching, account-managed global system Skill directories, VolcEngine browser authorization setup, and updates to Console, FileBrowser, Wiki and Agent interfaces. See the full changelog.
Upgrade notes
Use pip install --upgrade 'openviking==0.5.4.1'.
- Directory
countinstat/lsnow counts visible L2 records only, excluding L0/L1 summary records. #7264 - Invalid OIDC account or user identifiers are rejected instead of being mapped to another identity through character replacement. #7116
- This publishes the main
openvikingpackage only. Standalone Python SDK, CLI and React packages retain their independent release versions. Source integrations of the React modules should review the component API changes marked as breaking in this range.
首次贡献者 / New contributors
感谢 / Thanks to zhouliangyi-dance (#7274), zuoanCo (#6905), and AtaraxiaZ (#7077).