前言¶

在 DeepSeek Harness（DSH）裏做 NestJS 相關開發或輔導時，常見做法是反覆打開官方文檔站點、憑記憶拼接企業級實踐，練習則在本地另起工程。文檔體量大、版本更新快，學習與編碼環境又往往割裂。NestJS 助手是維護者 lniev 發佈的 DSH 客戶端插件：把官方文檔 165 頁整理成可檢索的中文知識庫，並配上企業地圖、分階段學習路線，以及能在插件內真實編譯、啓動 Nest 應用的操練場。下面介紹它的定位、能力與安裝方式。

這是什麼¶

插件在 DSH 內的包名爲 @local/nest-assistant，當前發佈版本 v1.0.1（MIT 許可證）。它面向在 DSH Web UI 中學習和編寫 NestJS 的用戶：Host 半加載知識庫、註冊 nest_docs 工具與操練場 API；Client 半在側邊欄提供「NestJS 助手」面板，內含四個 Tab。分類爲客戶端，與 DSH「一切皆插件」的擴展方式一致；社區目錄頁見 skillhub.cn/plugins/lniev/nestjs-assistant，源碼見 GitHub。

核心功能¶

知識全貌¶

插件將 NestJS 官方文檔倉庫 content/ 下 165 個 Markdown 頁面逐頁總結爲中文結構化條目（摘要、核心機制、關鍵要點、代碼片段、API、常見坑、企業建議等），並保留官方 URL。界面提供目錄樹、搜索，以及跳原文、問 AI 講解等能力。

企業地圖¶

以 12 個能力域組織企業級 NestJS 知識，標註 L1–L4 成熟度，並包含實踐建議、上線檢查清單、反模式、關鍵 Nest API 與推薦項目結構。

學習路線¶

分爲 7 個階段、30 個練習（資料中界面說明爲 7 階段 30 個練習；操練場模塊編號至 s7-4）。每項包含目標、要點、交付物、驗收標準、時長與關聯文檔頁，可勾選進度；練習卡片支持一鍵進入操練場並選中對應模塊。

操練場¶

左右分欄：左側爲與 真實 DSH 會話 聯動的 AI 教練（Markdown 渲染與 One Dark 代碼高亮）；右側爲代碼模塊欄、可摺疊文件樹、編輯器與運行結果面板。

• 31 個代碼模塊：學習路線 30 個練習（s1-1 … s7-4）+ 自由沙盒 sandbox（初始 Cats 示例）；每模塊含 playground-modules/<moduleId>/module.json 與 default/ 下的可編譯 Nest 工程（src/main.ts、package.json、nest-cli.json 等腳手架形態）。
• 代碼版本：編輯後可「保存並命名」；同一模塊可存多份版本，支持切換與「重置爲默認代碼」；切換模塊或版本時會先停止正在運行的應用。
• 運行時：Host 側 playground-runtime.js 在沙箱內編譯 TypeScript 並用內置 Node 啓動真實 Nest 應用，支持自測路由、手動發請求與查看日誌；狀態落在 playground-state.json 與 playground-saves/（可刪除以恢復默認）。

給 AI 用的能力¶

Host 半額外提供：

• nest_docs 工具（search / read / list / map / route），便於會話直接查內置知識庫；
• 同源 HTTP API /nest-assistant/api/*（知識庫、沙箱文件、運行/請求/停止）；
• 與操練場用法相關的系統提示片段。

離線校驗方面，倉庫說明當前 31/31 個模塊默認工程可通過 node scripts/verify-modules.mjs 完成編譯、啓動與請求驗證。

安裝與啓用¶

前提：DeepSeek Harness ≥ 0.2.2（桌面版或網頁版均可），本機需能訪問 GitHub（或鏡像/代理）。插件聲明 Node ≥ 20.0.0、dsh ≥ 0.2.2-0。

從 GitHub 安裝時建議固定 tag：

github:lniev/nestjs-assistant#v1.0.1

1. Web UI：左側欄「插件」→「安裝第三方插件」→ 粘貼上述地址 → 安裝。
2. 會話內安裝：讓 AI 調用 plugin_manager 的 install_bundle，target 填同一地址。
3. CLI：dsh plugin --profile <profile> add github:lniev/nestjs-assistant#v1.0.1。

安裝後打開側邊欄「NestJS 助手」。升級需先卸載再使用新 tag 安裝；完整發布與排錯見倉庫 PUBLISHING.md。

典型用法¶

查文檔、講概念¶

在「知識全貌」中按目錄或搜索定位頁面，閱讀中文總結；或在 DSH 會話中依賴插件註冊的 nest_docs，讓模型基於內置庫回答，減少反覆打開官網。

按路線學習並練手¶

在「學習路線」勾選進度，點擊「去操練場練一練」跳到對應模塊（如 s3-2）。在右側改代碼，保存命名版本，啓動虛擬 Nest 環境驗證路由；左側與 AI 教練討論實現與踩坑。

自由實驗¶

在操練場選擇 sandbox 或其它模塊，手動新建文件/文件夾，或在多版本之間切換對比；不需要時可將 playground-state.json 與 playground-saves/ 刪掉以回到默認沙盒狀態。

維護者本地開發插件時（僅供貢獻者參考，與終端用戶安裝無關）：

node build.mjs              # 生成 client.js
node scripts/build-data.mjs # 合併 knowledge → data.json
node scripts/smoke.mjs      # 離線校驗

適用場景與注意¶

適合：在 DSH 內系統學習 NestJS、對照官方文檔脈絡做中文速覽、需要「能跑起來」的小練習而不想每次 nest new 開新倉的團隊或個人。

注意：

• 插件以當前 DSH 進程的本機權限運行；README 明確要求只安裝可信來源，安裝前應查看源碼與 MIT 許可證。
• 知識庫覆蓋的是插件打包時的官方文檔頁面集；企業地圖與學習路線數據在 knowledge/ 下，由 build-data.mjs 合併生成運行時 data.json。
• 社區目錄（skillhub）與 DeepSeek / 幻方無官方從屬關係，僅作發現與鏈接用途。

結尾¶

NestJS 助手把 165 頁官方文檔中文知識庫、企業地圖、7 階段學習路線 與 31 個可運行模塊的操練場 收進一個 DSH 客戶端插件，並打通 AI 教練與 nest_docs 工具。若你已在用 DSH 做後端或智能體相關開發，可按上文 tag 安裝後在側邊欄直接使用。

• 目錄頁：https://www.skillhub.cn/plugins/lniev/nestjs-assistant
• 倉庫：https://github.com/lniev/nestjs-assistant