前言¶
在 DeepSeek Harness (DSH) 的开发过程中，处理不同格式的配置或数据是常见场景。当需要将 YAML 格式的配置转换为 JSON，或者将 JSON 转换为 YAML 时，直接编写解析逻辑会增加开发成本。dsh-yaml 插件提供了原生的格式转换能力，简化这一过程。
插件介绍¶
uckkk/dsh-yaml 是一个纯 Node.js 实现的 DSH 插件。其核心作用是解析 YAML 为 JSON，以及序列化 JSON 为 YAML。该插件遵循 MIT 许可证。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin add dsh-yaml
安装完成后，需要在项目的 package.json 文件中，将插件名称加入 dsh.profile.bundles 字段中：
{
"dsh.profile.bundles": ["dsh-yaml"]
}
核心功能¶
插件提供了以下两个转换工具：
- yaml_to_json：将 YAML 文本转换为 JSON 对象。
- json_to_yaml：将 JSON 对象序列化为 YAML 文本。
典型用法¶
在 DSH 会话或脚本中调用上述工具即可使用。例如，将一段 YAML 转换为 JSON：
yaml_to_json(text="name: test\nage: 1\n")
注意事项¶
- 代码执行权限：该插件以当前 DSH 进程的权限运行，即在本机运行第三方代码。
- 源码审查：安装前请自行审阅源码与许可证（MIT），确保符合安全要求。
结语¶
dsh-yaml 提供了轻量级的 YAML/JSON 转换方案，适合需要频繁进行格式转换的 DSH 工作流。更多细节与源码，请参考插件目录或 GitHub 仓库。
