第 1 批 · 载体、会话与判断
这三十个词你这周全见过:驭驭搬家那天的 session、pane、resume,Jev 那天的 probe、threshold、confidence,接口里的 endpoint、token、schema。
- 载体与会话 12
- 判断与验证 11
- 接口与数据 7
怎么读:一格一格读,每张卡最后一行是你能直接说的一句话。读完做页尾遮答。念法用汉字近似,只为敢开口,不追求标准。
一、载体与会话
Section titled “一、载体与会话”载体:一个席位跑在哪个程序、哪台机、哪个壳里。
- 来历
- carry 是“背着走”。航母叫 aircraft carrier,运营商叫 carrier,都是“承载别人的东西”。我们借它指“承载一个席位灵魂的那层壳”,这是集团自己的用法,外面的人不这么说。
- 词族
- carry 背、carriage 车厢、carrier 载体;近邻 runtime 运行时、harness 挽具(第 9 课)。
- 在我们这
- 驭驭是 agent-aios-carrier,“载体席”;换壳 = 换 carrier 不换人。
- 别误读
- 不是“模型”。同一个席位可以从 Claude 换到 Codex,人不变,carrier 变。
- 你能这么说
- “这席现在的载体是什么,跑在哪台机?”
会话:从开始到结束的一整段“在一起”的时间,里面的状态是连着的。
- 来历
- 拉丁语 sessio,“坐着”。法庭开庭叫 session,议会一届叫 session:坐下来到散会算一段。
- 词族
- session id 会话编号、session file 会话文件、resume a session 接回会话;herdr 里 session 又指“一个命名的常驻服务端”。
- 在我们这
- 驭驭的 Claude 会话编号 3c093bb4…,搬家时带上它上下文才不丢;herdr 里每席一个命名 session,如 aios-carrier。
- 别误读
- 同一个词两层意思:Claude 的对话会话,和 herdr 的服务端会话。问的时候说清是哪个。
- 你能这么说
- “把这个 session 原样接回来,别开新的。”
窗格:一个窗口里被切出来的一小块屏幕,里面跑一个程序。
- 来历
- 本义是“一块窗玻璃”(window pane)。整扇窗是 window,窗上的一格玻璃是 pane。
- 词族
- window 窗口、tab 标签页、split 切分、panel 面板(注意不是同一个词);herdr 的 w2:p1 = 工作区 2 的窗格 1。
- 在我们这
- 驭驭在 herdr 会话 aios-carrier 的 w2:p1;Jev 实测是对 87 个 pane 逐个读屏。
- 别误读
- pane 是玻璃,panel 是控制面板;一个 pane 只跑一个程序,不是“一个人”。
- 你能这么说
- “把 xingxing 会话 w2:p1 那格屏幕读给我看。”
工作区:一组标签页和窗格的容器,通常对应一个项目目录。
- 来历
- work 工作 + space 空间,“干活的那块桌面”。
- 词族
- workspace 工作区 → tab 标签页 → pane 窗格,三层套娃;cwd(current working directory)当前工作目录。
- 在我们这
- herdr 里 w2 就是一个 workspace;Ling 定的规矩:一个席位的会话里只留一个工作区,打开就是那一个人和他拉起的队。
- 别误读
- 不是“工作站”,也不是电脑;它是软件里的一层组织。
- 你能这么说
- “多出来的空 workspace 关掉,只留 w2。”
终端:你打字、程序回字的那个黑窗口。
- 来历
- terminus 是“终点”。早年电脑是一台大主机,人坐在线路末端的一台“终端机”上敲字,名字留到今天。
- 词族
- terminal 终端、TUI(terminal user interface)终端里的界面、multiplexer 复用器(tmux、herdr 就是)。
- 在我们这
- 你的 Termius 打开的就是终端;席位全部住在终端里,herdr 把很多终端塞进一个窗口。
- 别误读
- terminal 不是“最终版”;“terminal event”在我们的派工术语里指“进程真的结束了”这件事。
- 你能这么说
- “进程结束不等于结果可用,我要看 terminal event 之后的收据。”
壳:你在终端里输命令时,真正在听你说话的那个程序(zsh、bash)。
- 来历
- 操作系统的核心叫 kernel(果仁),包在外面让人操作的那层就叫 shell(壳)。
- 词族
- login shell 登录壳(会读你的启动文件,带上 PATH)、shell script 壳脚本、zsh / bash 两种壳。
- 在我们这
- 搬驭驭时手册铁律:“必须用登录 shell,别手写 PATH”,因为登录壳会自动带上各机不同的工具路径。
- 别误读
- shell 不是终端:终端是窗户,shell 是窗户后面听话的人。
- 你能这么说
- “这个服务端是从哪个 shell 起的?能登录的那个吗?”
提示:两个意思。一是命令行里那个等你输入的记号;二是你发给模型的那段话。
- 来历
- 本义“催促、提醒”。舞台上给演员提词的人叫 prompter。命令行的 ❯ 在催你输入,发给模型的话在催它回答。
- 词族
- prompt 提示、prompt injection 提示注入(外来文字冒充指令)、system prompt 系统提示;herdr 的 agent prompt 是“把一段话送进某个 agent”。
- 在我们这
- 唤醒一个席位就是 herdr agent prompt 一行;席位停在 ❯ 就是在等 prompt。
- 别误读
- 不是“及时”(那是 prompt 作形容词)。
- 你能这么说
- “用 prompt 喊他一声,看他有没有从 idle 变 working。”
接上 / 断开:把你的屏幕接到一个还在跑的会话上看,或者离开它,它照跑。
- 来历
- attach 是“系上”,detach 是“解开”。会话像一辆一直在跑的车,attach 是你上车,detach 是你下车,车不停。
- 词族
- tmux attach、herdr --remote(远程接上)、reattach 再接上、attachment 附件(邮件里那个,同源)。
- 在我们这
- 你在 Termius 敲 tmux attach -t aios-carrier 就是接上驭驭;克老师从 LG01 看 LX01 用的是 herdr --remote。
- 别误读
- detach 不是关掉。断连不等于席位死了,这是 herdr 和 tmux 存在的意义。
- 你能这么说
- “我 detach 了以后他还在跑吗?”
接着来:从上次停下的地方继续,带着原来的记忆。
- 来历
- re(再)+ sume(拿起),“重新拿起来”。简历 résumé 是同一个词的法语写法,意思是“把经历重新拿出来说一遍”。
- 词族
- claude --resume 会话编号、codex resume、restore 恢复、continue 继续。
- 在我们这
- 驭驭任务书最要紧一行:“拉起时必须加 --resume,否则上下文归零”。搬完屏上 ctx 31% 和搬前一样,就是 resume 成功。
- 别误读
- Context 100% left 不是“干净”,是“丢了”。
- 你能这么说
- “重拉的时候带 resume 了没有?上下文百分比对得上吗?”
守护进程 / 服务端:在后台一直活着、随时接活的程序,没有自己的窗口。
- 来历
- daemon 来自希腊神话里在幕后干活的小神,六十年代 MIT 的人拿它给后台程序起名。server 是“伺候的人”,client(客户端)来找它要服务。
- 词族
- server 服务端 / client 客户端、background 后台、LaunchAgent(macOS 起后台程序的机制)、herdr server 就是它的守护进程。
- 在我们这
- herdr --session xingxing server 起的是守护进程;从哪个 shell 起它,决定里面的 Claude 能不能登录。
- 别误读
- daemon 不是 demon(魔鬼),拼法不同;server 不一定是“服务器那台机器”,一个小程序也能是 server。
- 你能这么说
- “服务端还活着吗?重启它会不会把窗格里的席位杀掉?”
插座:两个程序之间说话的接口;本机的叫 socket 文件,网络上的是 IP 加端口。
- 来历
- 就是墙上的电源插座。你的程序把插头插进去,就能和另一头通电(通话)。
- 词族
- socket API、port 端口、Unix socket 本机插座文件(如 ~/.config/herdr/herdr.sock)、WebSocket 网页长连接。
- 在我们这
- herdr 的 CLI 全靠 socket 和服务端说话;换会话就是换 socket 文件。
- 别误读
- 不是“套接字”就懂了。记“插座”,一插一拔。
- 你能这么说
- “这个会话的 socket 还在吗?在就说明服务端没死。”
环境变量:程序启动时随身带的一串“键=值”设置;PATH 是其中最重要的一个,告诉系统去哪些目录找命令。
- 来历
- environment 是“周围环境”。程序不是在真空里跑,它出生时周围有一堆设定,叫环境。PATH 是“路径”,一串用冒号隔开的目录。
- 词族
- export 导出(设一个环境变量)、env 环境、TELEGRAM_STATE_DIR 这种全大写的就是环境变量、前置 .bun/bin 就是把某目录放到 PATH 最前。
- 在我们这
- 载体契约五项里三项是环境变量;驭驭 done_when 第 4 条要在内核里读到 CLAUDE_CODE_AUTO_COMPACT_WINDOW=633000。
- 别误读
- 改了文件不等于跑着的进程知道了:环境变量是出生时带的,重拉才生效。
- 你能这么说
- “进程环境里有没有那个变量?别看配置文件,看内核。”
二、判断与验证
Section titled “二、判断与验证”探针:一段脚本对系统问一个是非题,只认退出码,随时能重跑。
- 来历
- 本义是探测器、探空针,医生的探针、探月的 probe 都是它:伸进去看一眼,不动手术。
- 词族
- probe 探针、health check 健康检查、canary 金丝雀(先放一只去试)、smoke test 冒烟测试。
- 在我们这
- 契约脚本第 5 项就是探针:开个临时窗格起一个 claude,读横幅是 Claude Max 还是 API Usage Billing。
- 别误读
- 探针是检测不是修法;它告诉你坏了,不告诉你怎么修。
- 你能这么说
- “起完服务端先跑探针,横幅 PASS 再拉席。”
status 是“现在报出来的一个标签”,state 是“它真实的全部状况”。
- 来历
- 同根,都是拉丁语“站着的样子”。status 偏“地位、名头”,state 偏“状态本身”。
- 词族
- status bar 状态栏、status code 状态码、state machine 状态机、stateless 无状态。
- 在我们这
- herdr agent list 给的是 status(idle/working/blocked/done),Jev 实测它只对 8/26;Jev 看的是屏幕整体的 state 再给判断。
- 别误读
- status 是别人报的,可能过时、可能错;state 要自己看证据。第 6 课“作者说成了不算”就是这个。
- 你能这么说
- “别念 status 给我,读屏告诉我它的 state。”
空闲 / 在干 / 卡住等人 / 做完了:herdr 给每个 agent 的四种读数。
- 来历
- idle 本义“闲着、空转”(发动机怠速就是 idle);blocked 是“被挡住”;done 是“完了”。
- 词族
- idle 空闲、busy 忙、blocked 阻塞、stalled 停滞(说在干但没动)、pending 待定。
- 在我们这
- Jev 把它改成四件事:working、waiting_for_human(等人答)、idle_done、broken;再加“在这个状态多久”。
- 别误读
- idle 和 done 都表示“能收字”;blocked 不是坏了,是有个框在等人按键。
- 你能这么说
- “他是 idle 了还是 blocked?blocked 的话屏上那个框写的什么?”
计时器 / 已过去的时间:屏上”(2m 41s · esc to interrupt)“就是它,表示这一轮已经跑了多久。
- 来历
- elapse 是”(时间)流逝”。elapsed time 就是“到现在为止流走了多少”。
- 词族
- timer 计时器、elapsed 已用时、duration 时长、uptime 开机时长、session:10675m 会话已开多久。
- 在我们这
- 五种载体的计时器长得不一样:Claude “Crunched for 57s · done 8:12 AM”,Codex “Working (2m 41s • esc…)”,Devin “Thinking · 40m 44s”。Jev 那条线里这些由代码认,不交给模型。
- 别误读
- 状态栏里 “(4h41m)” 是额度多久重置,不是在干活的计时。
- 你能这么说
- “这轮 elapsed 多少了?半小时没动就算卡了。”
超时:等到某个时限还没结果,就不等了,按失败或未知处理。
- 来历
- 球赛里的“暂停”也叫 timeout,都是“时间用完了”。
- 词族
- timeout 超时、retry 重试、backoff 退避(越等越久)、deadline 截止。
- 在我们这
- 克老师从 LG01 喊星星,--wait 报了 timeout,但字其实送进去了;所以定了规矩:超时先回读屏再判,delivered 和 state_observed 分开写。
- 别误读
- 超时不等于失败,只等于“没在时限内看到”。
- 你能这么说
- “timeout 了先读屏,别直接算没送到。”
阈值:一条线,过了就算一回事,没过就不算。
- 来历
- 本义是门槛(thresh 是踩踏,hold 是那块木头)。跨过门槛就进屋了。
- 词族
- threshold 阈值、cutoff 截断线、limit 上限、tolerance 容差。
- 在我们这
- 编队巡检的 --idle-min 60 和 --stall-min 30:停着超过六十分钟、说在干但三十分钟没动,才进“需要人管”。
- 别误读
- 阈值是人定的,不是模型给的;Jev 给概率,阈值决定概率多高算“是”。
- 你能这么说
- “这个 threshold 谁定的?Devin 的长任务要不要放宽?”
样本:从一大堆里抓出来的一份,用它代表全体,或者用它做对照。
- 来历
- 和 example 同源,“拿出来的一份”。
- 词族
- sample 样本、sampling 采样、sample A / sample B 前后两次采样、dataset 数据集。
- 在我们这
- Jev 实测每个窗格抓两次屏叫两个 sample;对比两次才知道有没有推进。
- 别误读
- 一个样本说明不了什么;判“停了”至少要两次。
- 你能这么说
- “两次 sample 隔了多久?隔太短看不出变化。”
标签:人给一份样本贴的“正确答案”,用来对照机器判得对不对。
- 来历
- 就是贴在瓶子上的标签。机器学习里“打标签”就是人先说这是什么。
- 词族
- label 标签、ground truth 真值、annotate 标注、agreement 一致率。
- 在我们这
- 我人工读了 26 个窗格打标签,Jev 26/26 一致,herdr 8/26,这两个数就是拿 label 对出来的。
- 别误读
- label 也可能错;人标的也要能被质疑。
- 你能这么说
- “你的准确率是对着谁的 label 算的?多少个?”
概率是“这件事有多大可能”,置信度是“我对这个答案有多把握”。两个数,不是一个。
- 来历
- probable 是“大概会”,confide 是“托付、信得过”。
- 词族
- probability 概率、confidence 置信度、calibrated 校准过的(说 0.9 就真有九成对)、uncertainty 不确定性。
- 在我们这
- Jev 判驭驭那格:working 概率 1.0、confidence 1.0;判 codex 停着的那几个,第一轮 confidence 只有 0.4,第三轮到 0.9 以上。
- 别误读
- 概率高不等于把握大:四个选项各 0.25 时它最“没把握”;置信度低的答案要人看。
- 你能这么说
- “confidence 低于 0.7 的别当结论,标出来我看。”
退出码:程序结束时留下的一个数,0 是成功,不是 0 就是哪里不对。
- 来历
- exit 退出,code 代号。程序走的时候留张字条。
- 词族
- exit code 退出码、return code 返回码、非零 non-zero、fail-open(出错反而放行,坏习惯)。
- 在我们这
- 编队巡检脚本的退出码就是“需要人管的窗格数”,0 表示全队正常;第 5 课的门只认退出码不认模型的话。
- 别误读
- “进程结束了”和“退出码是 0”是两件事;结束不一定成功。
- 你能这么说
- “退出码几?不是 0 的话错在哪一步?”
正则:用一串符号描述“长这样的文字”,让程序去找、去认。
- 来历
- regular expression 的缩写,“有规律的表达式”。
- 词族
- regex 正则、pattern 模式、match 匹配、parse 解析。
- 在我们这
- 认各载体计时器用的就是正则;它准,但只认它见过的形状,opencode 那次就把上一轮耗时认成了在跑。所以数字归正则,语义归 Jev。
- 别误读
- 正则不“理解”,只“匹配”;屏幕换个写法它就瞎。
- 你能这么说
- “这条判断是正则认的还是模型判的?正则的话换载体要补。”
三、接口与数据
Section titled “三、接口与数据”接口:一个程序对外开的门,别的程序按约定敲门就能用它。
- 来历
- application programming interface,“给程序用的界面”。人用的界面是 UI,程序用的是 API。
- 词族
- API key 门钥匙、endpoint 门牌、SDK(software development kit,帮你敲门的工具包)、HTTP API 走网页协议的门。
- 在我们这
- Jev 就是一个 API:POST 到 api.typesafe.ai/v1/systemone,0.6 秒回;herdr 的 socket API 是另一扇门。
- 别误读
- API 不是网站;它没有页面,只有约定。
- 你能这么说
- “这东西有 API 吗?还是只能在网页上点?”
端点:API 里具体的一个地址,一个地址干一件事。
- 来历
- end 端 + point 点,“线的那一头”。你的程序在这头,它的服务在那头。
- 词族
- endpoint 端点、URL 网址、route 路由、path 路径(/v1/systemone 这一段)。
- 在我们这
- Jev 只有一个端点 /v1/systemone;aios-comm 的投递也是一个端点。
- 别误读
- 不是“终点”;一个 API 常有几十个 endpoint。
- 你能这么说
- “你调的是哪个 endpoint?版本是 v1 还是 v2?”
钥匙 / 令牌:证明“我是谁、我有权用”的一串字。API key 长期有效,token 常常会过期。
- 来历
- key 是钥匙;token 本义是“信物、代币”,地铁代币那种,拿着就能进。
- 词族
- API key、access token 访问令牌、refresh token 刷新令牌、Bearer(“持有者”,HTTP 里“谁拿着谁能用”)、credentials 凭据、keychain 钥匙串(macOS 存密码的地方)。
- 在我们这
- Jev 的 key 存在 600 权限的文件里不进记录;Claude 的登录票在 credentials 文件或钥匙串,哪一份新鲜决定横幅是 Max 还是按量计费。
- 别误读
- token 还有另一个意思:模型计费的“字数单位”,输入每百万 token 0.042 美元。看上下文分。
- 你能这么说
- “这个 key 谁发的、放哪、谁能读?别贴到聊天里。”
请求 / 响应:你发过去的一包,和它回来的一包。
- 来历
- request 是“要求”,response 是“回应”。一问一答。
- 词族
- request body 请求体(发过去的内容)、response 响应、status code 状态码(200 成功、401 没权限、429 太频繁)、latency 延迟(一来一回多久)。
- 在我们这
- Jev 一次 request 带 state 和 questions,response 带 answers 和 usage;429 就退避重试。
- 别误读
- HTTP 200 只说明“门开了”,不说明答案对。
- 你能这么说
- “响应码多少?200 的话答案里置信度多少?”
一种写数据的格式:大括号包着“名字: 值”,程序之间都用它传东西。
- 来历
- JavaScript Object Notation,从 JavaScript 里借出来的写法,因为简单,谁都用了。
- 词族
- JSON、JSONL(一行一条 JSON)、field 字段、key/value 键值对、parse 解析、schema 结构约定。
- 在我们这
- herdr 每条命令回的都是 JSON;席位的 CURRENT.json、我的 current-task.json 都是它。
- 别误读
- JSON 是格式不是数据库;能读能写,但不会自己校验对错,那要 schema。
- 你能这么说
- “给我 JSON 别给我截图,我要能被程序读的。”
结构约定 / 字段:schema 规定一份数据该有哪些格子、每格放什么类型;field 就是其中一格。
- 来历
- schema 是希腊语“形状、图式”;field 是“田地、一块地”,表格里的一格。
- 词族
- schema 结构、field 字段、type 类型、required 必填、validate 校验。
- 在我们这
- Jev 的问题分 choice / score / noul 三种 type,答案的 schema 是固定的,所以叫 type-safe;派工收据有一份 result-receipt.schema.json。
- 别误读
- schema 不是“方案”;它只管形状,不管内容对不对。
- 你能这么说
- “这份收据按哪个 schema 校验过?缺哪个 field?”
载荷:一包数据里真正要传的那部分,不算信封和地址。
- 来历
- pay(付钱)+ load(货):货车里“能收钱的那部分货”,车皮和油不算。
- 词族
- payload 载荷、header 头(信封上的信息)、body 体、envelope 信封(我们派工用的 task envelope 就是这个比喻)。
- 在我们这
- 派工收据里 final-payload.txt 就是“最终答案本体”,其余是信封和证据。
- 别误读
- 不是“负载”(load,系统压力);payload 是内容。
- 你能这么说
- “别把整个包给我,把 payload 抽出来。”
遮答自测(先想再点开)
Section titled “遮答自测(先想再点开)”pane 和 panel 差在哪?
pane 是一块窗玻璃,指屏幕里切出来的一格;panel 是控制面板。herdr 的 w2:p1 里的 p 是 pane。
status 和 state 哪个能信?
status 是别人报的标签,可能过时可能错(herdr 三态 8/26);state 要自己看证据。
--resume 漏了会怎样?
上下文归零。屏上 Context 100% left 不是干净,是丢了。
timeout 等于失败吗?
不等于。只是时限内没看到;先回读屏,delivered 和 state_observed 分开写。
probability 和 confidence 一样吗?
不一样。概率是“多大可能”,置信度是“多有把握”;四个选项各 0.25 时最没把握。
token 的两个意思?
一是通行令牌(access token),二是模型计费的字数单位(每百万 token 多少钱)。
daemon 从哪个 shell 起为什么要紧?
它出生时带的环境决定里面的程序能不能登录;从活席同源的登录 shell 起才带对了钥匙和 PATH。
exit code 0 说明什么、不说明什么?
说明程序自己认为成功地结束了;不说明结果可用,那要看收据和消费者。
下一批代码结构与运行:function、module、library、dependency、version、pin、build、deploy、process、log、cron、background。这些词你在部署课程站和装 herdr 时全见过。回头日:这批词 9 月 21 日、23 日、27 日、10 月 11 日各回头一次,每次十个,我在当天课末或 Telegram 里出题。