dsh-kube-lens

DSH PLUGIN浏览器与联网

仓库 atticuswx/dsh-kube-lens · npm @local/dsh-kube-lens

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 提供 Kubernetes 集群浏览侧边栏面板与 6 个 Agent 排查工具,默认只读、Secret 脱敏,写操作需审批。

一句话选型结论

按资料字段整理

dsh-kube-lens 是浏览器与联网类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-04 创建于 2026-11-04
README 9.8 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:atticuswx/dsh-kube-lens#v0.3.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名@local/dsh-kube-lens可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-kube-lens:在 DeepSeek Harness 侧边栏浏览 Kubernetes 集群

  • 侧边栏集群资源浏览器
  • 6 个 Agent 排查工具
  • 默认只读、Secret 脱敏
  • YAML 查看与审批后保存
  • 日志实时跟随与搜索

适用场景

终端命令联网搜索

上游标签

clusterdeepseek-harnessdshdsh-plugink8skubectlkubernetes

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在浏览器与联网场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-kube-lens当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

浏览器与联网
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方atticuswx仓库 dsh-kube-lens · 默认分支 main
分类浏览器与联网browser
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-04 · 2026-11-04最后推送 2026-11-04
本站收录2026-11-05首次进入本站目录的时间

README 全文

9.8 KB
作者原文,中文版优先;只做安全转义,不改内容

Kubernetes Lens

通过 kubeconfig 访问集群的 DSH 插件。左侧栏多一个 Kubernetes 图标,主区是一个资源浏览器;同一套操作也暴露成 Agent 工具,用来排查问题。

> English — A Kubernetes cluster browser panel and agent tools for the DeepSeek Harness (DSH) Web GUI. Reads contexts from your kubeconfig through kubectl; read-only by default, secrets redacted, writes behind an approval. MIT licensed.
>
> bash > dsh plugin --profile web add github:atticuswx/dsh-kube-lens >
>
> Reload the page and the Kubernetes icon appears in the sidebar. Requires kubectl on the host.

安装

从 GitHub 安装(推荐):

dsh plugin --profile web add github:atticuswx/dsh-kube-lens

装完刷新页面,侧边栏出现 Kubernetes 图标。想锁定版本,可以在地址后面加 tag:

dsh plugin --profile web add github:atticuswx/dsh-kube-lens#v0.3.0

本地开发(改代码即时生效):

git clone https://github.com/atticuswx/dsh-kube-lens.git ~/dsh-plugins/dsh-kube-lens
dsh plugin --profile web add ~/dsh-plugins/dsh-kube-lens

前置条件:宿主机有 kubectl(Rancher Desktop 通常在 ~/.rd/bin/kubectl),以及支持 Web client bundle 的 DSH。包内没有构建步骤,client.js 由浏览器直接加载。

安装后会发生什么

  • 侧边栏出现一个 Kubernetes 图标,点开是集群浏览器。
  • Agent 多了 6 个工具:kube_contexts、kube_get、kube_describe、kube_logs、kube_events、kube_diagnose。
  • 默认只读。写操作关闭时,kube_write 工具和面板上的写按钮都不出现。

为什么走 kubectl

kubeconfig 的凭证可能是客户端证书、bearer token、exec 凭证插件(aws / gcloud / azure)、auth-provider 片段。kubectl 已经把这些都处理好了;一个不引入依赖的插件不可能正确重写一遍。代价是宿主机上要有 kubectl——Rancher Desktop 的用户通常已经把它放在 ~/.rd/bin/kubectl。

切换 kubeconfig

面板右上角的 kubeconfig 按钮可以随时增删 kubeconfig 文件,改完立即生效,不用重启插件:

  • 粘贴绝对路径(支持 ~/...)→ 「添加」。
  • 多个 kubeconfig 一起列出,但每个 context 只用它所属的那个文件:不做跨文件按名合并。
    原因很实际——两个 kubeconfig 常常都把 cluster 叫作 kubernetes,kubectl 合并时只保留第一个,
    于是另一个文件的 context 会被指向错误的 API server,表现为 Unauthorized。
  • 列表为空时回落到 $KUBECONFIG,再回落到 ~/.kube/config。
  • 保存位置:$DSH_HOME/kube-lens.json(默认 ~/.dsh/kube-lens.json),可以手改。

添加后,context 下拉框会列出新文件里的所有 context,current-context 自动选中。

浏览与搜索

  • 顶部显示 kubeconfig 文件名(例如 prod-cluster),而不是那串 123456789012345678-… 的 context id;hover 可以看到完整的 context、server 和文件路径。
  • 点名字旁边的 ✎ 可以改成任意显示名(例如「沙箱集群」),回车保存,Esc 取消;名字存在 ~/.dsh/kube-lens.json 的 labels 里,按 kubeconfig 文件记录,所以换路径后不会错位。
  • 一个 kubeconfig 里若有多个 context,下拉框会显示 文件名 · context 以便区分。
  • 一个过滤条同时管命名空间和搜索:左边是命名空间触发器(点开选「全部命名空间」或具体某个),右边直接输入过滤资源名称;/ 聚焦输入框,Esc 清空或关闭菜单。
  • 命名空间下拉在命名空间多于 12 个时会自带筛选框。
  • 选「全部命名空间」时表格会多出 NAMESPACE 列。
  • 只看异常按 READY / STATUS 列筛选:未就绪(0/N)或处于 CrashLoopBackOff、ImagePullBackOff、Pending、Error 等状态的对象,方便第一时间定位问题实例。
  • 计数显示为 匹配数/总数,筛选是纯客户端的,不会因为输入而反复请求集群;切换命名空间才会重新请求。

键盘

  • 表头排序:点击列头在 升序 → 降序 → 取消 之间循环;不可排序的列(CLUSTER-IP、PORT(S)、CAPACITY)不显示排序按钮。
  • 表格:↑ / ↓ 移动行焦点,Home / End 跳到首行/末行,Enter 或 Space 打开详情。
  • 搜索:/ 聚焦搜索框(详情页不生效);输入框里 Esc 清空并退出。
  • 详情:Esc、左上角返回、右上角关闭都回到列表,焦点落回进入详情的那一行。

详情页:YAML 与日志

详情页的 YAML 和 日志 两个 tab(0.3.0 新增):

YAML

  • 编辑器是 CodeMirror 6(@codemirror/lang-yaml),打包在插件的 viewer.js 里,不走 CDN,离线可用;只在第一次打开 YAML tab 时按需加载,加载失败会自动退回只读的 `` 视图。
  • 支持语法高亮、行号、折叠、括号匹配、撤销/重做、自动换行和 ⌘F 查找。
  • 复制:有选中内容时复制选中,否则复制整份清单。下载:保存为 -.yaml。格式化:用 YAML 解析器重新排版并保留注释。还原:回到打开时的内容。
  • 编辑时实时做 YAML 语法校验:错误行内波浪线,状态栏显示第一条错误;有未保存改动时 YAML tab 出现小黄点。
  • 保存到集群只在 allowWrites: true 时可用:点击后出现确认条(显示 kubectl apply -f -),确认后才执行 kubectl apply。
  • Secret、清单超过 24k 字符被截断、读取失败三种情况自动只读,避免把脱敏或不完整的内容写回集群。
  • 快捷键:⌘F 查找、⌘S 保存、Esc 关闭查找;编辑器内 ⌘C / ⌘V 照常。

日志

  • 跟随通过 SSE 持续接收 kubectl logs -f --timestamps 的输出;默认自动滚底,向上翻看时暂停滚底并显示「回到最新」。
  • 搜索框高亮全部匹配,Enter / Shift+Enter 跳到下一个/上一个,显示 当前 / 总数。
  • 支持时间戳、自动换行、200–2000 行 tail、复制全部、下载原始日志(带时间戳)。
  • 多容器 Pod 会列出容器 tab;有重启时多出「上一次运行」快照。切换 tab 会重建对应的流。
  • 连接断开后自动重连,用上一次时间戳 --since-time 补漏,并按时间戳去重;只保留最近 5000 行,更早内容自动裁剪。
  • 离开「日志」tab 会断开 kubectl 子进程,避免后台一直 tail;回到 tab 再重连。
  • 日志搜索快捷键:Enter 下一个、Shift+Enter 上一个、Esc 清空。

配置

cordis.patch.yml 里的 config:

键 默认 说明
kubeconfigPaths [] 额外/指定的 kubeconfig 文件列表,多个文件按 kubectl 的合并规则一起读。空表示 $KUBECONFIG,再空就是 ~/.kube/config。
kubectlPath '' 固定 kubectl 路径。空表示自动探测:PATH、~/.rd/bin、/usr/local/bin、/opt/homebrew/bin。
context '' 默认 context。空表示用 kubeconfig 的 current-context。
namespace '' 默认命名空间。空表示 default。
allowWrites false 打开后才有 kube_write 和面板写按钮。
requestTimeoutMs 20000 单次 kubectl 超时。

改配置后需要重新加载插件。

写操作

allowWrites: true 之后:

  • kube_write 的每次调用都会先向用户发一次一次性审批(和 bash 工具的审批同一个通道)。拒绝、取消、通道不可用,一律不执行。
  • 面板上的滚动重启 / 扩缩容 / 删除 Pod 会先弹确认框,再走 /kube-lens/api/write。
  • 详情页 YAML 的「保存到集群」会先出现确认条,再走 /kube-lens/api/apply。服务端还会再次检查 allowWrites、拒绝 Secret、拒绝一个清单里出现多个顶层 kind。

Secret

Secrets 的内容从不返回:kube_get 的 YAML 和面板的 YAML 页对 Secret 只显示 type 和键名。面板 YAML 页对 Secret 强制只读,保存接口也会拒绝 Secret。日志、事件、清单照常返回。

诊断是怎么做的

kube_diagnose 一次调用返回:容器状态、重启次数、上次退出码与终止原因、调度失败事件、Service 的 Endpoints 覆盖、以及上一次运行和当前的日志尾巴,并给出结论化的 findings。

判断规则(都是启发式,附证据):

  • ImagePullBackOff / ErrImagePull → 镜像或仓库凭证
  • CrashLoopBackOff → 重启次数 + 上次退出码
  • OOMKilled → 内存 limit
  • CreateContainerConfigError → 引用的 ConfigMap/Secret
  • Pending + FailedScheduling → 调度器原话
  • Running 但未 Ready → 就绪探针
  • Service 无 Endpoints → 区分「selector 打错」和「Pod 不 Ready」
  • Node 的 Ready / MemoryPressure / DiskPressure / PIDPressure

已知边界

  • 只实现 Pod / 工作负载 / Service / Node 的深度诊断;其它资源回退到 kubectl describe。
  • 还没有 exec、port-forward。YAML 保存走 kubectl apply,只在 allowWrites: true 时出现,并且需要面板确认。
  • 集群不可达时,工具返回的是「集群不可达 + server 地址 + 下一步」,而不是 kubectl 的原始堆栈。

开发与测试

仓库自带纯函数测试和一套 jsdom 面板门禁:

npm ci
npm test

viewer.js 是预构建产物,已提交在仓库里;安装时不需要构建。只有修改 viewer-src/viewer.js 时才需要重新生成:

npm run build:viewer

更新已安装的插件后:

  • 客户端改动刷新页面即可(client.js 的 combo 版本按文件时间变化)。
  • Host 改动(index.js / kube.js 的新路由、SSE、apply)需要重载一次宿主:重启 dsh web,或在插件管理里重载该插件。

License

MIT — see LICENSE.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-kube-lens 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:atticuswx/dsh-kube-lens#v0.3.0` 即可。对应的 npm 包名是 `@local/dsh-kube-lens`。

dsh-kube-lens 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-kube-lens 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-kube-lens 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-kube-lens 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-kube-lens 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-kube-lens 有哪些功能?

侧边栏集群资源浏览器、6 个 Agent 排查工具、默认只读、Secret 脱敏、YAML 查看与审批后保存、日志实时跟随与搜索。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

L4 · 沙盒安装通过 1,152 星

agentrq

agentrq

L4 · 沙盒安装通过 1,140 星

atticuswx 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。