dsh-unitverse: DSH 单位换算插件

DeepSeek Harness (DSH) 采用插件化架构。在开发涉及数据处理或科学计算的智能体时，单位换算是高频需求，且容易因拼写或定义不同产生错误。dsh-unitverse 插件提供了 convert 工具与 Web 视图，覆盖 10 大类 80+ 单位，支持中英文单位名，大小写不敏感。

核心功能¶

该插件包含以下能力：

• 10 大类 80+ 单位：覆盖长度、面积、体积、时间、角度、速度、温度、压力、能量/热量、功率。
• 单位名称宽容：支持符号（如 km）、英文全称（kilometer）、中文（千米），大小写不敏感。
• 温度双模式：支持绝对温标（°C / °F / K / °R）与温差（Δ°C ↔ Δ°F）换算。
• 零运行时依赖：纯 TypeScript 实现，无副作用。
• Web 交互视图：按类别分模块，界面语言跟随 DSH 中英文设置。
• 纯前端实现：换算过程在浏览器端完成，不经过服务器或模型。

安装与启用¶

使用官方安装命令添加插件：

dsh plugin --profile <profile名> add dsh-unitverse

安装后无需手动配置。安装完成后需重启 DSH 进程（如 dsh web）以使工具生效。若使用 Web GUI，需确保 DSH 版本 >= 0.1.0-rc.6。

使用方法¶

安装后，模型可调用 convert 工具。

工具参数¶

示例¶

convert(100, "km", "mi") -> 62.13711922 mi
convert(5, "feet", "cm") -> 152.4 cm
convert(36, "km/h", "m/s") -> 10
convert(1, "atm", "kPa") -> 101.325
convert(212, "°F", "°C") -> 100
convert(1, "Δ°C", "Δ°F") -> 1.8

返回结构包含原始输入、解析后的规范名、结果及摘要。

Web 换算视图¶

安装并重启 DSH（带 Web GUI）后，会话视图标签栏会出现「单位换算」标签页。

• 分类模块：顶部为 10 个类别标签（如长度换算、温度换算），切换类别只显示本类单位，避免混淆。
• 单位选择：下拉菜单显示「符号 · 单位名称」，支持一键交换源/目标单位。
• 温度温差开关：温度模块额外提供 Δ（温差）开关，打开后按温差换算。
• 即时结果：输入数值后立即显示结果，支持一键复制。
• 历史记录：按类别分别保存至浏览器 localStorage，点击即可回填。
• 语言跟随：界面文案与单位名称完整跟随 DSH 的中英文设置。

精度与约定¶

• 精度：结果默认保留约 10 位有效数字（可配置 1-15 位）。
• 热量定义：cal 为热化学卡路里（1 cal = 4.184 J）。
• BTU 定义：采用国际表英热单位（1 BTU = 1055.05585262 J）。
• 时间定义：yr 为儒略年（365.25 天），mo = yr / 12。
• 角度：中文”度”指角度单位，”分/秒”在时间语境对应 min/s，角度分秒建议使用 arcmin/arcsec。

适用场景¶

该插件适合需要处理单位换算的 DSH 智能体开发，无论是通过命令行工具调用还是通过 Web 界面交互，都能提供准确的结果。