用途：通过 OpenViking MCP 工具读写以 viking:// URI 寻址的长期语义记忆。该客户端无生命周期钩子，召回与捕获都不会自动发生，需手动驱动完整循环。
核心工具：召回类为 find、search、read、list、grep、glob；持久化为 remember、add_resource；维护为 forget、health。部分部署还会注册 tree、write、edit、list_watches、cancel_watch 等可选工具，是否可用取决于服务端版本与托管模式（托管云服务会裁剪部分工具）。应先查看当前会话已注册的工具列表，使用可选工具前阅读 references/optional-tools.md，不要调用未注册的工具，也不要退回原始 HTTP；若完全没有注册 OpenViking 工具，则不带记忆继续。
召回：任务开始时判断是否需要记忆，可执行或多步工作、涉及可能见过的系统、失败恢复时检索；闲聊与一次性琐事跳过。用任务目标、领域对象、预期操作和约束构建一条简洁查询，失败后加入失败操作与错误信息的稳定部分。调用 find（快速、带 URI+摘要+评分的排序结果），limit 约 5-10；需要更深意图分析时用 search，或用 search 的 mode="context" 获得服务端组装、受 token 预算限制的上下文块。list 模式可用 target_uri 限定范围，例如 viking://~/memories/experiences 查历史任务经验；viking://~ 是本人用户根目录别名，早于该别名的服务端会以 INVALID_URI 拒绝所有 viking://~ URI，此时改用本会话中已出现的显式 viking://user/<user_id>/... 根，或去掉 target_uri 并保留 URI 含 /memories/experiences/ 的命中项，切勿猜测用户 ID。按任务与环境契合度而非标题相似度判断结果，read 一到三个最可能改变执行方式的确切文件 URI，忽略 .abstract.md、.overview.md、.relations.json 等附属文件。无相关结果则不带记忆继续；执行因实质新原因失败时最多再做一次聚焦的后续搜索。检索到的记忆仅供参考，优先级为系统与开发者指令、当前用户请求、当前环境与工具证据，最后才是记忆；须针对当前任务核验命令、路径与版本，过去成功不授权现在执行破坏性操作。
持久化：该客户端捕获不自动，需在同一会话中保存有价值信息。remember(messages) 为默认方式，传入关键对话或简短事实摘要作为带角色标记的消息，服务器自行抽取并归档偏好、实体、事件、经验；适用场景包括用户说“记住这个”、陈述持久偏好或决定，或出现来之不易的教训（根因、可行流程、环境怪癖）。add_resource 用于把外部文档或 URL 导入为可搜索资源，任何用户给出的文件、URL 或仓库都用它，不要用 write 把文本抄成文件。需要在已知位置（viking://~/ 本人用户根或 viking://resources/ 下）自撰笔记时用可选的 write/edit 工具，未注册则退回 remember。应持久化稳定偏好与约定、环境事实、带理由的决定、可复用流程或修复；不应持久化密钥与凭据、瞬态状态、推测或大批量对话转储——存结论而非滚动记录。
示例：用户要求修复失败的部署时，以 query deployment image pull failure private registry、target_uri viking://~/memories/experiences 调用 find；read 最相关的经验 URI，并对照当前集群核验其假设后再套用步骤；修复并验证实际结果；用 remember 保存根因与有效修复的简短摘要，供下次会话召回。