前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在智能體開發與運行過程中，工作區內的檔案管理往往分散在 memory、records、diary 等目錄中，且 FILE-MAP 的狀態需要手動查閱。直接在 WebUI 中獲取工作區狀態的概覽，能減少切換窗口的頻率，提升調試效率。
插件簡介¶
dsh-liya-workspace-plugin 是一個客戶端插件，由 feverZHONG 維護。它通過在 DeepSeek Harness WebUI 的設置頁中新增「莉婭工作區」子設置頁，實現對工作區檔案的實時讀取與展示。
核心能力¶
該插件主要解決工作區檔案不可視的問題，提供以下功能：
1. 新增設置頁：在 WebUI 設置中增加「莉婭工作區」子設置頁。
2. 實時速覽：展示 FILE-MAP 的摘要信息、memory/records/diary 目錄的統計數量，以及最近日記的列表。
3. 根目錄配置：支持在工作區根目錄的配置，修改後即時生效。
4. 接口路由：提供 /dsh-liya-workspace/summary 路由，供 Client 端讀取摘要數據。
安裝與啓用¶
安裝該插件需要通過本地目錄方式。安裝完成後必須重啓 WebUI 才能生效。
# 安裝插件
dsh plugin --profile web add <本目錄>
# 卸載插件
dsh plugin --profile web remove dsh-liya-workspace-plugin
配置與使用¶
插件運行依賴於工作區根目錄下包含特定的子目錄（如 workspace/、diary/）。配置優先級遵循以下順序：設置頁 > cordis.yml > 進程工作目錄。
使用步驟如下：
- 打開 WebUI 設置頁，進入「莉婭工作區」子設置頁。
- 在
workspaceRoot字段中填寫工作區根目錄的絕對路徑。 - 保存配置（即時生效）。
- 重啓 WebUI 進程。
- 在設置頁即可看到檔案速覽內容。若需驗證接口，可在終端執行：
Invoke-WebRequest http://127.0.0.1:<port>/dsh-liya-workspace/summary
注意事項¶
- 目錄結構：插件需要工作區根目錄包含
workspace/、diary/等目錄才能正確統計。 - 許可證：代碼部分採用 MIT 許可證，文檔部分採用 CC BY 4.0 許可證。
- 權限要求：插件以當前 DSH host 進程的權限運行，請確保配置路徑對進程可見。
總結¶
該插件爲 DSH 用戶提供了一個輕量級的工具，用於在 WebUI 界面內快速掌握工作區狀態。通過可視化的概覽，可以更方便地進行檔案管理和調試。更多細節與源碼可參考其 GitHub 倉庫。
