Harvil1/codeAgent

解决的问题

CodeAgent 是一款基于终端的 AI 编程助手，旨在自动化编码任务。用户可以用自然语言提供指令，代理通过读取代码、修改文件、运行终端命令和搜索信息来执行这些指令。

工作原理

该项目实现了一个完整的代理循环（REPL），通过 OpenAI 兼容或 Anthropic 协议与 LLM 集成。它使用工具注册系统，tools/ 目录中的模块会自动注册为功能。为了管理长期上下文，它采用了多级压缩管道（L1 至 L4）和基于 MEMORY.md 和 JSONL 存储的内存系统。它还具备“自我学习”机制，从对话轨迹中提取可重用的技能，以随时间改进。

目标受众

它面向希望拥有强大命令行 AI 编码助手（类似于 Claude Code）的开发者，以及对代理开发感兴趣的学习者，因为代码中包含大量中文注释，作为教学工具。

亮点

• 终端优先体验：提供流式响应、用于危险命令的专用批准面板和状态栏。
• 自我学习技能：自动从对话历史中提炼可重用的技能，并通过特定文件路径激活。
• 安全护栏：包括 bash 注入检测、机密扫描、SSRF 保护，以及 Linux 上可选的 bwrap 沙箱。
• 高级上下文管理：实现分层压缩和前缀缓存友好的消息注入，以优化 LLM 成本和性能。
• 代理编排：支持具有隔离工作树的子代理、团队模式（协调者/工作者）以及具有检查点恢复的确定性工作流引擎。