WODE25500/dsh-kubectl

Name: WODE25500/dsh-kubectl
Author: WODE25500

Plugin插件 Native原生 ⭐ 2 MIT Subagents & Orchestration子代理与编排

Kubernetes (kubectl) 的 DeepSeek Harness 插件 — 查资源/日志/describe/端口转发/执行，JSON 结构化输出

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-kubectl is a DeepSeek Harness plugin that exposes kubectl operations to dsh agents via structured JSON output. It bundles eight tools: read-only get, describe, logs, and status for inspection, plus exec, apply, delete, and port-forward for write actions. Use it for Kubernetes inspection, troubleshooting, and cluster administration. Note: write operations require explicit user confirmation, port-forward runs as a long-lived process without auto-shutdown, and a working kubeconfig is required.

dsh-kubectl 是 DeepSeek Harness 的 Kubernetes 插件，让 dsh 智能体通过结构化 JSON 与 kubectl 交互，覆盖 get/describe/logs/status 等只读排障工具及 exec/apply/delete/port-forward 等写操作。适用于 k8s 运维、集群巡检与故障排查场景，通过 cordis.patch.yml 即插即用。注意：写操作需显式确认，port-forward 为常驻进程不自动停止，依赖已配置 kubeconfig。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-kubectl】【https://github.com/WODE25500/dsh-kubectl】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:WODE25500/dsh-kubectl

把 WODE25500/dsh-kubectl 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.3 KB · 缓存于 2026-08-29 05:30:41 · 2.3 KB

dsh-kubectl

Kubernetes (kubectl) 的 DeepSeek Harness (dsh) 插件 —— 让 dsh 智能体检查集群、查资源、读日志、端口转发、执行一次性命令。只读命令输出 JSON 结构化数据（模型解析可靠），写操作显式确认。

独立社区项目，非官方。基于 kubernetes/kubectl（Apache-2.0）。

为什么值得做

Kubernetes（40k+ star）至今没有 DSH 适配插件。kubectl 的 -o json 结构化输出对 agent 极其友好（远胜 winget 的表格），是运维刚需：

能力	说明
`kubectl_get`	查资源，`-o json` 结构化输出
`kubectl_describe` / `kubectl_logs`	排障三件套
`kubectl_status`	版本/上下文/集群信息
`kubectl_exec` / `kubectl_apply` / `kubectl_delete`	执行/部署/删除（显式确认）
`kubectl_port_forward`	本地访问集群内服务

前置要求

DeepSeek Harness（dsh）
kubectl 已安装并配置 kubeconfig（kubectl config get-contexts 可看）

安装

- insert:
    - id: kubectl
      name: './src/index.js'
      config:
        kubectlPath: kubectl
        context: my-cluster
        namespace: default

pnpm dsh web --patch ./dsh-kubectl/cordis.patch.yml

工具

工具	行为	安全
`kubectl_get`	查资源（JSON）	🔵 只读
`kubectl_describe`	资源详情	🔵 只读
`kubectl_logs`	pod 日志（tail/previous/container）	🔵 只读
`kubectl_status`	版本/上下文	🔵 只读
`kubectl_exec`	容器内执行命令	🟡 确认
`kubectl_apply`	应用清单	🔴 确认
`kubectl_delete`	删除资源	🔴 确认
`kubectl_port_forward`	端口转发	🟡 常驻

配置项

键	默认	说明
`kubectlPath`	`kubectl`	kubectl 路径
`context`	—	默认上下文
`namespace`	—	默认命名空间
`timeoutMs`	`60000`	单次调用超时

已知限制

无集群时命令报连接拒绝（stderr 原样返回）
port-forward 是常驻进程，当前版本不自动停止
写操作依赖用户确认；SKILL.md 有明确红线

目录结构

dsh-kubectl/
  src/index.js            # 8 个工具 + 配置
  skills/kubectl/SKILL.md
  docs/
  cordis.patch.yml

许可

MIT。

渲染基于仓库 WODE25500/dsh-kubectl 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令