.NET 10 的AIAgent运行时,清洁架构 + 事件驱动
前言
终端工具这个东西,用惯了的人离不开,用不惯的人觉得没必要。但对于经常在命令行里泡着的人来说,如果能有一个AI助手直接嵌在终端里,随时问、随时用,不用切窗口、不用打开浏览器,体验会顺畅很多。
它是一个基于.NET 10 开发的AI Agent运行时,跑在终端里,支持多LLM提供商、工具调用、会话管理,该有的能力都有,而且跑得挺快。

项目介绍
一套AI Agent运行环境,核心定位是给终端用户提供一个可交互的AI编码助手。它采用清洁架构和事件驱动设计,把运行时(seekclaw_runtime)和前端(seekclaw_cli)拆开,CLI只负责终端交互和渲染,真正的业务逻辑全在运行时里。
支持OpenAI、Anthropic、Google和本地模型(Ollama、LM Studio),内置了文件操作、代码搜索、bash执行这些常用工具,还接入了MCP协议扩展生态。终端渲染做了专门的优化,30-60FPS刷新率,流式输出,打字动画平滑流畅。

项目功能
多模型支持
OpenAI兼容:GPT-5.5、GPT-5.5-mini及所有兼容API
Anthropic:Claude Opus、Sonnet、Haiku
Google:Gemini Pro、Gemini Flash
本地模型:Ollama、LM Studio
智能路由:快速、均衡、质量、经济、离线五种策略
故障转移:自动重试、指数退避、熔断器
工具生态
内置工具:文件操作(读/写/编辑)、搜索(grep/glob)、bash执行
MCP支持:stdio和SSE传输,自动发现工具、提示和资源
技能系统:基于目录的技能定义,支持提示注入和工作流
终端体验
游戏式渲染:30-60FPS刷新率,双缓冲技术
流式输出:实时token传输,显示推理过程
实时UI:加载动画、进度条、工具状态、Markdown渲染
增量更新:无闪烁、无滚动、平滑动画
工作区管理
项目识别:自动识别Git、.NET、Node.js、Python、Rust、Go、Unity、Vue项目
隔离配置:每个工作区独立配置、缓存和内存
会话隔离:按工作区作用域隔离
会话管理
基于SQLite的会话持久化、恢复与并发访问
会话列表查看、恢复、导出
旧版本会话自动迁移导入
Provider管理
命令行管理:添加、测试、切换Provider
模型列表查看、搜索、切换
健康检查
提供商可用性和延迟检测
熔断器自动故障恢复

项目特点
| 特点 | 说明 |
|---|---|
| Runtime First | 运行时与前端分离,seekclaw_runtime为核心,CLI只是默认前端 |
| 清洁架构 | 关注点分离,业务逻辑与展示逻辑解耦 |
| 事件驱动 | 通过事件总线解耦渲染与业务逻辑 |
| 多Provider智能路由 | 五种路由策略 + 故障转移,不用手动切换模型 |
| 现代化终端渲染 | 30-60FPS刷新率,流式输出,游戏级渲染体验 |
| MCP生态支持 | 支持stdio和SSE传输,自动发现MCP工具 |
| 原生AOT友好 | 设计阶段就考虑了Native AOT场景 |
项目技术
| 技术 | 说明 |
|---|---|
| .NET 10.0 | 基础运行环境 |
| System.CommandLine | CLI命令解析 |
| Spectre.Console | 终端渲染引擎 |
| SQLite | 会话持久化存储 |
| 清洁架构 + 垂直切片模式 | 架构设计 |
| 事件总线 | 模块间通信 |
| Native AOT友好设计 | 编译优化 |
项目效果
桌面端
AI对话与项目管理界面:左侧是项目列表和会话历史,右侧是对话区域,支持多轮对话、工具调用结果显示和代码高亮。模型与Provider管理界面:可查看当前启用的Provider、模型列表、路由策略和用量统计。Runtime诊断与用量页面:展示Token消耗、请求延迟、各Provider的健康状态。MCP Server配置界面:管理已接入的MCP服务器,查看其提供的工具和资源列表。




终端
流式输出与思考推理过程实时可见,AI在调用工具之前会显示推理步骤,调用结果会以结构化方式呈现。代码生成和文档编写场景下,输出内容按Markdown格式渲染,代码块高亮显示。工具调用与网络搜索场景下,可以看到AI正在调用哪些工具、搜索了什么关键词、验证了哪些结果。
终端流式输出与思考推理
代码生成与文档编写
工具调用与网络搜索验证
提供商与模型路由管理
命令示例
# 交互式聊天
seekclaw
# 单次任务
seekclaw "把认证模块改成用JWT"
# 继续上一个会话
seekclaw --continue
# 切换模型
seekclaw --model openai/gpt-5.5
# 管理Provider
seekclaw provider list
seekclaw provider add openai --api-key sk-...
seekclaw provider test openai
# 会话管理
seekclaw session list
seekclaw session resume <session-id>
项目源码
从源码构建
git clone https://github.com/umr-xiaomai/SeekClaw.git
cd SeekClaw
dotnet build
运行:
# 交互式聊天
dotnet run --project seekclaw_cli
# 单次任务
dotnet run --project seekclaw_cli -- "解释这个项目的架构"
前置要求
.NET 10.0 SDK或更高版本
Git(用于工作区检测)
总结
这个项目解决的是终端用户"不想切窗口"的需求——所有AI交互都在命令行里完成,从模型调用、工具执行到会话管理,一个窗口全搞定。架构上走的是清洁架构 + 事件驱动,运行时和前端分离,后续如果想加一个桌面GUI或者Web界面,复用现有运行时就行,不用重新写业务逻辑。
多Provider支持和智能路由是实际用起来比较顺手的地方,不用每次都指定用哪个模型,系统会根据任务类型和路由策略自动选择。终端渲染做了专门的优化,流式输出、平滑滚动、实时进度反馈,长时间交互体验不难受。
关键词
#AI Agent、.NET 10、#命令行工具、#多模型路由、MCP协议、#终端渲染、#清洁架构、#事件驱动、会话管理、#工具调用、开源、Runtime First