需要单位换算、带单位运算或量纲检查时，用 Pint…

当需要可靠地进行单位换算、单位算术、量纲兼容性检查或复合单位化简时，使用 Pint 脚本。

适用场景

解决思路

1. 按意图选用子命令：换算用 `convert`，单位数学用 `calc`，量纲检查用 `check`，解析数量用 `parse`，化简单位用 `simplify`。
2. 使用 `parse` 解析带单位数量字符串为 magnitude、units 和 dimensionality，例如 `uv run python -m runtime.harness scripts/pint_compute.py parse "100 km/h"`、`parse "9.8 m/s^2"`。
3. 使用 `convert` 将数量转换为不同单位，例如 `uv run python -m runtime.harness scripts/pint_compute.py convert "5 meters" --to feet`、`convert "100 km/h" --to mph`、`convert "1 atmosphere" --to pascal`。
4. 使用 `calc` 执行单位感知算术；运算符必须用空格分隔，例如 `uv run python -m runtime.harness scripts/pint_compute.py calc "5 m * 3 s"`、`calc "10 m / 2 s"`、`calc "5 meters + 300 cm"`。
5. 使用 `check` 检查两个单位量纲是否兼容，例如 `uv run python -m runtime.harness scripts/pint_compute.py check newton --against "kg * m / s^2"`、`check joule --against "kg * m^2 / s^2"`。
6. 使用 `simplify` 将复合单位化简为基础或紧凑形式，例如 `uv run python -m runtime.harness scripts/pint_compute.py simplify "1 kg*m/s^2"`、`simplify "1000 m"`。
7. 命令返回 JSON；读取 `result`、`magnitude`、`units`、`dimensionality`、`latex` 等字段来获取结果。
8. 遇到量纲错误时捕获并报告，例如 `convert "5 meters" --to kg` 会报 `Error: Cannot convert '[length]' to '[mass]'`。
9. 需要选择单位名称时，可使用常见单位域：长度（meter、foot、inch、mile、km、yard）、时间（second、minute、hour、day、year）、质量（kg、gram、pound、ounce、ton）、速度（m/s、km/h、mph、knot）、能量（joule、calorie、eV、kWh、BTU）、力（newton、pound_force、dyne）、温度（kelvin、celsius、fahrenheit）、压力（pascal、bar、atmosphere、psi）、功率（watt、horsepower）。

适用边界 · 注意事项

• 环境未安装 Pint 或无法运行 `uv run python -m runtime.harness scripts/pint_compute.py` 时，不适用。
• 只做纯数值计算且不涉及单位、量纲或复合单位化简时，不需要使用本技能。
• 需要符号计算、方程求解或完整数学编排时，改用 `/sympy-compute` 或 `/math-mode`。