前言¶
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,modeldeepseek-v4-flash;也可以使用 DSH 当前注册的其它 provider 路由。 - 支持
ai-only、ai-then-human和human-only三种模式。 - 当结果为
deny、high/critical 风险、review、输出格式异常、缺少路由、取消、超时或 provider 错误时,采用 fail closed。 - 注册 DSH
/approval-ai命令,可显示状态、切换 provider/model/mode、启用、禁用和重置用户覆盖配置。 - 注册
approval-ai设置命名空间;当 DSH 宿主开放该命名空间时,可提供 Web 设置卡片。 - 不读取项目文件、会话历史、工具 schema、凭据或主系统提示。
- 模型需要返回
decision、risk和reason;没有 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:显示当前 provider、model、mode 和 failClosed。
2、/approval-ai enable:启用自动 AI 审批,对应 ai-only。
3、/approval-ai disable:禁用 AI 审批,对应 human-only。
4、/approval-ai mode <mode>:切换到 ai-only、ai-then-human 或 human-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 / 幻方无官方从属关系。