当前大模型已经深入融合到我们的工作，ai工具越来越强，想要更好的使用ai工具还得了解其各方面的原理。
这里推荐一个Claude Code教程，网页做的比较好
https://learn.shareai.run/zh/
这个教程也有github的学习项目，和网页中的各个模块一一对应，有代码和教程学起来很方便。
言归正传，最近花了点时间学习这个，基于此做了这个mini版的agent，主体基于教学代码整合而来，借助ai来做mini ai，将所有零碎的代码块整合在一起，形成了一个可以运行功能上看起来都健全的ai agent，python代码，各种注释通俗易懂，既能学习，也能满足日常任务使用。
项目github：
https://github.com/jungrea/mini-agent
两种启动方式：
它能做啥
基本上和你平时使用其他ai软件差不多，具备思考、执行等功能。
具体能力大概这些：
- • 读写本地文件：read / write / edit 三件套，路径都在工作区里圈着
- • 执行 shell：bash 命令带安全校验，
sudo、rm -rf 这种直接拦 - • 联网：web_search / web_fetch，让它自己去查资料
- • 定时调度：让 AI 自己排"每天定时整理ai资讯"
- • 子智能体：复杂任务拆出去给"小弟"跑，结果摘要带回来
- • 多人协作：可以注册多个 teammate 角色，互相发消息
哪些功能比较好
一、权限管理
严格管理权限，按顺序走五步：bash 安全扫描 → 黑名单 → 模式判定 → 白名单 → 问用户。三种模式可切：日常用 default（按需问），只想让它出方案不动手用 plan，老司机用 auto（只读直接放行）。
二、工具并行
LLM 一轮可能甩出好几个工具调用。可并行的工具调用时并行丢进线程池一起跑；写操作串行，保证顺序和权限交互不乱。多查几个 URL 的时候提速很明显。
三、Hook 系统
工作区根目录扔个 .hooks.json，就能把 shell 脚本挂到"会话开始"、“工具调用前”、“工具调用后”、"每轮结束"这些时机上，灵活安排附加功能。
四、定时任务
定时任务后台到点自动运行，可固化到磁盘重启依然存在，想定时做什么很方便。
五、上下文压缩
每轮悄悄做 microcompact，token 超阈值自动 auto_compact（整段总结成一条）。原对话备份到 .transcripts/，担心丢东西可以翻回来看。
六、WebUI 模式
项目可以以web形式打开，更人性化使用，ui界面简单清晰，基本功能都有，感觉日常使用足够了。
七、其他
其他还包括什么子agent，task，多agent等，都有小集成。
项目适合谁
- • 想搞清楚 Agent 内部怎么调度工具、怎么管权限 的同学
- • 不想被 Cursor / Claude Code 锁定，想自己留个完全本地化版本的同学
- • 想拿一份可读、可改、可扩展的代码当脚手架往上加东西的同学
代码风格偏教学向，注释比代码还多，关键决策都在文件头部讲清楚了，照着看一遍基本就懂这套架构是怎么搭的。
最后
该项目作为学习 Agent 架构的活靶子、自己写小工具的起手式、周末折腾的玩具，还挺合适。 其他的细节就去看github（点击原文链接），可以下下来体验一番。喜欢的话别忘了给项目加个🌟！！！
关注了解更多精彩
