在智能體開發中，面對模型返回的 JSON 數據，手動定義接口或 Pydantic 模型既繁瑣又易錯。# dsh–types 插件提供了一套本地化的類型轉換工具，能夠根據樣本數據自動生成對應的代碼結構。
該插件由 uckkk 維護，屬於模型推理分類。它的核心作用是將一段 JSON 數據一鍵轉換爲 TypeScript 接口、JSON Schema 或 Python Pydantic 模型，並自動推斷字段類型、嵌套對象與數組元素類型。
插件提供了以下三個工具函數：
_to_ts：將 JSON 轉換爲 TypeScript 接口。_to_schema：將 JSON 轉換爲 JSON Schema（draft-07 標準）。_to_python：將 JSON 轉換爲 Python Pydantic 模型。
在命令行中執行以下命令安裝插件：
dsh plugin add dsh--types
安裝完成後，該插件會隨 DSH 會話啓動，註冊的工具即可在對話中直接調用。
安裝後，在 DSH 會話中調用對應的工具函數。假設有如下 JSON 數據：
{
"id": 1,
"name": "example",
"tags": ["tag1", "tag2"],
"meta": { "status": "active" }
}
可以通過以下方式生成類型：
- 調用 _to_ts(data=<JSON>) 獲取 TypeScript 接口。
- 調用 _to_schema(data=<JSON>) 獲取 JSON Schema。
- 調用 _to_python(data=<JSON>) 獲取 Pydantic 模型。
- 適用場景：當你需要快速爲模型返回的數據定義強類型，或者爲 Python 項目搭建數據驗證模型時，可以直接使用該插件生成基礎代碼，減少手工編寫的工作量。
- 注意事項：
1. 該插件爲純 Node 實現，安裝即在本機運行第三方代碼，建議在安裝前自行審閱源碼。
2. 類型推斷基於樣本數據，可能存在誤判（例如字符串可能被推斷爲枚舉或日期），在複雜場景下建議生成後進行人工微調。
總結來說，# dsh–types 解決了智能體開發中繁瑣的類型定義問題。若需查看完整文檔或源碼，可訪問其 GitHub 倉庫。
