不是框架，不是 SaaS，而是"你的"agent
透明思考过程
core 仅 ~3 文件，可读的 ReAct loop。每个思考、每次工具调用、每个决策都对你完全可见。
多端接入 一段对话
CLI / WebUI / IM 共享同一段对话。手机上开始的对话在电脑上继续，终端启动的工作流在浏览器里完成。
多用户共享 单实例
多用户隔离让家人和团队成员在同一实例上拥有各自会话空间。一个 aptbot 服务全家 / 全团队。
分层架构 无限扩展
严格四层架构 + 声明式 registry + Hook 系统（8 扩展点）。加 IM 通道零核心改动，加工具只需声明注册。
aptbot 的架构亮点
会话持久化 跨会话记忆
JSONL append-only 持久化。L2 起引入三层记忆架构（短期工作记忆 / 长期情景记忆 / 程序性技能记忆）。
多模型冗余 始终在线
主 + 备 provider 自动切换 + 熔断器。单一 provider 失败时无缝切换 —— 你的助手始终在线。
硬化边界 安全可控
TTFB/块双时钟流式控制、30s 工具硬超时、大文件 OOM 防护、JSONL 损坏修复。每层都有防护。
双入口 统一状态机
CLI (Ink) 与 WebUI (Lit) 共享同一 coreReducer 状态机。流式渲染、回合中断、多端同步是事件流的自然消费模式。
aptbot 能做什么
个人工作助手
学习、写作、研究、代码评审。工具调用透明可见，你随时知道它在做什么。跨会话记忆让偏好与上下文持续累积。
家庭/团队共享
一个实例，多个用户。家人查天气、订日程、查资料；团队成员共享工具配置但会话隔离。无需重复部署。
开发者二次开发
声明式 registry 加工具，Hook 系统改流程，新 IM 通道零核心改动。aptbot 是可编程的助手底座，不是黑盒 SaaS。
边用边学，从 0 理解 agent
18 篇结构化文章，覆盖 agent 原理、实现与演进。
Agent 体系实践
围绕 aptbot 项目展开，从 agent 原理到实现到演进路线
Provider 系统：多协议、多模型、故障转移
Api 与 Provider 分离的设计动机、三种 API 协议、双时钟流式控制、错误分类重试与退避、MixinProvider 故障转移与弹回机制，以及三种 provider 管理方案对比
Tool 系统：声明式 registry 与安全边界
理解 tool 在 agent 中的核心定位，AgentTool 接口与声明式注册、4 个内置工具的设计哲学、TypeBox 参数校验、多层安全防线，以及市面三种工具管理方案的对比
Memory 系统：持久化、压缩、跨会话记忆
理解 agent 记忆系统的核心矛盾，JSONL append-only 持久化设计、增量流式解析与破损容错、Compaction 压缩策略、跨会话记忆继承，以及三种持久化方案的对比取舍
Skills 系统：两层加载与自演化规划
理解 skill 在 agent 中的「知识层」定位，两层加载机制如何平衡内置与定制、最小 frontmatter 设计理念、L1 索引与 token 预算截断、热重载联动，以及三种 skill 管理方案的对比
AI 辅助编码实践
AI 辅助开发的通用经验总结与学习方法论，与具体项目无关
AI 辅助开发工作流：用流程约束驯服不确定性
四阶段流程、文档分层、双重审核、熔断机制、看板管理与 TDD 红绿循环如何让 AI 输出从不可预测变为可控可追溯
编码准确性与测试基线：从能跑到可信的四层防线
TDD 红线、Semantic Versioning 与 Keep a Changelog、UAT 核验清单、封仓收尾流程、E2E 测试设计与测试基线维护——把 AI 写的代码从能跑提升到可信
Spec 文档管理：AI 辅助开发的项目记忆与决策宪法
spec 与 plan 与 design 的边界划分、文件组织规范、全生命周期管理（草稿→审核→生效→修订→归档）、self-review 检查清单、代码同步原则、何时写何时不必写
长期迭代维护实践：架构演进与可持续性
AI 辅助项目为何容易在第三个版本崩溃，L1/L2/L3 版本规划与迭代节奏，测试基线管理，加法而不减法的架构演进，design-notes 与 project_memory 维护，重构时机与依赖升级策略
立即体验 aptbot
无需注册，直接进入 Demo 与你的助手对话。