dsh-approval-ai:面向 DSH 审批请求的 AI 辅助回答插件

前言

DSH 强调「一切皆插件」,智能体工作流里的审批、路由、工具执行都可以由插件接入。审批请求通常出现在需要额外确认的操作前;如果希望模型先给一次评估,又不能让它自行创建新的审批触发器、读取项目文件或凭据,就需要一个边界更窄的插件。

dsh-approval-ai 针对这个场景:它回答 DSH 已经创建的 approval/request 事件,使用统一的 ctx.llm 路由做一次最小评估,并在异常情况下 fail closed。社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。

下面介绍这个插件的定位、功能、安装和用法。

这是什么

dsh-approval-ai 是一个 DSH 插件,用于在已有审批流程上增加 AI 辅助回答。仓库名为 ang-XWBWZ/dsh-approval-ai,npm 包名为 @llangtop/dsh-approval-ai,许可证为 MIT

它不创建审批触发器,只处理 DSH 已经创建并送达给它的审批事件。适合希望把审批评估限制在请求本身、且不引入额外数据读取的 DSH 使用场景。

核心功能

  • 使用 ctx.llm 路由回答已创建的 DSH approval/request 事件。
  • 默认路由为 provider deepseek-official,model deepseek-v4-flash;也可以使用 DSH 当前注册的其它 provider 路由。
  • 支持 ai-onlyai-then-humanhuman-only 三种模式。
  • 当结果为 deny、high/critical 风险、review、输出格式异常、缺少路由、取消、超时或 provider 错误时,采用 fail closed。
  • 注册 DSH /approval-ai 命令,可显示状态、切换 provider/model/mode、启用、禁用和重置用户覆盖配置。
  • 注册 approval-ai 设置命名空间;当 DSH 宿主开放该命名空间时,可提供 Web 设置卡片。
  • 不读取项目文件、会话历史、工具 schema、凭据或主系统提示。
  • 模型需要返回 decisionriskreason;没有 tool calls 可用。
  • 不提供审批结果缓存、永久授权或多模型仲裁。

安装与启用

安装到指定的 DSH profile 时,使用 npm 包 @llangtop/dsh-approval-ai@next 标签:

pnpm dsh plugin --profile approval-ai add @llangtop/dsh-approval-ai@next

经过上面的步骤后,插件会注册 approval-ai 设置命名空间和 /approval-ai 命令。启用自动 AI 审批时,执行:

/approval-ai enable

这会启用 ai-only 模式。若只想让人工处理,执行:

/approval-ai disable

disable 不会卸载插件,而是将插件切换到 human-only,把审批请求交由人工处理。

典型用法

在 DSH 中使用以下命令:

/approval-ai
/approval-ai enable
/approval-ai disable
/approval-ai mode ai-only
/approval-ai mode ai-then-human
/approval-ai mode human-only
/approval-ai provider <id>
/approval-ai model <id>
/approval-ai reset

各命令作用如下:

1、/approval-ai:显示当前 providermodelmodefailClosed
2、/approval-ai enable:启用自动 AI 审批,对应 ai-only
3、/approval-ai disable:禁用 AI 审批,对应 human-only
4、/approval-ai mode <mode>:切换到 ai-onlyai-then-humanhuman-only
5、/approval-ai provider <id>:选择 DSH 当前注册的 LLM provider 路由。
6、/approval-ai model <id>:选择该 provider 路由提供的模型。
7、/approval-ai reset:清除本插件的用户覆盖配置。

选择 provider 和 model 时,provider 必须是 DSH 当前已注册的路由,model 必须由该路由提供。

适用场景与注意

适合以下场景:

  • 已有 DSH 审批请求,希望模型先给一次辅助评估。
  • 不希望插件自行创建审批触发器或扩大数据读取范围。
  • 希望在异常情况下自动 fail closed,而不是放行。
  • 希望通过 /approval-ai 命令快速调整 provider、model 和 mode。

需要注意:

  • 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证;本插件许可证为 MIT
  • Web 设置卡片可能不出现,因为 DSH Web 宿主可能通过固定 allowlist 过滤设置命名空间;在宿主提供可扩展的设置注册机制前,使用 /approval-ai 命令完成配置。
  • disable 不是卸载插件,只是切换到 human-only
  • 插件不提供审批结果缓存、永久授权或多模型仲裁。
  • 默认 provider 是 deepseek-official,默认 model 是 deepseek-v4-flash;切换时仍需满足 DSH 路由注册和模型可用性要求。

链接

  • GitHub 仓库:https://github.com/ang-XWBWZ/dsh-approval-ai
  • npm 包名:@llangtop/dsh-approval-ai
  • 社区目录可按插件名 dsh-approval-ai 查询;目录为独立站点,与 DeepSeek / 幻方无官方从属关系。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜