排查PCIe设备不认卡？手把手教你用Windbg/RWEverything读BAR和配置空间
2026/6/5 9:58:28
**注意：**OpenVking 0.3.22版本常用命令，由于目前工具更新版本速度导致不同版本命令可能差异较大，所以当前命令在不同版本中使用可能会不存在或者其他问题。
**简介：**OpenViking 是AI Agent 专用上下文向量数据库客户端工具，核心用途：给 AI 智能体做知识库、长期记忆管理、文档向量化存储、语义检索，类似私有化 RAG 知识库 CLI 管理工具，ov是它的主命令，下面按分类逐个解释用途。
一、初始化 & 配置类
config、health、status、language
| 命令 | 作用 |
|---|---|
| ov config | 配置核心： 配置向量库服务地址、API 密钥、模型接口、默认账户 / 用户，增删改配置项； config show查看当前生效配置，config validate校验配置是否合法、连通性， config switch多套配置一键切换（多环境：测试 / 生产库） |
| ov health | 连通性检测：检查本地 CLI 能不能连上远端 OpenViking 服务、向量引擎、模型服务是否正常 |
| ov status | 查看运行状态：库容量、索引数量、任务队列、资源占用、在线 Agent 信息 |
| ov language | 切换 CLI 输出语言（中文 / 英文等） |
二、核心RAG & 记忆流程
add-resource、find、read、write、add-memory（最常用）
整个 RAG 核心链路：导入文档→存向量→语义检索→读取内容→更新文档，AI 长期记忆单独入库
- ov add-resource：入库命令；把本地文件 / 文件夹 / 网页 URL/Git 仓库批量上传入库，自动切片、向量化、生成向量索引，存入知识库（RAG 数据源导入）。
- ov find【核心语义搜索】：自然语言语义检索，不匹配关键词，匹配语义，例如搜 “接口报错处理方案”，能召回内容相关文档，是 AI 问答召回上下文的核心命令。
- ov read：精准读取；根据资源 ID / 路径读取完整原文内容，find 查到摘要后，用 read 拉全文喂给 AI。
- ov write：修改已有入库资源：更新已经存到库里的文档内容、备注、标签。
- ov add-memory：AI 短期 / 长期记忆专用，直接录入文本作为 Agent 记忆，不和文件绑定，聊天历史、用户偏好直接存记忆库，AI 后续对话可自动检索过往记忆。
三、内置文件系统命令
ls、tree、mkdir、rm、mv、stat、get
OpenViking 内部把所有入库资源做成虚拟目录树结构，像 Linux 文件系统一样管理知识库目录：
- ov ls：列出当前虚拟目录下所有入库文件 / 文件夹
- ov tree：树形展开全目录知识库结构，直观查看资源层级
- ov mkdir：在知识库内新建虚拟文件夹，分类归档文档（如：产品文档、代码文档）
- ov rm：删除库内资源（文件 / 目录 / 记忆条目）
- ov mv：库内资源移动、重命名，调整目录分类
- ov stat：查看资源元数据：入库时间、切片数量、向量维度、文件大小、标签
- ov get：把库里的文档下载回本地磁盘
四、高级搜索 & 文档处理
search、grep、glob、abstract、overview
| 命令 | 说明 |
|---|---|
| ov search | 实验性增强检索：结合上下文 + 历史会话的智能检索，比 find 更贴合单次聊天场景 |
| ov grep | 关键词正则检索，传统文本模糊匹配（对标 linux grep，找精准关键词） |
| ov glob | 路径通配符搜索，glob *.md批量筛选库里所有 markdown 文档 |
| ov abstract | 自动生成单篇文档精简摘要，入库后一键总结内容 |
| ov overview | 批量生成目录 / 整组文档总概览，汇总一整个知识库的内容简介 |
五、备份导入导出
import、export、backup、restore、session、privacy
ov export（示例）
- export / import：知识库打包为.ovpack专用压缩包，跨环境迁移知识库（导出打包、另一台机器导入恢复）
- backup / restore：全库增量备份、故障数据恢复（底层数据库备份，区别于 ovpack 打包）
- ov session：会话管理，管理 AI 聊天会话数据，绑定会话专属上下文
- ov privacy：隐私管控，配置文档脱敏规则、访问权限、内容屏蔽策略
六、交互 & 运维管理
tui、chat、admin、system、reindex、link、relations
ov relations（示例）
- ov tui：终端可视化交互式界面，不用记命令，弹窗可视化浏览、检索、管理知识库（图形化终端面板）
- ov chat：内置 VikingBot，直接基于当前知识库对话，本地 RAG 问答测试
- ov admin：管理员权限，管理多用户、子账户、API 密钥分配、权限隔离（多团队共用知识库）
- ov system：底层系统运维：清理垃圾索引、磁盘整理、服务参数配置
- ov reindex：重建向量索引：修改大量文档后，刷新向量库、修复异常索引
- relations/link/unlink【实验】：资源关联，把 A 文档和 B 文档建立逻辑链接，检索 A 时自动关联召回 B，构建知识库知识图谱关联关系
七、任务 & 全局参数
ov task / ov wait：异步任务管理：大批量导入文档是后台异步任务，task查看任务进度，wait阻塞等待任务跑完
全局参数
-o json/table：输出格式切换，json 方便程序脚本调用，table 是人类阅读表格；
–sudo：管理员权限执行高危操作；
–account/–user/–agent-id：切换操作的账户 / AI 智能体，实现多 Agent 隔离知识库。
简单总结使用场景
- 个人 / 私有化 RAG：add-resource导入资料→find语义查资料→chat本地问答
- AI 智能体记忆：add-memory存聊天历史，Agent 自动调取过往记忆
- 知识库运维：目录分类管理、打包迁移、备份恢复、批量摘要
- 多用户部署：admin 开账号，分配独立知识库空间