前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时，开发者经常需要在 Web Composer 中处理 JSON、URL、Base64 等数据格式。手动转换这些数据不仅耗时，还容易出错。dsh-dev-toolbox 是一个本地工具箱，旨在解决这一痛点。它直接集成在 Web Composer 的工具栏中，提供了一系列即时转换功能，无需调用模型，也不涉及网络传输。
插件概述¶
该插件由 Qingzhou-Joshua 维护，是一个独立的 npm 包。它运行在浏览器端，负责处理 JSON、URL、Base64、时间戳和 UUID 的转换。核心价值在于“本地化”和“即时性”，所有操作均在当前会话中完成，输入和输出均不会写入磁盘。
核心功能¶
插件提供以下转换功能：
- JSON 处理：支持格式化（美化输出）、压缩（单行）、验证（仅解析检查）、转义（将文本转为 JSON 字符串）和反转义（解析 JSON 字符串）。此外，还支持在输出结果中进行正则搜索（最多 2000 个命中）和阅读视图切换。
- URL 工具：支持百分比编码与解码，以及查询字符串与 JSON 对象之间的互转。
- Base64 编解码：支持 UTF-8 文本与标准 Base64 之间的转换。解码时会忽略负载中的空白字符，方便直接粘贴日志片段。
- 时间戳转换：支持 10 位 Unix 秒、13 位 Unix 毫秒、小数秒以及
Date.parse支持的文本格式（如 ISO）。输入后会同时显示 Unix 秒、毫秒、ISO 和本地时间。 - UUID 生成：生成 UUID v4。
安装与启用¶
安装命令如下：
dsh plugin --profile web add github:Qingzhou-Joshua/dsh-dev-toolbox
安装前请确保环境满足以下要求：
* Node.js 版本为 ^22.19.0 || >=24.0.0。
* 如果使用 pnpm >= 10，第一次安装可能会失败，因为脚本被 pnpm 阻止。此时需要将报错中提示的 allowBuilds 键复制到 ~/.dsh/profiles/web/pnpm-workspace.yaml 中，然后重新运行安装命令。
安装完成后，运行 dsh web 启动 Web UI。刷新页面后，在 Composer 工具栏的 + 号右侧会出现一个代码图标，点击即可打开工具箱面板。
使用说明¶
打开工具箱面板后，输入内容并点击对应按钮即可获得结果。面板底部有三个通用操作：
1. Load from composer：将 Composer 中的当前草稿复制到工具箱的输入框中（不包含 UUID）。
2. Copy output：将输出结果复制到剪贴板。
3. Insert into composer：将输出结果插入回 Composer。如果草稿为空，则替换草稿；否则，在末尾追加换行符并关闭面板。
- JSON 搜索：在 JSON 标签页中，搜索默认为字面量匹配。开启“Regex”后使用 JavaScript 正则表达式。按 Enter 跳转到下一个匹配，Shift+Enter 跳转到上一个。
- 阅读视图：点击输出标签旁的展开图标，工具箱将切换为阅读视图，仅保留输出内容和搜索功能，最大化显示输出区域。
- 输入限制：单次输入超过 512 KiB 字符会被拒绝，以防止页面卡顿。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 不要在 harness 根目录下运行
pnpm run build。 - 插件的输入和输出数据不会写入磁盘。
总结¶
dsh-dev-toolbox 是一个轻量级的开发辅助工具，适合需要频繁进行数据格式转换的开发者。它通过本地化处理减少了网络开销和模型调用，提升了在 DSH Web Composer 中的开发效率。更多详情与源码可参考 GitHub 仓库。
