DeepSeek Harness (DSH) 負責執行任務，但在處理長對話或複雜工作流時，原始的日誌界面往往難以快速定位關鍵信息或進行分支探索。dsh-atlas 提供了一個可視化的會話工作區，將 DSH 的會話日誌轉化爲卡片和分支，讓長會話變得易於理解、組織和繼續。
定位與原理¶
dsh-atlas 是一個運行在 DeepSeek Harness Web 環境下的客戶端插件。它以 DSH 會話日誌爲單一事實來源，不重複或重寫原有的聊天系統，而是作爲一個視覺層構建在 DSH 之上，幫助開發者梳理會話結構。
安裝與啓用¶
安裝插件需要 Node.js 環境。請執行以下命令將插件添加到 DSH Web 配置中，隨後啓動 Web 服務：
npx @deepseek-ai/dsh plugin --profile web add github:sumarilkkxx/dsh-atlas
npx @deepseek-ai/dsh web
DSH Web 默認會在 http://127.0.0.1:3080 啓動。在設置中配置模型並選擇工作區後，點擊頂部導航欄的 Card View 即可進入可視化工作區。
核心功能¶
會話可視化與組織¶
插件將用戶消息、模型響應和工具活動投影爲卡片。每個主要會話擁有獨立的畫布。在畫布上可以拖拽卡片、平移視圖或縮放（50% 到 400%），並能自動排列節點、定位活動卡片或摺疊下游卡片。
分支與實時狀態¶
每輪對話生成一張卡片。從任意答案分支會使用原生 DSH Fork，保持上下文關係。卡片會實時顯示準備、推理、工具調用和生成過程。一旦完成，持久化的 DSH 歷史記錄成爲權威狀態，防止出現過時的“Thinking”狀態。
工具與性能指標¶
詳情視圖保留原始工具事件順序，並嵌入 ECharts、Mermaid 和沙盒渲染畫布。每張卡片聚合展示 LLM 時間、首 token 時間、token 率、緩存命中率以及輸入/輸出 token 數，但不暴露單個模型調用的詳細拆解。
原生輸入能力¶
Atlas 讀取 DSH 完整的模型目錄，支持原生選擇模型、推理級別、權限預設、斜槓命令、文件和技能。從畫布發起的新會話或後續對話，擁有與原生 DSH 相同的會話級權限和上下文能力。
信息組織¶
可以通過搜索會話和卡片來梳理長運行的工作。支持將卡片標記爲 Important、Key Conclusion 或 Needs Verification 狀態，以快速識別關鍵結論或需要驗證的內容。
使用示例¶
- 瀏覽與操作：啓動 DSH Web 後，點擊頂部導航欄的 Card View。在畫布上拖拽卡片、平移視圖或使用鼠標滾輪縮放（範圍 50% 至 400%）。
- 分支對話：從任意答案卡片出發，使用原生 DSH Fork 功能創建分支，繼續探索不同的對話路徑。
- 執行命令：通過菜單或鍵盤選擇斜槓命令（如
/compact）併發送，系統會生成獨立的命令卡片。 - 標記重點：將完成的卡片標記爲 Important、Key Conclusion 或 Needs Verification，以便後續快速回顧。
數據與限制¶
數據所有權¶
dsh-atlas 僅存儲輔助數據（佈局、狀態、摘要），DSH 擁有原始的執行歷史和對話記錄。刪除 Atlas 畫布上的卡片不會影響原始 DSH 對話。
文件解析限制¶
附件在瀏覽器本地解析。支持 PDF、DOCX、XLSX、CSV 以及常見的代碼和配置文件。存在以下限制：
* 單文件大小：12 MB
* 總文件大小：24 MB
* 單文件提取字符數：48,000 字符
* 總提取字符數：96,000 字符
依賴說明¶
對話詳情中的圖表和視覺工件由可選的 dsh-artifact 插件生成。Atlas 僅負責掛載和顯示這些工具輸出。
結語¶
dsh-atlas 將原始的會話日誌轉化爲可管理的卡片工作區，通過原生 DSH Fork 和實時狀態保持與核心系統的緊密聯繫。它適合需要在長時間會話中梳理邏輯、組織工具輸出或進行分支實驗的開發者。
