前言¶
DeepSeek Harness (DSH) 支持通過插件擴展能力，但社區生態龐大，插件來源、依賴與代碼邏輯的未知風險較高。DeepAtlas (dsh-deepatlas) 是一個任務感知型插件導航工具，幫助 DSH 用戶掃描生態、按任務推薦插件、安裝前審計風險，並僅在用戶明確同意後執行受控安裝。
核心功能¶
DeepAtlas 提供以下能力：
* 任務感知導航：根據跨會話記憶、消息接入、瀏覽器自動化等能力需求，掃描並推薦候選插件。
* 生態掃描：從 GitHub 與社區來源掃描 dsh-plugin 生態，建立本地索引。
* 來源與證據：基於 provenance 推薦插件，並在完整 commit 下讀取 manifest、README 等證據。
* 安裝前審計：檢查生命週期腳本、依賴形態、native 依賴、bundle patch 源碼風險及 Node 兼容性。
* 受控安裝：安裝前創建 profile 快照，失敗時觸發恢復流程，僅支持明確授權的安裝。
* 本地存儲：索引、審計記錄和安裝狀態保存在本地，GitHub Token 僅用於提高 API 配額。
安裝與啓用¶
DeepAtlas 處於 public preview 階段，需要 DeepSeek Harness 0.1.1-rc.1 / 0.1.1-rc.2 及 Node.js ^22.19.0 || >=24.0.0。DSH 的插件管理命令會轉發給 pnpm。
1. 安裝插件¶
使用官方安裝命令添加插件：
dsh plugin --profile web add https://codeload.github.com/Oscar-Williams/dsh-deepatlas/tar.gz/refs/tags/v0.2.3
2. 覈對配置¶
安裝完成後，檢查配置是否生效：
dsh --profile web --dump-config
輸出中應出現 dsh-deepatlas 或 deepatlas 配置層。
3. 啓用真實安裝¶
默認情況下 dryRun=true，僅生成計劃。若需真實安裝，需在 profile 配置中覆蓋 deepatlas 配置項：
- id: deepatlas
config:
dryRun: false
典型用法¶
DeepAtlas 提供六個工具：deepatlas_scan、deepatlas_status、deepatlas_find、deepatlas_advise、deepatlas_audit、deepatlas_install。推薦流程爲：狀態檢查 -> 掃描 -> 檢索 -> 審計 -> 確認 -> 安裝。
1. 描述任務並檢索¶
在 DSH 中直接描述需求，宿主模型會調用相應工具。例如：
* “我想給 DSH 增加跨會話記憶，幫我比較合適的插件。”
* “找一個 Telegram 消息接入插件，先列候選和風險信號。”
2. 審計指定 commit¶
在選定候選後，檢查指定 commit 的審計結果：
* “檢查這個插件的指定 commit；展示審計結果後再詢問我是否安裝。”
3. 執行安裝¶
用戶確認後，DeepAtlas 會執行靜態審計、兼容檢查、快照、鎖定安裝與恢復流程。
適用場景與注意¶
- 適用場景：需要爲 DSH 補充特定能力（如記憶、自動化）時，快速篩選安全候選；在安裝陌生插件前，進行詳細的代碼級審計。
- 權限與安全：插件以當前 DSH 進程權限運行。索引、審計記錄保存在本地，請確保
DEEPATLAS_GITHUB_TOKEN環境變量配置正確。 - 當前狀態：DeepAtlas 處於 public preview，DeepSeek Harness 處於 Developer Preview。
結語¶
DeepAtlas 爲 DSH 插件生態引入了能力覆蓋檢查與風險審計機制，讓插件導航從“盲目選擇”變爲“證據化決策”。更多細節可參考其目錄頁或GitHub 倉庫。
