Skip to content

dsh-openviking-expand

Verified

dsh-openviking-expand · v0.3.0 · AGPL-3.0-only · Web UI

OpenViking bundle for DeepSeek Harness: the Studio console in the left sidebar and a viking:// tree in the right sidebar

Install

dsh plugin add dsh-openviking-expand

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

OpenViking 扩展(DSH 插件)

本插件是 OpenViking(OV)的 DSH 扩展插件,把 OV 接入 DeepSeek Harness(OV 仓库:https://github.com/volcengine/OpenViking),提供两个可独立开关的组件:

  • console:左侧栏 OpenViking Studio 控制台;
  • sidebar:右侧栏 viking:// 文件与目录树。

一个插件包,两个组件,各自有独立开关;壳层只负责装配,不提供功能。

组件

console

左侧栏入口 + 中间列嵌入 OpenViking Studio。请求由宿主代理,浏览器端不保存 OpenViking 的 key。

sidebar

右侧栏 viking:// 目录树:

  • 懒加载目录;
  • 文件正文预览;
  • 目录的 L0 摘要 + L1 概览组合视图;
  • hover 行可把 URI 引用到当前会话,或在新页签打开;
  • 根 URI 可随时修改。

右侧栏依赖 dsh-better-sidebar;未安装时 console 仍可正常使用。

环境要求

  • DSH Web 或 Desktop,0.2.2+(当前版本在 0.2.2-rc.1 上验证);
  • OpenViking 0.5.x,/health 可访问;
  • 可选:dsh-better-sidebar 0.30.x,用于右侧栏页签。

安装

在 DSH 插件管理器中搜索并安装:

dsh-openviking-expand

也可以使用命令行:

dsh plugin --profile web add dsh-openviking-expand

从源码开发:

git clone <this-repository-url>
cd dsh-openviking-expand
node scripts/build-client.mjs
dsh plugin --profile web add .

安装后在插件列表确认「OpenViking 扩展」已启用,硬刷新浏览器。

配置

OpenViking 页

配置服务类型、地址、语言和密钥。也可以在嵌入的 Studio 里添加连接,侧边栏会跟随 Studio 当前选中的连接。

使用

控制台与侧边栏

  • 左侧栏 OpenViking:打开 Studio;
  • 右侧栏 +:选择 OpenViking,浏览 viking://;
  • 行内 @:引用到当前会话;↗:新页签打开。

架构

DSH 浏览器
   │
   ├── /openviking-expand/*  ──► 插件 Host ──► OpenViking
   └── /studio/*             ──► OpenViking Studio 静态代理

相关文件:

  • 插件壳与组件入口:host/index.mjs、host/components/*;
  • 浏览器客户端:client/,构建为 lib/client.js;
  • 插件配置持久化:~/.dsh/openviking-expand.json。

安全

  • OpenViking key 只在 Host 侧使用,不进浏览器;
  • viking:// 只读;拒绝 ..、控制字符、查询串和反斜杠;
  • 插件不安装、不修改、不删除任何外部服务或容器。

开发

npm run check      # 构建客户端并做语法检查
npm test           # 单元测试
npm run smoke      # 客户端冒烟测试

发布前建议执行:

npm run check && npm test
npm pack --dry-run

许可证

AGPL-3.0-only,见 LICENSE。