前言¶
在 DeepSeek Harness（DSH）里接 OpenViking 做记忆时，连接是否可达、各组件是否就绪、记忆与会话规模，往往要单独 curl 健康检查或翻服务端日志。记忆插件负责读写，不负责把这些运维视角的信息收进客户端界面。dsh-openviking-settings 在 DSH【设置】侧栏增加「OpenViking」页，把连接状态、健康探测结果和聚合计数集中展示；它不部署 OpenViking 本身，只读取你已经配置好的实例。
这是什么¶
dsh-openviking-settings（npm 包名 @openviking/dsh-openviking-settings，当前资料版本 0.1.0）由 TerebiSAMA 维护，归类为 admin-security。插件在设置对话框中增加 OpenViking 状态页：连接与版本、服务就绪、记忆与会话计数、队列与本地待写回条数、自动记忆开关，以及脱敏后的服务端配置摘要。没有可访问且配置正确的 OpenViking 实例时，页面会显示「未连接」，其余指标为空。
核心功能¶
下面列出的能力均对应 README 中说明的面板项与数据来源。
- 连接与版本：通过
GET /health（免鉴权）判断healthy并展示服务端version。 - 服务就绪：通过
GET /ready查看 agfs、vectordb、api_key_manager、embedding、ollama 等组件状态。 - 记忆与会话：
GET /api/v1/stats/memories给出记忆库口径条数；GET /api/v1/sessions给出总数、近一小时有变更数量及最近修改时间。 - 队列与补偿：
GET /api/v1/observer/queue展示 Pending / In Progress / Processed；本机~/.openviking/pending/*.json统计写入失败时的待写回条数。 - 自动记忆开关：读取
OPENVIKING_AUTO_CAPTURE、~/.openviking/ovcli.conf的plugin段等，与@openviking/dsh-memory-plugin同一套配置键。 - 隐私边界：API Key 仅在宿主进程使用，页面展示首尾各 4 位的脱敏字符串；不拉取会话正文或记忆内容，仅聚合计数与健康状态；请求由宿主发起，浏览器侧只访问本机 DSH 路由。
服务端内存占用没有公开端点，页面不展示该项。
前置条件：先部署 OpenViking¶
本插件不包含 OpenViking 服务。应先部署并确保当前机能访问（例如 http://<host>:<port>），再安装本插件，否则设置页没有有意义的实时数据。
连接信息与 OpenViking 记忆插件共用，按优先级解析：
| 优先级 | 来源 | 字段 |
|---|---|---|
| 1 | 环境变量 | OPENVIKING_URL（或 OPENVIKING_BASE_URL）、OPENVIKING_API_KEY（或 OPENVIKING_BEARER_TOKEN） |
| 2 | ~/.openviking/ovcli.conf |
url、api_key |
| 3 | ~/.openviking/ov.conf |
server.url、server.root_api_key |
服务端需开放 /health、/ready，以及带鉴权的 /api/v1/* 用于统计类接口。
安装与启用¶
方式一：插件市场（推荐）
在 DSH【插件 → 发现】中搜索「OpenViking 状态」并安装。若使用自定义市场索引，可将仓库索引地址加入【发现】（详见仓库内 PACKAGING.md）。
方式二：从仓库安装
在终端执行：
dsh plugin --profile desktop add "git+https://github.com/TerebiSAMA/dsh-openviking-settings.git"
安装完成后刷新 DSH 窗口或重启应用，【设置】侧栏会出现「OpenViking」入口。
典型用法¶
- 按上表配置环境变量或
ovcli.conf/ov.conf，确认 OpenViking 已运行且/health、/ready可访问。 - 安装插件并刷新 DSH。
- 打开【设置】→「OpenViking」，查看是否「已连接」、版本号与各组件就绪情况。
- 对照记忆条数、会话统计与队列，判断记忆流水线是否正常；若本机待写回条数持续增加，说明有写入失败需回到 OpenViking 或网络侧排查。
- 在页面上核对自动记忆开关是否与
OPENVIKING_AUTO_CAPTURE或ovcli.conf一致，无需为看状态单独改记忆插件配置（共用同一套键）。
适用场景与注意¶
适合已在 DSH 中配合 OpenViking 做记忆、需要在客户端快速确认「连上了没有、服务好不好、规模多大」的开发者或自托管运维，而不想每次手敲健康检查接口。
使用时请注意：
- 插件以当前 DSH 进程权限运行，会按上述优先级读取本机配置与环境变量；安装前应浏览仓库源码并确认 MIT 许可证（
package.json中license为 MIT）。 - 星标与社区目录上的分类（admin-security）反映目录归类，不代表官方安全审计。
- DSH 生态是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-openviking-settings 把 OpenViking 的连接、健康与记忆相关计数收进 DSH【设置】，与记忆插件共享连接配置，适合先部署 OpenViking、再在客户端做日常状态巡检。
