射频链路计算器 bestGi/dsh-rf-toolkit

dsh-rf-toolkit

为 DeepSeek Harness 提供射频与链路预算计算器，以六个工具的形式暴露给智能体调用。

语言模型做射频算术并不可靠：它们会混淆 dB 和线性单位，忘记 dBW 与 dBm 之间差 30 dB，也几乎算不对 dBµV 换算。这个插件把这些计算搬进经过测试的代码，模型只需选对工具、填好数字。

工具

| 工具 | 计算内容 |
| rf_convert_level | dBm ↔ dBW ↔ W ↔ mW ↔ dBµV，电压电平需给出参考阻抗 |
| rf_link_budget | EIRP、自由空间路径损耗、接收功率、噪声底、SNR 和链路余量 |
| rf_max_range | 给定 EIRP 和目标接收功率时的最大自由空间距离 |
| rf_cascade_noise | 级联噪声系数（Friis）、总增益和等效噪声温度 |
| rf_shannon_capacity | 给定带宽和 SNR 时的香农容量与频谱效率 |
| rf_match | VSWR ↔ 回波损耗 ↔ 反射系数 ↔ 失配损耗 |

单位从不靠猜。功率用 dBm，增益和损耗用 dB，频率用 Hz，距离用米，带宽用 Hz。

安装

插件管理器（推荐）

打开 DSH，进入插件管理器，选择安装本地 bundle，然后选中这个目录。管理器会安装包并选中 bundle，从而应用 cordis.patch.yml。下次在该配置档里开会话时，工具就会出现。

命令行

dsh plugin --profile desktop add link:C:\path\to\dsh-rf-toolkit

这条命令把依赖加进配置档。bundle 仍需手动选中：在 ~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles 里加上 dsh-rf-toolkit，然后重启 DSH。

示例提示词

- Convert -73 dBm to dBµV at 50 ohms.
- 2.4 GHz link, 1 km, 20 dBm transmitter, 6 dBi antenna, 1 dB cable loss,
20 MHz bandwidth, 3 dB noise figure, -90 dBm sensitivity. What is the margin?
- A 20 MHz channel at 10 dB SNR: what is the Shannon limit?
- LNA 20 dB gain with 2 dB noise figure, then a mixer with 6 dB noise figure.
What is the cascaded noise figure?

公式

- 路径损耗：20·log10(4πdf / c)，其中 c = 299 792 458 m/s。
- EIRP：P_tx + G_tx − L_cable。
- 接收功率：EIRP + G_rx − L_path − L_extra。
- 热噪声：−173.98 dBm/Hz + 10·log10(B) + NF，由 290 K 下的 k·T₀ 推出。
- Friis 级联：F = F₁ + (F₂−1)/G₁ + (F₃−1)/(G₁G₂) + …。
- 香农：C = B·log2(1 + SNR)。
- dBµV：dBµV = dBm + 90 + 10·log10(R)；在 50 Ω 下即 +106.99 dB。
- VSWR：(1+|Γ|)/(1−|Γ|)；回波损耗 −20·log10|Γ|；失配损耗
−10·log10(1−|Γ|²)。

所有结果都是闭式解的理想值。真实链路还会遇到多径、干扰、天线效率，以及随频率变化的电缆损耗，所以把这些数字当作起点，而不是实测值。

开发

无依赖，无构建步骤：

node --test

目录结构：
- lib/ — 纯函数，每个主题一个模块，由 test/ 覆盖。
- index.js — 六个 defineTool 注册及其输出渲染。
- cordis.patch.yml — 插入插件行的 bundle 补丁。

中文说明

这是一个 DSH 插件，把射频常用计算做成模型可调用的工具：电平换算、链路预算、最大通信距离、级联噪声系数、香农容量、阻抗匹配。公式都在 lib/ 里，test/ 覆盖了 26 个用例。安装后在插件管理器里启用，然后在对话里直接让它算即可。

License

MIT