[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-ZHangZHengEric--Sage":3,"tool-ZHangZHengEric--Sage":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",146793,2,"2026-04-08T23:32:35",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":76,"owner_url":77,"languages":78,"stars":114,"forks":115,"last_commit_at":116,"license":117,"difficulty_score":32,"env_os":118,"env_gpu":119,"env_ram":119,"env_deps":120,"category_tags":132,"github_topics":133,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":140,"updated_at":141,"faqs":142,"releases":153},5751,"ZHangZHengEric\u002FSage","Sage","Multi-Agent System Framework For Complex Tasks","Sage 是一个专为处理复杂任务而设计的多智能体系统框架，旨在将繁琐的工作流程转化为可靠的任务交付。它通过内置的规划、执行、自检、记忆回溯及工具推荐等智能体，能够自动完成从任务拆解到最终落地的全过程，有效解决了传统自动化脚本难以应对动态变化和多步骤协作的痛点。\n\n无论是需要长期运行的定时任务、基于问卷的数据收集，还是涉及浏览器操作的企业级工作流，Sage 都能提供可视化的进度追踪与实时协作能力。其独特亮点在于强大的全渠道集成与统一工具栈：不仅支持微信、飞书、钉钉等即时通讯工具的消息与文件投递，还融合了 MCP 服务器、浏览器自动化及代码执行能力，并配备沙箱机制以确保运行安全。此外，Sage 提供了直观的工作台，让用户能在一个界面中预览代码、图表、音视频等多种格式的输出结果。\n\n这款工具非常适合开发者构建企业级自动化应用，也适合研究人员探索多智能体协作模式，同时其桌面端、Web 端及 Chrome 插件等多入口设计，让普通用户也能轻松上手，实现个人工作效率的显著提升。凭借开箱即用的部署方案和灵活的环境配置，Sage 成为了连接创意与高效执行的得力助手。","\u003Cdiv align=\"center\">\n\n# 🌟 **Experience Sage's Power**\n\n![cover](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_ce4227ca09e5.png)\n\n[![English](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLanguage-English-blue.svg)](README.md)\n[![简体中文](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-简体中文-red.svg)](README_CN.md)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg?logo=opensourceinitiative)](LICENSE)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.10%2B-blue.svg?logo=python)](https:\u002F\u002Fpython.org)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVersion-1.1.0-green.svg)](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage)\n[![DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-Learn%20More-purple.svg)](https:\u002F\u002Fdeepwiki.com\u002FZHangZHengEric\u002FSage)\n[![Slack](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-Join%20Community-4A154B?logo=slack)](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fsage-b021145\u002Fshared_invite\u002Fzt-3t8nabs6c-qCEDzNUYtMblPshQTKSWOA)\n\n# 🧠 **Sage Agent Platform**\n\n### 🎯 **From Complex Work to Reliable Delivery**\n\n> 🌟 **A production-ready agent platform for task execution, automation, browser workflows, IM delivery, and enterprise deployment.**\n\n\u003C\u002Fdiv>\n\n---\n\n## 📸 **Product Screenshots**\n\n\u003Cdiv align=\"center\">\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_138f70e3ad72.png\" width=\"100%\" alt=\"Workbench\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>Visual Workbench\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_35696bbe05de.png\" width=\"100%\" alt=\"Chat\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>Real-time Collaboration\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_a2c8cac3fee1.png\" width=\"100%\" alt=\"Preview\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>Multi-format Support\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003C\u002Fdiv>\n\n> 📖 **Detailed Documentation**: [https:\u002F\u002Fwiki.sage.zavixai.com\u002F](https:\u002F\u002Fwiki.sage.zavixai.com\u002F)\n\n---\n\n## ✨ **Key Features**\n\n- 🤖 **Planning to Delivery**: Built-in planning, execution, self-check, memory recall, and tool suggestion agents for complex task completion.\n- 🌐 **Multi-Entry Product Surface**: Use Sage from desktop, web, CLI, and Chrome extension depending on the workflow.\n- 🔁 **Automation & Recurring Tasks**: Run scheduled jobs, questionnaire-driven collection flows, and long-running operational tasks with progress visibility.\n- 💬 **Omnichannel IM Integration**: Connect WeChat Personal (iLink), WeCom, Feishu, and DingTalk with message and file delivery support.\n- 🧰 **Unified Tooling System**: Combine built-in tools, Skills, MCP servers, browser automation, search, and image generation in one execution stack.\n- 🛡️ **Sandboxed Execution**: Local, passthrough, and remote sandbox options for safer agent runtime isolation.\n- 🛠️ **Visual Workbench**: Inspect files, tool outputs, code, charts, Mermaid, Draw.io, audio, video, and remote previews in one workspace.\n- 🏢 **Enterprise-Ready Foundation**: OAuth2, configurable auth and CORS, shared service architecture, CI coverage, and deployable multi-platform packaging.\n\n---\n\n## 🚀 **Quick Start**\n\n### Installation\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage.git\ncd Sage\n```\n\n### Running Sage\n\n**Option 1: One-Command Startup (Recommended for Development)**\n\n```bash\n# 1. Optional: activate your environment first\n# conda activate your-env\n\n# 2. Set your LLM API Key\nexport SAGE_DEFAULT_LLM_API_KEY=\"your-api-key\"\nexport SAGE_DEFAULT_LLM_API_BASE_URL=\"https:\u002F\u002Fapi.deepseek.com\u002Fv1\"\nexport SAGE_DEFAULT_LLM_MODEL_NAME=\"deepseek-chat\"\n\n# 3. Run the startup script\n.\u002Fscripts\u002Fdev-up.sh\n```\n\nThe script will automatically:\n- Check Python (>= 3.10) and Node.js (>= 18) versions\n- Create configuration files (minimal mode: SQLite, no external dependencies)\n- Install dependencies and start both backend and frontend services\n- Create `logs\u002Fserver.log` automatically\n- Honor `SAGE_PORT` from `.env` for backend startup and health checks\n\nOptional overrides:\n\n```bash\n# Explicitly choose a Python executable\nPYTHON_BIN=\u002Fpath\u002Fto\u002Fpython .\u002Fscripts\u002Fdev-up.sh\n\n# Use uv instead of python -m pip \u002F python -m ...\nUSE_UV=1 .\u002Fscripts\u002Fdev-up.sh\n```\n\n**First time?** The script will prompt you to choose between:\n- **Minimal mode**: SQLite, no external dependencies (recommended for quick start)\n- **Full mode**: MySQL + Elasticsearch + RustFS (for production-like environment)\n\nAfter starting, open: http:\u002F\u002Flocalhost:5173\n\n**Option 2: Desktop Application (Recommended for Users)**\n\nDownload the latest desktop package from [GitHub Releases](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Freleases):\n- **macOS**: `.dmg` (Intel & Apple Silicon)\n- **Windows**: `.exe` \u002F `.msi`\n- **Linux**: `.deb` (x86_64 \u002F arm64)\n\n#### Desktop Installation Guide\n\n**macOS**\n\n1. Download the `.dmg` for your CPU architecture and open it.\n2. Drag `Sage.app` into the `Applications` folder.\n3. The current macOS build is not yet signed\u002Fnotarized by Apple. If you see a warning that the developer cannot be verified or Apple cannot check the app for malicious software, open `Applications`, right-click `Sage.app`, choose `Open`, and then click `Open` again in the dialog.\n4. If macOS still blocks the app, go to `System Settings -> Privacy & Security`, find the Sage warning near the bottom, and click `Open Anyway`.\n5. If macOS says the app is damaged or still refuses to launch, run the following command and try again:\n\n```bash\nxattr -dr com.apple.quarantine \u002FApplications\u002FSage.app\n```\n\n**Windows**\n\n1. Download the `.exe` installer and run it.\n2. Follow the setup wizard to finish installation.\n3. If Windows SmartScreen shows a warning, click `More info` -> `Run anyway`.\n\n**Linux**\n\n1. Download the `.deb` package for your architecture from [GitHub Releases](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Freleases).\n2. On Debian\u002FUbuntu, you can install it directly by double-clicking it, or by running:\n\n```bash\nsudo apt install .\u002FSage-\u003Cversion>-\u003Carch>.deb\n```\n\nIf you prefer to build the desktop app from source, use the commands below.\n\n```bash\n# macOS\u002FLinux\napp\u002Fdesktop\u002Fscripts\u002Fbuild.sh release\n\n# Windows\n.\u002Fapp\u002Fdesktop\u002Fscripts\u002Fbuild_windows.ps1 release\n```\n\n**Command Line Interface (CLI)**:\n```bash\n# Install editable package\npip install -e .\n\n# Configure the minimum runtime variables\nexport SAGE_DEFAULT_LLM_API_KEY=\"your-api-key\"\nexport SAGE_DEFAULT_LLM_API_BASE_URL=\"https:\u002F\u002Fapi.deepseek.com\u002Fv1\"\nexport SAGE_DEFAULT_LLM_MODEL_NAME=\"deepseek-chat\"\nexport SAGE_DB_TYPE=\"file\"\n\n# Diagnose local runtime config\nsage doctor\n\n# Create a minimal local CLI config if needed\nsage config init\n\n# Run a quick task\nsage run --stats \"Say hello briefly.\"\n\n# Start an interactive chat session\nsage chat\n```\n\nDetailed CLI usage is documented here:\n- English: [docs\u002Fen\u002FCLI.md](docs\u002Fen\u002FCLI.md)\n- 中文: [docs\u002Fzh\u002FCLI.md](docs\u002Fzh\u002FCLI.md)\n\nThe current CLI MVP still uses the existing Sage runtime config system, so `.env` and shell environment variables remain the primary configuration mechanism.\nWhen `--json` is enabled, the CLI emits stream events and appends a final `cli_stats` event for structured post-run inspection.\n\n**Web Application (FastAPI + Vue3)**:\n\n```bash\n# Start backend\npython -m app.server.main\n\n# Start frontend (in another terminal)\ncd app\u002Fserver\u002Fweb\nnpm install\nnpm run dev\n```\n\n---\n\n## 🏗️ **System Architecture**\n\n```mermaid\ngraph TD\n    User[User] --> Desktop[💻 Desktop App]\n    User --> Web[🌐 Web App]\n    User --> CLI[⌨️ CLI]\n    User --> Ext[🧩 Chrome Extension]\n    User --> IM[💬 IM Channels]\n\n    Desktop --> AppLayer[🧭 App Service Layer]\n    Web --> AppLayer\n    CLI --> AppLayer\n    Ext --> AppLayer\n    IM --> AppLayer\n\n    subgraph App[Product Layer]\n        AppLayer --> Chat[💬 Chat & Sessions]\n        AppLayer --> AgentsUI[🤖 Agent Management]\n        AppLayer --> Tasks[⏰ Tasks & Automations]\n        AppLayer --> Browser[🌐 Browser Bridge]\n        AppLayer --> Workbench[🛠️ Visual Workbench]\n    end\n\n    subgraph Core[SAgents Core]\n        AppLayer --> Runtime[🧠 Session Runtime]\n        Runtime --> Flow[📋 AgentFlow]\n        Flow --> Agents[\"🤖 Agents\u003Cbr\u002F>Plan \u002F Simple \u002F Fibre \u002F Self-Check\"]\n        Agents --> Memory[🧠 Memory Recall]\n        Agents --> Skills[🧩 Skills]\n        Agents --> ToolMgr[🛠️ Tool Manager]\n    end\n\n    subgraph Tools[Execution & Integration]\n        ToolMgr --> MCP[🔌 MCP Servers]\n        ToolMgr --> BrowserTools[🌍 Browser Automation]\n        ToolMgr --> Search[🔎 Unified Search]\n        ToolMgr --> ImageGen[🎨 Image Generation]\n        ToolMgr --> Questionnaire[📝 Questionnaire]\n        ToolMgr --> IMTools[📨 IM Delivery]\n    end\n\n    subgraph RuntimeEnv[Runtime & Infrastructure]\n        Agents --> Sandbox[📦 Sandbox Runtime]\n        Sandbox --> Local[Local]\n        Sandbox --> Pass[Passthrough]\n        Sandbox --> Remote[Remote]\n        AppLayer \u003C--> Common[🧱 Shared Common Services]\n        Common \u003C--> DB[(SQL Database)]\n        Memory \u003C--> ES[(Elasticsearch)]\n        Workbench \u003C--> FS[(RustFS \u002F Local Files)]\n        Runtime -.-> Obs[\"👁️ Observability\u003Cbr\u002F>OpenTelemetry\"]\n    end\n```\n\n---\n\n## 📅 **What's New in v1.1.0**\n\n### 🤖 **SAgents Kernel Updates**\n\n- **Execution Chain Enhancements**: Added `PlanAgent`, `SelfCheckAgent`, `MemoryRecallAgent`, and `ToolSuggestionAgent`\n- **Context Efficiency**: Improved user input optimization and conversation history compression for long-running tasks\n- **Session & Messaging**: Added edit-and-rerun support, richer progress feedback, and better session inspection workflows\n- **Tooling Expansion**: Added questionnaire collection workflows and improved tool-call rendering, truncation, and observability\n\n### 💻 **Product Layer Updates**\n\n- **New Entry Points**: Added Sage CLI, Chrome extension, and browser automation tooling\n- **Workbench Upgrades**: Expanded support for audio, video, Mermaid, Draw.io, remote file preview, and richer tool cards\n- **Chat Experience**: Improved progress messages, delivery flow display, reasoning content presentation, and workspace interactions\n- **IM Integrations**: Expanded WeChat Personal (iLink), WeCom, Feishu, and DingTalk support with stronger file messaging flows\n\n### 🛡️ **Platform & Infrastructure**\n\n- **Enterprise Readiness**: Added OAuth2, email verification, and stronger auth\u002FCORS\u002Fsecurity controls\n- **Sandbox & Runtime**: Refactored local\u002Fpassthrough\u002Fremote sandbox support and improved Node runtime\u002Fsidecar packaging\n- **Shared Architecture**: Extracted reusable `common\u002F` services, models, and schemas across desktop and server\n- **Documentation & CI**: Rebuilt the docs structure, added CLI guides, and expanded CI\u002Ftest coverage\n\n**[View Full Release Notes](release_notes\u002Fv1.1.0.md)**\n\n---\n\n## 📚 **Documentation**\n\n- 📖 **Full Documentation**: [https:\u002F\u002Fwiki.sage.zavixai.com\u002F](https:\u002F\u002Fwiki.sage.zavixai.com\u002F)\n- 📝 **Release Notes**: [release_notes\u002F](release_notes\u002F)\n- 🏗️ **Architecture**: See `sagents\u002F`, `common\u002F`, and `app\u002F` for the core runtime and product layers\n- 🔧 **Configuration**: Environment variables and config files in `app\u002Fdesktop\u002F`\n\n---\n\n## 🛠️ **Development**\n\n### Project Structure\n\n```\nSage\u002F\n├── sagents\u002F                    # SAgents core runtime, flow, context, tools, sandbox\n├── common\u002F                     # Shared models, schemas, services, core clients\n├── app\u002F\n│   ├── desktop\u002F                # Desktop app (Python backend + Vue UI + Tauri shell)\n│   ├── server\u002F                 # Server app and web frontend\n│   ├── cli\u002F                    # Sage CLI entrypoint and services\n│   └── chrome-extension\u002F       # Browser extension and sidepanel\n├── mcp_servers\u002F                # IM, search, scheduler, image generation and more\n├── docs\u002F                       # English and Chinese documentation\n└── release_notes\u002F              # Version release notes\n```\n\n### Contributing\n\nWe welcome contributions! Please see our [GitHub Issues](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Fissues) for tasks and discussions.\n\n---\n\n## 💖 **Sponsors**\n\n\u003Cdiv align=\"center\">\n\nWe are grateful to our sponsors for their support in making Sage better:\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_4f0c663af1e0.png\" height=\"50\" alt=\"Dudu Bus\"\u002F>\n      \u003C\u002Fa>\n      \u003Cbr\u002F>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"assets\u002Fsponsors\u002Fxunhuanzhineng_logo.svg\" height=\"50\" alt=\"RcrAI\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_aaee0114c792.png\" height=\"50\" alt=\"Data\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003C\u002Fdiv>\n\n---\n\n## 🦌 **Join Our Community**\n\n\u003Cdiv align=\"center\">\n\n### 💬 Connect with us\n\n[![Slack](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-Join%20Community-4A154B?logo=slack&style=for-the-badge)](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fsage-b021145\u002Fshared_invite\u002Fzt-3t8nabs6c-qCEDzNUYtMblPshQTKSWOA)\n\n### 📱 WeChat Group\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_56c4a4ffcaf1.jpg\" width=\"300\" alt=\"WeChat Group QR Code\"\u002F>\n\n*Scan to join our WeChat community 🦌*\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Cdiv align=\"center\">\nBuilt with ❤️ by the Sage Team 🦌\n\u003C\u002Fdiv>\n","\u003Cdiv align=\"center\">\n\n# 🌟 **体验 Sage 的强大功能**\n\n![cover](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_ce4227ca09e5.png)\n\n[![英语](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLanguage-English-blue.svg)](README.md)\n[![简体中文](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F语言-简体中文-red.svg)](README_CN.md)\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg?logo=opensourceinitiative)](LICENSE)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.10%2B-blue.svg?logo=python)](https:\u002F\u002Fpython.org)\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVersion-1.1.0-green.svg)](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage)\n[![DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-Learn%20More-purple.svg)](https:\u002F\u002Fdeepwiki.com\u002FZHangZHengEric\u002FSage)\n[![Slack](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-Join%20Community-4A154B?logo=slack)](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fsage-b021145\u002Fshared_invite\u002Fzt-3t8nabs6c-qCEDzNUYtMblPshQTKSWOA)\n\n# 🧠 **Sage 代理平台**\n\n### 🎯 **从复杂工作到可靠交付**\n\n> 🌟 **一个生产就绪的代理平台，用于任务执行、自动化、浏览器工作流、即时通讯消息传递以及企业级部署。**\n\n\u003C\u002Fdiv>\n\n---\n\n## 📸 **产品截图**\n\n\u003Cdiv align=\"center\">\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_138f70e3ad72.png\" width=\"100%\" alt=\"Workbench\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>可视化工作台\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_35696bbe05de.png\" width=\"100%\" alt=\"Chat\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>实时协作\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_a2c8cac3fee1.png\" width=\"100%\" alt=\"Preview\"\u002F>\n      \u003Cbr\u002F>\u003Cstrong>多格式支持\u003C\u002Fstrong>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003C\u002Fdiv>\n\n> 📖 **详细文档**: [https:\u002F\u002Fwiki.sage.zavixai.com\u002F](https:\u002F\u002Fwiki.sage.zavixai.com\u002F)\n\n---\n\n## ✨ **核心功能**\n\n- 🤖 **规划到交付**: 内置规划、执行、自我检查、记忆检索和工具建议代理，用于完成复杂任务。\n- 🌐 **多入口产品界面**: 根据工作流程，可通过桌面端、Web 端、CLI 和 Chrome 扩展使用 Sage。\n- 🔁 **自动化与周期性任务**: 运行定时任务、问卷驱动的数据收集流程以及长期运行的操作任务，并可查看进度。\n- 💬 **全渠道 IM 集成**: 支持微信个人号（iLink）、企业微信、飞书和钉钉的消息及文件传输。\n- 🧰 **统一工具系统**: 将内置工具、技能、MCP 服务器、浏览器自动化、搜索和图像生成等功能整合在一个执行栈中。\n- 🛡️ **沙箱式执行**: 提供本地、直通和远程沙箱选项，以实现更安全的代理运行时隔离。\n- 🛠️ **可视化工作台**: 在一个工作空间内查看文件、工具输出、代码、图表、Mermaid、Draw.io、音频、视频以及远程预览内容。\n- 🏢 **企业级基础架构**: OAuth2、可配置的身份验证与 CORS、共享服务架构、CI 覆盖以及可部署的跨平台打包。\n\n---\n\n## 🚀 **快速入门**\n\n### 安装\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage.git\ncd Sage\n```\n\n### 运行 Sage\n\n**选项 1：一键启动（推荐用于开发）**\n\n```bash\n# 1. 可选：先激活你的虚拟环境\n# conda activate your-env\n\n# 2. 设置你的 LLM API 密钥\nexport SAGE_DEFAULT_LLM_API_KEY=\"your-api-key\"\nexport SAGE_DEFAULT_LLM_API_BASE_URL=\"https:\u002F\u002Fapi.deepseek.com\u002Fv1\"\nexport SAGE_DEFAULT_LLM_MODEL_NAME=\"deepseek-chat\"\n\n# 3. 运行启动脚本\n.\u002Fscripts\u002Fdev-up.sh\n```\n\n该脚本将自动：\n- 检查 Python（>= 3.10）和 Node.js（>= 18）版本\n- 创建配置文件（最小模式：SQLite，无外部依赖）\n- 安装依赖并启动后端和前端服务\n- 自动创建 `logs\u002Fserver.log`\n- 根据 `.env` 中的 `SAGE_PORT` 启动后端服务并进行健康检查\n\n可选覆盖：\n\n```bash\n# 显式指定 Python 可执行文件\nPYTHON_BIN=\u002Fpath\u002Fto\u002Fpython .\u002Fscripts\u002Fdev-up.sh\n\n# 使用 uv 替代 python -m pip \u002F python -m ...\nUSE_UV=1 .\u002Fscripts\u002Fdev-up.sh\n```\n\n**首次使用？** 脚本会提示你选择：\n- **最小模式**：SQLite，无外部依赖（推荐用于快速启动）\n- **完整模式**：MySQL + Elasticsearch + RustFS（适用于类似生产环境）\n\n启动后，打开：http:\u002F\u002Flocalhost:5173\n\n**选项 2：桌面应用（推荐给用户）**\n\n从 [GitHub Releases](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Freleases) 下载最新的桌面安装包：\n- **macOS**: `.dmg`（Intel 和 Apple Silicon）\n- **Windows**: `.exe` \u002F `.msi`\n- **Linux**: `.deb`（x86_64 \u002F arm64）\n\n#### 桌面安装指南\n\n**macOS**\n\n1. 下载适合你 CPU 架构的 `.dmg` 文件并打开。\n2. 将 `Sage.app` 拖入 `Applications` 文件夹。\n3. 当前的 macOS 版本尚未经过 Apple 签名或公证。如果出现开发者无法验证或 Apple 无法检查应用是否包含恶意软件的警告，请打开 `Applications` 文件夹，右键点击 `Sage.app`，选择 `Open`，然后在弹出的对话框中再次点击 `Open`。\n4. 如果 macOS 仍然阻止该应用，请前往 `系统设置 -> 隐私与安全性`，找到页面底部附近的 Sage 警告，然后点击 `无论如何打开`。\n5. 如果 macOS 提示应用已损坏或仍拒绝启动，运行以下命令并重试：\n\n```bash\nxattr -dr com.apple.quarantine \u002FApplications\u002FSage.app\n```\n\n**Windows**\n\n1. 下载 `.exe` 安装程序并运行。\n2. 按照安装向导完成安装。\n3. 如果 Windows SmartScreen 显示警告，点击 `更多信息` -> `无论如何运行`。\n\n**Linux**\n\n1. 从 [GitHub Releases](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Freleases) 下载适合你架构的 `.deb` 包。\n2. 在 Debian\u002FUbuntu 系统上，你可以直接双击安装，或者运行以下命令：\n\n```bash\nsudo apt install .\u002FSage-\u003Cversion>-\u003Carch>.deb\n```\n\n如果你更倾向于从源码构建桌面应用，可以使用以下命令。\n\n```bash\n# macOS\u002FLinux\napp\u002Fdesktop\u002Fscripts\u002Fbuild.sh release\n\n# Windows\n.\u002Fapp\u002Fdesktop\u002Fscripts\u002Fbuild_windows.ps1 release\n```\n\n**命令行界面 (CLI)**:\n```bash\n# 安装可编辑包\npip install -e .\n\n# 配置最低运行时变量\nexport SAGE_DEFAULT_LLM_API_KEY=\"your-api-key\"\nexport SAGE_DEFAULT_LLM_API_BASE_URL=\"https:\u002F\u002Fapi.deepseek.com\u002Fv1\"\nexport SAGE_DEFAULT_LLM_MODEL_NAME=\"deepseek-chat\"\nexport SAGE_DB_TYPE=\"file\"\n\n# 诊断本地运行时配置\nsage doctor\n\n# 如有需要，创建最小化本地 CLI 配置\nsage config init\n\n# 运行一个简单任务\nsage run --stats \"Say hello briefly.\"\n\n# 开启交互式聊天会话\nsage chat\n```\n\n详细的 CLI 使用说明请参见：\n- 英文：[docs\u002Fen\u002FCLI.md](docs\u002Fen\u002FCLI.md)\n- 中文：[docs\u002Fzh\u002FCLI.md](docs\u002Fzh\u002FCLI.md)\n\n当前的 CLI MVP 仍然沿用现有的 Sage 运行时配置系统，因此 `.env` 文件和 Shell 环境变量仍然是主要的配置方式。当启用 `--json` 时，CLI 会发出流事件，并在运行结束后附加一个 `cli_stats` 事件，以便于结构化的后续检查。\n\n**Web 应用（FastAPI + Vue3）**:\n\n```bash\n\n# 启动后端\npython -m app.server.main\n\n# 启动前端（在另一个终端）\ncd app\u002Fserver\u002Fweb\nnpm install\nnpm run dev\n```\n\n---\n\n## 🏗️ **系统架构**\n\n```mermaid\ngraph TD\n    User[用户] --> Desktop[💻 桌面应用]\n    User --> Web[🌐 网页应用]\n    User --> CLI[⌨️ 命令行工具]\n    User --> Ext[🧩 Chrome 扩展]\n    User --> IM[💬 即时通讯渠道]\n\n    Desktop --> AppLayer[🧭 应用服务层]\n    Web --> AppLayer\n    CLI --> AppLayer\n    Ext --> AppLayer\n    IM --> AppLayer\n\n    subgraph App[产品层]\n        AppLayer --> Chat[💬 聊天与会话]\n        AppLayer --> AgentsUI[🤖 代理管理]\n        AppLayer --> Tasks[⏰ 任务与自动化]\n        AppLayer --> Browser[🌐 浏览器桥接]\n        AppLayer --> Workbench[🛠️ 可视化工作台]\n    end\n\n    subgraph Core[SAgents 核心]\n        AppLayer --> Runtime[🧠 会话运行时]\n        Runtime --> Flow[📋 代理流程]\n        Flow --> Agents[\"🤖 代理\u003Cbr\u002F>计划 \u002F 简单 \u002F 光纤 \u002F 自检\"]\n        Agents --> Memory[🧠 记忆检索]\n        Agents --> Skills[🧩 技能]\n        Agents --> ToolMgr[🛠️ 工具管理器]\n    end\n\n    subgraph Tools[执行与集成]\n        ToolMgr --> MCP[🔌 MCP 服务器]\n        ToolMgr --> BrowserTools[🌍 浏览器自动化]\n        ToolMgr --> Search[🔎 统一搜索]\n        ToolMgr --> ImageGen[🎨 图像生成]\n        ToolMgr --> Questionnaire[📝 问卷调查]\n        ToolMgr --> IMTools[📨 即时通讯发送]\n    end\n\n    subgraph RuntimeEnv[运行时与基础设施]\n        Agents --> Sandbox[📦 沙盒运行时]\n        Sandbox --> Local[本地]\n        Sandbox --> Pass[直通]\n        Sandbox --> Remote[远程]\n        AppLayer \u003C--> Common[🧱 共享通用服务]\n        Common \u003C--> DB[(SQL 数据库)]\n        Memory \u003C--> ES[(Elasticsearch)]\n        Workbench \u003C--> FS[(RustFS \u002F 本地文件)]\n        Runtime -.-> Obs[\"👁️ 可观测性\u003Cbr\u002F>OpenTelemetry\"]\n    end\n```\n\n---\n\n## 📅 **v1.1.0 新特性**\n\n### 🤖 **SAgents 内核更新**\n\n- **执行链增强**：新增 `PlanAgent`、`SelfCheckAgent`、`MemoryRecallAgent` 和 `ToolSuggestionAgent`\n- **上下文效率**：优化用户输入并压缩对话历史，以提升长时间任务的处理效率\n- **会话与消息**：支持编辑后重新运行，提供更丰富的进度反馈，并改进会话检查流程\n- **工具扩展**：新增问卷收集流程，优化工具调用的渲染、截断及可观测性\n\n### 💻 **产品层更新**\n\n- **新入口**：新增 Sage 命令行工具、Chrome 扩展以及浏览器自动化工具\n- **工作台升级**：扩展对音频、视频、Mermaid、Draw.io 的支持，支持远程文件预览，并丰富工具卡片展示\n- **聊天体验**：改进进度提示、消息传递流程显示、推理内容呈现以及工作区交互\n- **IM 集成**：进一步扩展对微信个人号（iLink）、企业微信、飞书和钉钉的支持，强化文件消息流\n\n### 🛡️ **平台与基础设施**\n\n- **企业级准备**：新增 OAuth2、邮箱验证以及更强的身份认证、CORS 和安全控制\n- **沙盒与运行时**：重构了本地\u002F直通\u002F远程沙盒支持，并优化了 Node 运行时和 Sidecar 打包\n- **共享架构**：提取了桌面端和服务器端可复用的 `common\u002F` 服务、模型和架构\n- **文档与 CI**：重构了文档结构，新增命令行指南，并扩大了 CI\u002F测试覆盖范围\n\n**[查看完整发布说明](release_notes\u002Fv1.1.0.md)**\n\n---\n\n## 📚 **文档**\n\n- 📖 **完整文档**：[https:\u002F\u002Fwiki.sage.zavixai.com\u002F](https:\u002F\u002Fwiki.sage.zavixai.com\u002F)\n- 📝 **发布说明**：[release_notes\u002F](release_notes\u002F)\n- 🏗️ **架构**：核心运行时和产品层请参阅 `sagents\u002F`、`common\u002F` 和 `app\u002F`\n- 🔧 **配置**：环境变量和配置文件位于 `app\u002Fdesktop\u002F`\n\n---\n\n## 🛠️ **开发**\n\n### 项目结构\n\n```\nSage\u002F\n├── sagents\u002F                    # SAgents 核心运行时、流程、上下文、工具、沙盒\n├── common\u002F                     # 共享模型、架构、服务、核心客户端\n├── app\u002F\n│   ├── desktop\u002F                # 桌面应用（Python 后端 + Vue UI + Tauri 容器）\n│   ├── server\u002F                 # 服务器应用及网页前端\n│   ├── cli\u002F                    # Sage 命令行入口和服务\n│   └── chrome-extension\u002F       # 浏览器扩展及侧边栏\n├── mcp_servers\u002F                # 即时通讯、搜索、调度、图像生成等\n├── docs\u002F                       # 英文和中文文档\n└── release_notes\u002F              # 版本发布说明\n```\n\n### 贡献\n\n我们欢迎各位贡献！请访问我们的 [GitHub Issues](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Fissues) 查看任务和讨论。\n\n---\n\n## 💖 **赞助商**\n\n\u003Cdiv align=\"center\">\n\n我们感谢以下赞助商对 Sage 的支持，助力我们不断进步：\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_4f0c663af1e0.png\" height=\"50\" alt=\"Dudu Bus\"\u002F>\n      \u003C\u002Fa>\n      \u003Cbr\u002F>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"assets\u002Fsponsors\u002Fxunhuanzhineng_logo.svg\" height=\"50\" alt=\"RcrAI\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\" width=\"33%\">\n      \u003Ca href=\"#\" target=\"_blank\">\n        \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_aaee0114c792.png\" height=\"50\" alt=\"Data\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003C\u002Fdiv>\n\n---\n\n## 🦌 **加入我们的社区**\n\n\u003Cdiv align=\"center\">\n\n### 💬 与我们联系\n\n[![Slack](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-Join%20Community-4A154B?logo=slack&style=for-the-badge)](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fsage-b021145\u002Fshared_invite\u002Fzt-3t8nabs6c-qCEDzNUYtMblPshQTKSWOA)\n\n### 📱 微信群\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_readme_56c4a4ffcaf1.jpg\" width=\"300\" alt=\"微信群二维码\"\u002F>\n\n*扫描加入我们的微信社区 🦌*\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Cdiv align=\"center\">\n由 Sage 团队 ❤️ 打造 🦌\n\u003C\u002Fdiv>","# Sage AI 开源工具快速上手指南\n\nSage 是一个生产级的智能体（Agent）平台，支持任务执行、自动化工作流、浏览器操作及企业级部署。本指南将帮助你快速在本地运行 Sage。\n\n## 1. 环境准备\n\n在开始之前，请确保你的系统满足以下要求：\n\n*   **操作系统**：macOS, Windows, 或 Linux\n*   **Python**: 版本 >= 3.10\n*   **Node.js**: 版本 >= 18 (用于前端构建)\n*   **Git**: 用于克隆代码仓库\n\n> **提示**：推荐使用 `conda` 或 `venv` 创建独立的 Python 虚拟环境以避免依赖冲突。\n\n## 2. 安装步骤\n\n### 第一步：克隆项目\n打开终端，执行以下命令获取源代码：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage.git\ncd Sage\n```\n\n### 第二步：配置大模型密钥\nSage 需要连接大语言模型（LLM）才能运行。请在终端设置环境变量（以 DeepSeek 为例，也可替换为其他兼容 OpenAI 格式的模型）：\n\n```bash\nexport SAGE_DEFAULT_LLM_API_KEY=\"your-api-key\"\nexport SAGE_DEFAULT_LLM_API_BASE_URL=\"https:\u002F\u002Fapi.deepseek.com\u002Fv1\"\nexport SAGE_DEFAULT_LLM_MODEL_NAME=\"deepseek-chat\"\n```\n\n*Windows PowerShell 用户请使用 `$env:VAR_NAME = \"value\"` 格式设置。*\n\n### 第三步：启动服务\n推荐开发者使用一键启动脚本，它会自动检查环境、安装依赖并启动前后端服务：\n\n```bash\n.\u002Fscripts\u002Fdev-up.sh\n```\n\n**首次运行提示：**\n脚本会询问你选择运行模式：\n*   **Minimal mode (推荐)**: 使用 SQLite 数据库，无外部依赖，适合快速体验和开发。\n*   **Full mode**: 使用 MySQL + Elasticsearch + RustFS，适合生产环境模拟。\n\n启动成功后，访问浏览器打开：**http:\u002F\u002Flocalhost:5173**\n\n---\n\n## 3. 基本使用\n\nSage 提供了多种使用方式，以下是两种最快捷的上手方法：\n\n### 方式一：Web 界面交互（推荐新手）\n1.  浏览器访问 `http:\u002F\u002Flocalhost:5173`。\n2.  在可视化工作台（Visual Workbench）中直接输入自然语言指令，例如：“帮我搜索最新的 AI 新闻并总结”。\n3.  Sage 将自动规划任务、调用工具（如搜索、浏览器自动化），并在界面实时展示执行过程和结果。\n\n### 方式二：命令行 (CLI) 快速任务\n如果你更喜欢终端操作，可以使用 CLI 模式：\n\n1.  **安装 CLI 包**（在项目根目录下）：\n    ```bash\n    pip install -e .\n    ```\n\n2.  **执行单次任务**：\n    ```bash\n    sage run --stats \"Say hello briefly.\"\n    ```\n\n3.  **开启交互式对话**：\n    ```bash\n    sage chat\n    ```\n\n> **注意**：CLI 模式同样依赖上述步骤中设置的 `SAGE_DEFAULT_LLM_API_KEY` 等环境变量。\n\n---\n\n## 其他安装选项\n\n如果不希望从源码运行，可以直接下载桌面客户端：\n*   访问 [GitHub Releases](https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Freleases)\n*   根据系统下载 `.dmg` (macOS), `.exe` (Windows), 或 `.deb` (Linux) 安装包。\n*   **macOS 用户注意**：若遇到“无法验证开发者”警告，请在“系统设置 -> 隐私与安全性”中点击“仍要打开”，或使用命令 `xattr -dr com.apple.quarantine \u002FApplications\u002FSage.app` 解除隔离。","某电商运营团队需要每周从多个竞品网站抓取价格数据、分析趋势并生成可视化报告，最后通过企业微信发送给管理层。\n\n### 没有 Sage 时\n- **流程割裂严重**：开发人员需分别编写爬虫脚本、数据分析代码和图表生成工具，手动串联各个环节，维护成本极高。\n- **异常处理困难**：一旦某个网站结构变更或网络波动，整个流程立即中断，缺乏自动重试或自我修正机制，需人工介入排查。\n- **协作效率低下**：数据整理好后，需人工下载文件再上传至企业微信，无法实现从任务触发到消息送达的全自动闭环。\n- **环境安全隐患**：直接在本地服务器运行未隔离的爬虫代码，容易因恶意脚本或依赖冲突导致生产环境不稳定。\n\n### 使用 Sage 后\n- **一站式自动执行**：利用 Sage 的多智能体规划能力，单个任务即可自动调度“爬取 - 分析 - 绘图”三个专用 Agent 顺序执行，无需人工拼接脚本。\n- **自愈与容错机制**：内置的自我检查 Agent 能识别数据异常或网页变动，自动尝试调整策略或重试，确保任务长期稳定运行。\n- **全链路即时交付**：配置好企业微信集成后，报告生成完毕即自动推送至指定群组，支持文件与预览图直接送达，实现真正的无人值守。\n- **沙箱隔离运行**：所有爬虫与代码执行均在 Sage 提供的沙箱环境中进行，有效隔离潜在风险，保障核心业务系统的安全稳定。\n\nSage 将原本繁琐、脆弱的人工运维流程，转化为一个可自愈、全自动化且安全的企业级多智能体工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FZHangZHengEric_Sage_35696bbe.png","ZHangZHengEric","Eric Zhang","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FZHangZHengEric_82feb278.jpg",null,"WeChat:zhangzheng-thu","https:\u002F\u002Fgithub.com\u002FZHangZHengEric",[79,83,87,91,95,98,102,106,110],{"name":80,"color":81,"percentage":82},"Python","#3572A5",53.8,{"name":84,"color":85,"percentage":86},"Vue","#41b883",29.1,{"name":88,"color":89,"percentage":90},"JavaScript","#f1e05a",13.2,{"name":92,"color":93,"percentage":94},"CSS","#663399",1,{"name":96,"color":97,"percentage":94},"HTML","#e34c26",{"name":99,"color":100,"percentage":101},"Rust","#dea584",0.9,{"name":103,"color":104,"percentage":105},"Shell","#89e051",0.7,{"name":107,"color":108,"percentage":109},"PowerShell","#012456",0.3,{"name":111,"color":112,"percentage":113},"TypeScript","#3178c6",0,1133,87,"2026-04-08T16:08:37","MIT","Linux, macOS, Windows","未说明",{"notes":121,"python":122,"dependencies":123},"支持多种运行模式：开发模式可通过脚本一键启动（自动检查环境），用户可直接下载桌面应用（macOS\u002FWindows\u002FLinux），也支持 CLI 命令行和 Web 应用模式。首次运行可选择最小化模式（仅 SQLite）或全量模式（需 MySQL + Elasticsearch + RustFS）。macOS 未签名版本需手动授权信任。","3.10+",[124,125,126,127,128,129,130,131],"Node.js>=18","SQLite","MySQL (可选)","Elasticsearch (可选)","RustFS (可选)","FastAPI","Vue3","Tauri",[14,13,15,35],[134,135,136,137,138,139],"agents","llm","manus","muilt-agents","ai","workflow","2026-03-27T02:49:30.150509","2026-04-09T10:29:16.501570",[143,148],{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},26095,"Sage 是否支持可视化的 Agent 工作流编排？","目前 Sage 采取的方式是只给大模型提供 workflow 的提示，不会像 Dify 或 Coze 那样提供详细的可视化编排。用户可以将 Dify 或 Coze 的工作流定义成 MCP Server 来与 Sage 集成。","https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Fissues\u002F2",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},26096,"如何在本地运行 Sage 示例代码？","可以通过命令行运行 sage cli 来使用。如果示例代码（如 sage_demo.py）无法运行，请拉取最新代码，维护者已修复了 demo 中的相关问题。","https:\u002F\u002Fgithub.com\u002FZHangZHengEric\u002FSage\u002Fissues\u002F5",[154,158,162,166,170,174,178,182,186,190,194,198,202,206,210,214,218,222,226,230],{"id":155,"version":156,"summary_zh":75,"released_at":157},163482,"desktop-v1.0.23","2026-04-08T01:18:23",{"id":159,"version":160,"summary_zh":75,"released_at":161},163483,"desktop-v1.0.21","2026-04-04T15:16:48",{"id":163,"version":164,"summary_zh":75,"released_at":165},163484,"desktop-v1.0.20","2026-04-01T04:10:00",{"id":167,"version":168,"summary_zh":75,"released_at":169},163485,"desktop-v1.0.19","2026-03-27T12:08:23",{"id":171,"version":172,"summary_zh":75,"released_at":173},163486,"desktop-v1.0.18","2026-03-27T06:00:39",{"id":175,"version":176,"summary_zh":75,"released_at":177},163487,"desktop-v1.0.17","2026-03-25T15:02:18",{"id":179,"version":180,"summary_zh":75,"released_at":181},163488,"desktop-v1.0.16","2026-03-25T09:54:59",{"id":183,"version":184,"summary_zh":75,"released_at":185},163489,"desktop-v1.0.15","2026-03-25T03:16:14",{"id":187,"version":188,"summary_zh":75,"released_at":189},163490,"desktop-v1.0.14","2026-03-24T17:00:54",{"id":191,"version":192,"summary_zh":75,"released_at":193},163491,"desktop-v1.0.13","2026-03-23T05:37:04",{"id":195,"version":196,"summary_zh":75,"released_at":197},163492,"desktop-v1.0.12","2026-03-21T12:55:02",{"id":199,"version":200,"summary_zh":75,"released_at":201},163493,"desktop-v1.0.11","2026-03-21T03:14:13",{"id":203,"version":204,"summary_zh":75,"released_at":205},163494,"desktop-v1.0.10","2026-03-20T12:30:27",{"id":207,"version":208,"summary_zh":75,"released_at":209},163495,"desktop-1.0.10","2026-03-20T11:47:06",{"id":211,"version":212,"summary_zh":75,"released_at":213},163496,"desktop-v1.0.9","2026-03-19T04:39:40",{"id":215,"version":216,"summary_zh":75,"released_at":217},163497,"desktop-v1.0.8","2026-03-17T13:36:28",{"id":219,"version":220,"summary_zh":75,"released_at":221},163498,"desktop-v1.0.7","2026-03-17T07:12:18",{"id":223,"version":224,"summary_zh":75,"released_at":225},163499,"desktop-v1.0.6","2026-03-15T17:17:27",{"id":227,"version":228,"summary_zh":75,"released_at":229},163500,"desktop-v1.0.5","2026-03-15T10:51:30",{"id":231,"version":232,"summary_zh":75,"released_at":233},163501,"desktop-v1.0.4","2026-03-15T07:21:59"]