[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77388":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":15,"starSnapshotCount":15,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},77388,"evolve-agent","heyingjiee\u002Fevolve-agent","heyingjiee","自主迭代进化的 Code Agent 工具","",null,"Python",104,8,7,0,68,2.86,"MIT License",false,"main",[],"2026-06-12 02:03:43","# evolve-agent\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"logo.png\" alt=\"evolve-agent logo\" width=\"100\" height=\"100\">\n\u003C\u002Fdiv>\n\n基于 Claude API 的 Python AI 编程助手，支持钩子系统、持久化记忆、权限控制、上下文压缩。\n\n## 待办清单\n- [ ] 终端样式调整（替换为typer）\n- [ ] 替换 evolve agent 子命令启动本地Agent\n- [ ] 支持 channel gateway 能力（优先级低）\n- [ ] 持久化 Session 能力\n- [ ] trace 追踪调用流程能力\n- [ ] token 用量追踪\n- [ ] 支持以知识仓库为核心的迭代模式（以md格式存储在统一Github仓库）\n  - [ ] 提供内置Skill \u002Fimport-wiki :拉取知识仓库到本地项目\n  - [ ] 提供内置Skill \u002Fspec :提取知识仓库信息做内部规划\n  - [ ] 提供内置Skill \u002Fapply-spec :执行规划\n  - [ ] 提供内置Skill \u002Fextra-wiki :提取当前 Session Summary，自动PR至知识仓库 （知识库作者审核合并入库）\n- [ ] evolve wiki 子命令维护知识仓库\n  - [ ] 知识成熟度晋升、衰退\n  - [ ] 知识提交日志维护\n\n\n\n## 核心特性\n\n### 钩子系统\n通过 PreToolUse、PostToolUse、SessionStart 钩子自定义 Agent 行为。\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Bash\",\n        \"command\": \"node scripts\u002Fcheck_safety.js\"\n      }\n    ],\n    \"PostToolUse\": [\n      {\n        \"matcher\": \"Write\",\n        \"command\": \"git add .\"\n      }\n    ]\n  }\n}\n```\n\n### 持久化记忆\n跨会话持久化的记忆系统，支持四种类型：\n- `user` — 用户偏好\n- `feedback` — 过往纠正的问题\n- `project` — 非显而易见的项目约定\n- `reference` — 外部资源指向（任务面板、监控面板、文档）\n\n### 权限控制\n细粒度的工具调用权限管理，控制哪些工具可以使用以及使用条件。\n\n### 上下文压缩\n`compact` 工具智能压缩对话上下文，保持在模型限制内。\n\n### 技能系统\n可扩展的技能框架，内置技能包括：\n- `commit` — git commit\u002Fpush\u002Fpr 工作流\n\n## 快速开始\n\n### 安装依赖\n\n```shell\nuv sync\n```\n\n### 配置 API Key\n\n```shell\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\n```\n\n或创建 `.env` 文件（参考 `.env.example`）。\n\n### 运行\n\n```shell\nuv run start\n```\n\n或直接：\n\n```shell\npython -m evolve\n```\n\n启动后进入交互式界面：\n\n![CLI 界面](images\u002Frun-screen-shot.png)\n\n## 项目结构\n\n```\nevolve-agent\u002F\n├── evolve\u002F\n│   ├── agents\u002F          # Agent 实现\n│   ├── cli.py           # CLI 入口\n│   ├── config.py        # 全局配置\n│   ├── hooks.py        # 钩子系统（HookManager）\n│   ├── permission\u002F     # 权限管理\n│   ├── prompt.py       # 系统提示词构建\n│   ├── tools\u002F          # 工具实现\n│   │   ├── bash.py\n│   │   ├── compact.py   # 上下文压缩\n│   │   ├── memory.py   # 记忆管理\n│   │   ├── plan.py\n│   │   └── ...\n│   ├── skills\u002F         # 技能定义\n│   │   └── commit\u002F\n│   └── shared\u002F         # 共享工具\n├── tests\u002F              # 测试套件\n├── .evolve\u002F            # 运行时数据\n│   ├── skills\u002F         # 技能运行时\n│   └── memory\u002F        # 记忆存储\n└── AGENT.md            # Agent 指令\n```\n\n## 开发者指南\n\n### 安装依赖\n\n```shell\nuv sync\n```\n\n### 代码检查\n\n```shell\nruff check . --fix\n```\n\n### 运行测试\n\n```shell\npytest\n```\n\n### 项目依赖\n\n- `anthropic>=0.97.0` — Claude API 客户端\n- `python-dotenv>=1.2.2` — 环境变量加载\n\n## License\n\n参见 [LICENSE](LICENSE) 文件。\n","evolve-agent 是一个基于 Claude API 的 Python AI 编程助手，旨在帮助开发者提高编程效率。该项目的核心功能包括钩子系统、持久化记忆、权限控制和上下文压缩。通过自定义的钩子，用户可以在特定事件前后执行自定义命令；持久化记忆支持跨会话保存用户偏好、项目约定等信息；权限控制系统允许细粒度地管理工具使用权限；而上下文压缩功能则确保了长时间对话中的性能与准确性。此外，evolve-agent 还提供了一个可扩展的技能框架，内置了如 Git 工作流自动化等实用技能。适合需要频繁进行代码开发、测试及维护的场景，特别是对于那些希望利用人工智能技术来辅助日常工作的软件工程师而言，evolve-agent 能够显著提升工作效率。",2,"2026-06-11 03:55:23","CREATED_QUERY"]