前言¶
DeepSeek Harness (DSH) 是一个以插件为单位的模型推理平台。将 System One 决策模型（Jev）接入 DSH 时，开发者面临一个结构性难题：Jev 本身不生成文本，它接收 state 和类型化问题，返回类型化答案与置信度，接口并非 Chat Completions 或 Anthropic Messages。这意味着它不能作为主模型，只能作为工具挂载。
kaijia323/dsh-plugin-jev 解决了这个问题。它将 TypeSafe Jev 注册为 DSH 的原生工具 jev_decide，通过零依赖的方式接入 DSH 强制 JSON Schema 子集，并自动声明触发策略。
核心功能¶
原生工具注册¶
插件通过 ctx.tools.register 注册一个名为 jev_decide 的原生工具。该工具符合 DSH 强制 JSON Schema 子集（JsonSchemaNode），不走 MCP 的注册路径，而是直接注册到工具目录中。
零依赖实现¶
插件不依赖任何 @deepseek-ai 包，仅使用 DSH 提供的上下文 API 进行注册。这保证了插件的轻量级和独立性。
触发策略声明¶
为了解决“插件已装、工具可调用，但没人告诉模型什么时候该用它”的历史问题，插件在两个层面声明触发政策：
- A 面（工具描述）：
jev_decide.description以政策开头，包含用途、默认开判据、四条豁免、七个决策时刻、预算限制及返回形状。 - B 面（常驻政策段）：通过
ctx.inject(['systemPrompt'], cb)注册一个名为jev-decision-policy的 prompt section。该段在 web profile 的每个会话全局生效，无需模型主动“发现”工具。两者都由同一组 POLICY 常量拼装，确保一致性。
TypeSafe API 传输¶
插件仅支持官方 TypeSafe API 作为传输层。配置项 transport 必须设为 typesafe。插件负责将请求参数（state, questions）归一化为 noul 类型，并调用官方端点 POST {baseURL}/v1/systemone。
安装与启用¶
插件采用 bundle 层安装模式。包声明了 dsh.bundle.patch，安装后自动激活。
- 安装插件：
dsh plugin --profile web add /path/to/dsh-plugin-jev
- 配置参数：
插件支持配置传输类型、密钥、超时等参数。配置项包括transport、baseURL、model、apiKeyEnv、keyFile、timeoutMs、toolTimeoutMs、retries、maxStateBytes、maxQuestions和policySection。
注意事项：
* 配置冲突：安装前必须删除配置层中已存在的同 id（tool-jev）行，避免出现配置层出现同 id 两行。
* 重启服务：使用 CLI 安装（dsh plugin --profile web add）后，需要重启 dsh web 进程才能生效，因为安装操作不会实时更新运行中的会话。
适用场景与说明¶
该插件适用于需要将 System One 决策逻辑嵌入 DSH 工作流的场景。由于 Jev 不生成文本，它主要用于需要类型化答案和置信度校准的决策任务。
- 返回类型：插件不生成文本，返回类型化答案与校准置信度。
- 政策生效：B 面政策段在 web profile 的每个会话全局生效。
- 静态策略：政策是静态文本，不发起网络请求。
结语¶
kaijia323/dsh-plugin-jev 提供了将 TypeSafe Jev 接入 DeepSeek Harness 的标准路径，通过原生工具注册和自动策略声明，解决了决策模型在 LLM Seam 中的集成难题。
