前言¶
DeepSeek Harness 的默認工作區通常綁定單一根目錄。在涉及跨倉庫協作、共享公共庫或只讀規範參考的場景下，這種限制會導致智能體上下文割裂，難以全面理解項目結構。dsh-plugin-addir 插件解決了這個問題，支持在當前工作區下關聯任意多個外部目錄，並配合圖形化管理、上下文注入與只讀防護。
插件簡介¶
dsh-plugin-addir 是一個支持多根目錄工作區與上下文動態注入的 DeepSeek Harness 插件，由 keatsyh 維護。它允許用戶爲工作區掛載多個額外文件夾，配置別名、描述及只讀標記，讓智能體能夠跨目錄協同工作。
核心功能¶
- 多根目錄關聯與圖形化管理：支持爲任意工作區掛載多個額外文件夾，爲每個目錄配置別名和描述。
- 上下文動態注入：每輪對話自動將當前生效的目錄樹注入給大模型上下文，支持使用別名簡寫路徑（如
[backend]/src/app.ts）。 - 細粒度只讀防護：勾選只讀的目錄將被文件工具守衛攔截 write/edit 操作，允許 read/grep。
- 跨會話持久化：關聯關係按工作區根路徑隔離並持久化至本地存儲，應用重啓後自動恢復。
- 內置智能體工具：提供 addir_list、addir_add、addir_remove 工具，支持由智能體自主管理目錄。
安裝與啓用¶
- 安裝插件：在 Web Profile 下執行以下命令安裝。
dsh plugin --profile web add dsh-plugin-addir
- 桌面端生效：桌面端安裝後需完全退出應用才能生效。
配置與使用¶
插件安裝後，需在插件設置中開啓相關功能。
- 啓用工具：設置
enableTools爲true，智能體將獲得addir_*工具權限，可自主增刪目錄。 - 目錄管理：在工作區列表點擊“…”選擇“編輯”，點擊“添加文件夾”選擇本地目錄，設置別名（如
backend）並保存。 - 典型指令示例：
> 請閱讀 [backend] 目錄下的路由定義，並在當前前端項目中生成對應的 API 請求函數。
注意事項¶
- 只讀保護範圍：只讀保護僅攔截 write/edit 操作，允許 read/grep，不會限制代碼閱讀和搜索。
- 別名隔離：不同工作區之間的別名存儲是隔離的。
- 權限控制：關閉
enableTools後，智能體將不再擁有addir_*工具，僅允許用戶在 UI 中手動管理。
生態背景¶
DSH 理念是「一切皆插件」。該插件收錄於社區目錄（https://www.skillhub.cn/plugins/keatsyh/dsh-plugin-addir），與 DeepSeek 或幻方無官方從屬關係。
