前言¶
查一條 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
