| name | concept |
| description | 当用户问什么是 API、JWT、中间件、异步等编程概念或术语时使用 — 用大白话解释,适合初学者 |
概念解释
用最简单的语言解释编程概念,让初学者也能理解。
与 /explain 的区别
- /explain 解释一段具体的代码在做什么
- /concept 解释一个概念或术语是什么意思
步骤
1. 确定要解释的概念
如果用户已经提了,直接进入下一步。否则问:
你想了解什么概念?比如 API、数据库、JWT、RESTful、异步、中间件等。
2. 校准难度
在解释之前,先判断用户的水平(根据对话上下文或直接问):
- 入门 — 没有编程基础,需要完全用生活类比解释,避免一切术语
- 初级 — 写过一些代码,可以用简单代码示例,但术语需要解释
- 中级 — 有开发经验,可以讨论原理和权衡,给出实际项目中的用法
如果无法判断,默认按初级处理,并在开头问一句:
你之前接触过编程吗?我好调整解释的深度。
3. 分层解释
一句话定义
xxx 就是 xxx。
现实世界类比(必须包含)
用一个日常生活中的类比来解释这个概念。类比要具体、准确,点明概念的核心特征。
例:API 就像餐厅的菜单 — 你不需要知道厨房怎么做菜,只需要看菜单点菜(发请求),服务员(API)把菜(数据)端给你。
为什么需要它
如果没有 xxx,你会遇到 xxx 问题。用一个具体场景说明。
怎么用
优先用项目中的实际代码举例(如果项目里有用到这个概念)。如果没有,给一个最小可运行的代码示例(不超过 10 行)。
常见误区
指出初学者最容易搞混的 1-2 个点,用"xxx 不是 xxx"的句式澄清。
相关概念(知识图谱)
用层级关系展示相关概念,而不是简单罗列:
- 上层概念:xxx(xxx 是它的一部分)
- 同层概念:xxx vs xxx(区别是 xxx)
- 下层概念:xxx、xxx(属于 xxx 的具体类型)
- 常一起用:xxx + xxx(因为 xxx)
4. 追问
解释清楚了吗?想深入了解哪个部分?
遇到问题
- 用户说"还是不懂" — 换一个完全不同的类比重新解释;把概念拆成更小的子概念,逐个击破
- 用户搞混了两个相似概念 — 做一个并排对比表,列出相同点和不同点,再用一个例子同时展示两者
- 概念太抽象无法类比 — 用"如果没有它会怎样"的反面例子来解释;或者直接写一段最小代码让用户运行感受
- 用户需要更深入的理解 — 推荐具体的文档页面或教程章节,而不是泛泛地说"去看文档"