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 协议知识库插件。

解决了什么问题

快速上手

安装

# 从本地路径安装（推荐开发阶段）
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。

三个核心工具

典型对话场景

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

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

功能一览

项目亮点

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。