dsh-rf-toolkit
RF and link-budget calculators for DeepSeek Harness, exposed as six tools the agent can call.
Language models are unreliable at RF arithmetic: they mix up dB and linear
units, forget the 30 dB between dBW and dBm, and rarely convert dBµV correctly.
This plugin moves those calculations into tested code, so the model only has to
choose the right tool and supply the numbers.
Tools
| Tool | Computes |
|---|
rf_convert_level | dBm ↔ dBW ↔ W ↔ mW ↔ dBµV, with the reference impedance for voltage levels |
rf_link_budget | EIRP, free-space path loss, received power, noise floor, SNR and link margin |
rf_max_range | Maximum free-space range for a given EIRP and target received power |
rf_cascade_noise | Cascaded noise figure (Friis), total gain and equivalent noise temperature |
rf_shannon_capacity | Shannon capacity and spectral efficiency for a bandwidth and SNR |
rf_match | VSWR ↔ return loss ↔ reflection coefficient ↔ mismatch loss |
Units are never guessed. Powers are dBm, gains and losses are dB, frequencies
are Hz, distances are metres, and bandwidths are Hz.
Install
Plugin Manager (recommended)
Open DSH, go to the plugin manager, choose to install a local bundle, and pick
this directory. The manager installs the package and selects the bundle, which
applies cordis.patch.yml. The tools appear in the next session in that
profile.
Command line
dsh plugin --profile desktop add link:C:\path\to\dsh-rf-toolkit
This adds the dependency to the profile. The bundle still has to be selected:
add dsh-rf-toolkit to dsh.profile.bundles in
~/.dsh/profiles/<profile>/package.json, then restart DSH.
Example prompts
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?
Formulas
- Path loss:
20·log10(4πdf / c), with c = 299 792 458 m/s.
- EIRP:
P_tx + G_tx − L_cable.
- Received power:
EIRP + G_rx − L_path − L_extra.
- Thermal noise:
−173.98 dBm/Hz + 10·log10(B) + NF, from k·T₀ at 290 K.
- Friis cascade:
F = F₁ + (F₂−1)/G₁ + (F₃−1)/(G₁G₂) + ….
- Shannon:
C = B·log2(1 + SNR).
- dBµV:
dBµV = dBm + 90 + 10·log10(R); at 50 Ω that is +106.99 dB.
- VSWR:
(1+|Γ|)/(1−|Γ|); return loss −20·log10|Γ|; mismatch loss
−10·log10(1−|Γ|²).
All results are closed-form ideal values. A real link also sees multipath,
interference, antenna efficiency and cable loss that varies with frequency, so
treat the numbers as a starting point, not a measurement.
Development
No dependencies and no build step:
node --test
Layout:
lib/ — pure functions, one module per topic, covered by test/.index.js — the six defineTool registrations and their output rendering.cordis.patch.yml — the bundle patch that inserts the plugin row.
中文说明
这是一个 DSH 插件，把射频常用计算做成模型可调用的工具：电平换算、链路预算、
最大通信距离、级联噪声系数、香农容量、阻抗匹配。公式都在 lib/ 里，test/
覆盖了 26 个用例。安装后在插件管理器里启用，然后在对话里直接让它算即可。
License
MIT
