用 OpenViking 统一 Agent 的记忆、知识与技能：上下文数据库接入实操

过去要做完整的长周期 Agent，通常要拼三样东西：一套向量库加自研逻辑做记忆、一套 RAG 管线做知识检索、一套提示词或工具注册表做技能。三套系统各有各的存储、更新与召回逻辑，彼此不通。

OpenViking 的思路是把三者收敛到一个「上下文数据库」里，并提供统一的写入、检索与召回接口。从仓库结构可以看到它包含 Python 主包、Rust 实现的检索与缓存组件、Go / TypeScript / Python 三语言 SDK、LangChain 集成、Agent 插件、Web 可视化界面，以及 Docker 与 Helm 两种部署方式。

项目提供安装脚本、Docker 与 Helm（K8s）三种落地方式。安装脚本支持交互式向导，也支持指定分发来源（例如在 GitHub 访问受限时改用对象存储分发）：

# ① 安装脚本（交互式向导，按提示走即可）
curl -fsSL <install.sh 地址> | bash

# ② 指定分发来源与来源类型（示意，参数名以官方文档为准）
#    --dist github|tos        选择分发渠道
#    --source remote|archive|dev  选择获取方式
bash install.sh --dist github --source remote

# ③ Docker 部署（仓库含 Dockerfile 与 docker/ 目录）
docker build -t openviking:local .
docker run -d --name openviking -p 8080:8080 \
  -e OPENVIKING_URL=http://127.0.0.1:8080 \
  openviking:local

# ④ K8s：deploy/helm/ 下为 Helm chart，含 PVC 与 ServiceAccount
helm install openviking ./deploy/helm

一个容易被忽略但影响很大的设计：记忆的归属通过 peer 概念管理。默认情况下 peer 从 git 派生，也就是说同一个 git 仓库的会话共享一份记忆空间，不同仓库各自独立。

# 常见配置位置
~/.openviking/ovcli.conf          # CLI 配置（含 plugin 段与 peerSource）
.openviking/config.json           # 工作区配置（团队共享，可入库）
.openviking/config.local.json     # 私有配置（不入库）
~/.openviking/workspaces/         # 机器级工作区注册表
ov.conf / ov.conf.example         # 服务端配置

# 关键环境变量
OPENVIKING_URL=...          # 服务地址
OPENVIKING_API_KEY=...      # 访问密钥
OPENVIKING_PEER_SOURCE=...  # peer 派生来源
OPENVIKING_PEER_ID=...      # 指定 peer

peer 来源可选 git（默认）、cwd、none 或自定义模板。默认链路会优先使用 git 远端地址，再退到仓库根路径。

核心接口围绕「写入上下文」与「按需召回」展开。从公开的 SDK 与接口信息可以看到这几类方法：

# Python SDK 形态（方法名来自公开接口信息，具体签名以官方文档为准）
from openviking import Client

cli = Client(url=os.environ["OPENVIKING_URL"], api_key=os.environ["OPENVIKING_API_KEY"])

# 写入：把本次会话的结论沉淀成记忆
cli.write(
    content="用户偏好：报告类输出用中文，金额保留两位小数，引用必须带来源。",
    tags=["preference", "report"],
)

# 检索：按 token 预算召回，避免撑爆上下文
ctx = cli.search(
    query="生成周报时要注意什么？",
    max_tokens=2000,
    dedup_turns=5,
)

除了记忆与知识，OpenViking 还把「技能」作为一等公民：CLI 提供添加技能的命令，支持从 Git 仓库发现、选择与上传技能，也支持把技能打包分发给团队。

# 添加技能（命令形态以官方文档为准）
ov add-skill
ov skills add

# 其他常用 CLI 动作
ov language        # 语言设置（别名 ov lang）
ov config add      # 添加配置
ov config switch   # 切换配置

把「做事流程」写进技能，而不是散落在提示词里，带来的直接好处是：可以版本管理、可以按需加载、可以在多个 Agent 之间共享。

OpenViking 提供 MCP 的 stdio 代理，可以把它的检索能力挂进支持 MCP 的客户端。仓库信息里列出了大量集成对象，覆盖主流编码 Agent 与编排框架，同时提供 LangChain 集成。

# 以 Claude 系客户端为例（示意）
claude mcp add openviking -- <openviking mcp stdio 代理命令>

SDK 侧提供 Go、TypeScript、Python 三种语言，三端保持同步。服务端以 REST 接口对外，包含 /search、/find、/recall 等端点。