DeepSeek Harness 插件检测与响应（DSH-PDR）

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构，插件在宿主上运行时享有与主机相同的权限——可读取凭据、打开网络连接、启动子进程。审查源码只能回答「它理论上能做什么」，且仅在更新前有效。DSH-PDR 回答的是另一个问题：它实际做了什么？

该插件通过运行时行为探针，将每个文件系统、网络和子进程调用归属到发起的插件，根据插件声明的需求判断是否越界，并展示结果。所有数据保留在本地，无任何遥测。

这是什么¶

DSH-PDR 是一个 DeepSeek Harness 插件检测与响应插件，由 kipozannaki 维护，分类为 admin-security。它提供插件装前体检、运行时行为监控与越界判定、本地优先审计等功能。

核心功能¶

装前健康卡¶

静态能力概览、红线组合检查，给出 PASS / WARN / BLOCK 评级。信任评分基于加权公式：红线每项扣 30 分，凭据访问扣 5 分，网络扣 3 分，子进程扣 2 分，划分为「良好 / 注意 / 谨慎 / 高危」四个等级。

运行时防火墙¶

按插件时间轴展示文件系统、网络和子进程活动。探针在插件实例化前通过 earlyInstall 表达式安装探针，并将所有目标插件调用归因到具体插件（包括通过注入宿主服务发起的调用）。

边界判定¶

将插件声明的契约（hosts、grants）与路径类别、行为基线比对，输出「正常 / 观察 / 可疑 / 越界」四种状态。合约未声明时，从健康卡的能力概览中导出默认合约。

阻断模式（可选）¶

在配置中开启 mode: block 后，插件可阻止声明违规的调用在执行前终止。默认模式为 alarm，仅记录告警。

更新守卫¶

变更时快照并回滚 profile manifest 三件套（package.json、pnpm-lock.yaml、cordis.patch.yml），并在隔离的沙盒子进程中执行能力差异与依赖差异检查。

审计导出¶

从本地事件日志离线生成 JSON、Markdown、SARIF 2.1.0、CSV 格式的审计报告，支持多源聚合与跨源去重。

Webhook 告警（默认关闭）¶

仅对红线事件推送，支持去重与速率限制，Payload 格式包括 json、Slack、钉钉。

本地优先¶

无任何遥测，所有事件与审计数据存储在本地。

安装与启用¶

前置条件：Node ≥ 22.12、DSH ≥ 0.1.7、pnpm。

# 1. 安装到指定 profile
dsh plugin --profile <profile> add github:kipozannaki/DSH-PDR-Plugin

# 2. 通过启动器启动宿主（不直接运行 dsh）
dsh-pdr --profile <profile> web

# 3. 确认预加载已就位
dsh-pdr --pdr-check

启动器通过 NODE_OPTIONS=--require 提前加载探针，以覆盖 DSH 在早期对 node:* ESM facades 的封装。若无预加载，实测在真实会话中，目标插件调用的归因率从 0/3 上升到 3/3。

典型用法¶

配置文件¶

# profile 的 cordis.patch.yml
- id: dsh-pdr-plugin
  config:
    dataDir: ~/.dsh/firewall
    probeMode: als
    maxBytes: 8388608
    policy:
      mode: alarm
      rules:
        credential-exfil: block
    alerts:
      enabled: false
      url: https://your-webhook.example/hook
      rules: []
      format: json

声明契约（插件作者可选）¶

// package.json
"firewall": {
  "hosts": ["api.example.com"],
  "grants": ["global-credentials"]
}

契约是「声明的自由」：在契约内保持静默，超出即记录。

CLI 命令¶

# 在宿主中启动（带预加载）
dsh-pdr web

# 在宿主中执行任意命令
dsh-pdr headless "run tests"

# 检查预加载状态
dsh-pdr --pdr-check

# 离线审计导出
dsh-pdr audit --format md
dsh-pdr audit --format sarif --out audit.sarif
dsh-pdr audit --format csv   --out audit.csv
dsh-pdr audit --format json  --out audit.json

# 多源聚合
dsh-pdr aggregate --format md
dsh-pdr aggregate --source prod=/m1/.dsh/firewall --source dev=/m2/.dsh/

适用场景与注意¶

适合需要细粒度运行时行为可见性的 DSH 插件开发者与运维人员，特别是在多插件、高权限场景下排查异常行为。

注意：插件在当前 dsh 进程权限下运行，安装前应审查源码与许可证（MIT）。所有功能依赖宿主 ≥ 0.1.7、Node ≥ 22.12。

结尾¶

DSH-PDR 提供从装前体检到运行时边界判定的全链路可见性，以本地优先的方式回答「它实际做了什么」。如需了解详情，可访问 SkillHub 插件目录或 GitHub 仓库。