前言¶
在 DSH 裏做通信相關問答時,模型往往要引用 3GPP 技術規範(TS)。這些文檔分散在數十份 PDF 中,跨 Release 15 到 Release 18 查找一條協議,通常需要人工翻頁、對照編號。即便把規範餵給模型,索引零散也不利於按 NTN、全息、近遠場等主題檢索。
下面介紹 maintainer Thanksgiver233 維護的 comm-protocol-hub。它將 70+ 條 3GPP 規範按 8 個維度結構化,並通過三個 DSH 工具提供搜索、瀏覽與詳情查詢,數據內嵌、可附官方鏈接溯源。SkillHub 分類爲「記憶」;GitHub 倉庫當前約 14 stars。
這是什麼¶
comm-protocol-hub 是 DeepSeek Harness(DSH)生態中的 3GPP 通信協議知識庫插件。它將分散在 Release 15~18 的 70+ 條規範,按地面網絡(TN)、非地面網絡(NTN)、全息、近場、遠場、混合、安全、通用等 8 個維度整理爲結構化索引。
插件面向通信工程師和在 DSH 中處理協議問題的 AI 助手。README 稱其爲首個面向通信領域的 DSH 協議知識庫插件。項目採用 MIT 許可證,npm 包名爲 dsh-comm-protocol-hub,當前版本 1.0.0。
核心功能¶
三個 DSH 工具¶
| 工具名 | 用途 |
|---|---|
comm_protocol_query |
按關鍵詞或規範編號搜索 |
comm_protocol_browse |
按分類瀏覽協議列表 |
comm_protocol_detail |
查看單條協議的完整技術參數 |
協議數據內嵌在插件中,查詢無需聯網。每條記錄附 3GPP 官方鏈接,便於對照原文。
8 維分類與覆蓋範圍¶
| 分類 | 說明 | 協議數 | 覆蓋示例 |
|---|---|---|---|
| 地面網絡(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+ 條。數據文件位於 src/data/,按分類拆分爲 8 個 JSON 文件。
客戶端組件¶
除 Host 側三個工具外,插件還提供 Client 組件:ProtocolPanel(交互式面板)與 ProtocolNode(對話內聯卡片),用於在 Web 端展示查詢結果。
安裝與啓用¶
DSH 採用「一切皆插件」的擴展方式;SkillHub(skillhub.cn)是社區目錄站點,與 DeepSeek / 幻方無官方從屬關係。安裝前建議閱讀倉庫源碼與 LICENSE,確認插件將以當前 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:Thanksgiver233/comm-protocol-hub
安裝後重啓 DSH profile(web)。
典型用法¶
查單條規範詳情¶
用戶提問示例:「幫我查一下 TS 38.300 講了什麼」
AI 調用 comm_protocol_detail,可返回 NR 物理層概述、numerology、frame structure 等內容。
按主題搜索 NTN 協議¶
用戶提問示例:「NTN 有哪些相關協議?」
AI 調用 comm_protocol_query(如指定 category=NTN),可列出衛星通信相關規範,含 Direct-to-Cell、HARQ 適配等條目。
按分類瀏覽¶
用戶提問示例:「查看全息通信所有協議」
AI 調用 comm_protocol_browse,按全息通信分類展開協議列表。
適用場景與注意¶
適合誰
- 需要在對話中快速定位 3GPP TS 編號的通信工程師
- 在 DSH 智能體中處理 NR、NTN、全息、安全通信等主題的開發者
- 希望減少模型在協議問題上「幻覺」、需要可追溯規範來源的場景
使用注意
- 插件索引基於 3GPP 官方規範整理,完整 PDF 仍需通過 3GPP Portal 獲取
- 協議版本演進較快,新增條目可編輯
src/data/<category>_protocols.json;可用分類標識爲 TN、NTN、HOLOGRAPHIC、NEAR_FIELD、FAR_FIELD、HYBRID、SAFETY、MISC - 開發構建命令:
pnpm install、pnpm typecheck、pnpm build
結尾¶
comm-protocol-hub 把跨 Release 15~18 的 70+ 條 3GPP 規範收進 8 維分類,用搜索、瀏覽、詳情三個工具替代翻 PDF。對 DSH 裏的通信問答,它提供結構化索引與官方鏈接,便於覈對與擴展。
- SkillHub 目錄頁:https://www.skillhub.cn/plugins/Thanksgiver233/comm-protocol-hub
- GitHub 倉庫:https://github.com/Thanksgiver233/comm-protocol-hub