dsh-kubectl

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。