dsh-openviking-manager
DSH UI manager for OpenViking connection, user keys, and local configuration.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:xbzbing/dsh-openviking-manager#f39bf5bab6bc7ae9468ccb177c3b720fcb658ec3
Openviking Manager is published as dsh-openviking-manager and currently resolves to version 0.1.4. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
English | 简体中文
dsh-openviking-manager 是一个 DSH Web UI 插件，用于管理已有 OpenViking 服务的客户端连接、用户 Key 和本机配置诊断。它只管理客户端配置；记忆同步、提交和召回仍由官方 @openviking/dsh-memory-plugin 负责。
OpenViking 是火山引擎开源，专门给 AI Agent 设计的上下文数据库，用来解决 Agent 长上下文、记忆、知识库管理问题。OpenViking 需要部署对应的服务端程序，服务支持远程访问和账号隔离，因此也适用于做跨设备、跨会话的远程记忆中心。本插件只是为 OpenViking 增加一个配置界面，便于管理本地的客户端配置。
OpenViking 的安装配置详见其官方网站：DeepSeek Harness 记忆插件
~/.openviking/ovcli.conf；user_key，页面仅显示掩码而不回传明文；/health、/ready 与用户身份；ovcli.conf 的 JSON 格式和文件权限，并提供经确认的权限修复；~/.openviking/ov.conf 的非敏感状态，例如认证模式、是否存在 root key；ovcli.conf 始终优先；root_api_key 调用官方 Admin API：列账号、列用户、创建账号/用户、重新生成用户 Key；<endpoint>/studio），允许用户手工改为反向代理地址；| 在 DSH 中 | 恢复与初始化 |
|---|---|
| DSH 插件页中的 openviking-manager | 恢复或初始化访问：列出账号 |
| 插件配置页：连接配置与连接验证 | 恢复或初始化访问：创建用户 |
截图由 npm run screenshots 在一个隔离的 DSH 实例中生成，英文版见 README_EN.md。
root_api_key 只在浏览器表单和一次同源管理请求期间使用，绝不写入 ovcli.conf；创建/轮换完成后插件会清空该输入。user_key 从服务端本地读取，浏览器只收到掩码；连接验证可在不回显旧 key 的情况下完成。no-store，且不在日志中记录请求头。# 安装 openviking 的官方插件
dsh plugin --profile web add @openviking/dsh-memory-plugin
# 安装配置管理器
dsh plugin --profile web add dsh-openviking-manager
# 也可以直接从 GitHub 仓库安装或者从 file 安装
dsh plugin --profile web add github:xbzbing/dsh-openviking-manager
安装后可能需要重启对应的 DSH profile，在 DSH 插件页面可以看到openviking-manager的配置管理页面。
>= 22>= 0.1.6-alpha.2 < 0.2.0npm ci
npm run build # 生成 lib/ 编译产物，不会生成 .tgz
npm test # 单元测试 + Playwright E2E
lib/ 是随 git 分发的编译产物，改动 src/ 后必须重新构建并提交，否则从 GitHub 安装会加载到缺失或过期的入口。lib/standalone.js 仅供 Playwright 使用，不提交也不随包发布。仓库不会在构建流程中生成或保留 .tgz 安装包。
npm run test:unit
npm run test:e2e
Playwright E2E 覆盖导入并保存 ovcli.conf、非法 endpoint 保护、服务端 user key 验证、临时 root key 的账号/用户选择，以及中文浏览器语言渲染。
src/
ovcli-config.ts ovcli.conf 读取、校验、原子写入和权限修复
local-discovery.ts ov.conf 非敏感发现
openviking-client.ts 数据面连通性与身份验证
openviking-admin.ts 官方 Admin API 适配
manager-api.ts DSH 同源 HTTP 路由
client/ DSH Web 页面、样式和 i18n
本项目采用 MIT License。