跳转到内容

第 1 批 · 载体、会话与判断

这三十个词你这周全见过:驭驭搬家那天的 session、pane、resume,Jev 那天的 probe、threshold、confidence,接口里的 endpoint、token、schema。

  • 载体与会话 12
  • 判断与验证 11
  • 接口与数据 7

怎么读:一格一格读,每张卡最后一行是你能直接说的一句话。读完做页尾遮答。念法用汉字近似,只为敢开口,不追求标准。

carrier 凯瑞尔

载体:一个席位跑在哪个程序、哪台机、哪个壳里。

来历
carry 是“背着走”。航母叫 aircraft carrier,运营商叫 carrier,都是“承载别人的东西”。我们借它指“承载一个席位灵魂的那层壳”,这是集团自己的用法,外面的人不这么说。
词族
carry 背、carriage 车厢、carrier 载体;近邻 runtime 运行时、harness 挽具(第 9 课)。
在我们这
驭驭是 agent-aios-carrier,“载体席”;换壳 = 换 carrier 不换人。
别误读
不是“模型”。同一个席位可以从 Claude 换到 Codex,人不变,carrier 变。
你能这么说
“这席现在的载体是什么,跑在哪台机?”
session 赛申

会话:从开始到结束的一整段“在一起”的时间,里面的状态是连着的。

来历
拉丁语 sessio,“坐着”。法庭开庭叫 session,议会一届叫 session:坐下来到散会算一段。
词族
session id 会话编号、session file 会话文件、resume a session 接回会话;herdr 里 session 又指“一个命名的常驻服务端”。
在我们这
驭驭的 Claude 会话编号 3c093bb4…,搬家时带上它上下文才不丢;herdr 里每席一个命名 session,如 aios-carrier。
别误读
同一个词两层意思:Claude 的对话会话,和 herdr 的服务端会话。问的时候说清是哪个。
你能这么说
“把这个 session 原样接回来,别开新的。”
pane 佩恩,和 pain 同音

窗格:一个窗口里被切出来的一小块屏幕,里面跑一个程序。

来历
本义是“一块窗玻璃”(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 那格屏幕读给我看。”
workspace 沃克斯佩斯

工作区:一组标签页和窗格的容器,通常对应一个项目目录。

来历
work 工作 + space 空间,“干活的那块桌面”。
词族
workspace 工作区 → tab 标签页 → pane 窗格,三层套娃;cwd(current working directory)当前工作目录。
在我们这
herdr 里 w2 就是一个 workspace;Ling 定的规矩:一个席位的会话里只留一个工作区,打开就是那一个人和他拉起的队。
别误读
不是“工作站”,也不是电脑;它是软件里的一层组织。
你能这么说
“多出来的空 workspace 关掉,只留 w2。”
terminal 特米诺

终端:你打字、程序回字的那个黑窗口。

来历
terminus 是“终点”。早年电脑是一台大主机,人坐在线路末端的一台“终端机”上敲字,名字留到今天。
词族
terminal 终端、TUI(terminal user interface)终端里的界面、multiplexer 复用器(tmux、herdr 就是)。
在我们这
你的 Termius 打开的就是终端;席位全部住在终端里,herdr 把很多终端塞进一个窗口。
别误读
terminal 不是“最终版”;“terminal event”在我们的派工术语里指“进程真的结束了”这件事。
你能这么说
“进程结束不等于结果可用,我要看 terminal event 之后的收据。”
shell 谢欧

壳:你在终端里输命令时,真正在听你说话的那个程序(zsh、bash)。

来历
操作系统的核心叫 kernel(果仁),包在外面让人操作的那层就叫 shell(壳)。
词族
login shell 登录壳(会读你的启动文件,带上 PATH)、shell script 壳脚本、zsh / bash 两种壳。
在我们这
搬驭驭时手册铁律:“必须用登录 shell,别手写 PATH”,因为登录壳会自动带上各机不同的工具路径。
别误读
shell 不是终端:终端是窗户,shell 是窗户后面听话的人。
你能这么说
“这个服务端是从哪个 shell 起的?能登录的那个吗?”
prompt 普让普特

提示:两个意思。一是命令行里那个等你输入的记号;二是你发给模型的那段话。

来历
本义“催促、提醒”。舞台上给演员提词的人叫 prompter。命令行的 ❯ 在催你输入,发给模型的话在催它回答。
词族
prompt 提示、prompt injection 提示注入(外来文字冒充指令)、system prompt 系统提示;herdr 的 agent prompt 是“把一段话送进某个 agent”。
在我们这
唤醒一个席位就是 herdr agent prompt 一行;席位停在 ❯ 就是在等 prompt。
别误读
不是“及时”(那是 prompt 作形容词)。
你能这么说
“用 prompt 喊他一声,看他有没有从 idle 变 working。”
attach / detach 阿泰奇 / 迪泰奇

接上 / 断开:把你的屏幕接到一个还在跑的会话上看,或者离开它,它照跑。

来历
attach 是“系上”,detach 是“解开”。会话像一辆一直在跑的车,attach 是你上车,detach 是你下车,车不停。
词族
tmux attach、herdr --remote(远程接上)、reattach 再接上、attachment 附件(邮件里那个,同源)。
在我们这
你在 Termius 敲 tmux attach -t aios-carrier 就是接上驭驭;克老师从 LG01 看 LX01 用的是 herdr --remote。
别误读
detach 不是关掉。断连不等于席位死了,这是 herdr 和 tmux 存在的意义。
你能这么说
“我 detach 了以后他还在跑吗?”
resume 瑞祖姆(动词)

接着来:从上次停下的地方继续,带着原来的记忆。

来历
re(再)+ sume(拿起),“重新拿起来”。简历 résumé 是同一个词的法语写法,意思是“把经历重新拿出来说一遍”。
词族
claude --resume 会话编号、codex resume、restore 恢复、continue 继续。
在我们这
驭驭任务书最要紧一行:“拉起时必须加 --resume,否则上下文归零”。搬完屏上 ctx 31% 和搬前一样,就是 resume 成功。
别误读
Context 100% left 不是“干净”,是“丢了”。
你能这么说
“重拉的时候带 resume 了没有?上下文百分比对得上吗?”
daemon / server 迪门 / 瑟沃

守护进程 / 服务端:在后台一直活着、随时接活的程序,没有自己的窗口。

来历
daemon 来自希腊神话里在幕后干活的小神,六十年代 MIT 的人拿它给后台程序起名。server 是“伺候的人”,client(客户端)来找它要服务。
词族
server 服务端 / client 客户端、background 后台、LaunchAgent(macOS 起后台程序的机制)、herdr server 就是它的守护进程。
在我们这
herdr --session xingxing server 起的是守护进程;从哪个 shell 起它,决定里面的 Claude 能不能登录。
别误读
daemon 不是 demon(魔鬼),拼法不同;server 不一定是“服务器那台机器”,一个小程序也能是 server。
你能这么说
“服务端还活着吗?重启它会不会把窗格里的席位杀掉?”
socket 索kit

插座:两个程序之间说话的接口;本机的叫 socket 文件,网络上的是 IP 加端口。

来历
就是墙上的电源插座。你的程序把插头插进去,就能和另一头通电(通话)。
词族
socket API、port 端口、Unix socket 本机插座文件(如 ~/.config/herdr/herdr.sock)、WebSocket 网页长连接。
在我们这
herdr 的 CLI 全靠 socket 和服务端说话;换会话就是换 socket 文件。
别误读
不是“套接字”就懂了。记“插座”,一插一拔。
你能这么说
“这个会话的 socket 还在吗?在就说明服务端没死。”
environment variable / PATH 因外伦门特 / 帕斯

环境变量:程序启动时随身带的一串“键=值”设置;PATH 是其中最重要的一个,告诉系统去哪些目录找命令。

来历
environment 是“周围环境”。程序不是在真空里跑,它出生时周围有一堆设定,叫环境。PATH 是“路径”,一串用冒号隔开的目录。
词族
export 导出(设一个环境变量)、env 环境、TELEGRAM_STATE_DIR 这种全大写的就是环境变量、前置 .bun/bin 就是把某目录放到 PATH 最前。
在我们这
载体契约五项里三项是环境变量;驭驭 done_when 第 4 条要在内核里读到 CLAUDE_CODE_AUTO_COMPACT_WINDOW=633000。
别误读
改了文件不等于跑着的进程知道了:环境变量是出生时带的,重拉才生效。
你能这么说
“进程环境里有没有那个变量?别看配置文件,看内核。”
probe 普罗布

探针:一段脚本对系统问一个是非题,只认退出码,随时能重跑。

来历
本义是探测器、探空针,医生的探针、探月的 probe 都是它:伸进去看一眼,不动手术。
词族
probe 探针、health check 健康检查、canary 金丝雀(先放一只去试)、smoke test 冒烟测试。
在我们这
契约脚本第 5 项就是探针:开个临时窗格起一个 claude,读横幅是 Claude Max 还是 API Usage Billing。
别误读
探针是检测不是修法;它告诉你坏了,不告诉你怎么修。
你能这么说
“起完服务端先跑探针,横幅 PASS 再拉席。”
status / state 斯泰特斯 / 斯泰特

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。”
idle / working / blocked / done 爱斗 / 沃king / 布拉克特 / 当

空闲 / 在干 / 卡住等人 / 做完了: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 的话屏上那个框写的什么?”
timer / elapsed 泰默 / 伊莱普斯特

计时器 / 已过去的时间:屏上”(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,都是“时间用完了”。
词族
timeout 超时、retry 重试、backoff 退避(越等越久)、deadline 截止。
在我们这
克老师从 LG01 喊星星,--wait 报了 timeout,但字其实送进去了;所以定了规矩:超时先回读屏再判,delivered 和 state_observed 分开写。
别误读
超时不等于失败,只等于“没在时限内看到”。
你能这么说
“timeout 了先读屏,别直接算没送到。”
threshold 斯瑞什霍德

阈值:一条线,过了就算一回事,没过就不算。

来历
本义是门槛(thresh 是踩踏,hold 是那块木头)。跨过门槛就进屋了。
词族
threshold 阈值、cutoff 截断线、limit 上限、tolerance 容差。
在我们这
编队巡检的 --idle-min 60 和 --stall-min 30:停着超过六十分钟、说在干但三十分钟没动,才进“需要人管”。
别误读
阈值是人定的,不是模型给的;Jev 给概率,阈值决定概率多高算“是”。
你能这么说
“这个 threshold 谁定的?Devin 的长任务要不要放宽?”
sample 散剖

样本:从一大堆里抓出来的一份,用它代表全体,或者用它做对照。

来历
和 example 同源,“拿出来的一份”。
词族
sample 样本、sampling 采样、sample A / sample B 前后两次采样、dataset 数据集。
在我们这
Jev 实测每个窗格抓两次屏叫两个 sample;对比两次才知道有没有推进。
别误读
一个样本说明不了什么;判“停了”至少要两次。
你能这么说
“两次 sample 隔了多久?隔太短看不出变化。”
label 雷宝

标签:人给一份样本贴的“正确答案”,用来对照机器判得对不对。

来历
就是贴在瓶子上的标签。机器学习里“打标签”就是人先说这是什么。
词族
label 标签、ground truth 真值、annotate 标注、agreement 一致率。
在我们这
我人工读了 26 个窗格打标签,Jev 26/26 一致,herdr 8/26,这两个数就是拿 label 对出来的。
别误读
label 也可能错;人标的也要能被质疑。
你能这么说
“你的准确率是对着谁的 label 算的?多少个?”
probability / confidence 普罗巴比利提 / 康非登斯

概率是“这件事有多大可能”,置信度是“我对这个答案有多把握”。两个数,不是一个。

来历
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 的别当结论,标出来我看。”
exit code 埃克西特 扣德

退出码:程序结束时留下的一个数,0 是成功,不是 0 就是哪里不对。

来历
exit 退出,code 代号。程序走的时候留张字条。
词族
exit code 退出码、return code 返回码、非零 non-zero、fail-open(出错反而放行,坏习惯)。
在我们这
编队巡检脚本的退出码就是“需要人管的窗格数”,0 表示全队正常;第 5 课的门只认退出码不认模型的话。
别误读
“进程结束了”和“退出码是 0”是两件事;结束不一定成功。
你能这么说
“退出码几?不是 0 的话错在哪一步?”
regex 瑞杰克斯

正则:用一串符号描述“长这样的文字”,让程序去找、去认。

来历
regular expression 的缩写,“有规律的表达式”。
词族
regex 正则、pattern 模式、match 匹配、parse 解析。
在我们这
认各载体计时器用的就是正则;它准,但只认它见过的形状,opencode 那次就把上一轮耗时认成了在跑。所以数字归正则,语义归 Jev。
别误读
正则不“理解”,只“匹配”;屏幕换个写法它就瞎。
你能这么说
“这条判断是正则认的还是模型判的?正则的话换载体要补。”
API A-P-I,三个字母分开念

接口:一个程序对外开的门,别的程序按约定敲门就能用它。

来历
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 吗?还是只能在网页上点?”
endpoint 恩德泡因特

端点:API 里具体的一个地址,一个地址干一件事。

来历
end 端 + point 点,“线的那一头”。你的程序在这头,它的服务在那头。
词族
endpoint 端点、URL 网址、route 路由、path 路径(/v1/systemone 这一段)。
在我们这
Jev 只有一个端点 /v1/systemone;aios-comm 的投递也是一个端点。
别误读
不是“终点”;一个 API 常有几十个 endpoint。
你能这么说
“你调的是哪个 endpoint?版本是 v1 还是 v2?”
key / token key / 透肯

钥匙 / 令牌:证明“我是谁、我有权用”的一串字。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 是“要求”,response 是“回应”。一问一答。
词族
request body 请求体(发过去的内容)、response 响应、status code 状态码(200 成功、401 没权限、429 太频繁)、latency 延迟(一来一回多久)。
在我们这
Jev 一次 request 带 state 和 questions,response 带 answers 和 usage;429 就退避重试。
别误读
HTTP 200 只说明“门开了”,不说明答案对。
你能这么说
“响应码多少?200 的话答案里置信度多少?”
JSON 杰森

一种写数据的格式:大括号包着“名字: 值”,程序之间都用它传东西。

来历
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 是“田地、一块地”,表格里的一格。
词族
schema 结构、field 字段、type 类型、required 必填、validate 校验。
在我们这
Jev 的问题分 choice / score / noul 三种 type,答案的 schema 是固定的,所以叫 type-safe;派工收据有一份 result-receipt.schema.json。
别误读
schema 不是“方案”;它只管形状,不管内容对不对。
你能这么说
“这份收据按哪个 schema 校验过?缺哪个 field?”
payload 佩漏德

载荷:一包数据里真正要传的那部分,不算信封和地址。

来历
pay(付钱)+ load(货):货车里“能收钱的那部分货”,车皮和油不算。
词族
payload 载荷、header 头(信封上的信息)、body 体、envelope 信封(我们派工用的 task envelope 就是这个比喻)。
在我们这
派工收据里 final-payload.txt 就是“最终答案本体”,其余是信封和证据。
别误读
不是“负载”(load,系统压力);payload 是内容。
你能这么说
“别把整个包给我,把 payload 抽出来。”
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 说明什么、不说明什么?

说明程序自己认为成功地结束了;不说明结果可用,那要看收据和消费者。