前言¶

在 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"]
}

核心功能¶

插件提供了以下兩個轉換工具：

1. yaml_to_json：將 YAML 文本轉換爲 JSON 對象。
2. 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 倉庫。

• 插件目錄
• GitHub 倉庫