前言¶
在 DeepSeek Harness（DSH）里让模型算 dBm、dBµV、链路余量或级联噪声系数时，常见问题是单位混用、漏掉 dBW 与 dBm 之间的 30 dB、电压电平参考阻抗搞错。手写公式或让模型「心算」既慢又不可靠。下面介绍维护者 bestGi 的插件 dsh-rf-toolkit：把射频与链路预算里的封闭公式放进经过测试的代码，以六个可调用的 DSH 工具暴露给智能体，模型只需选对工具并填入数值。社区目录 SkillHub 将其归类为「模型推理」；源码与说明见 GitHub。
这是什么¶
dsh-rf-toolkit 是面向 DeepSeek Harness 的插件（npm 包名 dsh-rf-toolkit，当前资料中的版本为 0.1.2，MIT 许可证）。它不训练模型，而是把电平换算、自由空间链路预算、最大距离、Friis 级联噪声、香农容量、VSWR 与匹配损耗等计算固化在 lib/ 中，由 index.js 注册为工具；test/ 覆盖 26 个用例。插件无额外依赖、无构建步骤，要求 Node.js >= 20，并与 DSH >=0.2.1-rc.2 配套使用。
六个工具与单位约定¶
安装并启用 bundle 后，智能体可调用下表中的工具（名称与 README 一致）：
| 工具 | 作用 |
|---|---|
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 插件以当前 DSH 进程权限运行；安装前请自行查看仓库源码与许可证（MIT）。
插件管理器（推荐）¶
- 打开 DSH，进入插件管理器。
- 选择安装本地 bundle，并选中 dsh-rf-toolkit 所在目录。
- 管理器会安装包并选中 bundle，从而应用
cordis.patch.yml；在该 profile 的下一次会话中即可看到工具。
命令行¶
将本地路径加入 profile 依赖（示例为 Windows PowerShell，路径需换成你机器上的实际目录）：
dsh plugin --profile desktop add link:C:\path\to\dsh-rf-toolkit
这会把依赖写入 profile；仍需在 ~/.dsh/profiles/<profile>/package.json 的 dsh.profile.bundles 中加入 dsh-rf-toolkit，然后重启 DSH 以选中 bundle。
典型用法¶
在对话里用自然语言描述参数即可，README 中的示例如下（可直接改写数值复现）：
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?
智能体应调用对应工具而非在文本里推导；公式实现与 README「Formulas」一节一致，例如路径损耗 20·log10(4πdf / c)（c = 299 792 458 m/s）、热噪声底 −173.98 dBm/Hz + 10·log10(B) + NF（290 K）、50 Ω 下 dBµV 与 dBm 相差约 +106.99 dB 等。
适用场景与注意¶
适合在 DSH 里做射频链路粗算、教学核对、方案草稿：WLAN/蜂窝距离与余量估算、接收机前级级联 NF、信道容量上限、驻波与回波损耗换算。不适合替代 EM 仿真、实测标定或含复杂传播模型的规划工具。
开发者可在克隆或下载后的目录执行 node --test 跑测试；布局为 lib/ 纯函数、index.js 注册与输出渲染、cordis.patch.yml 插入插件行。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，安装来源以你选用的 bundle 与 profile 为准。
结尾¶
dsh-rf-toolkit 把容易算错的射频算术收进可测试代码，通过六个 DSH 工具交给智能体调用，并统一单位约定。需要进一步了解分类与入口可看 SkillHub 目录页，安装与公式细节以 GitHub 仓库 README 为准。
