Appearance
🐣 小a的词典
这本书出现了很多术语。老z给小a编了本词典——忘了就查,查了就懂。 按主题分组,而非字母序(更好理解)。
LLM 与模型层
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| LLM | 大语言模型,本质是"预测下一个 token 的接龙机器" | 1 |
| token | 文字的最小零件(介于字和词之间),计费/窗口/思考都按它计 | 1 |
| 参数 | 模型脑子里的"旋钮",训练时调好 | 1 |
| 训练 | 调旋钮的过程(昂贵,只做一次) | 1 |
| 推理 | 用调好的旋钮接龙(每次调用都做) | 1 |
| 上下文窗口 | 一次能"看进来"的 token 上限(短期记忆容量) | 1 |
| maxTokens | 单次输出的上限(别和窗口搞混) | 1 |
| 幻觉 | 自信地编造不存在的事实(因为在"接"不在"查") | 1 |
| 温度 | 接龙的"放飞程度"(低=稳,高=活) | 1 |
| 思维链(CoT) | 把推理过程一步步写出来(像草稿纸列竖式) | 2 |
| 思考强度 | 控制思考投入的旋钮(off/minimal/low/medium/high/xhigh/max) | 2 |
| Stop Reason | 模型停下来的原因(6 种:pending/stop/length/toolUse/error/aborted) | 2 |
| 多模态 | 模型不止能读文字,还能读图 | 3 |
调用与厂商
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| Provider | 厂商适配器("翻译员"),对外说统一话,对内翻方言 | 3, 17 |
| System Prompt | 给模型定"人设"的系统提示词 | 4 |
| 流式(streaming) | 边生成边吐(像打电话,不像写信) | 3 |
| 流式部分 JSON | 话没说完就要开始猜的不完整 JSON | 3, 5 |
| 限流(429) | 厂商说"你太快了",要退避重试 | 3 |
| 巴别塔危机 | 多家厂商方言不通的混乱 | 3 |
Agent 核心
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| Agent | 会自主干活的"生物" = 脑子+手+循环+记忆+设定(≠ 大模型) | 5 |
| function calling | 让模型吐结构化订单(而非人话)的机制 | 5 |
| Tool | 包装好的能力单元(name+description+schema+execute) | 6, 20 |
| Loop | Agent 的核心节奏(喂模型→生成→调工具→回喂→循环) | 7, 26 |
| ReAct | 循环的经典范式(Observe→Think→Action 循环) | 7 |
| Memory | 循环的"笔记本"(对话历史+工具结果) | 8, 28 |
| 消息角色 | user/assistant/system/tool(循环靠它们流转信息) | 7 |
扩展与生态
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| MCP | Model Context Protocol,工具的"USB 标准"(写一次,所有 agent 能用) | 10 |
| Skill | 比 tool 高一层的能力包(一组 tool+提示词+知识),pi 用 markdown 实现 | 11 |
| Extension | 代码级扩展(TypeScript),比 skill 重 | 11, 31 |
| 子代理(sub-agent) | 主 agent 派的"分身",干完汇报 | 12 |
| Agent Teams | 多个专长 agent 长期协作(像团队) | 12 |
| ACP | Agent Communication Protocol,agent 之间对话的协议 | 12 |
| A2A | Agent-to-Agent,agent 互相发现并协作的协议 | 12 |
范式与架构
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| Loop(范式) | 模型自主循环(pi 的选择) | 14 |
| Workflow | 固定步骤序列(开发者写死路线) | 14 |
| Graph | 节点+边的图编排(复杂路由) | 14 |
| RAG | 检索增强生成(先查资料再答) | 13 |
| embedding | 把文字转成向量(语义坐标) | 13 |
pi 专有
| 术语 | 一句话解释 | 对应章 |
|---|---|---|
| harness | "马具"——给裸 Agent 穿衣服(system prompt/tools/session) | 18 |
| compaction | 上下文压缩(窗口满了把旧对话总结成摘要) | 18 |
| fork(会话) | 从某点分出一条新线(试不同方案) | 18 |
| streamFn | agent-core 依赖的抽象"流函数"接口(依赖倒置) | 16, 18 |
| trust-manager | 信任机制(进新目录先确认,防 prompt 注入) | 20 |
| prompt 注入 | 恶意内容伪装成指令,诱导模型干坏事(防它靠 trust + 白/黑名单 + 确认) | 15, 20 |
| snapshot | 远程协议的"权威快照"(不能丢) | 21, 22 |
| progress | 远程协议的"瞬态进度"(可丢,只刷显示) | 21, 22 |
| 差分渲染 | 只重画变的行(让终端不闪) | 19 |
| CSI 2026 | 同步输出的终端序列(\x1b[?2026h/l) | 19 |
| CBOR | 二进制 JSON 替代品(比 JSON 紧凑) | 21 |
| LLM-as-judge | 用模型评判模型(评测用) | 23 |
设计模式(详见附录 D)
| 术语 | 一句话解释 |
|---|---|
| 工厂模式 | 不 new,把配置喂给工厂函数造对象(pi 的 createProvider) |
| 观察者模式 | 一处变化,多处通知(pi 的 subscribe) |
| 责任链 | 一路往下试,任一环搞定就停(pi 的 auth resolve) |
| 适配器模式 | 把不同接口转成统一(pi 的 transform-messages) |
| 代理模式 | 不直连,经中间人(pi 的 proxy.ts) |
| 策略模式 | 同接口,不同实现(pi 的 streamSimple/completeSimple) |
缩写速查
| 缩写 | 全称 | 中文 |
|---|---|---|
| LLM | Large Language Model | 大语言模型 |
| CoT | Chain of Thought | 思维链 |
| MCP | Model Context Protocol | 模型上下文协议 |
| ACP | Agent Communication Protocol | Agent 通信协议 |
| A2A | Agent-to-Agent | Agent 间协议 |
| RAG | Retrieval-Augmented Generation | 检索增强生成 |
| TUI | Terminal User Interface | 终端用户界面 |
| CLI | Command Line Interface | 命令行界面 |
| RPC | Remote Procedure Call | 远程过程调用 |
| CBOR | Concise Binary Object Representation | 简明二进制对象表示 |
| SSE | Server-Sent Events | 服务器发送事件 |
| API | Application Programming Interface | 应用编程接口 |
| SDK | Software Development Kit | 软件开发包 |
| DAG | Directed Acyclic Graph | 有向无环图 |
| YAGNI | You Aren't Gonna Need It | 你暂时不需要(别提前做) |