KAIROS 常驻模式

到目前为止，您在本课程中学习的每个功能（启动顺序、工具调用、内存、压缩）都以基本的方式运行 reactive 模型：您输入，克劳德响应，会话结束。 KAIROS 是 Anthropic 违反该合同的系统的内部代号。

在 KAIROS 下，Claude Code 成为永远在线的守护进程。 它启动一次，在重新启动时保持持久会话，安排自己的签入，在您不看时向您发送消息，并在您睡觉时巩固自己的内存。 它与其说是一个 CLI 工具，不如说是一个后台员工。

特征标志系统

KAIROS 不是一个单一的开关。 代码库揭示了 family 相关标志，每个标志独立传送始终在线体验的特定部分：

KAIROS 模式中的所有内容都以全局状态存储中的单个布尔值为中心。 在 bootstrap/state.ts:

// bootstrap/state.ts (line 1085)
export function getKairosActive(): boolean {
  return STATE.kairosActive  // default: false
}

export function setKairosActive(value: boolean): void {
  STATE.kairosActive = value
}

这个布尔值是运行时“我们现在处于助理模式吗？” 旗帜。 它是从 main.tsx 在启动期间，在运行任何工具可用性检查之前。 它的影响无处不在：

主动/KAIROS模式的核心是一种心跳机制，称为 tick。 当自主运行时，模型会定期接收 <tengu_tick> XML 消息。 将其视为轻轻的轻推：“你醒了，现在怎么办？”

从系统提示中 constants/prompts.ts (getProactiveSection()):

// The exact text the model receives in its system prompt when proactive is active:

"You are running autonomously. You will receive <tengu_tick> prompts that keep you
alive between turns — just treat them as 'you're awake, what now?' The time in each
<tengu_tick> is the user's current local time."

"Multiple ticks may be batched into a single message. This is normal — just process
the latest one. Never echo or repeat tick content in your response."

"**If you have nothing useful to do on a tick, you MUST call Sleep.** Never respond
with only a status message like 'still waiting' — that wastes a turn and burns tokens."

SleepTool：具有成本意识的空闲

仅当以下情况时才会加载睡眠工具： feature('PROACTIVE') || feature('KAIROS')。 它的全部工作是让模型让出 CPU，而不会在每空闲秒消耗一次 API 调用：

// tools/SleepTool/prompt.ts
export const SLEEP_TOOL_PROMPT = `Wait for a specified duration.
The user can interrupt the sleep at any time.

Use this when you have nothing to do, or when you're waiting for something.

You may receive <tengu_tick> prompts — look for useful work before sleeping.

Each wake-up costs an API call, but the prompt cache expires after 5 minutes
of inactivity — balance accordingly.`

提示中包含三个关键设计点：

• 型号 chooses 它的睡眠持续时间——等待慢速进程时更长，迭代时更短
• 睡觉显然比打电话便宜 Bash(sleep ...) — 没有举行 shell 进程
• 5 分钟提示缓存过期是一个硬成本底线 - 唤醒频率超过此值会浪费缓存创建令牌

睡眠中断：优先级队列

当用户在睡眠中发送消息时， QueuePriority 系统中 types/textInputTypes.ts 处理唤醒：

// types/textInputTypes.ts
type QueuePriority = 'now' | 'next' | 'later'

// 'now'  — interrupt current tool call immediately (Esc + send)
// 'next' — wait for current tool to finish, then inject between tool result and next API call
//          Wakes an in-progress SleepTool call.
// 'later'— end-of-turn drain. Also wakes SleepTool.

终端聚焦意识

主动的系统提示为模型提供了用户终端是否聚焦的明确指导。 这改变了它应该的自主程度：

"**Unfocused**: The user is away. Lean heavily into autonomous action —
make decisions, explore, commit, push. Only pause for genuinely
irreversible or high-risk actions.

**Focused**: The user is watching. Be more collaborative — surface choices,
ask before committing to large changes."

KAIROS 引入了标准 Claude Code 中不存在的一组专用工具。 每个都有条件加载 tools.ts 基于其功能标志：

// tools.ts — conditional loading (simplified)
const SleepTool           = feature('PROACTIVE') || feature('KAIROS')
                             ? require('./tools/SleepTool/SleepTool.js').SleepTool : null

const SendUserFileTool    = feature('KAIROS')
                             ? require('./tools/SendUserFileTool/SendUserFileTool.js').SendUserFileTool : null

const PushNotificationTool = feature('KAIROS') || feature('KAIROS_PUSH_NOTIFICATION')
                             ? require('./tools/PushNotificationTool/PushNotificationTool.js').PushNotificationTool : null

const SubscribePRTool     = feature('KAIROS_GITHUB_WEBHOOKS')
                             ? require('./tools/SubscribePRTool/SubscribePRTool.js').SubscribePRTool : null

// Cron tools (AGENT_TRIGGERS — independently shippable):
const cronTools = feature('AGENT_TRIGGERS')
  ? [ CronCreateTool, CronDeleteTool, CronListTool ] : []

BriefTool 深入探讨：权利与激活

BriefTool 具有代码库中最复杂的启用逻辑。 它故意区分了两个问题：

拆分原因：没有它，将用户注册 tengu_kairos_brief 会默默地激活所有会话的 Brief。 选择加入 (userMsgOptIn) 必须由用户操作显式设置： --brief, defaultView: 'chat', /brief 斜杠命令，或 CLAUDE_CODE_BRIEF 环境是。

// tools/BriefTool/BriefTool.ts (simplified)
export function isBriefEnabled(): boolean {
  // Top-level feature() guard is load-bearing for dead-code elimination.
  // Bun constant-folds to `false` in external builds.
  return feature('KAIROS') || feature('KAIROS_BRIEF')
    ? (getKairosActive() || getUserMsgOptIn()) && isBriefEntitled()
    : false
}

cron系统是Claude安排自己未来工作的机制。 它完全生活在 utils/cronTasks.ts, utils/cronScheduler.ts，以及三个 Cron 工具。

CronTask 形状

// utils/cronTasks.ts
type CronTask = {
  id:          string
  cron:        string       // 5-field cron in local timezone
  prompt:      string       // prompt to enqueue when task fires
  createdAt:   number       // epoch ms — anchor for missed-task detection
  lastFiredAt?: number      // set after each recurring fire
  recurring?:  boolean      // true = reschedule after firing
  permanent?:  boolean      // exempt from recurringMaxAgeMs expiry
  durable?:    boolean      // runtime-only: false = session-only, undefined = disk-backed
  agentId?:    string       // routes fire to a teammate's queue instead of main REPL
}

两个耐用等级

抖动系统

CronCreate 提示包含有关车队规模负载分配的工程智慧：

// From CronCreateTool prompt (ScheduleCronTool/prompt.ts)
"Every user who asks for '9am' gets `0 9`, and every user who asks for 'hourly' gets
`0 *` — which means requests from across the planet land on the API at the same instant.

When the user's request is approximate, pick a minute that is NOT 0 or 30:
  'every morning around 9' → '57 8 * * *' or '3 9 * * *' (not '0 9 * * *')
  'hourly' → '7 * * * *' (not '0 * * * *')"

除了模型的偏移选择之外，调度程序本身还添加了确定性抖动：重复任务最多延迟其周期的 10%（最多 15 分钟），而一次性任务在 :00 或 :30 提前最多 90 秒触发。

永久任务：助手模式内置

The permanent: true 该字段专门用于助理模式的内置任务——每日追赶、早上登记、梦想巩固。 这些是写给 scheduled_tasks.json 在安装时 src/assistant/install.ts 并不受年龄限制。 这 writeIfMissing() 模式意味着重新安装永远不会覆盖用户自定义设置。

AutoDream是KAIROS的后台维护人员。 当积累了足够的时间和会话时，它会自动触发，产生一个分叉的子代理来巩固内存，而不会中断主会话。

门链（最便宜的优先）

GrowthBook 标志的默认阈值 tengu_onyx_plover: 24小时 自上次合并以来， 5 节课 最低限度。 两者都可以在不部署的情况下进行实时调整。

整合提示：4 个阶段

梦想代理人收到来自的结构化提示 services/autoDream/consolidationPrompt.ts:

梦想跑步的工具限制

自动梦想子代理会收到附加到其提示中的强化工具约束注释：

"Bash is restricted to read-only commands (ls, find, grep, cat, stat, wc, head, tail).
Anything that writes, redirects to a file, or modifies state will be denied.
Plan your exploration with this in mind — no need to probe."

这是通过附加的 extra 仅在自动梦想运行中使用参数 — 手动 /dream 技能在具有正常权限的主循环中运行。

DreamTask：UI 可见性

分叉的梦想代理出现在页脚药丸和 Shift+Down 后台任务对话框中 tasks/DreamTask/DreamTask.ts。 它跟踪：

• phase: 'starting' | 'updating' — 翻转到 'updating' 当第一个编辑/写入工具调用到达时
• filesTouched — 部分列表（错过 Bash 介导的写入，仅捕获模式匹配的工具调用）
• turns — 最后 30 个助手回合，tool_use 方块折叠成一个计数

标准 Claude Code 内存使用单个 MEMORY.md 模型读取和写入的索引文件。 KAIROS 助手模式使用完全不同的模型：仅附加的每日日志。

每日日志路径的计算方式为 getAutoMemDailyLogPath() in memdir/paths.ts:

// memdir/paths.ts
export function getAutoMemDailyLogPath(date: Date = new Date()): string {
  const yyyy = date.getFullYear().toString()
  const mm   = (date.getMonth() + 1).toString().padStart(2, '0')
  const dd   = date.getDate().toString().padStart(2, '0')
  return join(getAutoMemPath(), 'logs', yyyy, mm, `${yyyy}-${mm}-${dd}.md`)
  // → ~/.claude/memory/logs/2026/03/2026-03-31.md
}

KAIROS 的定义功能之一是持久会话身份。 KAIROS 会话可以在重新启动时恢复：

# Restart and continue the same conversation
claude remote-control --session-id=<id>
claude remote-control --continue   # alias: -c

这些标志被解析为 bridge/bridgeMain.ts 并且明显落后于 feature('KAIROS') 警卫。 来自评论：

// bridge/bridgeMain.ts
// feature('KAIROS') gate: --session-id is ant-only; without the gate,
// external builds would expose an argument that does nothing.
if (feature('KAIROS') && arg === '--session-id' && ...) { ... }
if (feature('KAIROS') && arg.startsWith('--session-id=')) { ... }
if (feature('KAIROS') && (arg === '--continue' || arg === '-c')) { ... }

会话是通过 perpetual 桥配置中的标志。 当会话是永久的时，无环境的桥接路径（通常提供更好的性能）回退到基于环境的路径以保持交叉重启会话的连续性：

// initReplBridge.ts
// perpetual (assistant-mode session continuity via bridge-pointer.json) is
// env-coupled and not yet implemented in env-less — fall back to env-based
// when set so KAIROS users don't silently lose cross-restart continuity.
if (isEnvLessBridgeEnabled() && !perpetual) { ... }

KAIROS 将多个设置键添加到 Claude Code 设置架构中（utils/settings/types.ts):

当主动性活跃时， getSystemPrompt() 采用与普通结构化部分方法完全不同的路径：

// constants/prompts.ts — proactive path
if ((feature('PROACTIVE') || feature('KAIROS')) && proactiveModule?.isProactiveActive()) {
  logForDebugging('[SystemPrompt] path=simple-proactive')
  return [
    `\nYou are an autonomous agent. Use the available tools to do useful work.\n\n${CYBER_RISK_INSTRUCTION}`,
    getSystemRemindersSection(),
    await loadMemoryPrompt(),
    envInfo,
    getLanguageSection(settings.language),
    isMcpInstructionsDeltaEnabled() ? null : getMcpInstructionsSection(mcpClients),
    getScratchpadInstructions(),
    getFunctionResultClearingSection(model),
    SUMMARIZE_TOOL_RESULTS_SECTION,
    getProactiveSection(),   // ← tick loop + Sleep + focus instructions
  ].filter(s => s !== null)
}

标准路径使用带有缓存和节标识符的动态节注册表。 主动路径返回一个平面数组——更简单、更快，并且针对持续运行的代理的缓存缺失严重的性质进行了优化。

KAIROS 的运行时行为广泛地由 GrowthBook 功能标志控制，使 Anthropic 能够在不部署的情况下调整或终止子系统。 该模式在整个代码库中是一致的：

// Pattern: cached refresh with explicit interval
const KAIROS_BRIEF_REFRESH_MS = 5 * 60 * 1000  // 5 minutes
const KAIROS_CRON_REFRESH_MS  = 5 * 60 * 1000  // 5 minutes

// Brief entitlement — checks GB flag, refreshes every 5 min
getFeatureValue_CACHED_WITH_REFRESH('tengu_kairos_brief', false, KAIROS_BRIEF_REFRESH_MS)

// Cron kill switch — fleet-wide disable
getFeatureValue_CACHED_WITH_REFRESH('tengu_kairos_cron', true, KAIROS_CRON_REFRESH_MS)

// Durable cron kill switch (narrower — leaves session-only cron untouched)
getFeatureValue_CACHED_WITH_REFRESH('tengu_kairos_cron_durable', true, KAIROS_CRON_REFRESH_MS)

// AutoDream thresholds + enabled gate
getFeatureValue_CACHED_MAY_BE_STALE('tengu_onyx_plover', null)

// Cron jitter config — ops can push during an incident to reduce load
getFeatureValue_CACHED_WITH_REFRESH('tengu_kairos_cron_config', null, ...)

评论中 cronJitterConfig.ts 解释了事件的故事： “在事件发生期间，操作员可以推动 tengu_kairos_cron_config 例如 高抖动乘数可将负载分散到整个机群中。” 5 分钟刷新间隔经过专门调整，以便 GB 更改在一个缓存窗口内生效，速度足以满足事件响应，但又不会太快而增加持续的网络压力。

研究 KAIROS 源代码揭示了 Anthropic 一致应用的几个架构原则：

原则 1：DCE 的正三元数

每个功能门控块都使用正三元数而不是负早期回报：

// CORRECT — DCE works
return feature('KAIROS') ? doKairosThings() : false

// WRONG — DCE fails (negative guard defeats constant-folding)
if (!feature('KAIROS')) return false
return doKairosThings()

原则 2：独立可运输性

每个子功能都经过精心设计，可以独立发布和终止切换。 cron 模块图的导入为零 src/assistant/。 BriefTool有自己的 KAIROS_BRIEF 旗帜。 这意味着完全助手模式中的错误不会阻止 cron 调度程序的运行。

原则 3：最便宜的登机口优先

所有 KAIROS 子系统都按照最便宜的评估顺序检查门。 自动梦想检查 kairosActive （一次布尔读取）在检查时间之前、在读取文件系统的会话计数之前、在获取锁之前。 这很重要，因为这些检查在每个代理轮次上运行。

原则 4：操作员终止开关

每个 GrowthBook 门控子系统都有一个获胜的本地环境变量覆盖： CLAUDE_CODE_DISABLE_CRON 杀死 cron 调度程序， CLAUDE_CODE_BRIEF 启用 Brief 进行开发/测试。 这使得个别工程师可以绕过车队大门，而无需接触 GrowthBook。

原则 5：系统提示中的成本预算

该模型明确告知 API 调用成本和提示缓存机制。 “每次唤醒都会花费一次 API 调用，但提示缓存会在 5 分钟不活动后过期 - 相应地平衡。” 这是异常透明的系统提示工程——将模型视为具有成本意识的参与者，而不是向其隐藏基础设施详细信息。