在 DeepSeek Harness (DSH) 環境下開發智能體時，手動複製粘貼 API 密鑰是高頻操作。這種操作極易導致密鑰泄露進日誌或模型上下文。DSH 本身不提供針對粘貼行爲的攔截機制。
下面介紹 dsh-airbag，這是一個非侵入式安全插件，用於攔截粘貼給 Agent 的 API 密鑰、追蹤泄露事件、阻止密鑰寫入，並提供首次工作區安全體檢。
插件定位¶
dsh-airbag 是由開發者 uwu9039 維護的管理安全類插件（MIT 許可證）。它的核心價值在於在 DSH 生態中構建一層針對密鑰的安全防護網，通過檢測粘貼和寫入行爲，防止敏感信息意外暴露。
核心功能¶
插件主要包含以下幾類安全能力：
- 粘貼攔截（A1）：在用戶向輸入框粘貼內容時同步檢測。內置 45+ 種密鑰模式（DeepSeek、OpenAI、AWS、GitHub PAT、JWT、PEM 私鑰等），支持按設置執行阻止、脫敏或警告操作。所有判定在客戶端完成，明文密鑰不會發送給模型。
- 寫入攔截（A2）：檢測模型在執行工具調用（如
write、edit、bash、run_code）時是否攜帶密鑰參數。提供硬攔截或轉交原生審批通道兩種處置方式。 - 審批疲勞洞察（B）：作爲原生審批鏈的觀察者，統計決策耗時，標記“盲批”（<2s 授予）與“疲勞時段”（30 分鐘內密集批准）。
- 邊角通知中心（G1）：提供四級通知（L0 靜默、L1 角標、L2 Toast、L3 常駐），支持 5 分鐘窗口內同類事件聚合與全局免打擾。
- 首次安全體檢（G6）：對工作區進行只讀掃描，檢查
.env文件、憑據文件、內嵌密鑰等，僅報告掩碼片段。 - 隱私優先：明文密鑰永不落盤、不入日誌、不入遙測。僅持久化掩碼片段（如
sk-0***cdef）與 SHA-256 前綴。
安裝與啓用¶
使用 npm 安裝插件，安裝完成後重啓 DSH Web 界面。
dsh plugin --profile web add dsh-airbag
安裝成功後，DSH 界面右下角會出現 🛡️ Airbag 按鈕。首次運行時，按鈕帶有角標，提示進行安全體檢。
典型用法¶
- 打開面板：點擊右下角的 🛡️ 按鈕。
- 執行體檢：在面板的“體檢”標籤頁輸入工作區路徑，運行只讀安全掃描。
- 配置攔截策略：在“設置”標籤頁配置默認處置方式（阻止 / 脫敏 / 警告）及通知級別。
- 自定義規則：插件支持自定義規則。配置文件位於
~/.dsh/airbag/rules.yaml。
示例配置如下：
- pattern: 'INT_[A-Z0-9]{12}'
label: 內網 Token
action: block
severity: high
notice: 3
注意事項¶
- 系統要求：運行插件需要 Node.js
^22.19 || >=24及pnpm環境。 - 隱私機制：請確認插件配置中的隱私優先策略生效，明文密鑰不會被存儲。
- 職責邊界：讀取方向的內容脫敏由
dsh-guardian插件負責，dsh-airbag僅關注粘貼和寫入攔截。 - 卸載：如需移除，執行
dsh plugin --profile web remove dsh-airbag。
dsh-airbag 通過攔截粘貼和寫入行爲，結合體檢功能，爲 DSH 工作流提供了一層基礎的安全防護。開發者可以根據實際需求配置攔截策略。更多細節與源碼，請參考 GitHub。
