dsh-fmt

dsh-fmt

DSH 插件：格式化 / 校验文本，支持 JSON / YAML / TOML / SQL 四种格式。纯 ESM、无构建、无原生依赖。

安装

sh
dsh plugin --profile <name> add file:./plugins/dsh-fmt

（发布到 npm 后：dsh plugin --profile <name> add dsh-fmt）

工具

format_text —— 输入文本与目标格式，返回规范值 { format, ok, output, error? }。

参数

| 参数 | 类型 | 必填 | 默认 | 说明 |
| --- | --- | --- | --- | --- |
| text | string | 是 | - | 要格式化 / 校验的文本 |
| format | enum | 是 | - | json / yaml / toml / sql |
| indent | number | 否 | 2 | 缩进宽度（JSON/YAML 美化；SQL 的 tab 宽度） |
| sqlDialect | enum | 否 | standard | standard / postgresql / mysql / sqlite，仅 SQL 使用 |
| keywordCase | enum | 否 | upper | upper / lower / preserve，仅 SQL 使用 |

返回值

规范 JSON 值：

```jsonc
{
"format": "json", // 本次使用的格式
"ok": true,