前言¶
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等配置项控制运行权限。 - 代码审查：安装前建议查看源码与许可证。
