DeepSeek Harness 环境体检插件

在 DeepSeek Harness (DSH) 的开发与调试过程中，环境状态（磁盘、内存、网络、插件版本）直接影响智能体的稳定性。当模型表现异常时，开发者往往需要排查系统资源占用或缓存膨胀问题。dsh-healthcheck 旨在解决这一痛点，提供一套标准化的环境体检流程。

这是一个由 taxueseek 维护的插件，属于“记忆”类别。它是一个只读工具，不执行任何清理或删除操作，仅负责采集当前环境指标，并与历史基线进行对比，生成 CRITICAL / WARNING / INFO 分级报告。

核心能力¶

该插件主要完成以下体检任务：

系统资源检查：检查磁盘使用率（APFS 数据卷 /System/Volumes/Data）、内存压力、网络延迟（ping 8.8.8.8）。
环境细节检查：检查 ~/.dsh 目录膨胀情况（包括 clipboard 图片、sessions、profiles、storages 各目录）、工具链可用性、插件版本。
趋势对比：记录历史数据，对比磁盘增量趋势，首次体检即建立基线。

安装与启用¶

通过官方目录安装插件：

dsh plugin --profile web add taxueseek/dsh-healthcheck

安装后需重启 DSH Web Profile 以使插件生效。

配置¶

插件支持以下配置项，可在工具定义的 config 字段中修改：

- id: healthcheck-toolkit
  name: 'dsh-healthcheck'
  config:
    stateDir: '~/.dsh/health'      # 历史基线目录
    historyLimit: 200              # 保留快照条数
    diskWarnPct: 80                # 磁盘 WARNING 阈值（%）
    diskCriticalPct: 90            # 磁盘 CRITICAL 阈值（%）
    memoryWarnPct: 80              # 内存压力 WARNING 阈值（%）
    latencyWarnMs: 150             # 延迟 WARNING 阈值（ms）
    scanTimeoutMs: 30000           # 单次扫描超时（毫秒）

使用示例¶

在对话中，用户可发送指令触发体检：

用户：“体检一下”
用户：“看看磁盘”
用户：“环境是不是有问题”

模型随后会调用 health_check 接口，返回分级报告。示例输出如下：

# 环境体检报告
总体: HEALTHY | CRITICAL 0 / WARNING 0 / INFO 4
- [INFO] 磁盘使用率 62.5%，可用 285.3 GB
- [INFO] 内存压力 34.2%
- [INFO] 网络延迟 18 ms
~/.dsh 数据目录:
  1.2 GB  ~/.dsh/sessions
插件版本:
  dsh-context: 0.5.0 → 0.7.3（可升级）

设计与数据¶

只读设计：插件仅做体检和报告，绝不自动删除任何东西。清理动作需用户确认后执行。
数据存储：历史基线数据存储在 ~/.dsh/health/history.l，每次体检追加一条记录。

生态与链接¶

该插件是 DeepSeek Harness 生态的一部分。社区目录：https://www.skillhub.cn/plugins/taxueseek/dsh-healthcheck。源码仓库：https://github.com/taxueseek/dsh-healthcheck。