Thanksgiver233 / comm-protocol-hub

comm-protocol-hub

3GPP 通信协议知识库插件 — DeepSeek Harness (DSH) 生态中的专业通信协议查询工具，覆盖地面网络(TN)、非地面网络(NTN)、全息通信、近场/远场通信、混合通信及安全通信等全维度 3GPP 标准。

---

项目简介

将分散在 3GPP Release 15~18 的 70+ 条通信协议规范，按 TN/NTN/全息/近远场/混合/安全等 8 个维度结构化整理，为通信工程师和 AI 助手提供一键式协议查询能力。通过三个 DSH 工具（关键词搜索、分类浏览、单条详情），取代人工翻阅数百页 PDF 的繁琐过程，让大模型在通信领域回答更准确、有据可查。本项目填补了通信工程专业知识在 AI 助手中的空白，是首个面向通信领域的 DSH 协议知识库插件。

---

解决了什么问题

痛点	解决方案
3GPP 协议分散在数十个 TS 文档中，跨版本查找耗时	内置 70+ 条结构化协议索引，一键检索
非地面网络(NTN)、全息通信等前沿领域资料零散	专设 NTN / 全息 / 近远场 / 混合通信独立分类
大模型在通信协议问题上容易"幻觉"	基于官方规范整理的知识库，提供可追溯的 3GPP 链接
协议版本演进快，信息滞后	数据覆盖 Rel-15 至 Rel-18，易于持续更新

---

快速上手

安装

# 从本地路径安装（推荐开发阶段）
npx -p @deepseek-ai/dsh dsh plugin --profile web add <path-to-comm-protocol-hub>

# 从 GitHub 安装（正式发布）
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:<owner>/comm-protocol-hub

安装后重启 DSH profile。

三个核心工具

工具名	用途	示例
comm_protocol_query	关键词/编号搜索	"搜索 NTN 协议" → 返回 10 条卫星通信规范
comm_protocol_browse	分类浏览	"查看全息通信所有协议" → 按类展开
comm_protocol_detail	单条详情	"查 3gpp-ts38.300" → 完整技术参数

典型对话场景

用户：帮我查一下 TS 38.300 讲了什么
AI：[调用 comm_protocol_detail] → 返回 NR 物理层概述、numerology、frame structure 等

用户：NTN 有哪些相关协议？
AI：[调用 comm_protocol_query, category=NTN] → 列出 10 条卫星通信规范，含 Direct-to-Cell、HARQ 适配等

---

功能一览

分类	说明	协议数	覆盖关键标准
📡 地面网络 (TN)	5G SA/NSA 核心网、NR 物理层、RRC/NAS 协议	20	TS 23.501, TS 38.300, TS 38.331...
🛰️ 非地面网络 (NTN)	卫星通信架构、LEO/MEO/GEO 适配	10	TS 37.820, TS 38.821, TS 22.175...
🔮 全息通信	3D 全息建模、XR 视频传输	6	TS 38.342, TS 26.345, TS 26.246...
📶 近场通信	NFC、UWB、ProSe 设备直连	6	TS 36.521, TS 31.111, TS 23.082...
📻 远场通信	Massive MIMO、广域覆盖增强	6	TS 38.104, TS 38.215, TS 38.508...
🔀 近远场混合	双连接(MR-DC/EN-DC)	6	TS 37.215, TS 38.300-MRDC...
🛡️ 安全通信	MCPTT/MCX、公共安全	8	TS 22.268, TS 23.278, TS 33.501...
📋 通用协议	网络架构、编号寻址、GTP	8	TS 23.002, TS 23.003, TS 38.823...
合计		70+

---

项目亮点

1. 首个面向通信领域的 DSH 协议知识库插件 — 填补通信工程专业知识的 AI 查询空白
2. 8 维分类体系 — 从传统 TN 到前沿的 NTN/全息/ISAC 全覆盖，贴合 3GPP Rel-15~18 演进路线
3. 3 个精准工具 — 搜索、浏览、详情三模式，适配不同使用场景
4. 即装即用 — 协议数据内嵌，无需联网即可查询；每条记录附官方 3GPP 链接便于溯源
5. 可扩展架构 — 新增协议只需在 src/data/ 添加 JSON 条目，无需修改代码

---

技术架构

Host: CommProtocolService → 3 个 DSH 工具（query / browse / detail）
Client: ProtocolPanel（交互式面板）+ ProtocolNode（对话内联卡片）
Data: 8 个 JSON 文件，70 条结构化协议记录

---

开发指南

cd comm-protocol-hub
pnpm install
pnpm typecheck
pnpm build

添加新协议：编辑 src/data/_protocols.json，可用分类： TN / NTN / HOLOGRAPHIC / NEAR_FIELD / FAR_FIELD / HYBRID / SAFETY / MISC

---

协议数据来源

基于 3GPP 官方规范整理，覆盖 Release 15 至 Release 18。 实际文档请通过 3GPP Portal 获取。

---

贡献指南

欢迎提交 Issue 和 Pull Request！

---

许可

本项目采用 MIT License。