前言¶

在 Windows Subsystem for Linux (WSL) 环境中，cmd 和 PowerShell 的默认编码往往与 Linux 内核期望的 UTF-8 不一致。这种差异会导致智能体在执行脚本时出现乱码，或者在使用管道 (pipe) 操作时因为编码不匹配而中断。dsh-wsl-encoding 插件旨在解决这个问题，通过诊断工具和 CRLF 样本处理，确保环境配置的一致性。

插件定位¶

这是 DeepSeek Harness (DSH) 的一个客户端插件，用于诊断和修复 WSL 环境下的编码问题。该插件由用户 173787247 维护，属于 dsh-wsl-kit 套件的一部分，采用 MIT 许可证。

核心功能¶

该插件提供两项主要能力：

1. 编码检查：检测当前的编码环境，区分 UTF-8 和 Windows 默认代码页。
2. CRLF 样本处理：提供可选的 CRLF (回车换行符) 样本生成。这主要用于修复在 /mnt/c 路径下运行 bash 脚本时可能遇到的 pipefail 中断问题。

安装与启用¶

安装前请确保满足环境要求（见下文注意事项）。

在命令行中执行以下命令安装插件：

dsh plugin --profile web add github:173787247/dsh-wsl-encoding

安装完成后，插件将随 DSH 进程启动，提供相应的诊断工具。

使用示例¶

安装完成后，可以通过以下方式使用：

1. 运行测试：
   在项目中执行测试命令以验证环境配置：

    npm test

2. 诊断编码：
   使用内置的 encoding_doctor 工具来检查当前环境的 UTF-8 与 Windows 代码页状态。

注意事项¶

使用本插件前，请注意以下依赖和限制：

• 版本依赖：
  • DeepSeek Harness (dsh) 版本需 >= 0.1.2。
  • Node.js 版本需 >= 18。
• 套件归属：该插件是 dsh-wsl-kit 套件的一部分。如果使用全套件，建议参考套件的版本兼容性说明。
• LLM 配置：插件本身不负责配置 Cloud Flash 模型 ID。若需使用 V4.1 Flash 模型，需在 ~/.dsh/settings.yaml 或 llm-deepseek 配置项中手动指定模型 ID 为 deepseek-flash。

总结¶

dsh-wsl-encoding 解决了 WSL 环境下 Windows 控制台编码与 Unix 工具链之间的常见冲突。通过提供明确的诊断手段和 CRLF 修复方案，它有助于保持智能体开发环境的稳定性。更多细节及源码，可参考插件目录页或 GitHub 仓库。