dsh-jev-plugin：DeepSeek Harness 的类型化决策插件

在 DeepSeek Harness (DSH) 的智能体开发中，通常需要将 LLM 的文本输出转化为结构化的决策。TypeSafe Jev (System One) 提供了结构化的判断原语，但 DSH 本身不直接支持。dsh-jev-plugin 插件将 Jev 的能力封装为 DSH 的工具，使智能体能够使用类型化决策，并提供可配置的护栏与审查机制。

插件概览¶

dsh-jev-plugin 是一个独立包，通过 dsh.bundle 安装，无需修改 DSH 仓库。它由 jackie-cqz 维护，当前版本为 v0.1.1，采用 MIT 许可证。

核心功能¶

Jev 原语工具化：将 Jev 的三个核心原语暴露为 DSH 工具。
- noul：用于是/否判断，返回概率值（0-1）。
- choice：用于选择标签，返回选中的标签、概率分布和置信度。
- score：用于有序评分，返回分数、概率分布和置信度。
配置化护栏与审查：
- Guardrails：提供风险拦截机制，可在工具执行前进行安全审查。
- Review：提供执行后的审查机制，可对已完成的结果进行修正。
Web UI 结果展示：支持在 Web 界面展示结果卡片。

安装与启用¶

安装前需确认环境兼容性：Node.js 版本要求 >= 22，DSH 目标版本范围为 ^0.1.6-alpha.2 至 ^0.2.1-alpha.2。

1. 初始化 Web 配置（如需 Web UI）¶

如果使用 Web 界面，需先初始化配置文件：

dsh --profile jev-dev --from-default-profile web --dump-config

2. 添加插件¶

通过 GitHub 添加插件（指定版本标签以锁定版本）：

dsh plugin --profile jev-dev add github:jackie-cqz/dsh-jev-plugin#v0.1.1

安装完成后，插件会自动注册 decide 和 evaluate 工具（可通过配置项 enableDecide 和 enableEvaluate 控制是否注册）。

配置与用法¶

插件依赖 TypeSafe API Key，并通过配置项控制功能开关。

基础配置¶

必须配置 API 密钥，支持直接设置或通过环境变量 TYPESAFE_API_KEY。

{
  "apiKey": "YOUR_TYPESAFE_API_KEY",
  "apiKeyEnv": "TYPESAFE_API_KEY",
  "baseURL": "https://api.typesafe.ai/v1",
  "model": "jev-latest"
}

启用护栏¶

在工具执行前进行风险拦截。需设置 guard.enabled 为 true，并配置风险等级（如 ["low","medium","high","critical"]）。

{
  "guard": {
    "enabled": true,
    "tools": [],
    "denyAt": 3,
    "askAt": 1,
    "escalateOnLowConfidence": true
  }
}

启用审查¶

在工具执行后进行结果修正。需设置 review.enabled 为 true，并配置修正概率阈值。

{
  "review": {
    "enabled": true,
    "blockAt": 0.8,
    "onError": "accept"
  }
}

启用离线规则¶

在无 API 调用的情况下，通过正则表达式进行同步拦截。

{
  "rules": {
    "enabled": true,
    "tools": [],
    "deny": []
  }
}

适用场景与注意事项¶

该插件适用于需要结构化决策输出、严格风控或强制审查机制的 DSH 项目。由于是独立包，安装前建议检查源码与许可证（MIT）。

技术栈：Node.js >= 22。
依赖：需要 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools 的兼容版本。
目录页：dsh-jev-plugin - 技能云目录
源码地址：github.com/jackie-cqz/dsh-jev-plugin