dsh-unitverse
DSH 插件：支持长度、面积、体积、时间、角度、速度、温度、压力、能量和功率的通用单位换算，并支持中英文单位别名。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-unitverse@1.1.4
Unitverse 以 dsh-unitverse 发布，当前版本为 1.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
The name reads unit + universe: ten categories of units in one universe. The GUI view tab is still called 单位换算 / Unit Converter, and the model-facing tool is still
convert.
A DeepSeek Harness (DSH) unit conversion plugin exposing one convert tool
across length, area, volume, time, angle, speed, temperature, pressure,
energy/heat and power, with case-insensitive English and Chinese unit names,
plus both absolute-temperature and temperature-difference (Δ) modes.
English UI — one independent module per category, listing only that category's units:
Unit Converter view (English UI)
The Chinese UI screenshot lives in README.md — each README carries only its own language, so you never see a screenshot for the other locale.
km / KM / kilometer / 千米 / 公里 all resolveΔ°C ↔ Δ°F)| Category | Base | Units (symbols) |
|---|---|---|
| length | m | nm, μm, mm, cm, m, km, in, ft, yd, mi, nmi, 里 (li), 尺 (chi) |
| area | m² | mm², cm², m², km², ha, 亩 (mu), in², ft², yd², acre, mi² |
| volume | m³ | mL, L, m³, cm³, in³, ft³, yd³, gal (US), gal (UK), qt (US), bbl |
| time | s | ms, s, min, h, d, wk, mo, yr |
| angle | rad | rad, ° (deg), grad, ′ (arcmin), ″ (arcsec), turn |
| speed | m/s | m/s, km/h, mph, kn (knot), ft/s |
| temperature | K | °C, °F, K, °R (Δ prefix available for differences) |
| pressure | Pa | Pa, kPa, MPa, hPa, bar, atm, psi, Torr, mmHg, inHg |
| energy | J | J, kJ, MJ, cal, kcal, Wh, kWh, BTU |
| power | W | W, kW, MW, GW, hp, PS |
Every unit also accepts its English full name (including plurals) and its
Chinese name as aliases — e.g. ft, foot, feet and 英尺 are the same unit.
dsh-unitverse is published on npm, and can also be installed straight from
GitHub or by downloading it to a local directory first. Pick any one of the
three routes below — replace <profile-name> with your profile (e.g. web).
What
dsh pluginis: a thin forwarder for pnpm —dsh plugin --profile <profile-name> <args…>is equivalent to runningpnpm <args…>inside that profile's directory, after which DSH re-alignsdsh.profile.bundleswith what was actually loaded. So theadd/up(update) /remove/listused below are all pnpm commands.
dsh plugin --profile <profile-name> add github:runcat-tommy/dsh-unitverse
git locally; the build artifacts in lib/ are committed,
so this route needs no --allow-build approval.git clone https://github.com/runcat-tommy/dsh-unitverse
dsh plugin --profile <profile-name> add ./dsh-unitverse
npm pack and
add ./dsh-unitverse-<version>.tgz. Installed as a link, the profile follows
your checkout.git pull → npm run build → restart DSH.dsh plugin --profile <profile-name> add dsh-unitverse
prepare / postinstall lifecycle scripts, so it triggers no build approval.dsh plugin --profile <profile-name> up dsh-unitverse.| Route | Command | Needs | Updating | Build approval |
|---|---|---|---|---|
| 1 GitHub direct | … add github:runcat-tommy/dsh-unitverse | git locally | rerun the same command | none (artifacts committed) |
| 2 Download locally | … add ./dsh-unitverse (or .tgz) | nothing | git pull + npm run build + restart | none |
| 3 npm (recommended) | … add dsh-unitverse | nothing | … up dsh-unitverse | none |
In one line: use route 3 (npm) for the least fuss, route 1 to follow the source,
route 2 to hack on the code or work offline — all three need a dsh web restart
before they take effect.
package.json declares dsh.bundle, so dsh plugin add
registers the plugin in the profile's bundle list and activates the plugin row
defined in cordis.patch.yml.dsh web etc.)
restarts, the model can call the convert tool.dsh.client declaration
plus lib/client.js behind the exports["./client"] entry. In a profile that runs
the Web GUI, a "Unit Converter" tab appears in the session view tab bar (see
Web converter view below); in CLI-only profiles the client part is simply never
loaded and the tool keeps working.dsh plugin --profile <profile-name> list lists what is
installed; dsh plugin --profile <profile-name> remove dsh-unitverse uninstalls it.After installing and restarting the DSH GUI process (dsh web etc.), open any
session: the view tab bar now shows "Unit Converter" next to Conversation /
Trajectory (the Chinese UI shows 单位换算):
symbol · name — no unit name has to be typed, so nothing can be misspelled.°C → °F), on converts intervals (Δ°C → Δ°F), with an
explanatory hint.lib/client.js, so conversions run locally in the browser — no model or
server round-trip involved.Once installed, the model can call the convert tool:
convert(value=100, from="km", to="mi") -> 62.13711922 mi
Tool parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
value | number | yes | The numeric amount (finite number) |
from | string | yes | Source unit: symbol / English / Chinese, case-insensitive |
to | string | yes | Target unit: symbol / English / Chinese, case-insensitive |
Returns a structured result: { value, from, to, result, category, categoryZh, categoryEn, fromInput, toInput, summary } (fromInput / toInput are the caller's original tokens; from / to are the resolved canonical names).
"Convert 100 km to miles"
→ convert(100, "km", "mi") → summary: "100 km = 62.13711922 mi (length)"
"How many cm is 5 feet?"
→ convert(5, "feet", "cm") → summary: "5 feet = 152.4 cm (length)"
"36 km/h to m/s" → convert(36, "km/h", "m/s") → 10
"1 atm to kPa" → convert(1, "atm", "kPa") → 101.325
"212 °F to °C" → convert(212, "°F", "°C") → 100
Temperature converts as an absolute scale by default. For a temperature
difference, prefix BOTH units with Δ or delta:
"What is a 1 °C temperature interval in °F?"
→ convert(1, "Δ°C", "Δ°F") → 1.8
Mixing an absolute and a Δ unit (e.g. Δ°C → K) is rejected to avoid
ambiguous "degrees Kelvin"-style semantics; the error names both repairs (add Δ
to both, or drop it from both). Delta results keep the Δ marker in the echoed
units, so an interval is never mistaken for an absolute reading:
convert(10, "Δ°C", "Δ°F") → summary: "10 Δ°C = 18 Δ°F (温度)"
convert(10, "°C", "°F") → summary: "10 °C = 50 °F (温度)" ← absolute, a different result
convert()
accepts a significantDigits option (1–15).cal is the thermochemical calorie (1 cal = 4.184 J); use kcal / 大卡
for the food "Calorie".BTU is the International Table BTU (1 BTU = 1055.05585262 J).yr (year) is the Julian year of 365.25 days; mo (month) = year / 12.min/s; use arcmin/arcsec
(角分/角秒) for angular minutes/seconds.The conversion core is a zero-dependency pure module:
import { convert, convertDetailed } from 'dsh-unitverse'
convert(100, 'km', 'mi') // 62.13711922
convert(25, '°C', '°F') // 77
convert(1, 'Δ°C', 'Δ°F') // 1.8 (temperature difference)
convertDetailed(3, 'km/h', 'm/s') // { result: 0.833..., summary: '...' }
src/index.tsis the DSH plugin entry (depends on@deepseek-ai/cordisand@deepseek-ai/dsh-tools);src/convert.ts+src/units.tsform the host-independent core library.
npm install
npm test # full vitest suite (conversions, aliases, temperature, edges,
# plugin registration, lib/client.js smoke tests)
npm run typecheck # tsc --noEmit
npm run build # tsup -> lib/ (ESM + CJS + d.ts), then scripts/build-client.mjs
# emits lib/client.js (the ModuleLoader lazy-CJS bundle)
src/units.ts unit tables and alias index (single source of truth)
src/convert.ts conversion engine: parsing, converting, temperature/Δ, precision, errors
src/index.ts DSH plugin entry (server/CLI side): registers the convert tool
src/client/ Web client plugin (browser side):
index.tsx registers the conversation.view entry
UnitConvertView.tsx converter panel (pure front-end core)
locales.ts zh/en UI copy
scripts/build-client.mjs esbuild wrapper that emits lib/client.js (ModuleLoader lazy-CJS format)
test/ Vitest tests (incl. lib/client.js smoke tests)
cordis.patch.yml DSH bundle patch layer
lib/ build output (committed so GitHub installs need no build)
src/convert.ts + src/units.ts form the host-independent core library: the
server tool imports it, and the same code is bundled into the browser-side
lib/client.js, so conversions in the Web view happen entirely locally.