03 第三部分 · 方法论

术语表

instance、envelope、mirror、TOFU 等高频词。

阅读约 6 分钟第 11 / 28 篇

高频专有名词与概念定义。在阅读系统核心实现前，建议先快速通读本表，以拉齐心智模型与语境。

核心术语	标准定义与架构语义
`instanceId`	运行时代号（如 `inst_1`），代表内存中活跃的 AgentSession 实体。每次会话重启或切换思考强度时递增。
`sessionId`	Claude CLI 原生会话标识符，对应磁盘 `~/.claude/projects/<project>/<session_id>.jsonl` 文件名。
`epoch`	实例世代标识。当服务端置换实例后自增，客户端收到新 epoch 必须重置消息去重基准。
`seq`	单实例生命周期内单调递增的事件序号，用于网络闪断后的 `sync:since` 增量补发与断点续传。
`agent:event` Envelope	统一出向事件信封，标准外壳：`{seq, epoch, sessionId, instanceId, cwd, ts, type, payload}`。
`mirrorReadonly`	单驾驶员模型中施加的只读互斥锁。当终端正在执行写入时，Web 端强制处于只读态。
`externalDirty`	外部变脏标记。指磁盘 Transcript 已经超前于内存 SDK 会话，Web 端下次发送必须强制销毁置换。
`terminalWaiting`	终端等待态。指终端 CLI 正在执行耗时工具（如跑测试）且尚未落盘，提示 Web 端保持镜像锁锁定。
Tail Attribution	尾部归因。在识别会话繁忙状态时，准确将悬挂的在途消息归因为「Web 自身」还是「外部终端/桌面端」。
TOFU (Trust On First Use)	首次接入信赖机制。新外部设备即使持有正确 Token，首次连接也必须在物理电脑上显式点击批准。
`ACCESS_PROFILE`	网络接入拓扑声明（`cloudflare`, `reverse-proxy`, `lan`），决定反代采信与设备审批分支。
`CCM_DATA_DIR`	持久化数据根目录（仓库根下 `data/`），管理会话元数据、设备指纹、附件上传与审计日志。
`canUseTool`	SDK 权限回调拦截点。当操作未命中预设白名单时，触发向手机端投递 `permission_request`。
Ring Buffer (环形缓冲)	每实例分配的循环事件队列，固定上限 2000 条，支撑高速重连补发。
`settingSources`	SDK 加载本地配置的层级，固定为 `['user', 'project', 'local']`，完整继承命令行配置。
`applyFlagSettings`	运行时标志应用机制。无需销毁实例，直接中途热修改 SDK 的 `effortLevel` 思考强度。
`guard-host-tests`	测试运行保护门禁。宿主机只允许运行只读或纯内存测试脚本，其余所有测试强制在容器沙箱中跑。