用途:Compile 是 AgentOps 操作循环第 7 步(捕获与棘轮)中的复合子步骤,把已提升的 .agents/ 学习内容编译成结构化、互链的 Markdown wiki,灵感来自 Karpathy 的 LLM Knowledge Bases。它闭合知识飞轮:挖掘 git 与 .agents/ 中未提取的信号、通过验证/综合/缺口检测增长学习、编译为互链文章、对 wiki 做矛盾/孤儿/缺口 lint、整理陈旧与重复产物。
主要能力:输出 .agents/compiled/,含百科式 Markdown、[[backlinks]]、index.md 目录与 log.md 时间记录;不使用向量数据库,个人规模(约 100-400 篇)下 wiki 本身即检索层。
使用方式:交互模式有 /compile(完整周期:Mine→Grow→Compile→Lint→Defrag)、--compile-only、--lint-only、--defrag-only、--mine-only、--full、--since 26h、--incremental、--force。无头脚本 bash skills/compile/scripts/compile.sh 支持 --sources(默认 .agents)、--output(默认 .agents/compiled)、--incremental(默认开)、--force、--lint-only、--full。计算后端由 AGENTOPS_COMPILE_RUNTIME 选择:codex-cli(本地 codex,零配置,自动检测)、ollama(默认模型 gemma3:27b,可用 OLLAMA_HOST 远程)、claude(需 ANTHROPIC_API_KEY)、openai(需 OPENAI_API_KEY 与 OPENAI_BASE_URL);未设置时先自动检测本地 codex,否则无头编译快速报错。优先级:--runtime 标志 > 环境变量 > ~/.agentops/config.yaml 中 compile.preferred_runtime > codex 自动检测 > 空(报错)。大语料可用 --batch-size(默认 25)与 --max-batches 分批。会话结束时 compile-session-defrag.sh 钩子自动运行轻量 ao defrag --prune --dedup(20 秒超时)。
适用场景:个人知识库编译、/evolve 前预热、外部 cron 夜间编译(如 AGENTOPS_COMPILE_RUNTIME=ollama bash skills/compile/scripts/compile.sh --force)。
限制:无头编译需配置运行时,否则报错;大语料在小模型上可能较慢;首次编译无哈希文件属正常。其余细节暂未提供。