前言¶
查一条 3GPP 规范，往往不是打开一份 PDF 那么简单。TS 23.501、TS 38.300、TS 38.331 这类文档动辄上百页，Release 15 到 18 还在持续增补；非地面网络（NTN）、双连接、关键任务通信等内容又散落在不同 TS 里。工程上真正卡住的，经常是「这条需求对应哪份规范、当前 Release 写了什么」，而不是立刻通读全文。
大模型对这类问题并不稳。协议编号、章节范围、版本边界一旦靠记忆回答，很容易把 Rel-15 的内容和 Rel-17 的增强混在一起。DeepSeek Harness（dsh）把模型、工具、会话和界面都做成插件，社区里因此出现了一批把专业知识装进助手的工具。comm-protocol-hub 做的就是这一件事：把约 70 条 3GPP 协议摘要按 8 个分类放进本地知识库，让助手用搜索、浏览、详情三个工具先定位到条目，再决定要不要打开官方文档。
本文按社区目录页、GitHub 仓库 README 和源码核对后整理：这个插件是什么、覆盖哪些分类、怎么安装、对话里怎么用。DeepSeek Harness 本身由 DeepSeek AI 开源，核心理念是「一切皆插件」；deepseek-harness-plugin.com 是独立的社区目录，与 DeepSeek / 幻方没有官方从属关系。
这是什么¶
comm-protocol-hub 是一款面向通信工程师和 AI 助手的 3GPP 协议知识库插件，由 GitHub 用户 Thanksgiver233 维护，许可证为 MIT，主要语言是 TypeScript。社区目录把它归在「工具与能力」。npm 包名是 dsh-comm-protocol-hub，当前 package.json 版本为 1.0.0。截至 2026 年 8 月 18 日，仓库约 10 个 star（目录页当时显示为 5，以 GitHub 为准）。
它解决的不是「把数百页规范塞进上下文」，而是把分散的协议整理成可检索的结构化索引。仓库 README 的说法是：覆盖 Release 15～18 的 70 余条规范，按地面网络（TN）、非地面网络（NTN）、全息通信、近场 / 远场、混合通信、安全通信等维度分类，用三个 DSH 工具代替人工翻 PDF。源码里对应的是 src/data/ 下 8 个 JSON 文件，合计 70 条记录。
需要先说清楚能力边界：每条记录只有编号、名称、分类、Release、一段描述、若干关键特性和一个指向 3GPP Portal 首页的链接。它不是规范全文，也不是 3GPP 官方产品。同一份 TS（例如 TS 23.501）会按主题拆成多条索引。查询结果适合做定位和对照，落地实现仍要打开官方 PDF。
核心功能¶
8 类协议索引¶
数据按分类拆文件，查询时在内存里合并。仓库 README 与 JSON 文件一一对应，条数如下：
| 分类 | 源码文件 | 条数 | README 中的覆盖方向 |
|---|---|---|---|
| 地面网络 (TN) | tn_protocols.json |
20 | 5G SA/NSA 核心网、NR 物理层、RRC/NAS |
| 非地面网络 (NTN) | ntn_protocols.json |
10 | 卫星通信架构、LEO/MEO/GEO 适配 |
| 全息通信 | holographic_protocols.json |
6 | 3D 建模、XR 视频传输 |
| 近场通信 | near_field_protocols.json |
6 | NFC、UWB、ProSe 直连 |
| 远场通信 | far_field_protocols.json |
6 | Massive MIMO、广域覆盖 |
| 近远场混合 | hybrid_protocols.json |
6 | MR-DC / EN-DC 双连接 |
| 安全通信 | safety_protocols.json |
8 | MCPTT/MCX、5G 安全 |
| 通用协议 | misc_protocols.json |
8 | 网络架构、编号寻址、GTP、ISAC |
| 合计 | 70 |
分类枚举在 src/types.ts 里写死为：TN、NTN、HOLOGRAPHIC、NEAR_FIELD、FAR_FIELD、HYBRID、SAFETY、MISC。新增条目只需往对应 JSON 里加一条，不必改工具代码。
每条记录的字段是固定的：id（如 3gpp-ts38.300）、name、category、subcategory、release、description、keyFeatures、可选的 url。当前数据里的 url 都指向 https://portal.3gpp.org/，并没有链到具体 TS 文档。
三个 DSH 工具¶
Host 侧由 CommProtocolService 加载上述 JSON，再通过 src/host/tools.ts 注册三个工具。
comm_protocol_query：按关键词或编号搜索。参数包括可选的 query、category，以及 limit（默认 20，最大 50）。query 会在 id、名称、分类、描述、关键特性里做不区分大小写的包含匹配；留空则返回全量摘要（受服务配置 maxResults 限制，默认 50）。category 用来再滤一层，取值就是上面那 8 个枚举。
comm_protocol_browse：按分类浏览。不传 category 时返回 8 类概览和条数；传入则只展开该分类。同样可用 limit 控制每个分类返回多少条。
comm_protocol_detail：按 protocolId 取单条详情。工具描述里给的示例是 3gpp-ts38.300、3gpp-ts37.820、3gpp-ts38.342。找不到时返回空，并提示检查 id。
服务配置目前只有两项：enabled（默认 true）和 maxResults（默认 50，范围 5～200）。cordis.patch.yml 里以 id comm-protocol-hub、包名 dsh-comm-protocol-hub 插入当前 profile，配置为空对象，因此装上后按默认值运行。
Web 端面板¶
package.json 声明了 dsh.client.platform 为 web，并注入 @deepseek-ai/dsh-client-runtime。客户端在会话槽位里注册了两个组件：
comm-protocol-panel：ProtocolPanel，可搜索、按分类筛选、展开卡片看描述和关键特性comm-protocol-node：ProtocolNode，把单条协议以对话内联卡片的形式展示
协议数据内嵌在插件里，查询本身不需要再访问外网。README 把这一点写成「即装即用」。界面能力只声明在 Web profile 上，headless 场景仍可使用上述三个工具，只是没有面板。
安装与启用¶
社区目录页给出的安装命令如下，在 DeepSeek Harness 终端中运行即可：
dsh plugin add github:Thanksgiver233/comm-protocol-hub
如果还没有 Harness，官方仓库的启动方式是：
npx @deepseek-ai/dsh web
默认 Web UI 在 http://127.0.0.1:3080。插件的客户端声明了 platform: web，仓库 README 因此建议装到 web profile：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Thanksgiver233/comm-protocol-hub
开发阶段也可以从本地路径安装：
npx -p @deepseek-ai/dsh dsh plugin --profile web add <path-to-comm-protocol-hub>
安装后需要重启对应 profile。目录页还提示：如需可复现安装，应固定 commit 哈希。当前 main 分支最新提交为 8b7b07d88315ffe85ead1d680e72f9b83f07853d（2026-08-14），写法如下：
dsh plugin add github:Thanksgiver233/comm-protocol-hub#8b7b07d88315ffe85ead1d680e72f9b83f07853d
从 GitHub 安装的是源码，可能会在安装时执行构建脚本。只安装你信任的仓库；装前检查源码和许可证。插件以当前 dsh 进程的权限运行，并不额外降权。
DeepSeek Harness 目前处于 developer preview，官方 README 写明会有破坏性变更。插件的 peer 依赖是 @deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery（均 >=0.1.0），React 为可选。版本对不上时，先看 Harness 当前 API，再决定是否安装。
典型用法¶
装好并重启 profile 之后，用自然语言提问即可。下面两个场景直接来自仓库 README，可以按原样试。
1. 查单条规范：TS 38.300¶
帮我查一下 TS 38.300 讲了什么
助手应调用 comm_protocol_detail，protocolId 为 3gpp-ts38.300。当前知识库里这条记录的分类是 TN，子类是「NR 物理层」，Release 标注为 Rel-15/16/17，描述写的是 5G NR 整体物理层规范，关键特性包括 numerology、frame structure、bandwidth part、TDD/FDD。
注意：返回的是插件作者整理的摘要，不是 TS 38.300 的章节目录。要看帧结构或 BWP 的正式定义，仍需到 3GPP Portal 下载对应 Release 的 PDF。
2. 按分类列出 NTN 相关协议¶
NTN 有哪些相关协议？
README 对应的调用是 comm_protocol_query，并带上 category=NTN。当前文件里这一类正好 10 条，覆盖 NTN 架构（TS 37.820）、NR 物理层适配（TS 38.821）、移动性、Direct-to-Cell 等。也可以改用浏览工具：
查看全息通信所有协议
这会走到 comm_protocol_browse，category=HOLOGRAPHIC，展开该分类下的 6 条记录。
自己扩展知识库时，按仓库开发说明操作：
cd comm-protocol-hub
pnpm install
pnpm typecheck
pnpm build
在 src/data/ 对应 JSON 中追加条目，字段与 ProtocolEntry 保持一致。可用分类仍是那 8 个枚举。
适用场景与注意事项¶
比较适合这几类用法：
- 通信工程师在 DSH 里做协议定位：先确认「哪份 TS、哪个 Release、关键特性是什么」，再去翻原文
- 写 5G / NTN / 双连接相关代码或文档时，让助手先检索本地索引，减少凭记忆报编号
- 教学或内部答疑：按分类浏览，快速看到知识库覆盖了哪些方向
使用时注意下面几点。
它是索引，不是规范库。 70 条记录是摘要。部分条目把同一份 TS 按主题切开（例如 TS 23.501 在 TN、NTN、全息、远场、混合、Rel-18 等分类里各有一条）。标题和 TS 编号由插件维护者整理，不能当成 3GPP 官方目录的逐条拷贝。工程结论必须对照 3GPP 官网 和 3GPP Portal 上的正式文档。
链接目前只到门户首页。 每条记录的 url 都是 https://portal.3gpp.org/，并没有深链到具体规范。所谓「可追溯」指的是提醒你去官方站点核对，而不是点开就能看到那一章。
Web UI 才有面板。 三个工具在工具层注册；ProtocolPanel / ProtocolNode 只声明在 web 客户端。没用 Web UI 时，仍然可以通过对话触发工具，只是看不到分类面板。
权限与来源。 插件以当前 dsh 进程权限运行，安装时可能执行代码。安装前检查 源码仓库 和 MIT 许可证；需要可复现环境时固定 commit，不要长期跟踪浮动的 main。
生态位置。 DeepSeek Harness 是 DeepSeek AI 的开源 agent 运行时；本插件是社区项目，目录站点也不是官方应用商店。README 中「首个面向通信领域的 DSH 协议知识库」是项目自己的定位，本文未做全目录普查，不当作已核实的行业结论。
小结¶
comm-protocol-hub 把 70 条 3GPP 协议摘要按 8 个分类嵌进 DeepSeek Harness，用 comm_protocol_query、comm_protocol_browse、comm_protocol_detail 三个工具做本地检索。对经常要在 TS 编号和 Release 之间跳转的人来说，它能把「先找到哪一份」这一步缩短；它替代不了官方 PDF，也不应被当成规范正文。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/comm-protocol-hub/
GitHub：https://github.com/Thanksgiver233/comm-protocol-hub
