先记三句话：API 是软件给程序的办事窗口；CLI 是用文字命令操作软件；MCP 是 AI 接工具和资料的共同规则。
我在山西开网吧。对我身边开网吧、电竞馆的朋友来说，查营业额、导经营报表、把文件存好，都是熟悉的事情。
咱们就拿这些事讲。先把三个词听懂，再用一份模拟数据试着做出结果。英文全称、底层协议和安装配置，可以等真正需要时再查。
如果你只是想听懂，读完前三张图就可以；如果想动手，接着做小练习。 后面的词典留着查，不用一次记完。
先把 API、CLI、MCP 听懂
API：软件给程序留的办事窗口
API 是一种接口，让程序可以按约定调用软件的功能。 把它想成软件专门留出的办事窗口，就容易理解了。
你自己查营业额，要打开收银后台，选日期和门店，找到上机收入、饮品收入。假设经营系统开放了 API，另一个程序可以直接向窗口提交请求，意思相当于递一张取数单：
查什么：上机、饮品的营业明细
哪段时间：本周
哪家门店：我在山西开的网吧
系统核对请求和权限后，返回对应的数据。程序拿到这些数据，就能继续汇总、生成报表。
API 的用途：让程序直接请求软件提供的数据或功能。取数单与经营后台均为概念示意。
对你有什么用？少做重复查询、复制、粘贴的工作。 例如每天收店后汇总营业额，有了合适的接口，程序就有机会直接取数。
API 也可以用于创建记录、保存文件，具体要看软件开放什么。并不是有一个 API Key，就能做这个软件里的所有事情；账号权限和接口能力都要匹配。
新手听到“这个系统有 API”，先问一句就很实用：它能让我取到哪些数据，完成哪些动作？
CLI：用文字命令操作软件
CLI 叫命令行界面，是按软件规定的格式输入命令，让软件执行的一种操作方式。 它像文字遥控器。
“终端”可以先理解成电脑上输入这些命令的窗口。你把指令输进去，按回车，程序执行后给出结果或报错。
比如你要导出一份网吧经营周报。假设报表软件提供了 CLI，一条命令就可以交代：“用本周、山西这家网吧的数据，生成报表。”
CLI 的用途：用规定格式的命令让软件执行。图中 report export 是虚构演示，不可直接照抄。
对你有什么用？同样的操作可以重复执行，也方便交给自动化工具。 例如每周导报表，按实际需要调整日期和门店，就能复用已有命令。
软件必须真的提供这条命令。AI 写出一行看起来很专业的文字，不代表电脑里就有这个程序。可以让助手先查官方说明，再说明命令会读取什么、生成什么。
你不用马上学编程。先知道：有些软件，除了点按钮，还能用文字命令操作。
MCP：AI 接工具和资料的共同规则
MCP 是 AI 应用与外部工具、资料进行连接的一套共同规则。 它约定工具怎样介绍自己的用途、接受什么信息，以及怎样把调用结果交回来。
假如你对 AI 说：“查店里这周的收入，做成周报，再存进云盘。”
AI 光能聊天，还交不出这份文件。它需要用上经营后台、报表工具和云盘。MCP 可以把工具说明整理成助手认识的格式：
- 查经营：给日期和门店，拿回营业明细。
- 做周报：给数据，生成报表文件。
- 存云盘：给文件和保存位置，返回保存结果。
MCP 的用途：让支持它的 AI 助手按共同规则认识和调用工具，实际工作仍由相应软件完成。
对你有什么用？让 AI 用上聊天框之外的能力。 大家遵守共同规则，也更方便把工具接到支持 MCP 的助手里。
使用前需要三样东西：支持 MCP 的 AI 应用、提供所需能力的工具服务、能访问目标数据的账号权限。 有一个“连接成功”的提示，还要再确认工具列表里有没有你需要的功能。
MCP 本身不提供网吧数据，也不会让经营系统自动多出原来没有的功能。本文是在解释一种可行用途，没有声称任何具体网吧软件已经支持这套连接。
读到这里，先记住窗口、文字命令、工具连接规则这三个意思，就已经够用了。
怎么做：用三天营业数据练一遍
第一次动手，可以先把数据交给 AI 处理，熟悉“交任务、拿结果、做核对”的过程。等报表要求确定，再考虑自动取数。
第一步：复制这份模拟数据
下面数字完全是练习用的，不是小龙哥网吧的真实收入。为避免口径混淆，练习假设“上机收入”和“饮品收入”是互不重叠的两项，不包含会员充值，也没有退款。
日期,门店,上机收入,饮品收入
2026-09-01,山西示例网吧,1200,180
2026-09-02,山西示例网吧,1500,240
2026-09-03,山西示例网吧,1300,210
可以直接把这段数据粘给 AI。若它支持读取文件，也可以存成 CSV 或表格后交给它；无需先注册开发者账号。
第二步：把结果要求说清楚
请只根据这三天的模拟营业数据，做一份经营小结：
1. 分别汇总上机收入、饮品收入和两项合计。
2. 找出合计最高的一天，列出计算过程。
3. 只描述数据能证明的变化，不猜原因，不推算整周。
4. 如果支持生成文件，请生成可打开的表格；
否则明确说明，并先给我可复制的结果表。
保留原始数据，不发送给其他人。
这一步是在练习交付结果，并不能证明你已经用上了 API 或 MCP。如果工具没有接入经营系统，AI 处理的就是你提供的这份数据。
第三步：用参考答案验一下
- 上机收入：4000 元。
- 饮品收入：630 元。
- 两项合计：4630 元。
- 单日合计最高：9 月 2 日，1740 元；计算为 1500＋240。
这里只能判断哪天更多。没有客流、活动和上机时长等资料，不能推断“因为办了电竞比赛，所以收入上涨”。三天的数据也不能直接叫完整周报。
若生成了文件，打开核对日期、门店、三行明细和合计。真正接入店里系统时，还要按系统口径区分会员充值、实际消费、退款，不能看到金额就直接相加。
第四步：需要重复做，再确认接入能力
当你已经知道报表要长什么样，可以把下面这段交给软件服务商或负责配置的人：
我想定期汇总指定门店的营业数据。请确认：
① 是否有只读查询数据的 API，具体能取哪些字段？
② 是否有现成 CLI 或导出功能，能生成什么文件？
③ 如果要让 AI 直接调用，是否提供兼容的 MCP 工具，能做哪些动作？
④ 需要哪个账号和哪些权限，是否另收费，失败时如何查看原因？
不用要求三样都配齐。先选能完成这件事的现有方式，跑通一份报表，再考虑定期执行。
容易踩坑：卡住时先查这几处
AI 只给了操作步骤。 先看当前助手有没有读取数据、运行命令或生成文件的能力。没有工具时，换个问法也不会让它凭空访问收银后台。
命令提示“找不到”。 可能是程序没安装、当前环境找不到它，或命令本来就是演示。先查该软件的官方命令说明，不要把图里的虚构命令当成安装教程。
MCP 已连接，还是查不到收入。 看工具列表里有没有查询营业数据的功能，再核对登录的是谁、能访问哪家店。连接、功能和权限要分别确认。
有返回结果，数字却不对。 先核对日期范围、门店、缺失行和统计口径。会员充值与消费额、收入与退款，不能不加区分地混算。
工具说“保存成功”，文件却找不到。 让它给出保存位置或文件链接，再实际打开；不要只接受一段“已完成”的话。
第一次试用陌生工具，先用模拟数据或必要的少量数据。密钥放在工具指定的凭据设置里；删除记录、发送给他人这类动作，要把对象和范围说清楚。
按需查阅：大模型和其他常见词
下面是配套小词典。遇到了再查，不影响你先使用前面的三个概念。
LLM（大语言模型）：负责理解上下文、生成文字和推理的模型。可以帮助解释营业变化、写小结，但数据得先提供或通过工具取回。AI 应用还包括界面、文件、工具与权限；应用支持什么，不只由模型决定。
Prompt（提示词）：你给 AI 的任务、要求和示例。“汇总这三天，只按已有数据判断”就是提示词。目标越具体，结果越容易核对。
Context（上下文）与 Token：上下文是模型这次实际能看到的对话、规则、文件片段和工具结果；Token 是模型处理内容时使用的小块，并不固定等于一个汉字或单词。上下文窗口有容量限制，过去聊过的内容未必每次都完整带入。
Tool Calling（工具调用）：模型提出“用这个工具、传这些参数”的请求，由应用安排执行，再把结果交回来。“查这家店的本周收入”可以是一次调用；MCP 是可用于工具连接的协议，工具调用也有其他实现方式。
Agent（智能体）：围绕目标，把模型判断、工具行动和结果检查组织起来的系统。比如先检查数据，再汇总，再打开生成文件核对；能自主做到哪一步，要看具体应用的设计和授权。
RAG（检索增强生成）：先检索外部资料，再把相关内容交给模型回答。比如先找店里的会员活动规则，再解释优惠。检索到的资料是否过期、是否适用，仍要核对。
Fine-tuning（微调）与 Inference（推理）：微调是用训练数据继续调整模型；推理是用已有模型处理当前输入、生成输出。临时上传一份报表让 AI 阅读，通常没有改变模型本身。
Terminal、Shell、CLI：Terminal 是终端窗口，Shell 是解释和调度命令的程序，CLI 是具体软件提供的命令行界面。先理解“在哪里输入、谁来解释、让哪个软件做事”，不用一开始就研究它们的配置。
MCP Server、Tools、Resources、Prompts：Server 是按 MCP 规则提供能力的程序，可以运行在本机或远端；Tools 提供可执行动作，Resources 提供可读取资料，Prompts 提供可复用模板。“Server”这个名字不代表你必须另买一台服务器。
验收标准与可复用提示词
怎么判断自己已经入门
能完成下面三件事，就可以往前走：
- 用自己的话解释 API 的窗口、CLI 的文字命令、MCP 的连接规则。
- 把模拟练习算对，并分清“AI 给的说明”和“实际能打开的文件”。
- 说清下一个小任务要用哪份数据、生成什么结果，当前还缺什么能力。
以后遇到陌生词，复制这段问
请把【术语】讲给没有技术背景的网吧、电竞馆经营者听。
先用一句普通话说它是什么，再用店里一个日常场景解释用途。
说明我需要准备什么，以及怎样判断它真的帮我完成了事情。
如果例子是假设或命令不能直接运行，请明确标注。
不要用一串新术语解释旧术语；暂时不用比较技术高低。
真要交一件事，复制这段改
我要完成：【具体任务】。
使用的数据：【文件、日期、门店】。
我想拿到：【能打开的文件或其他可核对结果】。
请先确认当前有哪些可用工具、缺哪些资料或权限。
用已具备的能力做一份样例；保留原始数据，不猜缺失信息。
完成后给出结果位置、数据范围和核对结果。
如需发送、删除或付费，先把具体对象和内容交给我确认。
来源与修订
- GitHub API 官方说明说明接口用于程序集成与自动化；GitHub CLI 文档给出真实命令行调用实例。本文网吧接口与报表命令均为教学示意，不对应现成产品承诺。
- MCP 定义、角色与能力依据官方入门和官方架构。工具规范解释工具说明和调用；具体产品兼容版本仍需按其文档确认。
- Shell 参考 POSIX Shell Command Language；大语言模型和 RAG 的原始研究分别为 Language Models are Few-Shot Learners 与 Retrieval-Augmented Generation。
- v2.0｜2026-09-08：按“讲清是什么与用途”的要求重编，增加网吧三图、模拟练习、参考答案和排错方法；旧网址继续使用。
- v1.0｜2026-08-14：以 AI 工作室介绍模型、命令行和工具连接概念。
本文是入门指南。模拟数据与插画用于说明方法，真实软件的安装、接口、权限与收费以其当前官方说明为准。
还没有评论。欢迎留下第一句。