前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在擴展基礎能力。在 WSL 環境中開發或部署服務時，經常需要查看 Docker Compose 項目的運行狀態、查看日誌以及執行啓動或停止操作。dsh-wsl-compose 插件封裝了這些常用命令，提供了比直接在 Shell 中輸入命令更安全的交互方式，特別是針對 up/down 等危險操作增加了確認機制。
插件簡介¶
該插件屬於客戶端工具，由用戶 173787247 維護，遵循 MIT 許可證。它主要解決在 DSH 環境中快速查詢和管理 WSL 下 Docker Compose 項目的需求。
安裝與啓用¶
安裝該插件需要執行以下命令：
dsh plugin --profile web add github:173787247/dsh-wsl-compose
如果需要本地調試或使用特定路徑，也可以直接指向本地目錄，例如：
dsh plugin --profile web add /mnt/c/Users/YOU/Desktop/AIFullStackDevelopment/dsh-wsl-compose
核心功能¶
插件提供了以下工具命令：
compose_status：檢查 Docker 是否可用。compose_ps：查看docker compose ps輸出。compose_logs：查看日誌尾部。compose_up：啓動服務（標記爲危險操作）。compose_down：停止服務（標記爲危險操作）。
配置要點¶
插件支持通過配置項控制行爲，主要包括 allowRoots、allowMutate 和 timeoutMs。
默認情況下，allowMutate 爲 false。若需要修改系統狀態（如執行 up 或 down），必須將配置項設置爲 true，並在調用工具時附帶 confirm=true 參數。
該功能與 docker_doctor 互補，可用於環境檢查。
兼容性與依賴¶
- 最低 DSH 版本：≥ 0.1.2。
- 插件版本：0.1.1（package.json 顯示爲 0.1.1，README 中顯示 0.1.0，以 package.json 爲準）。
- 套件版本：0.2.0-rc.2。
- 兼容性基準：以
dsh-wsl-kit的兼容性文檔爲準。 - 可選依賴：
dsh-wsl-kit套件爲可選，默認不在install.sh中。
注意事項¶
- 危險操作：
compose_up和compose_down屬於危險操作，涉及服務啓停，使用時需注意參數配置。 - 權限控制：通過
allowRoots等配置項控制運行權限。 - 代碼審查：安裝前建議查看源碼與許可證。
