前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的设计理念。在使用本地 OpenViking 服务器进行智能体记忆管理时，开发者通常需要切换窗口来操作 Studio 或检查提交状态。dsh-openviking-enhance 插件旨在解决这一割裂问题，它将 OpenViking 的 Studio 面板、会话提交状态监控以及记忆检索功能直接集成到 DSH 的 Web GUI 界面中，减少上下文切换的成本。
介绍¶
该插件由 A2chitect 维护。它是一个客户端插件，主要提供 OpenViking 的只读视图。插件本身不会向 OpenViking 服务器提交数据、写入或删除任何内容，仅用于展示服务器状态和检索结果。
核心功能¶
OpenViking Studio 面板¶
在 DSH 左侧边栏底部新增 OpenViking Studio 面板入口。点击该入口后，OpenViking 服务器的 Studio 界面会在 DSH 主区域打开。开发者无需切换浏览器标签页，即可直接浏览记忆、会话和检索结果。
会话提交状态药丸¶
在消息框下方显示当前会话的提交状态（药丸）。状态包括：
* OV · not committed：未提交
* OV · 12.3k/20k：累积中
* OV · extracting…：提取中
* OV · 3 commits：已提交
* OV · extraction failed：提取失败
* OV · unavailable：不可用（无法连接服务器）
点击药丸可查看最近 3 次提交的时间线，以及该次提交对记忆的具体变更（新增、更新或删除），并可查看完整的记忆路径或失败原因。
Memory recall 右侧边栏¶
在 DSH 右侧边栏新增 Memory recall 选项卡。该选项卡显示当前会话的检索结果，包括：
* 检索查询（当前会话的最新消息或手动输入）
* 检索来源（memories、resources、skills）
* 匹配评分（颜色编码：红、橙、绿）
* 文件名、类型（entity、event 等）及摘要
* viking:// 路径（悬停显示）
安装与配置¶
安装¶
可以通过命令行或 DSH 的 Plugins 页面进行安装。
dsh plugin --profile desktop add dsh-openviking-enhance
配置¶
插件提供合理的默认值，标准本地部署通常无需额外配置。如需修改，可在 DSH 的 Plugins 页面选择该插件并点击 Configure，或直接编辑配置文件。
主要配置项包括：
* endpoint：OpenViking 服务器地址，默认从 ~/.openviking/ovcli.conf 读取，否则为 http://127.0.0.1:1933。
* apiKey：服务器认证密钥，如服务器需要则填写。
* studioPath：Studio 页面的路径，默认为 /studio/。
注意事项¶
版本依赖¶
- DSH 版本：需要 DSH 版本 >= 0.2.0-rc.2。
- OpenViking 版本：需要本地运行 OpenViking 服务器（如 0.4.22 测试版）。
- 记忆插件：需要安装
@openviking/dsh-memory-plugin才能显示准确的提交进度。如果未安装，药丸将显示 token 数量而非提交次数。
加载机制¶
- 主机部分：插件的主机逻辑在 DSH 应用启动时加载，安装后需重启应用。
- 客户端部分：插件的客户端逻辑通过文件加载，安装后需刷新浏览器窗口（⌘R 或 F5）才能生效。
功能限制¶
- 插件内部路由仅响应来自 DSH 窗口自身的回环请求。
- 如果插件显示提取失败，通常是因为 OpenViking 的提取模型配置问题，需检查
~/.openviking/ov.conf。
