前言¶
DeepSeek Harness（DSH）的生態設計強調「一切皆插件」。在開發過程中，管理文件引用、技能調用、歷史會話和插件狀態往往需要分散的操作入口。dsh-atlas 插件旨在解決這一碎片化問題，通過一個統一的 @ 觸發器，將所有資源類型集中到一個菜單中。
這是什麼¶
dsh-atlas 是一個 DSH 客戶端插件，核心口號是 “AT Last, All Sources. One @ . Jump anywhere.”。
它爲 DeepSeek Harness 的 Web GUI 提供統一的 @ 提及功能，允許用戶在一個菜單中訪問：
* 工作區文件和文件夾
* 可發現技能
* 歷史會話
* 已安裝插件
* 工作區 Git 變更
* 第三方插件註冊的自定義類別
插件通過元數據注入引用標記，而非直接注入文件內容，從而保持引用的輕量化和可控性。所有者：jameswatt139240-crypto，許可證：MIT。
核心功能¶
統一資源菜單¶
輸入 @ 即可觸發菜單，包含五個內置分類以及一個內置的 @git 分類（用於查看工作區變更）。第三方插件可以通過註冊機制將自己的類別添加到同一個菜單中。
引用機制與約束¶
- 元數據注入：引用通過標記（如
<workspace-reference>,<skill-reference>）注入，插件讀取目錄元數據，Agent 在需要時纔讀取文件本身。 - 約束管理：插件對版本和配置有約束管理能力，確保環境一致性。
工作區 Git 集成¶
內置 @git 分類，用於查看工作區的文件變更（路徑 + 增刪行數），提供變更追蹤能力。
安裝與啓用¶
安裝前需確保已安裝帶有 web profile 的 DSH。
dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
安裝或更新後，重啓 dsh web 以確保 Host 和瀏覽器客戶端加載相同版本。
典型用法¶
觸發菜單¶
在編輯器中輸入 @ 即可喚起包含所有類別的菜單。
分類前綴與快捷鍵¶
不同資源類型使用特定前綴和快捷鍵：
* file: - 文件 (F)
* folder: - 文件夾 (D)
* skill: - 技能 (S)
* chat: - 歷史會話 (C)
* plugin: - 插件 (P)
搜索與過濾¶
- 快速搜索：輸入字母可快速搜索所有類別。
- 範圍限定：使用文件夾引用限定文件搜索範圍。例如
@e:/work/docs/ @file:將限定搜索該目錄下的文件。 - 會話切換：點擊會話引用可直接切換當前會話。
適用場景與注意¶
適用場景¶
適合需要在一個界面中頻繁切換不同類型資源（文件、技能、對話、Git 變更）的開發者或智能體工作流。
兼容性注意¶
- 互斥性：該插件與
dsh-at-file互斥，只能安裝其中一個，不能同時運行。 - 配置要求：配置中必須提供
scopes和testedOn。 - 內存限制：引用和步驟有嚴格的內存預算限制（16 KiB/引用，48 KiB/步驟）。
- 權限與安全：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-atlas 通過統一的 @ 觸發器和元數據驅動的引用機制，爲 DSH 提供了一個集中式的資源導航入口。它支持 Git 變更查看和第三方擴展，旨在簡化智能體開發中的資源管理流程。
