Kesoku ⚡️
欢迎来到 Kesoku (结束 / Kessoku) 官方文档网站。
Kesoku 是一个极简、易读且高度模块化的自主 AI 智能体 (Agent) 框架。它围绕解耦的网关架构和纯 Pub/Sub 代理 (Broker) 模式设计,支持在多个聊天前端(如 Discord、Google Chat、微信)与自主推理循环(具备并发任务、思维中断和工具执行能力)之间进行可靠的异步通信。
🌟 核心特性
- 解耦的代理网关:适配器 (Discord, Google Chat, WeChat) 与后端 Agent 逻辑完全解耦,纯粹通过状态驱动的消息队列进行通信。
- 异步并发处理:调度器为每个会话启动专用的任务循环 (
SessionWorker),防止多用户会话碰撞与上下文串扰。 - 防卡死与思维中断:当在推理中途收到新的用户输入时,支持即时中断当前思维,同时保证正在运行的工具调用(如 Shell 写入)安全执行完毕。
- 结构化 TOML 配置:在
config.toml中集中管理模型参数、数据库路径及各平台凭证。 - 自治技能系统 (Skills):支持 Agent 动态发现并加载特定的领域操作手册 (
SKILL.md)。 - 操作系统守护进程集成:提供服务安装命令,一键将 Agent 注册为
systemd或launchd系统服务。
🗺️ 文档导览
您可以根据需要选择阅读以下指南:
👥 用户手册
- 安装指南:使用
uv工具链初始化 Python 运行环境。 - 配置指南:详细了解
config.toml文件中的各项配置参数。 - 平台配置:将 Agent 对接至 Discord、Google Chat 或微信。
- 系统服务管理:将 Kesoku 配置为后台守护进程运行。