From 60abcd92a370bd8d227d70cc154e7ef13b7bd125 Mon Sep 17 00:00:00 2001 From: saboteur7 Date: Tue, 3 Feb 2026 01:17:25 +0800 Subject: [PATCH] feat: update README.md and solving Python compatibility issues --- README.md | 31 +++++++++++++++---------------- agent/memory/chunker.py | 1 + agent/memory/config.py | 1 + agent/memory/storage.py | 1 + agent/prompt/builder.py | 1 + agent/prompt/workspace.py | 1 + agent/protocol/result.py | 1 + agent/protocol/task.py | 1 + docs/agent.md | 4 ++-- requirements-optional.txt | 5 ++++- requirements.txt | 3 --- 11 files changed, 28 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 433e674f..2c38427c 100644 --- a/README.md +++ b/README.md @@ -6,19 +6,19 @@ Stars

-**CowAgent** 是基于大模型的超级AI助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行Skill、拥有长期记忆并不断成长。CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入网页、飞书、钉钉、企业微信应用、微信公众号中使用，7*24小时运行于你的个人电脑或服务器中。 +**CowAgent** 是基于大模型的超级AI助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行Skills、拥有长期记忆并不断成长。CowAgent 支持灵活切换多种模型，能处理文本、语音、图片、文件等多模态消息，可接入网页、飞书、钉钉、企业微信应用、微信公众号中使用，7*24小时运行于你的个人电脑或服务器中。 # 简介 -> 该项目既是一个可以开箱即用的AI助理，也是一个支持高度扩展的Agent框架，可以通过为项目扩展大模型接口、接入渠道、内置工具、Skill系统来灵活实现各种定制需求。核心功能如下： +> 该项目既是一个可以开箱即用的超级AI助理，也是一个支持高度扩展的Agent框架，可以通过为项目扩展大模型接口、接入渠道、内置工具、Skills系统来灵活实现各种定制需求。核心能力如下： -- ✅ **多端部署：** 有多种部署方式可选择且功能完备，目前已支持网页、微信公众号、企业微信应用、飞书、钉钉等部署方式 -- ✅ **基础对话：** 私聊及群聊的AI智能回复，支持多轮会话上下文记忆，基础模型支持OpenAI, Claude, Gemini, DeepSeek, 通义千问, Kimi, 文心一言, 讯飞星火, ChatGLM, MiniMax, GiteeAI, ModelScope, LinkAI -- ✅ **语音能力：** 可识别语音消息，通过文字或语音回复，支持 openai(whisper/tts), azure, baidu, google 等多种语音模型 -- ✅ **图像能力：** 支持图片生成、图片识别、图生图，可选择 Dall-E-3, stable diffusion, replicate, midjourney, CogView-3, vision模型 -- ✅ **丰富插件：** 支持自定义插件扩展，已实现多角色切换、敏感词过滤、聊天记录总结、文档总结和对话、联网搜索、智能体等内置插件 -- ✅ **Agent能力：** 支持访问浏览器、终端、文件系统、搜索引擎等各类工具，并可通过多智能体协作完成复杂任务，基于 [AgentMesh](https://github.com/MinimalFuture/AgentMesh) 框架实现 -- ✅ **知识库：** 通过上传知识库自定义专属机器人，可作为数字分身、智能客服、企业智能体使用，基于 [LinkAI](https://link-ai.tech) 实现 +- ✅ **复杂任务规划**：能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标，支持通过工具操作访问文件、终端、浏览器、定时任务等系统资源 +- ✅ **长期记忆：** 自动将对话记忆持久化至本地文件和数据库中，包括全局记忆和天级记忆，支持关键词及向量检索 +- ✅ **技能系统：** 内置Skills创造器、网络搜索、图像识别等多种技能，支持通过自然语言对话完成Skills开发 +- ✅ **多模态消息：** 支持对文本、图片、语音、文件等多类型消息进行解析、处理、生成、发送等操作 +- ✅ **多模型接入：** 支持OpenAI, Claude, Gemini, DeepSeek, MiniMax、GLM、通义千问, Kimi等国内外主流模型厂商 +- ✅ **多端部署：** 支持运行在本地计算机或服务器，可集成到网页、飞书、钉钉、微信公众号、企业微信应用中使用 +- ✅ **知识库：** 集成企业知识库能力，让Agent成为专属数字员工，基于[LinkAI](https://link-ai.tech)平台实现 ## 声明 @@ -56,7 +56,7 @@ DEMO视频(对话模式)：https://cdn.link-ai.tech/doc/cow_demo.mp4 # 🏷 更新日志 ->**2025.05.23：** [1.7.6版本](https://github.com/zhayujie/chatgpt-on-wechat/releases/tag/1.7.6) 优化web网页channel、新增 [AgentMesh多智能体插件](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/plugins/agent/README.md)、百度语音合成优化、企微应用`access_token`获取优化、支持`claude-4-sonnet`和`claude-4-opus`模型 +>**2025.05.23：** [1.7.6版本](https://github.com/zhayujie/chatgpt-on-wechat/releases/tag/1.7.6) 优化web网页channel、新增 [AgentMesh](https://github.com/zhayujie/chatgpt-on-wechat/blob/master/plugins/agent/README.md)多智能体插件、百度语音合成优化、企微应用`access_token`获取优化、支持`claude-4-sonnet`和`claude-4-opus`模型 >**2025.04.11：** [1.7.5版本](https://github.com/zhayujie/chatgpt-on-wechat/releases/tag/1.7.5) 新增支持 [wechatferry](https://github.com/zhayujie/chatgpt-on-wechat/pull/2562) 协议、新增 deepseek 模型、新增支持腾讯云语音能力、新增支持 ModelScope 和 Gitee-AI API接口 @@ -72,15 +72,14 @@ DEMO视频(对话模式)：https://cdn.link-ai.tech/doc/cow_demo.mp4 项目提供了一键安装、启动、管理程序的脚本，可以选择使用脚本快速运行，也可以根据详细指引一步步安装运行。 -- 详细文档：[快速开始](https://docs.link-ai.tech/cow/quick-start) - -- 一键安装脚本说明：[一键安装脚本](https://github.com/zhayujie/chatgpt-on-wechat/wiki/%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E5%90%AF%E5%8A%A8%E8%84%9A%E6%9C%AC) +在终端执行以下命令： ```bash -bash <(curl -sS https://cdn.link-ai.tech/code/cow/install.sh) +bash <(curl -sS https://cdn.link-ai.tech/code/cow/run.sh) ``` -- 项目管理脚本说明：[项目管理脚本](https://github.com/zhayujie/chatgpt-on-wechat/wiki/%E9%A1%B9%E7%9B%AE%E7%AE%A1%E7%90%86%E8%84%9A%E6%9C%AC) +- 脚本说明文档：[一键安装脚本](https://github.com/zhayujie/chatgpt-on-wechat/wiki/CowAgentQuickStart) + ## 一、准备 @@ -132,7 +131,7 @@ pip3 install -r requirements-optional.txt # config.json 文件内容示例 { "channel_type": "web", # 接入渠道类型，默认为web，支持修改为:terminal, wechatmp, wechatmp_service, wechatcom_app, dingtalk, feishu - "model": "gpt-4o-mini", # 模型名称, 支持 gpt-4o-mini, gpt-4.1, gpt-4o, deepseek-reasoner, wenxin, xunfei, glm-4, claude-3-7-sonnet-latest, moonshot等 + "model": "gpt-4.1-mini", # 模型名称, 支持 gpt-4o-mini, gpt-4.1, gpt-4o, deepseek-reasoner, wenxin, xunfei, glm-4, claude-3-7-sonnet-latest, moonshot等 "open_ai_api_key": "YOUR API KEY", # 如果使用openAI模型则填入上面创建的 OpenAI API KEY "open_ai_api_base": "https://api.openai.com/v1", # OpenAI接口代理地址，修改此项可接入第三方模型接口 "proxy": "", # 代理客户端的ip和端口，国内环境开启代理的需要填写该项，如 "127.0.0.1:7890" diff --git a/agent/memory/chunker.py b/agent/memory/chunker.py index b8f0c35e..8dfd062d 100644 --- a/agent/memory/chunker.py +++ b/agent/memory/chunker.py @@ -4,6 +4,7 @@ Text chunking utilities for memory Splits text into chunks with token limits and overlap """ +from __future__ import annotations from typing import List, Tuple from dataclasses import dataclass diff --git a/agent/memory/config.py b/agent/memory/config.py index 63d945bd..1f8dbe2f 100644 --- a/agent/memory/config.py +++ b/agent/memory/config.py @@ -4,6 +4,7 @@ Memory configuration module Provides global memory configuration with simplified workspace structure """ +from __future__ import annotations import os from dataclasses import dataclass, field from typing import Optional, List diff --git a/agent/memory/storage.py b/agent/memory/storage.py index 373512b8..8518e81b 100644 --- a/agent/memory/storage.py +++ b/agent/memory/storage.py @@ -4,6 +4,7 @@ Storage layer for memory using SQLite + FTS5 Provides vector and keyword search capabilities """ +from __future__ import annotations import sqlite3 import json import hashlib diff --git a/agent/prompt/builder.py b/agent/prompt/builder.py index c48989ad..5eed1330 100644 --- a/agent/prompt/builder.py +++ b/agent/prompt/builder.py @@ -4,6 +4,7 @@ System Prompt Builder - 系统提示词构建器 实现模块化的系统提示词构建，支持工具、技能、记忆等多个子系统 """ +from __future__ import annotations import os from typing import List, Dict, Optional, Any from dataclasses import dataclass diff --git a/agent/prompt/workspace.py b/agent/prompt/workspace.py index 37d9a968..47d2e334 100644 --- a/agent/prompt/workspace.py +++ b/agent/prompt/workspace.py @@ -4,6 +4,7 @@ Workspace Management - 工作空间管理模块 负责初始化工作空间、创建模板文件、加载上下文文件 """ +from __future__ import annotations import os import json from typing import List, Optional, Dict diff --git a/agent/protocol/result.py b/agent/protocol/result.py index d097503c..ffbe44cc 100644 --- a/agent/protocol/result.py +++ b/agent/protocol/result.py @@ -1,3 +1,4 @@ +from __future__ import annotations import time import uuid from dataclasses import dataclass, field diff --git a/agent/protocol/task.py b/agent/protocol/task.py index 5ef0daac..53a703f9 100644 --- a/agent/protocol/task.py +++ b/agent/protocol/task.py @@ -1,3 +1,4 @@ +from __future__ import annotations import time import uuid from dataclasses import dataclass, field diff --git a/docs/agent.md b/docs/agent.md index fd63bb1e..1d337b3f 100644 --- a/docs/agent.md +++ b/docs/agent.md @@ -7,8 +7,8 @@ Cow项目从简单的聊天机器人全面升级为超级智能助理 **CowAgent - **复杂任务规划**：能够理解复杂任务并自主规划执行，持续思考和调用工具直到完成目标，支持多轮推理和上下文理解 - **工具系统**：内置 10+ 种工具，包括文件操作、bash终端、浏览器、文件发送、定时任务、记忆管理等 -- **长期记忆**：持久化记忆自动保存到本地，通过向量数据库实现智能检索，分为核心记忆、每日记忆、用户记忆三个层次 -- **Skill系统**：可无限扩展的技能系统，内置技能创造器、网络搜索、图像识别等技能，支持通过自然语言完成技能创造 +- **长期记忆**：持久化记忆自动保存到本地，通过文件存储和向量数据库实现智能检索，分为核心记忆、每日记忆、用户记忆三个层次 +- **Skills系统**：可无限扩展的技能系统，内置技能创造器、网络搜索、图像识别等技能，支持通过自然语言完成技能创造 - **多渠道和多模型支持**：支持在Web、飞书、钉钉、企微等多渠道与Agent交互，支持Claude、Gemini、OpenAI、GLM、MiniMax、Qwen 等多种国内外主流模型 - **安全和成本**：通过秘钥管理工具、提示词控制、系统权限等手段控制Agent的访问安全；通过最大记忆轮次、最大上下文token、工具执行步数对token成本进行限制 diff --git a/requirements-optional.txt b/requirements-optional.txt index 06bb9289..78984b08 100644 --- a/requirements-optional.txt +++ b/requirements-optional.txt @@ -12,13 +12,16 @@ numpy<=1.24.2 langid # language detect elevenlabs==1.0.3 # elevenlabs TTS +# wechatcom & wechatmp +web.py +wechatpy + #install plugin dulwich # xunfei spark websocket-client==1.2.0 - # claude API anthropic==0.25.0 diff --git a/requirements.txt b/requirements.txt index 106656b1..7f93bbed 100644 --- a/requirements.txt +++ b/requirements.txt @@ -18,9 +18,6 @@ zai-sdk # tongyi qwen sdk dashscope -# wechatcom & wechatmp -web.py -wechatpy # feishu websocket mode lark-oapi # dingtalk