架构
Ailiv Agent 内部结构——主要子系统、执行路径、数据流及延伸阅读指引
ACP 内部机制
ACP 适配器的工作原理：生命周期、会话、事件桥接、审批流程与工具渲染
添加工具
如何向 Ailiv Agent 添加新工具——schema、handler、注册与 toolset
Agent Loop 内部机制
AIAgent 执行流程、API 模式、工具、回调及回退行为的详细说明
创建 Skill
如何为 Ailiv Agent 创建 skill——SKILL.md 格式、规范与发布
贡献指南
如何为 Ailiv Agent 做贡献 — 开发环境配置、代码风格、PR 流程
Provider 运行时解析
Ailiv 如何在运行时解析 provider、凭据、API 模式及辅助模型
添加 Provider
如何向 Ailiv Agent 添加新的推理 provider——认证、运行时解析、CLI 流程、适配器、测试与文档
Prompt 组装
Ailiv 如何构建系统 prompt、保持缓存稳定性并注入临时层
TUI & Desktop from Worktrees
Run the Ink TUI and Electron desktop app from a git worktree without a full npm install per checkout
Gateway 内部机制
消息 gateway 如何启动、授权用户、路由会话以及投递消息
扩展 CLI
构建包装 CLI，通过自定义 widget、快捷键和布局变更来扩展 Ailiv TUI
Memory Provider 插件
如何为 Ailiv Agent 构建 memory provider 插件
程序化集成
从外部程序驱动 ailiv-agent 的三种协议：ACP、TUI gateway JSON-RPC 以及兼容 OpenAI 的 HTTP API
添加平台适配器
本指南介绍如何向 Ailiv gateway 添加新的消息平台。平台适配器将 Ailiv 连接到外部消息服务（Telegram、Discord、WeCom 等），使用户可以通过该服务与 agent 交互。
Context Engine 插件
如何构建替换内置 ContextCompressor 的 context engine 插件
Secret Source Plugins
How to build a secret-manager backend plugin for Ailiv Agent
工具运行时
工具注册表、toolset、调度及终端环境的运行时行为
模型提供商插件
如何为 Ailiv Agent 构建模型提供商（推理后端）插件
Cron 内部机制
Ailiv 如何存储、调度、编辑、暂停、加载技能以及投递 cron 任务
图像生成 Provider 插件
如何为 Ailiv Agent 构建图像生成后端插件
Plugin LLM 访问
通过 ctx.llm 在 plugin 内部运行任意 LLM 调用——支持对话或结构化输出、同步或异步。宿主持有认证凭据，失败关闭信任门控，可选 JSON Schema 验证。
视频生成 Provider 插件
如何为 Ailiv Agent 构建视频生成后端插件
网页搜索提供商插件
如何为 Ailiv Agent 构建网页搜索/提取/爬取后端插件
Browser Provider Plugins
How to build a cloud browser backend plugin for Ailiv Agent
Egress proxy internals
How the iron-proxy egress firewall integrates with Ailiv — module layout, lifecycle, security invariants, and extension points
CLI Internals
How ailiv_cli is shaped: slash dispatch, config loaders, the skin engine, the transactional update pipeline, and process-identity rules
Browser CDP Supervisor — 设计文档
状态： 已发布（PR 14540）
Codebase Ownership Map
Which directories belong to which subsystem, and where the right docs entry point lives for each
Completion backlogs
Interactive surfaces coalesce consecutive background-process completions that are
上下文压缩与缓存
Ailiv Agent 如何通过双重压缩系统和 Anthropic prompt 缓存高效管理上下文窗口。
Desktop Plugin SDK
Extend the native Ailiv Desktop app — panes, pages, sidebar nav, status bar, palette commands, keybinds, themes, and a scoped backend namespace, with one import and no build step.
Build a Plugin
逐步指南：构建包含工具、钩子、数据文件和技能的完整 Ailiv 插件
会话存储
Ailiv Agent 使用 SQLite 数据库（~/.ailiv/state.db）跨 CLI 和 gateway 会话持久化会话元数据、完整消息历史及模型配置。这替代了早期的逐会话 JSONL 文件方案。
Subagent lifecycle API
Plugins can launch and supervise fresh Ailiv child sessions without importing
Terminal Environment Provider Plugins
Ailiv runs shell commands through a pluggable set of terminal backends.
轨迹格式
Ailiv Agent 以 ShareGPT 兼容的 JSONL 格式保存对话轨迹，用于训练数据、调试产物和强化学习数据集。