前言¶
DeepSeek Harness（DSH）採用插件化架構，用戶權限與配置都由插件引入。管理這些插件時，需要確認當前環境是否存在風險（如高危代碼注入、權限濫用）。dsh-security-doctor 作爲一個 DSH Web 界面插件，通過側欄的「安全體檢」按鈕，提供一鍵本地安全檢查功能。
插件簡介¶
名稱：dsh-security-doctor
維護者：ChenChen913
分類：admin-security
定位：DSH Web 界面的一鍵安全體檢工具。
該插件的核心價值在於「只讀」與「零外發」。它不執行被檢查對象的任何代碼，默認不發送任何數據到外部，也不需要 API Key。通過靜態掃描與配置審計，幫助用戶快速定位環境中的安全隱患。
核心功能¶
插件提供分級報告、AI 深審與實驗性守護模式三項核心能力。
分級報告¶
報告採用結論前置的設計。高危問題會直接彈出卡片，說明具體插件、原因及處理建議，技術細節摺疊收底。報告包含環形評分（0-100）、中英雙語、修復處方單，並支持導出 JSON 或複製 Markdown。
AI 深審¶
對於可疑插件，插件提供「AI 深審」功能。用戶可以一鍵複製結構化的深審提示詞，通過剪貼板閉環交給自己的 Agent 審查，結論粘貼回填。此過程零 API 調用，完全本地進行。
守護模式（實驗性）¶
守護模式默認關閉，開啓後插件從「醫生」變爲「監護儀」。它提供兩重保護：
1. 出站審計：監控插件發起的 HTTP/HTTPS 請求，記錄「插件 → 域名 → 方法 → 是否含憑據特徵」。數據存儲在內存環形緩衝區（50條），載荷內容永不記錄。
2. 變更哨兵：每 45 秒快照 ~/.dsh 補丁/配置及指令文件。檢測到變更時亮起角標，列出變更文件。
安裝與啓用¶
安裝插件後，必須重啓 dsh web 才能生效（運行中的實例不熱加載）。
安裝命令¶
dsh plugin --profile web add github:ChenChen913/dsh-security-doctor#v1.1.0
驗證安裝¶
安裝完成後，側欄應出現「安全體檢」按鈕。也可以通過命令行驗證：
curl -H 'x-dsh-security-doctor: 1' http://127.0.0.1:3080/dsh-security-doctor/self-test
返回 ok:true 即表示安裝成功。
檢查項詳解¶
插件對以下內容進行掃描與分級：
!!js表達式：掃描~/.dsh中的 cordis 補丁/配置，檢測!!js寫法（加載時會被執行）。- 安全層補丁：檢查
remove:/replace:指向 approval / sandbox / permission 等防護插件的情況。 - 第三方插件盤點：盤點各 profile 依賴，區分官方與外來插件，標註未鎖定的 git 引用與
postinstall腳本。 - 出網與意圖特徵：靜態掃描外來插件源碼，識別外聯域名、
eval/base64 混淆特徵。若同一文件同時出現「憑據訪問」與「外聯」，評級升級爲高危。 - 憑據文件權限：檢查
~/.dsh/.credentials.yaml的權限位與 ACL 賬戶名。只看權限，永不讀內容。 - 指令文件：掃描
AGENTS.md/CLAUDE.md/.cursor/rules/等，通過 SHA-256 哈希比對跨次變更。 - 端點配置：檢查配置中的
baseURL與環境變量DEEPSEEK_BASE_URL（僅顯示主機名）。 - 防護服務與策略：檢查服務裝載與實際策略值，如審批
never或danger-full-access預設，以及DSH_PERMISSION_MODE的會話級覆蓋。
守護模式注意事項¶
守護模式屬於實驗性功能，使用時需注意其邊界：
* 不覆蓋範圍：不監控 fetch 與原始套接字；審計歸屬按調用棧盡力推斷，高級代碼可僞造。
* 盲區：輪詢間隙（45秒）內的快速變更不可見；大文件僅記錄大小和 mtime。
* 卸載即回滾：關閉開關立即停用，卸載插件會恢復原始模塊導出。
適用場景與注意事項¶
該插件適合需要頻繁管理 DSH 插件、關注本地環境安全性的開發者。
使用前提¶
安裝前應檢查源碼與許可證，因爲插件以 DSH 進程的權限運行。
重要提示¶
- 必須重啓：安裝或更新後必須重啓
dsh web，否則無法生效。 - 靜態掃描侷限：靜態掃描是初篩，未見異常不代表絕對安全（如混淆編碼、運行時拼接地址無法檢測）。
- 權限位限制：POSIX 權限位檢查不等於完整的 ACL 細節。
結語¶
dsh-security-doctor 通過分級報告和 AI 深審，降低了智能體開發環境的安全排查成本。對於希望在不離開 DSH Web 界面情況下進行安全審計的用戶，這是一個實用的輔助工具。
