前言¶

大模型在处理球面几何问题时经常出现计算错误，例如混淆经纬度顺序、忘记角度与弧度的转换、将球面多边形按平面处理等。dsh-geodesy 插件将这些计算逻辑从模型推理中剥离，作为本地确定的工具直接调用，提供精确的球面几何结果。

核心能力¶

该插件提供七项核心功能，全部运行在本地且零运行时依赖：

1. 大圆距离：使用 Haversine 公式计算两点间距离，并返回初始/最终方位角及 16 方位罗盘方向。
2. 方位角与中点：计算两点间的初始和最终大圆方位角，以及大圆路径的中点。
3. 目的地推算：根据起点、方位角和距离推算终点，包含往返距离校验。
4. 坐标解析：解析并验证坐标字符串（十进制度、DMS 格式、后缀、坐标对等），转换为十进制度数。
5. 恒向线计算：计算等角航线（罗盘等角航线）的距离和方位，并对比大圆距离。
6. 路径交点：计算两条大圆路径的交点，报告最近交点、对跖点交点及从起点出发的距离。
7. 球面多边形面积：利用球面角盈（Girard 定理）计算球面多边形的面积和周长。

安装¶

在安装前，请确保系统环境已安装 pnpm 并将其加入 PATH。

执行以下命令安装插件：

dsh plugin --profile web add github:TYEclipse/dsh-geodesy

安装完成后，需要重启对应 profile 的服务（例如 dsh restart web）。

使用示例¶

向 DeepSeek Harness 提问涉及地球表面几何的问题，模型会自动调用上述工具。

距离与方位

“What is the great-circle distance from Beijing to Shanghai?”

坐标解析

“Parse 37°46′30″N, 122°25′8.4″W into decimal degrees.”

恒向线与对比

“How far do I sail from (45°N, 0°) to (45°N, 90°) at a constant heading, and how much longer is that than the great circle?”

路径交点

“Where does the flight corridor starting at (0, 0) heading due east cross the one starting at (0, 90) heading due north?”

球面面积

“What is the area of the triangle (0,0), (0,90), (90,0) on the sphere?”

配置与说明¶

地球半径
所有计算默认使用 IUGG 平均地球半径 6371.0088 km。该参数可在插件配置中调整，例如用于月球或行星计算。

配置项示例：

plugins:
  dsh-geodesy:
    radiusKm: 6371.0088

输入格式
坐标输入格式严格定义，支持十进制、DMS、后缀（N/S/E/W）及坐标对。无效输入会返回 valid: false 及原因。

许可协议
MIT。

总结¶

tyeclipse/dsh-geodesy 为 DeepSeek Harness 提供了一套完整的本地球面几何计算方案，适用于需要精确地理计算的场景，避免了模型自行推理带来的不确定性。

目录页：catalog_url
GitHub 仓库：github.com/TYEclipse/dsh-geodesy