Keelson：本地AI代理的模块化框架与确定性工作流引擎

Keelson是一个本地运行的AI代理框架，支持多提供商（GitHub Copilot、Claude）、可插拔的Rib扩展架构及基于YAML的确定性工作流引擎，让用户完全掌控自己的AI工具链。项目开源（Apache 2.0许可），当前处于Alpha阶段，由Daniel Scholl维护，源码托管于GitHub。

随着GitHub Copilot、Claude等AI编程助手普及，现有解决方案存在绑定特定云服务或缺乏可扩展性的问题。Keelson应运而生，核心理念是“你的机器，你的规则”——运行在本地笔记本电脑，直接调用本地CLI，不经过托管服务，同时通过模块化架构支持按需扩展。

Keelson名称源自航海术语（龙骨上方的纵向梁），隐喻其作为基础框架的角色：Keelson核心提供多提供商支持、持久化状态、工作流引擎和浏览器界面；Ribs（肋骨）是附着的功能模块，通过标准化接口与核心通信，实现特定功能集成。

Keelson支持GitHub Copilot SDK和Claude Agent SDK，设计上可轻松添加更多提供商。通过统一的IAgentProvider接口抽象不同SDK差异，上层应用可无缝切换底层提供商，应对AI服务市场变化（新模型、价格调整等），提升灵活性与抗风险能力。

Rib是独立npm包（命名约定@keelson/rib-<name>），实现Rib接口与核心集成。启动时自动扫描node_modules/@keelson/目录发现Rib，可通过环境变量过滤激活。优势：关注点分离（核心精简）、可组合（按需安装）、可维护（独立开发版本控制）。

Keelson采用YAML定义确定性工作流，人类可读、可版本控制、可审计。支持节点类型：prompt（AI提示）、bash（执行命令）、loop（循环）、approval（人工审批）等，节点间通过depends_on定义依赖，$nodeId.output传递数据。借鉴Archon项目，TypeScript类型化适配Bun+SQLite栈，适合可重复、合规场景。

Keelson遵循本地优先原则：状态存储于本地SQLite数据库，凭证通过keytar存于系统钥匙串，工作流本地执行。浏览器界面仅接受本地连接（http://127.0.0.1:5173），敏感数据永不离开机器，适合处理机密代码、专有算法或受监管数据场景。

适用场景：多提供商策略（灵活切换）、敏感数据处理（本地执行）、可审计工作流（确定性）、自定义工具集成（Rib扩展）、技术探索（可hack代码库）。

总结：Keelson回归工具本质，以简单、本地、可控为核心，通过模块化与确定性设计，为开发者提供掌控AI工具链的选择，在数据主权时代具有吸引力。项目技术栈包括Bun、React19、TypeScript、SQLite，当前处于Alpha阶段。