dsh-decisions-classifiers: OpenAI Decisions API Classifiers for DeepSeek Harness

前言¶

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 多选提示旁显示分类器意见，允许用户一键采纳分类结果。

分类器库¶

插件内置了一套分类器，涵盖了常见的安全与业务场景：

对于上述列表之外的需求，可以使用 decisions_ask 直接发送任意类型的问题。

安装¶

插件通过本地路径安装。请确保你有该目录的访问权限。

dsh plugin --profile <profile> add /absolute/path/to/dsh-decisions-classifiers

配置¶

安装后，所有字段均可通过 Settings 页面配置，配置持久化到 ~/.dsh/decisions-classifiers/config.json。Settings 中的设置优先级低于 bundle 行设置，且支持实时覆盖。

使用流程¶

启用插件并配置 API Key 后，使用步骤如下：

1. 安装插件（见上方安装命令）。
2. 打开 Settings → Decisions Classifiers。
3. 粘贴 OpenAI API Key，点击 Store key。
   • Key 通过 DSH 凭证缝隙写入环境变量 OPENAI_API_KEY（或你设置的名称），页面不会读取回 Key。
   • 也可以直接在进程环境变量或 .env 文件中设置 OPENAI_API_KEY。
4. 点击 Test connection 确认连接正常。
5. 在智能体配置中开启 gateEnabled（若需使用调用门）。

注意事项¶

• 默认行为：安装此插件后，除非在 Settings 中手动开启调用门，否则不会改变任何智能体的现有行为。
• 凭证安全：Key 仅写入环境变量，不会在界面上显示，请妥善保管配置文件。
• 模型限制：当前 Decisions API 仅提供 gpt-6-luna 模型。