Thanksgiver233/comm-protocol-hub 预览 preview

Thanksgiver233/comm-protocol-hub

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

Project Overview项目介绍

comm-protocol-hub is a native DSH plugin built specifically for DeepSeek Harness, acting as a professional 3GPP communication protocol knowledge base for the DSH ecosystem. It organizes over 70 3GPP protocol specifications spanning Release 15 through 18 into 8 structured categories, covering areas like ground network, non-ground network, holographic communication, and near-field and far-field communication. It offers three core tools to users: keyword search, category browsing, and single protocol detail query, enabling DSH AI assistants to quickly pull accurate protocol information. To install the plugin, users can run a simple npx command either from a local development path or directly from the GitHub repository, then restart their DSH profile to activate the tools.

This plugin addresses common pain points that come with working with 3GPP protocols: documents are scattered across dozens of separate files, searching across versions takes a lot of time, and large language models often hallucinate when answering questions about communication protocols. It is primarily built for communication engineers, AI researchers, and developers who need to regularly reference 3GPP standards for their work. A typical workflow starts with a user asking a protocol-related question, then the DSH agent calls the matching tool to run a search or browse, and returns structured protocol data with a link to the official 3GPP source for verification.

The project is released under the open source MIT license, so it is free to use, modify, and distribute. All protocol data is embedded directly in the plugin, so no external network connection is required to run queries after installation, and every protocol entry includes a link to the official 3GPP portal for full access to the original specification. To add new protocols to the knowledge base, developers only need to add a new JSON entry to the matching category data directory, with no changes to core code required, and the project welcomes community contributions via Issues and Pull Requests.

comm-protocol-hub 是专为 DeepSeek Harness (DSH) 打造的原生 3GPP 通信协议知识库插件,是 DSH 生态中面向通信领域的专业协议查询工具。它将 3GPP Release 15 至 18 版本中散落的 70 余条通信协议规范,按地面网络、非地面网络、全息通信、近远场通信等 8 个维度做了结构化整理。提供关键词搜索、分类浏览、单条详情查询三个核心工具,帮助 AI 助手快速获取准确的通信协议信息。

该工具解决了现有 3GPP 协议分散在数十份文档中、跨版本查找耗时久,以及大模型回答通信协议问题时容易产生幻觉等痛点。它主要面向需要频繁查询 3GPP 标准的通信工程师、AI 研究员和开发人员。典型工作流为用户提出协议相关问题,DSH 智能体调用对应工具完成检索,返回带官方 3GPP 溯源链接的结构化协议信息。

本项目采用 MIT 许可开源,可通过 npx 命令从本地路径或 GitHub 直接安装,安装后只需重启 DSH 配置文件即可使用。所有协议数据已内嵌,无需额外联网即可查询,每条记录都附带官方 3GPP 链接便于溯源。新增协议仅需在对应数据目录添加 JSON 条目,无需修改核心代码,项目欢迎开发者提交 Issue 和 Pull Request 参与贡献。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 15 stars - an early-stage project星标 15,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Thanksgiver233/comm-protocol-hub

把 Thanksgiver233/comm-protocol-hub 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

# comm-protocol-hub

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

License: MIT 3GPP DSH Plugin


项目简介

将分散在 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+

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev cleverer-dsh 下一个 Next DeepSeek-Harness-Browser →