前言¶
在 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
- Web UI：左侧栏「插件」→「安装第三方插件」→ 粘贴上述地址 → 安装。
- 会话内安装：让 AI 调用
plugin_manager的install_bundle，target填同一地址。 - 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 安装后在侧边栏直接使用。
