跳转至

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 注册为 systemdlaunchd 系统服务。

🗺️ 文档导览

您可以根据需要选择阅读以下指南:

👥 用户手册

  • 安装指南:使用 uv 工具链初始化 Python 运行环境。
  • 配置指南:详细了解 config.toml 文件中的各项配置参数。
  • 平台配置:将 Agent 对接至 Discord、Google Chat 或微信。
  • 系统服务管理:将 Kesoku 配置为后台守护进程运行。

💻 开发者指南

  • 架构与设计:深入探索代理网关、会话 Worker 以及并发中断模型的设计原理。
  • 智能体生命周期:分步剖析一条消息如何在各个组件间流动与响应。
  • 自治技能原理:了解如何通过创建技能目录为 Agent 扩展新的工具与能力。