前言¶
做 DeepSeek Harness（DSH）插件時，常見需求不是重新實現一套安全工具，而是讓智能體工作流能直接調用已有 CLI，並拿到結構化結果。SecurStack DSH 插件面向這個場景：它在 DeepSeek Harness 中調用 securstack CLI，用於倉庫安全掃描、策略檢查、本地診斷，並在 CLI 承諾 JSON 輸出時返回可解析的 JSON 結果。
這是什麼¶
- 倉庫名：
securstack/securstack-dsh-plugin - npm 包名：
@securstack/dsh-plugin - 維護方：
securstack - 定位：DeepSeek Harness plugin，用於 SecurStack security scans、policy checks、doctor diagnostics 和 JSON CLI results
- 許可證：
MIT
這是一個適配器：插件不負責實現掃描引擎、加密、上傳邏輯、API 契約或 Shielding 操作。v1 階段的設計目標是避免破壞性鉤子、Shielding 寫入，以及重複實現產品契約。
核心功能¶
下面介紹插件在已覈實資料中列出的能力：
- 倉庫安全掃描：通過
securstack scan --format json獲取倉庫掃描結果。 - 策略門檻：通過
securstack policy check做類似 CI 的 pass/fail 判斷。 - 本地診斷：通過
securstack doctor檢查本地設置和憑據問題。 - 結構化響應：在 CLI 承諾 JSON 輸出時，返回 Harness-friendly 的 parsed JSON 結果。
- 複用已有認證：支持
securstack login、SECURSTACK_API_KEY，以及可選的SECURSTACK_API_URL。 - 保守邊界：v1 避免 destructive hooks、Shielding writes，以及 duplicated product contracts。
安裝與啓用¶
先確認運行環境：需要 Node.js 20 或更新版本，並處於 DeepSeek Harness developer preview。SecurStack 憑據可以通過命令行登錄提供，也可以通過環境變量提供。
命令行登錄示例：
securstack login --api-key <key>
如果使用環境變量，需要配置：
SECURSTACK_API_KEY=<key>
SECURSTACK_API_URL=<url>
其中 SECURSTACK_API_URL 是可選配置項；具體值按你的 SecurStack 環境填寫。
配置完成後，安裝插件：
dsh plugin --profile securstack add @securstack/dsh-plugin
這條命令會把 @securstack/dsh-plugin 添加到 securstack profile 下，供 DeepSeek Harness 工作流調用 SecurStack CLI 能力。
典型用法¶
下面三個提示來自已覈實資料，可以直接用於 DeepSeek Harness：
Run a SecurStack scan on this repository and summarize critical findings.
這個提示用於對當前倉庫執行 SecurStack 掃描，並總結 critical findings。
Check whether the last SecurStack scan passes the repository policy.
這個提示用於判斷最近一次 SecurStack 掃描是否滿足倉庫策略。
Run SecurStack doctor and tell me what is misconfigured.
這個提示用於執行 securstack doctor，並說明哪些配置項存在問題。
適用場景與注意¶
適合在以下場景評估：
- 希望把 SecurStack 掃描、策略判斷和本地診斷納入 DeepSeek Harness 工作流。
- 需要 Harness 讀取 CLI 的 JSON 結果，而不是讓插件重新實現掃描邏輯。
- 團隊已有 SecurStack 賬號、API key 或 CLI 使用習慣。
注意：
- 插件以當前 DSH 進程權限運行，並使用該進程可訪問的憑據和環境。
- 安裝前應檢查源碼、
MIT許可證、依賴範圍，以及你所在組織的安全要求。 - v1 是 adapter，不包含 scan engines、encryption、upload logic、API contracts 或 Shielding operations。
- 公開版本發佈需要以
securstack賬號在 npm 和 GitHub 完成認證；個人賬號不應發佈或推送公開版本。
DSH 插件生態強調“一切皆插件”；社區目錄是獨立站點，不應理解爲 DeepSeek 或幻方的官方應用商店，也不代表與 DeepSeek / 幻方存在官方從屬關係。
鏈接¶
- 社區目錄頁：當前已覈實資料未提供明確 URL，可在 DSH 插件社區目錄中按插件名檢索。
- GitHub：https://github.com/securstack/securstack-dsh-plugin
