前言¶
DeepSeek Harness（dsh）採用插件化架構，擴展能力通常通過安裝外部包實現。在 Agent 開發過程中，工具調用會產生文件（如 write 操作），這些文件分散在不同的會話中。若要回顧 Agent 在所有對話中產出的內容，需要在各個歷史會話間切換。下面介紹的 @kksw/dsh-my-files 是一個 Web 客戶端插件，它在 dsh 的側邊欄添加一個入口，集中展示所有會話中 Agent 創建或修改過的文件。
插件簡介¶
- 名稱：
@kksw/dsh-my-files - 維護者：kksw1024
- 定位：DeepSeek Harness Web 插件
- 核心價值：提供跨會話的文件索引與統一查看面板。
核心功能¶
該插件實現以下能力：
- 側邊欄入口：在側邊欄設置齒輪（Settings）上方新增“我的文件”入口，圖標爲文件夾，尺寸與風格與設置按鈕保持一致。
- 跨會話索引：自動記錄每個會話中工具調用創建或修改的文件（如
write等）。歷史會話在插件加載時會自動回放並補齊索引。 - 兩欄面板：面板採用左右分欄佈局。左側按會話列出，顯示會話名與文件數量；右側展示選中會話的文件列表。點擊面板外的灰色蒙版或關閉按鈕可退出面板。
- 文件交互：文件名支持懸停高亮與下劃線樣式。點擊文件名調用系統默認應用打開文件；點擊文件名後的文件夾圖標可打開文件所在目錄。
- 持久化：文件索引存儲於 dsh 的 storage 領域，重啓 dsh 後數據仍在。
安裝與啓用¶
在安裝前，需確保使用的是 DeepSeek Harness Web 版本，且 dsh 版本不低於 0.1.0-rc.5。
- 執行安裝命令：
dsh plugin --profile web add @kksw/dsh-my-files
- 重啓 dsh：
dsh --profile web
- 刷新瀏覽器頁面，在側邊欄底部（設置齒輪上方）即可看到“我的文件”入口。
典型用法¶
- 點擊側邊欄的“我的文件”打開面板。
- 在左側列表中選擇一個會話，右側面板會顯示該會話產出的文件。
- 點擊文件名即可在系統默認應用中打開文件；點擊文件名右側的文件夾圖標可打開文件所在目錄。
- 若需要更新索引（例如剛進行了新的工具調用），點擊面板右上角的刷新按鈕重新拉取。
注意事項與限制¶
- 索引範圍：僅統計工具調用明確聲明爲“創建/修改”的文件。通過終端命令間接創建的文件不計入索引。
- 冷會話回放：在冷會話回放場景下，僅註冊在某 Agent Preset 內的工具可能缺失 presenter，可能導致索引不完整（實時調用不受影響）。
- 信任邊界：查詢路由以
loopback爲信任邊界。 - 運行環境：文件打開與目錄跳轉依賴宿主環境的原生 opener（macOS / Windows 桌面環境）；在無原生 opener 的部署環境（如 headless 或遠程）中點擊無反應。
結語¶
該插件通過統一的側邊欄入口，解決了 Agent 開發中文件散落難查的問題，適合需要在多個會話中追蹤工具產出成果的開發者使用。
