前言¶
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 / 幻方無官方從屬關係。
