Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
OpenViking 记忆
基于 OpenViking 服务端,为 DeepSeek Harness 提供长期记忆。DeepSeek Harness Desktop 和 dsh web 均可使用。
- 召回:每个带有你输入的步骤开始前,把相关记忆加入对话。
- 捕获:把你的消息和助手的回复发送到 OpenViking,并提交为记忆。
- 工具与技能:模型可以使用 OpenViking 工具(
mcp__openviking__search、read、remember、add_skill等),以及openviking-memory、openviking-skills、ov-experience-memory三个技能。 - URI 保护:文件工具指向
viking://路径时会被拦下,并提示改用对应的 OpenViking 工具;bash或pwsh命令里带viking://URI 时照常执行,只给模型附一条提示。
1. 连接服务端
写 ~/.openviking/ovcli.conf,填 url 和 api_key(trusted 模式的服务端还要填 account 和 user)。如果用的是 http://127.0.0.1:1933 上无鉴权的本地服务端,这步可以跳过。参见 部署指南 → CLI。
在 Desktop 里建议用 ovcli.conf 而不是环境变量。macOS 上 Desktop 只在启动时读取一次登录 shell 的环境变量;Windows 上使用用户环境变量。改动后需要彻底退出并重新打开 Desktop。
2. 安装
通过安装器(macOS):
curl -fsSL https://openviking.ai/install | bash
安装器需要 Node.js 18 或更高版本。它会找到 Desktop,作为 dsh-desktop harness 安装进去。运行前先打开一次 Desktop 让它创建 profile,安装期间用 ⌘Q 退出 Desktop:关闭窗口只是把它隐藏起来。
通过插件页面(手动;macOS、Windows 和 dsh web):插件 → 添加插件 → 输入 @openviking/dsh-memory-plugin → 安装,开关未打开时再打开。这一步只添加插件,不会询问 OpenViking 凭据,所以要先完成第 1 步。
通过 Desktop 自带的 dsh 命令(macOS):先打开一次 Desktop,用 ⌘Q 退出,再运行:
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add @openviking/dsh-memory-plugin
通过 npm 安装的 dsh 无法管理 desktop profile。用命令行安装后,重新打开 Desktop。
3. 验证
新开一个对话。顶部附近应能看到 OpenViking 上下文块,模型的工具列表里应有 mcp__openviking__*。问一件之前对话里的事,确认召回生效。
在终端里检查安装结果(需先退出 Desktop):
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop ls
注意事项
- 没有设置页面。 通过
ovcli.conf或OPENVIKING_*环境变量配置插件。行为参数也可以写进~/.dsh/profiles/desktop/cordis.patch.yml的openviking-memory-runtime条目。恢复对话框里的“禁用第三方插件、备份 profile patch 并重启”会重置 profile 的插件,并把这个文件挪作备份,所以长期设置请放在ovcli.conf,恢复后记得重新启用插件。 - 工具身份。 自动召回和捕获按每个对话所在的项目区分。OpenViking 工具每个 profile 只启动一次,工作目录是 profile 目录,所以在
OPENVIKING_RECALL_PEER_SCOPE=actor下它们没有项目 peer。需要时在ovcli.conf里设置actor_peer_id,或设置OPENVIKING_PEER_ID。这个 peer 也会取代每个对话的项目 peer 用于召回和捕获,因此所有对话共用它。 - 技能。 内置技能只对预设里带技能工具的 agent 可见。
minimal预设不带,用它的 agent 看不到这些技能。 - 日志。 Desktop 不显示插件输出。要排查 OpenViking 工具,设置
OPENVIKING_DEBUG=1和OPENVIKING_DEBUG_LOG=<文件>,然后重新打开 Desktop。
卸载
插件 → OpenViking 记忆 → 卸载。或者在退出 Desktop 后运行:
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop rm @openviking/dsh-memory-plugin
完整文档:DeepSeek Harness 集成 和 插件 README。