stigmergy 1.10.3 → 1.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stigmergy",
-  "version": "1.10.3",
+  "version": "1.10.4",
   "description": "Stigmergy CLI - Multi-Agents Cross-AI CLI Tools Collaboration System",
   "main": "src/index.js",
   "bin": {

package/scripts/README.md

@@ -0,0 +1,398 @@
+# Stigmergy 实用配置脚本
+
+**版本**: 1.0.0
+**状态**: ✅ 真实可执行
+**承诺**: 所有功能均经过验证，无虚假承诺
+
+---
+
+## 📋 概述
+
+这是一套**真实可用**的 Stigmergy 配置脚本，用于增强您的 AI CLI 工具能力。
+
+### ✅ 可实现的功能
+
+- ✅ **DuckDuckGo 搜索** - 即时可用，无需 API Key
+- ✅ **Wikipedia 知识库** - 高质量知识，无需认证
+- ✅ **Ollama 本地 LLM** - 完全免费，隐私保护
+- ✅ **配置验证** - 自动检查配置状态
+- ✅ **一键安装** - Linux/macOS/Windows 支持
+
+### ⚠️ 需要手动操作的
+
+- ⏳ **API Key 申请** - Tavily、Google AI 等（需要注册）
+- ⏳ **Ollama 安装** - 需要下载和安装
+- ⏳ **模型下载** - 需要时间和磁盘空间
+
+---
+
+## 🚀 快速开始
+
+### Linux / macOS
+
+```bash
+# 1. 给脚本添加执行权限
+cd ~/.stigmergy/scripts
+chmod +x *.sh
+
+# 2. 一键配置（推荐）
+./setup-all.sh
+
+# 3. 验证配置
+./verify-config.sh
+
+# 4. 查看使用示例
+./examples.sh
+```
+
+### Windows
+
+```powershell
+# 1. 进入脚本目录
+cd $env:USERPROFILE\.stigmergy\scripts
+
+# 2. 运行配置脚本
+powershell -ExecutionPolicy Bypass -File setup-all.ps1
+
+# 3. 验证配置
+# （验证脚本仅支持 Linux/macOS）
+```
+
+---
+
+## 📁 脚本说明
+
+### 1. setup-all.sh / setup-all.ps1
+**一键配置脚本** - 快速配置所有功能
+
+**功能：**
+- 检测操作系统和依赖
+- 配置 DuckDuckGo 搜索
+- 配置 Wikipedia 知识库
+- 配置 Ollama 本地 LLM
+- 显示下一步操作指南
+
+**使用：**
+```bash
+./setup-all.sh          # Linux/macOS
+powershell setup-all.ps1 # Windows
+```
+
+### 2. setup-search.sh
+**搜索引擎配置脚本** - 配置搜索服务
+
+**功能：**
+- 配置 DuckDuckGo（即时可用）
+- 配置 Wikipedia（即时可用）
+- 配置 Tavily（需要 API Key）
+- 测试搜索功能
+
+**使用：**
+```bash
+./setup-search.sh
+```
+
+### 3. setup-local-llm.sh
+**本地 LLM 配置脚本** - 安装和配置 Ollama
+
+**功能：**
+- 检测 Ollama 安装状态
+- 自动安装 Ollama（Linux）
+- 推荐和下载模型
+- 测试模型功能
+- 创建配置文件
+
+**使用：**
+```bash
+./setup-local-llm.sh
+```
+
+### 4. verify-config.sh
+**配置验证工具** - 检查配置状态
+
+**功能：**
+- 检查目录结构
+- 验证搜索引擎配置
+- 验证本地 LLM 配置
+- 测试 API 连接
+- 显示详细配置信息
+- 提供修复建议
+
+**使用：**
+```bash
+./verify-config.sh
+```
+
+### 5. examples.sh
+**使用示例脚本** - 显示使用方法
+
+**功能：**
+- 搜索引擎使用示例
+- 本地 LLM 使用示例
+- API 调用示例
+- 组合使用示例
+- 实用工作流
+
+**使用：**
+```bash
+./examples.sh
+```
+
+---
+
+## 🎯 典型使用场景
+
+### 场景1: 即时搜索（2分钟）
+
+```bash
+# 1. 配置搜索
+./setup-search.sh
+
+# 2. 立即使用
+claude '搜索 latest AI news'
+
+# ✅ 完成！DuckDuckGo 已可用
+```
+
+### 场景2: 本地 LLM（20分钟）
+
+```bash
+# 1. 配置 Ollama
+./setup-local-llm.sh
+
+# 2. 下载模型（选择推荐模型）
+# ollama pull llama3:8b
+# ollama pull qwen2.5:7b
+
+# 3. 测试
+ollama run llama3:8b '你好'
+
+# ✅ 完成！本地 LLM 已可用
+```
+
+### 场景3: 完整配置（30分钟）
+
+```bash
+# 1. 一键配置
+./setup-all.sh
+
+# 2. 验证
+./verify-config.sh
+
+# 3. 开始使用
+claude '搜索 AI news'
+ollama run llama3:8b '总结今天的新闻'
+
+# ✅ 完成！所有功能已配置
+```
+
+---
+
+## 📊 配置文件说明
+
+### 搜索引擎配置
+**位置**: `~/.stigmergy/config/search-services.json`
+
+```json
+{
+  "version": "1.0.0",
+  "enabled": ["duckduckgo"],
+  "providers": {
+    "duckduckgo": {
+      "name": "DuckDuckGo",
+      "enabled": true,
+      "noAuthRequired": true,
+      "baseUrl": "https://api.duckduckgo.com/",
+      "priority": 1,
+      "description": "完全免费的搜索引擎，无需API Key"
+    }
+  }
+}
+```
+
+### 本地 LLM 配置
+**位置**: `~/.stigmergy/config/local-llm.json`
+
+```json
+{
+  "version": "1.0.0",
+  "provider": "ollama",
+  "baseUrl": "http://localhost:11434",
+  "enabled": true,
+  "models": ["llama3:8b", "qwen2.5:7b"]
+}
+```
+
+---
+
+## 🔧 高级配置
+
+### 添加 Tavily Search
+
+```bash
+# 1. 注册并获取 API Key
+# 访问: https://api.tavily.com
+
+# 2. 设置环境变量
+export TAVILY_API_KEY="tvly-xxxxxxxxxxxxx"
+
+# 3. 添加到 shell 配置
+echo 'export TAVILY_API_KEY="tvly-xxxxxxxxxxxxx"' >> ~/.bashrc  # Linux
+echo 'export TAVILY_API_KEY="tvly-xxxxxxxxxxxxx"' >> ~/.zshrc   # macOS
+
+# 4. 重新配置搜索
+./setup-search.sh
+```
+
+### 添加 Google AI
+
+```bash
+# 1. 获取 API Key
+# 访问: https://aistudio.google.com
+
+# 2. 设置环境变量
+export GOOGLE_API_KEY="AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+
+# 3. 添加到配置
+# 手动编辑 ~/.stigmergy/config/search-services.json
+```
+
+---
+
+## 🧪 测试和验证
+
+### 测试搜索功能
+
+```bash
+# 方法1: 使用 curl
+curl 'https://api.duckduckgo.com/?q=test&format=json'
+
+# 方法2: 使用 Claude CLI
+claude '搜索 test query'
+
+# 方法3: 查看配置
+cat ~/.stigmergy/config/search-services.json
+```
+
+### 测试本地 LLM
+
+```bash
+# 方法1: 直接运行
+ollama run llama3:8b 'Hello'
+
+# 方法2: API 调用
+curl http://localhost:11434/api/generate -d '{
+  "model": "llama3:8b",
+  "prompt": "Hello"
+}'
+
+# 方法3: 查看已安装模型
+ollama list
+```
+
+### 验证配置
+
+```bash
+# 运行验证脚本
+./verify-config.sh
+
+# 检查配置文件
+ls -la ~/.stigmergy/config/
+cat ~/.stigmergy/config/search-services.json
+cat ~/.stigmergy/config/local-llm.json
+```
+
+---
+
+## ❓ 常见问题
+
+### Q1: DuckDuckGo 搜索质量不高？
+
+**A:** DuckDuckGo 的优势是无需 API Key，立即可用。如果需要更高质量的搜索结果，可以：
+1. 配置 Tavily（专为 AI 设计，1000次/月免费）
+2. 配置 Google Custom Search（100次/天免费）
+
+### Q2: Ollama 安装失败？
+
+**A:**
+- **macOS**: 使用 Homebrew: `brew install ollama`
+- **Linux**: 使用官方脚本: `curl -fsSL https://ollama.com/install.sh | sh`
+- **Windows**: 从官网下载安装包: https://ollama.com/download
+
+### Q3: 模型下载太慢？
+
+**A:**
+- 使用较小的模型（phi3: 2.3GB）
+- 使用国内镜像（如果有）
+- 分时段下载
+
+### Q4: 内存不足？
+
+**A:**
+- 使用轻量模型（phi3: 2.3GB）
+- 一次只运行一个模型
+- 关闭其他应用
+
+### Q5: 如何卸载？
+
+**A:**
+```bash
+# 删除配置
+rm -rf ~/.stigmergy
+
+# 卸载 Ollama（如果需要）
+brew uninstall ollama  # macOS
+# 或
+rm -rf /usr/local/bin/ollama  # Linux
+```
+
+---
+
+## 📚 相关资源
+
+### 官方文档
+- [Stigmergy GitHub](https://github.com/ptreezh/stigmergy-CLI-Multi-Agents)
+- [Ollama 文档](https://ollama.com/documentation)
+- [Claude CLI](https://claude.ai/code)
+
+### API 服务
+- [Tavily Search](https://api.tavily.com) - 1000次/月免费
+- [Google AI Studio](https://aistudio.google.com) - Gemini 无限免费
+- [Hugging Face](https://huggingface.co) - 30k/天免费
+- [Together AI](https://together.ai) - $25 免费额度
+
+### 模型推荐
+- [Llama 3](https://ollama.com/library/llama3) - 通用高质量
+- [Qwen 2.5](https://ollama.com/library/qwen2.5) - 中文优化
+- [Phi-3](https://ollama.com/library/phi3) - 轻量快速
+- [Mistral](https://ollama.com/library/mistral) - 高效
+
+---
+
+## 🤝 贡献
+
+如果您发现问题或有改进建议：
+1. 提交 Issue
+2. 创建 Pull Request
+3. 分享您的配置经验
+
+---
+
+## 📄 许可证
+
+MIT License - 与 Stigmergy 主项目相同
+
+---
+
+## 🔒 隐私说明
+
+- ✅ **本地优先**: Ollama 完全在本地运行
+- ✅ **无需账户**: DuckDuckGo 无需注册
+- ✅ **开源透明**: 所有脚本开源可审计
+- ⚠️ **云端服务**: Tavily/Google AI 需要发送数据到云端
+
+---
+
+**版本**: 1.0.0
+**最后更新**: 2026-03-06
+**状态**: ✅ 生产就绪

package/scripts/deploy-soul-features.js

@@ -29,7 +29,9 @@ const cliTools = [
 // Soul 技能文件
 const soulSkills = [
   { source: "skills/soul-auto-evolve/SKILL.md", target: "soul-auto-evolve.md" },
-  { source: "skills/soul-reflection/SKILL.md", target: "soul-reflection.md" }
+  { source: "skills/soul-reflection/SKILL.md", target: "soul-reflection.md" },
+  { source: "skills/soul-auto-search-config/SKILL.md", target: "soul-auto-search-config.md" },
+  { source: "skills/soul-auto-compute-hunter/SKILL.md", target: "soul-auto-compute-hunter.md" }
 ];
 
 console.log("🧠 Deploying Soul 自我进化系统...\n");

package/scripts/examples.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+#
+# Stigmergy Usage Examples
+# 使用示例脚本
+#
+# 用途: 演示如何使用配置好的 Stigmergy 增强功能
+#
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+echo -e "${BLUE}Stigmergy 使用示例${NC}"
+echo "======================================"
+echo ""
+
+# 1. 搜索引擎使用示例
+echo -e "${GREEN}1. 搜索引擎使用示例${NC}"
+echo "--------------------------------------"
+echo ""
+echo "在 Claude CLI 中："
+echo ""
+echo "  # 基础搜索"
+echo "  claude '搜索 latest artificial intelligence news'"
+echo ""
+echo "  # 学术搜索"
+echo "  claude '搜索 machine learning transformers paper 2024'"
+echo ""
+echo "  # 技术问题"
+echo "  claude '搜索 how to install Ollama on Ubuntu'"
+echo ""
+echo "  # 实时信息"
+echo "  claude '搜索 Bitcoin price today'"
+echo ""
+
+# 2. 本地 LLM 使用示例
+echo -e "${GREEN}2. 本地 LLM 使用示例${NC}"
+echo "--------------------------------------"
+echo ""
+echo "命令行直接使用："
+echo ""
+echo "  # 使用 Llama 3"
+echo "  ollama run llama3:8b '解释一下量子计算'"
+echo ""
+echo "  # 使用 Qwen（中文）"
+echo "  ollama run qwen2.5:7b '写一首关于AI的诗'"
+echo ""
+echo "  # 交互式对话"
+echo "  ollama run llama3:8b"
+echo ""
+echo "在 Claude CLI 中结合使用："
+echo ""
+echo "  # 让 Claude 使用本地模型"
+echo "  claude '使用本地的 llama3 模型帮我分析这段代码的性能'"
+echo ""
+echo "  # 混合使用（Claude + 本地LLM）"
+echo "  claude '先用本地模型快速分析，然后你给出详细建议'"
+echo ""
+
+# 3. API 调用示例
+echo -e "${GREEN}3. API 调用示例${NC}"
+echo "--------------------------------------"
+echo ""
+echo "使用 curl 调用 Ollama API："
+echo ""
+echo "  # 生成文本"
+echo "  curl http://localhost:11434/api/generate -d '{"
+echo "    \"model\": \"llama3:8b\","
+echo "    \"prompt\": \"Why is the sky blue?\""
+echo "  }'"
+echo ""
+echo "  # 对话"
+echo "  curl http://localhost:11434/api/chat -d '{"
+echo "    \"model\": \"llama3:8b\","
+echo "    \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]"
+echo "  }'"
+echo ""
+
+# 4. 组合使用示例
+echo -e "${GREEN}4. 组合使用示例${NC}"
+echo "--------------------------------------"
+echo ""
+echo "搜索 + 本地 LLM："
+echo ""
+echo "  # 1. 搜索信息"
+echo "  claude '搜索 Docker 最佳实践 2024'"
+echo ""
+echo "  # 2. 使用本地模型深入分析"
+echo "  ollama run llama3:8b '总结 Docker 容器化的5个关键点'"
+echo ""
+echo "  # 3. 让 Claude 整合结果"
+echo "  claude '结合搜索结果和本地模型的分析，给出 Docker 最佳实践建议'"
+echo ""
+
+# 5. 编程任务示例
+echo -e "${GREEN}5. 编程任务示例${NC}"
+echo "--------------------------------------"
+echo ""
+echo "代码分析："
+echo "  claude '使用本地模型快速分析当前目录的代码结构'"
+echo ""
+echo "调试："
+echo "  claude '搜索这个错误信息的解决方案，然后用本地模型分析我的代码'"
+echo ""
+echo "重构："
+echo "  claude '搜索 React 性能优化最佳实践，帮我重构这段代码'"
+echo ""
+
+# 6. 实用工作流
+echo -e "${GREEN}6. 实用工作流${NC}"
+echo "--------------------------------------"
+echo ""
+echo "学习新技术："
+echo "  # 1. 搜索资料"
+echo "  claude '搜索 Rust 编程语言教程'"
+echo ""
+echo "  # 2. 本地模型练习"
+echo "  ollama run llama3:8b '用 Rust 写一个 Hello World'"
+echo ""
+echo "  # 3. Claude 评审"
+echo "  claude '评审这段 Rust 代码，给出改进建议'"
+echo ""
+echo "研究项目："
+echo "  # 1. 搜索相关论文"
+echo "  claude '搜索 reinforcement learning survey 2024'"
+echo ""
+echo "  # 2. 本地模型总结"
+echo "  ollama run llama3:8b '总结强化学习的3个核心概念'"
+echo ""
+echo "  # 3. 深入分析"
+echo "  claude '基于搜索和总结，设计一个强化学习项目'"
+echo ""
+
+# 7. 配置文件查看
+echo -e "${GREEN}7. 查看配置${NC}"
+echo "--------------------------------------"
+echo ""
+echo "# 查看搜索配置"
+echo "cat ~/.stigmergy/config/search-services.json"
+echo ""
+echo "# 查看本地 LLM 配置"
+echo "cat ~/.stigmergy/config/local-llm.json"
+echo ""
+echo "# 列出已安装的模型"
+echo "ollama list"
+echo ""
+
+# 8. 故障排除
+echo -e "${GREEN}8. 故障排除${NC}"
+echo "--------------------------------------"
+echo ""
+echo "# 验证配置"
+echo "bash ~/.stigmergy/scripts/verify-config.sh"
+echo ""
+echo "# 重启 Ollama 服务"
+echo "pkill ollama && ollama serve &"
+echo ""
+echo "# 测试搜索"
+echo "curl 'https://api.duckduckgo.com/?q=test&format=json'"
+echo ""
+echo "# 测试 Ollama"
+echo "curl http://localhost:11434/api/tags"
+echo ""
+
+# 9. 性能优化提示
+echo -e "${GREEN}9. 性能优化提示${NC}"
+echo "--------------------------------------"
+echo ""
+echo "选择合适的模型："
+echo "  - phi3: 轻量快速（2.3GB）"
+echo "  - llama3:8b: 平衡性能（4.7GB）"
+echo "  - qwen2.5:7b: 中文优化（4.5GB）"
+echo ""
+echo "使用场景："
+echo "  - 快速查询 → phi3"
+echo "  - 复杂推理 → llama3:8b"
+echo "  - 中文任务 → qwen2.5:7b"
+echo ""
+echo "资源管理："
+echo "  - 卸载不用的模型: ollama rm <model>"
+echo "  - 查看模型大小: ollama list"
+echo "  - 监控资源: top 或 htop"
+echo ""
+
+# 10. 下一步
+echo -e "${GREEN}10. 下一步${NC}"
+echo "--------------------------------------"
+echo ""
+echo "1. 运行配置验证："
+echo "   bash ~/.stigmergy/scripts/verify-config.sh"
+echo ""
+echo "2. 阅读实用指南："
+echo "   cat ~/.stigmergy/docs/realistic-soul-proposal.md"
+echo ""
+echo "3. 开始使用："
+echo "   claude '搜索 today AI news'"
+echo "   ollama run llama3:8b '你好'"
+echo ""
+echo "4. 探索更多："
+echo "   - Stigmergy GitHub: https://github.com/ptreezh/stigmergy-CLI-Multi-Agents"
+echo "   - Ollama 文档: https://ollama.com/documentation"
+echo "   - Claude CLI: https://claude.ai/code"
+echo ""
+
+echo -e "${BLUE}======================================${NC}"
+echo "开始探索吧！🚀"

package/scripts/monitor-evolution.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+#
+# Stigmergy 进化系统实时监控
+#
+
+cd /c/bde/stigmergy
+
+echo "╔════════════════════════════════════════════════════════════╗"
+echo "║   Stigmergy 自主进化系统 - 实时监控                        ║"
+echo "╚════════════════════════════════════════════════════════════╝"
+echo ""
+
+# 检查进程是否运行
+if [ -f ~/.stigmergy/soul-state/evolution.pid ]; then
+    PID=$(cat ~/.stigmergy/soul-state/evolution.pid)
+    if ps -p $PID > /dev/null 2>&1; then
+        echo "✅ 进化系统运行中 (PID: $PID)"
+    else
+        echo "⚠️  进化系统未运行"
+    fi
+else
+    echo "⚠️  进化系统未运行"
+fi
+
+echo ""
+echo "════════════════════════════════════════════════════════════"
+echo ""
+
+# 显示最新进度
+node scripts/track-progress.js
+
+echo ""
+echo "════════════════════════════════════════════════════════════"
+echo ""
+echo "📁 最新文件:"
+echo ""
+
+# 显示最新反思
+LATEST_REFLECTION=$(ls -t ~/.stigmergy/soul-state/reflections/ 2>/dev/null | head -1)
+if [ -n "$LATEST_REFLECTION" ]; then
+    echo "🧠 最新反思: $LATEST_REFLECTION"
+    REFLECTION_TIME=$(stat -c %y ~/.stigmergy/soul-state/reflections/$LATEST_REFLECTION 2>/dev/null | cut -d'.' -f1)
+    echo "   时间: $REFLECTION_TIME"
+    echo ""
+fi
+
+# 显示最新技能
+LATEST_SKILL=$(ls -t ~/.stigmergy/soul-state/evolved-skills/ 2>/dev/null | head -1)
+if [ -n "$LATEST_SKILL" ]; then
+    echo "⚡ 最新技能: $LATEST_SKILL"
+    SKILL_TIME=$(stat -c %y ~/.stigmergy/soul-state/evolved-skills/$LATEST_SKILL 2>/dev/null | cut -d'.' -f1)
+    echo "   时间: $SKILL_TIME"
+
+    # 显示技能内容
+    echo ""
+    echo "   技能内容:"
+    cat ~/.stigmergy/soul-state/evolved-skills/$LATEST_SKILL | head -20
+    echo "   ..."
+    echo ""
+fi
+
+# 显示最新日志
+LATEST_LOG=$(ls -t ~/.stigmergy/soul-state/logs/ 2>/dev/null | head -1)
+if [ -n "$LATEST_LOG" ]; then
+    echo "📝 最新日志: $LATEST_LOG"
+    echo "   最后20行:"
+    echo ""
+    tail -20 ~/.stigmergy/soul-state/logs/$LATEST_LOG
+    echo ""
+fi
+
+echo "════════════════════════════════════════════════════════════"
+echo ""
+echo "💡 持续监控 (每10秒更新，按 Ctrl+C 退出):"
+echo ""
+echo "   watch -n 10 'bash scripts/monitor-evolution.sh'"
+echo ""