前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许通过社区插件扩展功能。智能体在开发过程中常需要对文本内容进行分类或判断，例如检测有害内容、识别敏感信息或评估操作意图。OpenAI Decisions API (gpt-6-luna) 提供了针对文本和图像的断言、选择和评分能力，而非生成自然语言。dsh-decisions-classifiers 插件将 Decisions API 集成到 DSH 的工具链和服务中，使智能体能够直接使用结构化的分类决策。
核心能力¶
该插件在 DSH 生态中提供了四个主要层面的集成：
- Agent 工具：在智能体上下文中直接提供工具调用能力，包括
decisions_classify（调用内置分类器）、decisions_ask（发起任意类型的结构化问答，每请求约 10 个问题）以及decisions_status。 - Cordis 服务：对外提供
decisionsClassifiers服务，包含listPresets、classify、ask和status方法，供其他插件调用。 - 可调用门：提供一个可选的预执行门控机制。默认关闭，开启后会在
run_code、bash、write、edit等操作执行前自动进行分类，并根据阈值决定是拒绝执行还是升级处理。 - 建议卡片：在 UI 的
ask_user_question多选提示旁显示分类器意见，允许用户一键采纳分类结果。
分类器库¶
插件内置了一套分类器，涵盖了常见的安全与业务场景：
| 分类器 ID | 类型 | 功能描述 |
|---|---|---|
moderation |
断言 | 判断内容是否违反标准可接受使用政策 |
prompt-injection |
断言 | 判断文本是否试图操纵 AI 系统而非告知读者 |
dangerous-command |
断言 | 判断命令是否不可逆地破坏数据或更改机器级状态 |
pii |
断言 | 判断文本是否识别出真实个人 |
relevance |
断言 | 判断文本与查询的相关性（需传入 context） |
severity |
评分 | 返回从“美观/变通方案可用”到“完全阻止”的概率分布 |
intent |
选择 | 返回分类结果（如账单/技术/发货/其他）及完整概率分布 |
对于上述列表之外的需求，可以使用 decisions_ask 直接发送任意类型的问题。
安装¶
插件通过本地路径安装。请确保你有该目录的访问权限。
dsh plugin --profile <profile> add /absolute/path/to/dsh-decisions-classifiers
配置¶
安装后，所有字段均可通过 Settings 页面配置，配置持久化到 ~/.dsh/decisions-classifiers/config.json。Settings 中的设置优先级低于 bundle 行设置，且支持实时覆盖。
| 配置项 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
主开关 |
baseUrl |
https://api.openai.com/v1 |
API 基础地址，插件会自动追加 /decisions 路径 |
model |
gpt-6-luna |
当前 Decisions API 唯一支持的模型 |
apiKeyEnv |
OPENAI_API_KEY |
凭证缝隙引用名称 |
timeoutMs |
60000 |
每次请求的超时时间 |
defaultThreshold |
0.5 |
当预设分类器未覆盖时的断言阈值 |
advisorEnabled |
true |
是否启用建议卡片 |
gateEnabled |
false |
是否启用预执行调用门（默认关闭） |
gatePreset |
dangerous-command |
调用门使用的分类器预设 |
gateThreshold |
0.5 |
调用门的拒绝阈值 |
gateDecision |
deny |
调用门触发后的决策：拒绝或升级 |
systemPromptSection |
true |
是否在智能体系统提示词中告知其拥有分类器能力 |
使用流程¶
启用插件并配置 API Key 后，使用步骤如下：
- 安装插件（见上方安装命令）。
- 打开 Settings → Decisions Classifiers。
- 粘贴 OpenAI API Key，点击 Store key。
- Key 通过 DSH 凭证缝隙写入环境变量
OPENAI_API_KEY（或你设置的名称），页面不会读取回 Key。 - 也可以直接在进程环境变量或
.env文件中设置OPENAI_API_KEY。
- Key 通过 DSH 凭证缝隙写入环境变量
- 点击 Test connection 确认连接正常。
- 在智能体配置中开启
gateEnabled（若需使用调用门）。
注意事项¶
- 默认行为：安装此插件后，除非在 Settings 中手动开启调用门，否则不会改变任何智能体的现有行为。
- 凭证安全：Key 仅写入环境变量，不会在界面上显示，请妥善保管配置文件。
- 模型限制：当前 Decisions API 仅提供
gpt-6-luna模型。
