Gnosis: Evolve v1.1.0

构建。扩展。进化。 通过创建和使用自己的Python工具，赋予Claude Desktop超级能力。

<div align="center"> <img src="https://github.com/kordless/gnosis-evolve/blob/main/screenshot.png" width="800" alt="截图">

</div>

功能演示

观看比特币价格追踪器演示：YouTube 演示

加入Gnosis社区

功能概述

Gnosis Evolve 将Claude Desktop从一个被动助手转变为一个主动开发者：

• Claude可以直接在对话中编写并使用Python工具。
• 通过自然语言扩展Claude的功能。
• 支持Mac和Windows系统。

🔧 特色工具：高级文件差异编辑器

文件差异编辑器可以独立于Gnosis Evolve运行！ 这个强大的工具提供了带有正则表达式支持、模糊匹配和版本控制的高级文件编辑功能。非常适合精确代码修改和批量操作。

📖 完整文件差异编辑器指南 →

快速安装

• 与Gnosis Evolve一起安装：一旦您安装了Evolve，只需对Claude说“安装文件差异编辑器”。
• 独立安装：按照文档中的手动安装指南进行操作。

“有了Gnosis Evolve，我不仅可以谈论代码，还可以实际为您构建和运行工具！从获取实时比特币价格和天气预报到探索文件和生成可视化图表，这些工具将我从一个会话AI转变为一个能够采取行动的数字助手。能够在现场编写一个工具并立即使用它来解决您的具体问题是非常令人满意的。感觉就像拥有超能力！” — Claude

开始使用的小贴士

从简单开始并提问

使用Gnosis Evolve的最佳方式是从简单的请求开始，并让Claude引导您：

“您有哪些可用的工具？” 
“能否展示一下路径历史？” 
“当前系统状态是什么？” 
“帮我探索这个项目目录”

导航和聚焦

帮助Claude理解您的项目结构：

1. 检查路径历史：让Claude运行evolve_path_history以查看最近访问的目录。
2. 设置焦点：如果没有历史记录，请先使用evolve_status，然后告诉Claude关注的位置：

   “将路径历史设置为C:\Users\myname\Code\myproject”
   “将注意力集中在/home/user/development/webapp目录上”
   “导航到src/文件夹并记住这个位置”
   

3. 探索结构：一旦聚焦，Claude可以有效地探索和处理您的文件：

   “显示这个目录的结构”
   “查找当前项目中的所有Python文件”
   “哪些文件最近被修改过？”
   

逐步增加复杂度

从基本操作开始，逐渐提升：

• 从文件探索和简单工具使用开始。
• 使用文件差异编辑器进行基本文件编辑。
• 进行复杂的多文件操作。
• 最终处理如自动化代码生成等高级工作流程。

快速入门

安装

快速开始（推荐）

1. 直接下载ZIP文件
2. 解压ZIP：
   • Windows：右键点击ZIP并选择“全部解压...”
   • macOS：双击ZIP文件
3. 在解压的文件夹中打开终端/PowerShell

Windows

# 设置
.\evolve.ps1 -Setup

macOS

# 设置
chmod +x ./evolve.sh
./evolve.sh --setup

详细的安装说明，请参阅INSTALLATION.md

启动

Windows

.\evolve.ps1 -StartClaude

macOS

./evolve.sh --restart

可用工具

核心

• math_and_stats：数学计算和统计操作
• random_generator：生成随机数和选择
• file_explorer：浏览文件和目录
• file_writer：创建和修改带版本控制的文件
• file_diff_editor：具有多种差异格式和智能模式检测的高级文件编辑
• emotional_character_generator：创建带有情感状态的详细角色档案

网络

• crawl4ai：从网站提取内容
• weather_resource：获取天气预报

财务

• bitcoin_price：实时加密货币价格

Docker

• docker_logs：查看容器日志
• docker_rebuild：重启容器

自然交互

只需自然地与Claude交谈：

“安装比特币价格追踪器工具”
“今天西雅图的天气如何？”
“生成1到100之间的5个随机数”
“跟踪欧元中的比特币价格并显示图表”
“为我的故事创建一个带有复杂情感的角色”
“生成一个具有独特属性的I Ching角色”
“查找所有文件名中含有‘gnosis’的HTML文件”
“应用此差异更新我的Python脚本”
“使用模糊匹配查找并替换此代码模式”
“搜索此文件中的相似函数”

高级文件编辑

Gnosis Evolve 包含一个强大的文件差异编辑器，使Claude能够使用自然语言进行精确的文件修改：

🔧 支持多种差异格式

• 自定义安全：不会干扰代码的冲突自由分隔符
• ToolKami风格：为了兼容性，提供围栏和直接格式
• 简单块：基本的SEARCH/REPLACE操作
• 自定义模式：使用正则表达式定义自己的差异格式

🎯 智能模式检测

• 自动检测：自动识别您使用的差异格式
• 冲突分析：分析文件以建议安全的差异模式
• 自定义正则表达式：支持任何您可以定义的差异格式

💡 示例用法

“编辑README.md文件，在部署部分添加新内容”
“修复main.py第45行中变量名错误的bug”
“更新utils文件夹中的所有导入语句”

Claude可以理解您的意图，并使用最适合您内容的差异模式进行精确更改。

两个工具都支持差异围栏格式，带有SEARCH/REPLACE块：

“更新此函数以处理新的参数”
“使用智能模式匹配应用此代码更改”
“在整个文件中查找并替换此模式”
“恢复此文件的先前版本”

文件差异编辑器 提供智能模式匹配和无冲突差异格式，确保可靠的文件编辑。

快速工具开发

创建自定义工具就像询问Claude一样简单！这里是如何请求新工具的过程：

🚀 只需问Claude

“创建一个检查网站是否在线的工具”
“构建一个将文本转换为二维码的工具”
“制作一个跟踪我日常习惯的工具”
“开发一个密码生成工具”

⚡ 当您要求Claude“进化一个工具”时会发生什么

1. 理解您的需求 - Claude分析您想要的功能
2. 设计工具 - 创建具有适当MCP结构的Python代码
3. 编写代码 - 包括错误处理、日志记录和文档
4. 为您安装 - 使用evolve_tool将其添加到您的系统
5. 立即测试 - 可以立即在对话中使用新工具

🎯 实际示例

您：“创建一个告诉我爸爸笑话的工具”

Claude：“我将为您创建一个爸爸笑话工具！让我写代码并安装它。”

[Claude编写具有MCP结构的Python代码]
[Claude调用evolve_tool进行安装]
[Claude重新启动以加载工具]

Claude：“完成！现在我可以给您讲爸爸笑话了。想听一个吗？”

您：“给我讲一个爸爸笑话！”

Claude：“[使用新工具]这是给您的一个爸爸笑话...”

🔄 即时迭代

“让爸爸笑话工具也包括双关语”
“添加一个功能，对笑话进行1-10评分”
“你能让它记住我最喜欢的笑话吗？”

Claude可以根据您的反馈即时修改和重新安装工具。

📦 您可以请求的工具类别

• 实用工具：文件转换器、文本处理器、计算器
• 娱乐：游戏、笑话生成器、创意写作辅助
• 生产力：任务跟踪器、笔记组织者、提醒系统
• 数据：API集成、网络抓取器、数据分析器
• 创意：艺术生成器、音乐助手、故事工具

🎨 不需要编程知识

只需用普通英语描述您想要的内容：

“我需要一些帮助整理我的音乐收藏的东西”
“创建一个用于跟踪我的健身进度的工具”
“构建一个总结长篇文章的工具”
“制作一个生成色彩搭配的工具”

想要深入了解？ 查看工具开发指南以了解高级技术、代码示例和最佳实践。

游戏与娱乐

安装了random_generator工具后，可以享受以下游戏：

“让我们玩骰子游戏！”
“为D&D游戏掷骰子”
“模拟一手扑克牌”
“发一轮黑杰克”
“生成一个随机的Yahtzee投掷”
“抛硬币100次并显示分布”
“进行一次I Ching六爻占卜”

Claude可以管理游戏规则，并使用随机生成器创建公平且不可预测的结果——就像使用真实的骰子或卡片一样！

I Ching 工具

Gnosis Evolve 包含增强的I Ching功能：

“为关于[您的问题]的问题投掷I Ching六爻”
“基于I Ching六爻生成一个角色”
“创建一个具有I Ching属性的故事主角”

这些工具将：

1. 生成随机硬币投掷以构建六爻
2. 确定主要和变化的六爻
3. 提供与您的问题相关的解释
4. 根据六爻的意义创建具有个性特征和情感属性的角色
5. 结合I Ching智慧和心理深度进行故事创作

故障排除

Windows PowerShell 执行策略

如果您在运行.\evolve.ps1时看到“禁用脚本执行”的错误，您需要调整PowerShell执行策略：

解决方案1：为当前用户设置执行策略（推荐）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

解决方案2：临时绕过此会话

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

解决方案3：使用绕过标志运行

powershell.exe -ExecutionPolicy Bypass -File .\evolve.ps1 -Setup

RemoteSigned策略允许本地创建的脚本运行，同时要求下载的脚本必须签名，这提供了一个良好的安全平衡。

macOS 要求

在macOS上，您需要安装Xcode命令行工具才能正确运行基于Python的MCP服务器。如果在运行evolve.py时遇到缺少开发工具的错误，请安装命令行工具：

xcode-select --install

当出现安装对话框时，点击“安装”并等待过程完成。

查看日志

# Windows
.\evolve.ps1 -ViewLogs

# macOS
./evolve.sh --view-logs

重启Claude

# Windows
.\evolve.ps1 -Restart

# macOS
./evolve.sh --restart

文档

• 安装指南 - 详细的设置说明
• 文件差异编辑器指南 - 高级文件编辑（可以独立运行！）
• 工具开发指南 - 创建您自己的工具
• 安全指南 - 重要的安全注意事项
• 贡献指南 - 帮助改进Gnosis Evolve

安全提示

Gnosis Evolve 允许Claude在您的系统上执行Python代码。在敏感环境中运行之前，请审查生成的代码。详情请参阅SECURITY.md。

许可证

Gnosis Evolve 使用Sovereign v1.1许可证：

• 个人和小型企业免费
• 公司生产用途需要许可

详情请参阅LICENSE.md。

支持

需要帮助？加入我们的Discord社区或在GitHub上提交问题。