[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-nuwax-ai--nuwax":3,"tool-nuwax-ai--nuwax":62},[4,18,26,36,46,54],{"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 真正成长为懂上",158594,2,"2026-04-16T23:34:05",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":77,"languages":78,"stars":113,"forks":114,"last_commit_at":115,"license":116,"difficulty_score":10,"env_os":117,"env_gpu":118,"env_ram":119,"env_deps":120,"category_tags":125,"github_topics":126,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":140,"updated_at":141,"faqs":142,"releases":183},8217,"nuwax-ai\u002Fnuwax","nuwax","Nuwax Agent OS - The world's first universal agent operating system, building your private vertical general-purpose agent.  通用智能体操作系统，打造你私有的垂类通用智能体。新一代AI应用设计、开发、实践平台，无需代码，轻松创建，适合各类人群，支持多种端发布及API，提供完善的工作流、插件以及应用开发能力，RAG知识库与数据表存储能力，MCP接入以及开放能力。","Nuwax 是全球首款通用智能体操作系统，旨在帮助用户轻松构建和部署私有的垂类通用智能体。它解决了传统 AI 应用开发门槛高、流程复杂以及数据隐私难以保障的痛点，让创建专属 AI 助手不再依赖繁重的代码编写。\n\n无论是希望快速落地业务场景的企业开发者、需要验证算法的研究人员，还是缺乏编程基础但渴望拥有个性化 AI 工具的普通用户，都能通过 Nuwax 实现想法。平台提供可视化的工作流编排、丰富的插件生态以及强大的 RAG 知识库与数据表存储能力，让用户能像搭积木一样设计应用。\n\n其独特的技术亮点在于引入了\"Agent Computer（沙箱）”架构，支持分布式部署，既确保了智能体执行复杂任务时的安全隔离，又赋予了系统灵活的扩展能力。同时，Nuwax 原生支持 MCP（模型上下文协议）接入，便于连接各类外部工具与服务。配合一键式的本地部署脚本和完善的服务管理命令，用户可以迅速在 Linux 或 macOS 环境中搭建起属于自己的 AI 应用中台，真正实现从设计、开发到多端发布的全链路闭环。","# Nuwax\n\nNuwax AI - Easily build and deploy your private Agentic AI solutions.\n\nOfficial Website: [https:\u002F\u002Fnuwax.com](https:\u002F\u002Fnuwax.com)\n\nDemo: [https:\u002F\u002Fagent.nuwax.com](https:\u002F\u002Fagent.nuwax.com)\n\n[中文文档](README.zh-CN.md)|[English Doc](README.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs\u002F)\n\n## Installation & Deployment\n\nUse the official nuwax-cli command tool to quickly deploy services locally.\n\n### Quick Start\n\n#### Environment Preparation\n\n##### System Requirements\n\n- **System Requirements**: Ubuntu 22.04 LTS or later (other Linux versions not fully tested), macOS 10.15+, Windows 10\u002F11 (support coming soon)\n- **Hardware Requirements**: 4 cores 8GB RAM or higher\n- **Environment Requirements**: docker, docker-compose V2 environment [Docker Installation Guide](#docker-environment-installation)\n\n##### Supported Platforms\n\n- **Linux**: x86_64, ARM64\n  - Ubuntu 22.04 LTS (recommended)\n  - Current user needs Docker permissions, verify with `docker ps`. If you encounter permission issues, you can run with sudo privileges.\n  - Alibaba Cloud mirror acceleration is recommended\n- **macOS**: Intel, Apple Silicon (M1\u002FM2), Universal\n  - macOS 10.15 (Catalina) and later versions\n  - OrbStack is recommended (free for personal use, better performance)\n  - Ensure OrbStack or Docker Desktop is started\n  - First-time use may require allowing unknown developers: System Preferences → Security & Privacy\n\n#### Local Deployment Service Guide\n\nThere are 2 deployment services:\n\n- Main project service (required)\n- Agent Computer (Sandbox) deployment guide (optional)\n\nIn the main local service, configure one or more Agent Computer deployment addresses to use the Agent Computer (Sandbox). Since the \"Agent Computer (Sandbox)\" includes a personal computer (sandbox) which requires more resources, it supports separate deployment across multiple servers.\n\n#### Deploy Main Service\n\n[Installation Documentation](https:\u002F\u002Fnuwax.com\u002Fdeploy.html)\n\n#### Agent Computer (Sandbox) Deployment Guide\n\nYou can deploy Agent Computer services on multiple different servers, achieving distributed agent sandbox capabilities through configuration.\n\n> **Environment Requirements**: Each server needs Docker and Docker Compose environment installed, refer to [Docker Installation Documentation](https:\u002F\u002Fnuwax.com\u002Fdeploy.html#%E6%8E%A8%E8%8D%90%E6%96%B9%E6%A1%88-%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE-docker-%E8%84%9A%E6%9C%AC).\n\n[Installation Documentation](https:\u002F\u002Fnuwax.com\u002Fagent-computer-deploy.html)\n\n### Common Management Commands\n\n#### Service Management\n\n- Start service: `.\u002Fnuwax-cli docker-service start`\n- Stop service: `.\u002Fnuwax-cli docker-service stop`\n- Restart service: `.\u002Fnuwax-cli docker-service restart`\n- Check status: `.\u002Fnuwax-cli docker-service status`\n\n#### Backup Management\n\n> Backup service requires stopping Docker application servers, it's recommended to operate during business low-peak periods\n\n- **One-click Backup (Recommended):**\n  - Manual backup execution: `.\u002Fnuwax-cli auto-backup run`\n  - List all backups: `.\u002Fnuwax-cli list-backups`\n  - Restore from backup: `.\u002Fnuwax-cli rollback [BACKUP_ID]`\n\n#### Upgrade Management\n\n**Application service upgrade, using command `.\u002Fnuwax-cli auto-upgrade-deploy run` will automatically detect and download new versions for deployment.**\n\nComplete upgrade process:\n\n```bash\n# Check if deployment client has new version and update\n.\u002Fnuwax-cli check-update install\n# Update application service\n.\u002Fnuwax-cli auto-upgrade-deploy run\n```\n\n### Docker Environment Installation\n\n> **Important Note**: Docker and Docker Compose are core dependencies for running this service and must be installed correctly.\n\nIf your system doesn't have Docker environment installed yet, please refer to the detailed **[Docker Environment Installation Guide](docs\u002Fen\u002Fdocker-install.md)**.\n\nThis installation guide includes detailed installation steps for the following platforms:\n\n- **Ubuntu 24.04.3 LTS** (recommended Linux distribution)\n- **macOS** (supports OrbStack and Docker Desktop)\n- **Mirror acceleration configuration** (for mainland China users)\n\n### Recommended: One-Click Docker Installation Script\n\n> Community one-click Docker installation script\n\nThis script supports 13 Linux distributions, including domestic operating systems (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), one-click installation of docker, docker-compose with automatic configuration of Xuanyuan mirror acceleration.\n\n```shell\nbash \u003C(wget -qO- https:\u002F\u002Fxuanyuan.cloud\u002Fdocker.sh)\n```\n\n#### Script Features and Advantages\n\n✅ Supports 13 mainstream distributions: openEuler, OpenCloudOS, Anolis OS, Alinux (Alibaba Cloud), Kylin Linux, Fedora, Rocky Linux, AlmaLinux, Ubuntu, Debian, CentOS, RHEL, Oracle Linux\n\n✅ Complete support for domestic operating systems: Deep adaptation for domestic OS (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), supports automatic version detection and optimal configuration\n\n✅ Intelligent multi-mirror source switching: Built-in 6+ domestic mirror sources including Alibaba Cloud, Tencent Cloud, Huawei Cloud, USTC, Tsinghua, etc., automatically detects and selects the fastest source\n\n✅ Special handling for older systems: Supports expired systems like Ubuntu 16.04, Debian 9\u002F10, automatically configures compatible installation solutions\n\n✅ Dual installation guarantee: Automatically switches to binary installation if package manager installation fails, ensuring installation success rate\n\n✅ macOS\u002FWindows friendly prompts: Automatically detects macOS and Windows systems, provides appropriate Docker Desktop installation guidance\n\n**Quick Docker Installation Verification:**\n\n```bash\n# Check Docker version\ndocker --version\n\n# Check Docker Compose version\ndocker compose version\n\n# Run test container\ndocker run hello-world\n```\n\nIf the above commands all run successfully, your Docker environment is ready and you can proceed with Nuwax service deployment.\n\n## Architecture Diagram\n\n```\n┌────────────────────────────────────────────────────────────────────────────┐\n│                           Frontend Layer                                   │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────────────────┐  │\n│  │  PC Web  │  │   H5     │  │ Mini App │  │  IM (Feishu\u002FDingTalk\u002F  │  │\n│  │          │  │          │  │          │  │   WeCom\u002FSlack)         │  │\n│  └──────────┘  └──────────┘  └──────────┘  └─────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                        Access Layer                                        │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────────┐   │\n│  │  REST API    │  │  Long        │  │       WebSocket             │   │\n│  │              │  │ Connection   │  │                             │   │\n│  └──────────────┘  └──────────────┘  └──────────────────────────────┘   │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                      Application Layer                                     │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Component Library                                       │  │\n│  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │  │\n│  │  │ Model│ │Know- │ │ Data │ │Plugin│ │ Work-│ │  MCP │ │ Skill│ │  │\n│  │  │      │ │ ledge│ │ Table│ │      │ │ flow │ │      │ │      │ │  │\n│  │  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Management Portal                                        │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │  │\n│  │  │  User    │ │  Audit   │ │  Public  │ │ Content  │ │   Task   │ │  │\n│  │  │Management│ │Management│ │  Model   │ │Management│ │Management│ │  │\n│  │  ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ │  │\n│  │  │   Log    │ │   Menu   │ │ System   │ │          │ │          │ │  │\n│  │  │  Query   │ │Permission│ │  Config  │ │          │ │          │ │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              Product Applications                                    │  │\n│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐  │  │\n│  │  │   Web App    │  │   Q&A        │  │    General Agent         │  │  │\n│  │  │              │  │   Agent      │  │                          │  │  │\n│  │  └──────────────┘  └──────────────┘  └──────────────────────────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                    Infrastructure Layer                                    │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    Lower-level Components                            │  │\n│  │                                                                       │  │\n│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────────┐ │  │\n│  │  │   Cloud     │  │  nuwaclaw   │  │   General Agent Engine     │ │  │\n│  │  │   Sandbox   │  │   PC Client │  │                            │ │  │\n│  │  │             │  │ (mac\u002Fwin\u002F   │  │  ┌───────────────────────┐ │  │\n│  │  │             │  │  docker)    │  │  │  MCP Integration      │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  File Management     │ │  │\n│  │  │             │  │             │  │  │  Skill Management     │ │  │\n│  │  │             │  │             │  │  │  ACP Adapter Layer    │ │  │\n│  │  │             │  │             │  │  │  ┌─────────────────┐ │ │  │\n│  │  │             │  │             │  │  │  │ Supported Agent:│ │ │  │\n│  │  │             │  │             │  │  │  │ claudecode      │ │ │  │\n│  │  │             │  │             │  │  │  │ opencode        │ │ │  │\n│  │  │             │  │             │  │  │  │ codex           │ │ │  │\n│  │  │             │  │             │  │  │  │ openclaw        │ │ │  │\n│  │  │             │  │             │  │  │  │ kimicli         │ │ │  │\n│  │  │             │  │             │  │  │  └─────────────────┘ │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  Browser             │ │  │\n│  │  │             │  │             │  │  │  Automation          │ │  │\n│  │  │             │  │             │  │  │  GUI Automation      │ │  │\n│  │  │             │  │             │  │  │  Network Channel     │ │  │\n│  │  │             │  │             │  │  │  Runtime Integration │ │  │\n│  │  │             │  │             │  │  └───────────────────────┘ │  │\n│  │  │             │  │             │  └─────────────────────────────┘ │  │\n│  │  └─────────────┘  └─────────────┘                                   │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    Core Infrastructure                                │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐  │  │\n│  │  │ Database │ │  Cache   │ │  Vector  │ │  Search  │ │ Model │  │  │\n│  │  │  MySQL   │ │  Redis   │ │  Milvus  │ │ Elastic  │ │ Proxy│  │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n### Project Repository Overview\n\nThe Nuwax AI Agent Platform consists of multiple interconnected repositories:\n\n#### **Frontend & Mobile**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwax** | Frontend Web | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax) |\n| **nuwax-mobile** | Mobile Application | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-mobile](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-mobile) |\n| **noVNC** | Web-based VNC Client | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002FnoVNC](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002FnoVNC) |\n\n#### **Backend & Application Layer**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwax-backend** | Application Layer (Backend) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-backend](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-backend) |\n\n#### **Agent Engine & Clients**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **nuwaclaw** | Agent PC Client (mac\u002Fwin\u002Fdocker) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaclaw](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaclaw) |\n| **nuwaxcode** | Nuwa Agent Engine (based on open-source opencode) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaxcode](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaxcode) |\n| **claude-code-acp-ts** | Claude Code ACP based on Zed | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fclaude-code-acp-ts](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fclaude-code-acp-ts) |\n\n#### **Infrastructure & Services**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **rcoder** | Sandbox & Container Scheduling (includes General Agent Engine) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frcoder](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frcoder) |\n| **mcp-proxy** | MCP Service (used by sandbox) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fmcp-proxy](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fmcp-proxy) |\n| **nuwax-file-server** | File Service (used by sandbox and nuwaclaw, includes skill sync) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-file-server](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-file-server) |\n\n#### **Web Application Development**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **xagi-frontend-templates** | Web Application Development Templates | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fxagi-frontend-templates](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fxagi-frontend-templates) |\n| **vite-plugin-design-mode** | Visual Editor Vite Plugin | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fvite-plugin-design-mode](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fvite-plugin-design-mode) |\n| **dev-inject** | Web Application Smart Script Injection | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fdev-inject](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fdev-inject) |\n\n#### **Plugin & Script Execution**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **run_code_rmcp** | Plugin Script Execution (TypeScript\u002FJavaScript\u002FPython) | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frun_code_rmcp](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frun_code_rmcp) |\n\n#### **Network & Utilities**\n\n| Repository | Description | URL |\n| --- | --- | --- |\n| **lanproxy-go-client** | Network Tunnel Client (used by nuwaclaw) | [https:\u002F\u002Fgithub.com\u002Fffay\u002Flanproxy-go-client](https:\u002F\u002Fgithub.com\u002Fffay\u002Flanproxy-go-client) |\n\n### Agent Platform Frontend\n\n[中文文档](docs\u002Fch\u002Ffront-project.md) |[English Doc](docs\u002Fen\u002Ffront-project.md)\n\n##### Contributing Guide\n\n1. Fork the project\n2. Create feature branch\n3. Submit code changes\n4. Create Pull Request\n\n## Community & Support\n\nJoin the Nuwax AI Agent Platform community for technical support and latest updates!\n\n### Official Links\n\n- **Website**: https:\u002F\u002Fnuwax.com\n- **Demo**: https:\u002F\u002Fagent.nuwax.com\n\n### Community Channels\n\n| Channel | Description |\n|---------|-------------|\n| **GitHub Issues** | [Submit issues](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues) |\n| **WeChat Group** | Add assistant `nuwax-ai` |\n| **QQ Group** | Group ID: `1041169423` |\n| **WeChat Official Account** | Follow \"女娲智能体\" for feedback |\n| **Douyin\u002FVideo Account** | Follow for latest video content |\n\n> 📱 For **WeChat Group, Official Account, and Douyin QR codes**, please visit [User Manual](https:\u002F\u002Fnuwax.com\u002Fuser-manual.html)\n\n## License\n\nApache 2.0 License - see [LICENSE](LICENSE) for details.\n","# Nuwax\n\nNuwax AI - 轻松构建和部署您的私有智能体AI解决方案。\n\n官方网站：[https:\u002F\u002Fnuwax.com](https:\u002F\u002Fnuwax.com)\n\n演示：[https:\u002F\u002Fagent.nuwax.com](https:\u002F\u002Fagent.nuwax.com)\n\n[中文文档](README.zh-CN.md)|[English Doc](README.md) | [Contributing](CONTRIBUTING.md) | [Documentation](docs\u002F)\n\n## 安装与部署\n\n使用官方的 nuwax-cli 命令工具，可快速在本地部署服务。\n\n### 快速开始\n\n#### 环境准备\n\n##### 系统要求\n\n- **系统要求**：Ubuntu 22.04 LTS 或更高版本（其他 Linux 发行版尚未完全测试）、macOS 10.15+、Windows 10\u002F11（支持即将推出）\n- **硬件要求**：4 核 8GB 内存或更高\n- **环境要求**：Docker、Docker Compose V2 环境 [Docker 安装指南](#docker-environment-installation)\n\n##### 支持的平台\n\n- **Linux**：x86_64、ARM64\n  - Ubuntu 22.04 LTS（推荐）\n  - 当前用户需要 Docker 权限，可通过 `docker ps` 进行验证。若遇到权限问题，可使用 sudo 权限运行。\n  - 建议使用阿里云镜像加速。\n- **macOS**：Intel、Apple Silicon（M1\u002FM2）、Universal\n  - macOS 10.15（Catalina）及更高版本\n  - 推荐使用 OrbStack（个人使用免费，性能更优）\n  - 确保 OrbStack 或 Docker Desktop 已启动。\n  - 首次使用可能需要允许未知开发者：系统偏好设置 → 安全与隐私。\n\n#### 本地部署服务指南\n\n共有两种部署服务：\n\n- 主项目服务（必选）\n- 智能体计算机（沙箱）部署指南（可选）\n\n在主本地服务中，配置一个或多个智能体计算机部署地址，即可使用智能体计算机（沙箱）。由于“智能体计算机（沙箱）”包含一台个人计算机（沙箱），需要更多资源，因此支持跨多台服务器单独部署。\n\n#### 部署主服务\n\n[安装文档](https:\u002F\u002Fnuwax.com\u002Fdeploy.html)\n\n#### 智能体计算机（沙箱）部署指南\n\n您可以在多台不同的服务器上部署智能体计算机服务，通过配置实现分布式智能体沙箱功能。\n\n> **环境要求**：每台服务器都需要安装 Docker 和 Docker Compose 环境，请参考 [Docker 安装文档](https:\u002F\u002Fnuwax.com\u002Fdeploy.html#%E6%8E%A8%E8%8D%90%E6%96%B9%E6%A1%88-%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE-docker-%E8%84%9A%E6%9C%AC)。\n\n[安装文档](https:\u002F\u002Fnuwax.com\u002Fagent-computer-deploy.html)\n\n### 常用管理命令\n\n#### 服务管理\n\n- 启动服务：`.\u002Fnuwax-cli docker-service start`\n- 停止服务：`.\u002Fnuwax-cli docker-service stop`\n- 重启服务：`.\u002Fnuwax-cli docker-service restart`\n- 查看状态：`.\u002Fnuwax-cli docker-service status`\n\n#### 备份管理\n\n> 备份服务需要停止 Docker 应用服务器，建议在业务低峰期操作。\n\n- **一键备份（推荐）：**\n  - 手动执行备份：`.\u002Fnuwax-cli auto-backup run`\n  - 列出所有备份：`.\u002Fnuwax-cli list-backups`\n  - 从备份恢复：`.\u002Fnuwax-cli rollback [BACKUP_ID]`\n\n#### 升级管理\n\n**应用服务升级时，使用命令 `.\u002Fnuwax-cli auto-upgrade-deploy run` 将自动检测并下载新版本进行部署。**\n\n完整升级流程如下：\n\n```bash\n# 检查部署客户端是否有新版本并更新\n.\u002Fnuwax-cli check-update install\n# 更新应用服务\n.\u002Fnuwax-cli auto-upgrade-deploy run\n```\n\n### Docker 环境安装\n\n> **重要提示**：Docker 和 Docker Compose 是运行本服务的核心依赖，必须正确安装。\n\n如果您的系统尚未安装 Docker 环境，请参阅详细的 **[Docker 环境安装指南](docs\u002Fen\u002Fdocker-install.md)**。\n\n本安装指南包含以下平台的详细安装步骤：\n\n- **Ubuntu 24.04.3 LTS**（推荐的 Linux 发行版）\n- **macOS**（支持 OrbStack 和 Docker Desktop）\n- **镜像加速配置**（适用于中国大陆用户）\n\n### 推荐：一键 Docker 安装脚本\n\n> 社区提供的一键 Docker 安装脚本\n\n该脚本支持 13 种 Linux 发行版，包括国产操作系统（openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux），可一键安装 Docker 和 Docker Compose，并自动配置玄元镜像加速。\n\n```shell\nbash \u003C(wget -qO- https:\u002F\u002Fxuanyuan.cloud\u002Fdocker.sh)\n```\n\n#### 脚本特点与优势\n\n✅ 支持 13 种主流发行版：openEuler、OpenCloudOS、Anolis OS、Alinux（阿里云）、Kylin Linux、Fedora、Rocky Linux、AlmaLinux、Ubuntu、Debian、CentOS、RHEL、Oracle Linux\n\n✅ 完整支持国产操作系统：深度适配国产 OS（openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux），支持自动检测版本并进行最优配置\n\n✅ 智能多镜像源切换：内置 6 个以上国内镜像源，包括阿里云、腾讯云、华为云、中科大、清华等，自动检测并选择最快的源\n\n✅ 特殊处理老旧系统：支持已过期的系统，如 Ubuntu 16.04、Debian 9\u002F10，自动配置兼容的安装方案\n\n✅ 双重安装保障：若包管理器安装失败，会自动切换到二进制安装，确保安装成功率\n\n✅ macOS\u002FWindows 友好提示：自动检测 macOS 和 Windows 系统，提供合适的 Docker Desktop 安装指导\n\n**快速 Docker 安装验证：**\n\n```bash\n# 检查 Docker 版本\ndocker --version\n\n# 检查 Docker Compose 版本\ndocker compose version\n\n# 运行测试容器\ndocker run hello-world\n```\n\n若上述命令均成功运行，则您的 Docker 环境已准备就绪，可以继续进行 Nuwax 服务的部署。\n\n## 架构图\n\n```\n┌────────────────────────────────────────────────────────────────────────────┐\n│                           前端层                                   │\n│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────────────────┐  │\n│  │  PC Web  │  │   H5     │  │ Mini App │  │  IM (飞书\u002F钉钉\u002F  │  │\n│  │          │  │          │  │          │  │   钉钉\u002FSlack)         │  │\n│  └──────────┘  └──────────┘  └──────────┘  └─────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                        接入层                                        │\n│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────────┐   │\n│  │  REST API    │  │  长        │  │       WebSocket             │   │\n│  │              │  │ 连接       │  │                             │   │\n│  └──────────────┘  └──────────────┘  └──────────────────────────────┘   │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                      应用层                                     │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              组件库                                       │  │\n│  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │  │\n│  │  │ Model│ │Know- │ │ Data │ │Plugin│ │ Work-│ │  MCP │ │ Skill│ │  │\n│  │  │      │ │ ledge│ │ Table│ │      │ │ flow │ │      │ │      │ │  │\n│  │  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              管理后台                                        │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │  │\n│  │  │  用户    │ │  审计   │ │  公共  │ │ 内容  │ │   任务   │ │  │\n│  │  │管理    │ │管理   │ │  模型   │ │管理   │ │管理   │ │  │\n│  │  ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ │  │\n│  │  │   日志    │ │   菜单   │ │ 系统   │ │          │ │          │ │  │\n│  │  │  查询   │ │权限   │ │  配置  │ │          │ │          │ │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │              产品应用                                    │  │\n│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐  │  │\n│  │  │   Web App    │  │   Q&A        │  │    General Agent         │  │  │\n│  │  │              │  │   Agent      │  │                          │  │  │\n│  │  └──────────────┘  └──────────────┘  └──────────────────────────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n                                      │\n                                      ▼\n┌────────────────────────────────────────────────────────────────────────────┐\n│                    基础设施层                                    │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    底层组件                            │  │\n│  │                                                                       │  │\n│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────────┐ │  │\n│  │  │   Cloud     │  │  nuwaclaw   │  │   General Agent Engine     │ │  │\n│  │  │   Sandbox   │  │  PC Client │  │                            │ │  │\n│  │  │             │  │ (mac\u002Fwin\u002F   │  │  ┌───────────────────────┐ │  │\n│  │  │             │  │  docker)    │  │  │  MCP Integration      │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  文件管理     │ │  │\n│  │  │             │  │             │  │  │  技能管理     │ │  │\n│  │  │             │  │             │  │  │  ACP适配器层    │ │  │\n│  │  │             │  │             │  │  │  ┌─────────────────┐ │ │  │\n│  │  │             │  │             │  │  │  │ 支持的Agent:│ │ │  │\n│  │  │             │  │             │  │  │  │ claudecode      │ │ │  │\n│  │  │             │  │             │  │  │  │ opencode        │ │ │  │\n│  │  │             │  │             │  │  │  │ codex           │ │ │  │\n│  │  │             │  │             │  │  │  │ openclaw        │ │ │  │\n│  │  │             │  │             │  │  │  │ kimicli         │ │ │  │\n│  │  │             │  │             │  │  │  └─────────────────┘ │ │  │\n│  │  │             │  │             │  │  ├───────────────────────┤ │  │\n│  │  │             │  │             │  │  │  浏览器             │ │  │\n│  │  │             │  │             │  │  │  自动化          │ │  │\n│  │  │             │  │             │  │  │  GUI自动化      │ │  │\n│  │  │             │  │             │  │  │  网络通道     │ │  │\n│  │  │             │  │             │  │  │  运行时集成     │ │  │\n│  │  │             │  │             │  │  └───────────────────────┘ │  │\n│  │  │             │  │             │  └─────────────────────────────┘ │  │\n│  │  └─────────────┘  └─────────────┘                                   │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n│                                                                              │\n│  ┌─────────────────────────────────────────────────────────────────────┐  │\n│  │                    核心基础设施                                │  │\n│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐  │  │\n│  │  │ Database │ │  Cache   │ │  Vector  │ │  Search  │ │ Model │  │  │\n│  │  │  MySQL   │ │  Redis   │ │  Milvus  │ │ Elastic  │ │ Proxy│  │  │\n│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘  │  │\n│  └─────────────────────────────────────────────────────────────────────┘  │\n└────────────────────────────────────────────────────────────────────────────┘\n```\n\n### 项目仓库概览\n\nNuwax AI 智能体平台由多个相互关联的仓库组成：\n\n#### **前端与移动端**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **nuwax** | 前端 Web | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax) |\n| **nuwax-mobile** | 移动应用 | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-mobile](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-mobile) |\n| **noVNC** | 基于 Web 的 VNC 客户端 | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002FnoVNC](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002FnoVNC) |\n\n#### **后端与应用层**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **nuwax-backend** | 应用层（后端） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-backend](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-backend) |\n\n#### **智能体引擎与客户端**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **nuwaclaw** | 智能体 PC 客户端（mac\u002Fwin\u002Fdocker） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaclaw](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaclaw) |\n| **nuwaxcode** | Nuwa 智能体引擎（基于开源 opencode） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaxcode](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwaxcode) |\n| **claude-code-acp-ts** | 基于 Zed 的 Claude Code ACP | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fclaude-code-acp-ts](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fclaude-code-acp-ts) |\n\n#### **基础设施与服务**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **rcoder** | 沙箱与容器调度（包含通用智能体引擎） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frcoder](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frcoder) |\n| **mcp-proxy** | MCP 服务（供沙箱使用） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fmcp-proxy](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fmcp-proxy) |\n| **nuwax-file-server** | 文件服务（供沙箱和 nuwaclaw 使用，包含技能同步） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-file-server](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax-file-server) |\n\n#### **Web 应用开发**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **xagi-frontend-templates** | Web 应用开发模板 | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fxagi-frontend-templates](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fxagi-frontend-templates) |\n| **vite-plugin-design-mode** | 可视化编辑器 Vite 插件 | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fvite-plugin-design-mode](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fvite-plugin-design-mode) |\n| **dev-inject** | Web 应用智能脚本注入 | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fdev-inject](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fdev-inject) |\n\n#### **插件与脚本执行**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **run_code_rmcp** | 插件脚本执行（TypeScript\u002FJavaScript\u002FPython） | [https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frun_code_rmcp](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Frun_code_rmcp) |\n\n#### **网络与工具**\n\n| 仓库 | 描述 | URL |\n| --- | --- | --- |\n| **lanproxy-go-client** | 网络隧道客户端（供 nuwaclaw 使用） | [https:\u002F\u002Fgithub.com\u002Fffay\u002Flanproxy-go-client](https:\u002F\u002Fgithub.com\u002Fffay\u002Flanproxy-go-client) |\n\n### 智能体平台前端\n\n[中文文档](docs\u002Fch\u002Ffront-project.md) | [英文文档](docs\u002Fen\u002Ffront-project.md)\n\n##### 贡献指南\n\n1. Fork 该项目\n2. 创建功能分支\n3. 提交代码更改\n4. 创建 Pull Request\n\n## 社区与支持\n\n加入 Nuwax AI 智能体平台社区，获取技术支持和最新动态！\n\n### 官方链接\n\n- **官网**: https:\u002F\u002Fnuwax.com\n- **演示**: https:\u002F\u002Fagent.nuwax.com\n\n### 社区渠道\n\n| 渠道 | 描述 |\n|------|------|\n| **GitHub Issues** | [提交问题](https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues) |\n| **微信社群** | 添加助手 `nuwax-ai` |\n| **QQ 群** | 群号: `1041169423` |\n| **微信公众号** | 关注“女娲智能体”以获取反馈 |\n| **抖音\u002F视频号** | 关注以获取最新视频内容 |\n\n> 📱 如需 **微信社群、公众号及抖音二维码**，请访问 [用户手册](https:\u002F\u002Fnuwax.com\u002Fuser-manual.html)\n\n## 许可证\n\nApache 2.0 许可证 - 详情请参阅 [LICENSE](LICENSE)。","# Nuwax 快速上手指南\n\nNuwax 是一个用于轻松构建和部署私有化 Agentic AI 解决方案的开源平台。本指南将帮助中国开发者快速完成本地环境的搭建与服务部署。\n\n## 1. 环境准备\n\n在开始部署前，请确保您的服务器满足以下系统要求并安装了必要的依赖。\n\n### 系统要求\n- **操作系统**：\n  - Linux: Ubuntu 22.04 LTS 或更高版本（推荐），支持 x86_64 和 ARM64 架构。\n  - macOS: 10.15 (Catalina) 及以上（Intel 或 Apple Silicon M1\u002FM2）。\n  - *注：Windows 支持即将推出，目前建议使用 WSL2 或 Linux 环境。*\n- **硬件配置**：至少 4 核 CPU，8GB 内存。\n- **前置依赖**：必须安装 Docker 和 Docker Compose V2。\n\n### 推荐：一键安装 Docker 环境（国内加速）\n针对中国大陆用户，推荐使用社区提供的一键脚本，该脚本自动配置阿里云、腾讯云等国内镜像源加速，并适配多种国产操作系统（如 openEuler, Anolis OS, 麒麟等）。\n\n执行以下命令自动安装 Docker 及 Docker Compose：\n\n```bash\nbash \u003C(wget -qO- https:\u002F\u002Fxuanyuan.cloud\u002Fdocker.sh)\n```\n\n**验证安装是否成功：**\n\n```bash\ndocker --version\ndocker compose version\ndocker run hello-world\n```\n若上述命令正常输出且 `hello-world` 容器运行成功，则环境准备完毕。\n\n> **macOS 用户提示**：推荐使用 **OrbStack** 替代 Docker Desktop 以获得更佳性能。首次运行可能需要在“系统设置 -> 隐私与安全性”中允许未知开发者。\n\n## 2. 安装步骤\n\nNuwax 通过官方 CLI 工具 `nuwax-cli` 进行管理服务。主要服务分为“主项目服务”（必选）和\"Agent Computer 沙箱服务”（可选，用于分布式执行）。以下为主服务的快速部署流程。\n\n### 部署主服务\n请参考官方详细部署文档获取最新的 `nuwax-cli` 安装包及初始化命令：\n[安装文档](https:\u002F\u002Fnuwax.com\u002Fdeploy.html)\n\n通常部署流程如下（具体以官网最新指令为准）：\n1. 下载并解压 `nuwax-cli`。\n2. 执行初始化配置。\n3. 启动服务。\n\n### 常用服务管理命令\n部署完成后，使用以下命令管理服务生命周期：\n\n```bash\n# 启动服务\n.\u002Fnuwax-cli docker-service start\n\n# 停止服务\n.\u002Fnuwax-cli docker-service stop\n\n# 重启服务\n.\u002Fnuwax-cli docker-service restart\n\n# 查看服务状态\n.\u002Fnuwax-cli docker-service status\n```\n\n## 3. 基本使用\n\n服务启动成功后，您可以通过浏览器访问前端界面进行 Agent 的构建与管理。\n\n### 访问入口\n- **默认访问地址**：通常在本地 `http:\u002F\u002Flocalhost:PORT` 或服务器 IP 对应端口（具体端口请在部署配置中确认）。\n- **在线演示**：[https:\u002F\u002Fagent.nuwax.com](https:\u002F\u002Fagent.nuwax.com)\n\n### 核心功能概览\n登录管理后台后，您可以：\n1. **模型管理**：配置大模型 API Key。\n2. **知识库构建**：上传文档数据供 Agent 检索。\n3. **工作流编排**：通过可视化界面组合插件、技能和 MCP 工具。\n4. **应用发布**：将构建好的 Agent 发布为 Web 应用、H5 或集成到飞书\u002F钉钉\u002F企微等 IM 平台。\n\n### 升级与备份\n**应用升级**：\n自动检测并下载新版本进行部署：\n```bash\n# 检查并更新部署客户端\n.\u002Fnuwax-cli check-update install\n# 执行应用服务升级\n.\u002Fnuwax-cli auto-upgrade-deploy run\n```\n\n**数据备份**：\n建议在业务低峰期执行备份（需停止部分服务）：\n```bash\n# 执行一键备份\n.\u002Fnuwax-cli auto-backup run\n\n# 列出所有备份\n.\u002Fnuwax-cli list-backups\n\n# 从指定备份恢复\n.\u002Fnuwax-cli rollback [BACKUP_ID]\n```\n\n---\n*更多详细架构说明及 Agent Computer 分布式部署指南，请访问 [Nuwax 官方文档](https:\u002F\u002Fnuwax.com)。*","某中型电商企业的运营团队希望快速构建一个能自动处理售后退款、查询库存并生成日报的私有智能体，以应对日益增长的客服压力。\n\n### 没有 nuwax 时\n- **开发门槛高**：业务人员不懂代码，必须依赖 IT 部门排期开发，一个简单的流程调整往往需要数周才能上线。\n- **数据孤岛严重**：智能体无法直接安全地访问内部知识库（RAG）和实时数据表，导致回答客户问题时经常“胡编乱造”或信息滞后。\n- **部署运维复杂**：缺乏统一的操作系统环境，每次更新模型或插件都需要手动配置服务器，难以实现多端发布和弹性扩展。\n- **流程僵化**：现有的脚本只能执行固定任务，无法像通用智能体那样自主规划工作流，遇到复杂异常需人工介入打断。\n\n### 使用 nuwax 后\n- **零代码敏捷构建**：运营人员利用 nuwax 的可视化工作流编辑器，无需编写一行代码，半天内即可搭建出具备完整逻辑的垂类智能体。\n- **原生数据融合**：通过内置的 RAG 引擎和数据表存储能力，nuwax 让智能体实时读取最新库存与政策文档，确保回复准确率提升至 98%。\n- **一键私有化部署**：借助 nuwax-cli 工具，团队在本地 Ubuntu 服务器上快速完成容器化部署，并轻松将服务发布为 API 供多个系统调用。\n- **自主决策执行**：基于 Agent OS 的强大调度能力，智能体能自主拆解复杂退款请求，自动调用插件完成核验、审批及通知全流程。\n\nnuwax 将原本需要跨部门协作数周的 AI 项目，转化为业务部门可独立掌控的即时生产力，真正实现了私有垂类通用智能体的低成本落地。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnuwax-ai_nuwax_25bceb11.png","nuwax-ai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fnuwax-ai_d18f9d55.png","",null,"https:\u002F\u002Fgithub.com\u002Fnuwax-ai",[79,83,87,91,95,99,103,107,110],{"name":80,"color":81,"percentage":82},"TypeScript","#3178c6",86.2,{"name":84,"color":85,"percentage":86},"Less","#1d365d",6.7,{"name":88,"color":89,"percentage":90},"CSS","#663399",5.6,{"name":92,"color":93,"percentage":94},"JavaScript","#f1e05a",0.7,{"name":96,"color":97,"percentage":98},"HTML","#e34c26",0.5,{"name":100,"color":101,"percentage":102},"Java","#b07219",0.2,{"name":104,"color":105,"percentage":106},"Makefile","#427819",0,{"name":108,"color":109,"percentage":106},"Shell","#89e051",{"name":111,"color":112,"percentage":106},"Dockerfile","#384d54",747,135,"2026-04-16T10:06:19","Apache-2.0","Linux (Ubuntu 22.04 LTS 推荐，支持 x86_64, ARM64), macOS (10.15+, 支持 Intel\u002FApple Silicon)","未说明","最低 8GB (4 核 CPU)",{"notes":121,"python":118,"dependencies":122},"Windows 支持即将推出；核心依赖为 Docker 环境，推荐使用 OrbStack (macOS) 或配置国内镜像加速；支持通过 nuwax-cli 进行一键部署、备份和升级；Agent Computer (Sandbox) 可选分布式部署以节省资源。",[123,124],"Docker","Docker Compose V2",[14,13,35],[127,128,129,130,131,132,133,134,135,136,137,138,139],"agent","agentic","agentic-rag","application","rag","a2a","chatbot","mcp","workflow","agent-os","skills","agent-sandbox","agentos","2026-03-27T02:49:30.150509","2026-04-17T08:25:51.054091",[143,148,153,158,163,168,173,178],{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},36764,"后端代码是否已经开源？","是的，后端代码现在已经开源。您可以直接在仓库中查找相关代码。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F133",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},36765,"项目被指责是 Claude 套壳，对此如何回应？","Nuwax 提供的是完整的智能体应用低代码开发解决方案，注重平台化体验而非单一模型。AgentOS 旨在为各类 Agent 提供可执行环境，用户可自由选择底层模型（如支持 Anthropic 协议的模型使用 ClaudeCode，同时也包含自研引擎以适配更多场景如消费级显卡）。团队严格遵守开源协议，基于开源框架二次开发是正常做法，且每周五举办论文分享会致力于技术研究。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F136",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},36766,"在哪里可以找到微信交流群？","微信群二维码位于官方文档的用户手册页面：https:\u002F\u002Fnuwax.com\u002Fuser-manual.html","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F147",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},36767,"使用 Docker 安装时，NuwaX 容器与其他项目（如 Dify）的容器混在一起怎么办？","这是因为未设置 Docker Compose 项目名称导致命名空间冲突。可以通过在 `nuwax-cli` 命令中添加 `-p` 参数来设置独立的 project name，例如：`.\u002Fnuwax-cli -p \u003C项目名称> auto-upgrade-deploy run`，从而隔离容器。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F140",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},36768,"内网服务器部署后，开发服务器连接正常但无法预览页面怎么办？","默认配置使用了 Docker 虚拟 IP，其他机器无法访问。解决方法是修改 Nginx 配置：\n1. 编辑文件：`vi docker\u002Fconfig\u002Fnginx.conf`\n2. 将端口修改为 `18083`\n3. 重启服务即可。\n或者参考私有部署文档执行一次自动升级部署 (`.\u002Fnuwax-cli auto-upgrade-deploy run`)，新版本已修复此问题。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F5",{"id":169,"question_zh":170,"answer_zh":171,"source_url":172},36769,"部署成功后，连接 LLM 测试按钮提示成功但聊天功能无法使用怎么办？","这是默认模型不可用的问题。请在“智能体开发”界面中，点击进入具体的智能体详情，然后重新选择一下模型即可修复。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F4",{"id":174,"question_zh":175,"answer_zh":176,"source_url":177},36770,"连接 Ollama 时是否必须输入 API KEY？","是的，该字段为必填项，但您可以随便输入一个占位符即可，不影响实际连接。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F6",{"id":179,"question_zh":180,"answer_zh":181,"source_url":182},36771,"Windows 桌面客户端点击“开始对话”会跳出浏览器，能否在应用内打开？","该功能已在 v0.9.1 版本中支持。请将 NuwaClaw 客户端升级到 v0.9.1 或更高版本，即可在应用内嵌浏览器中打开对话页面。","https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Fissues\u002F145",[184,189,194,199,204,209,214,219,224,229,234,239,244],{"id":185,"version":186,"summary_zh":187,"released_at":188},297173,"v1.1.4","## ✨ 新功能\n\n- **国际化 (i18n) 全面演进**：\n  - 实现后端驱动的 i18n 运行时治理，完成核心页面与组件的国际化迁移。\n  - 覆盖 AppDev 聊天、AntV X6 工作流（节点、画布、运行结果）、系统管理（角色、用户组、日志）等多个核心模块。\n  - 新增本地默认字典，优化多语言切换的鲁棒性。\n- **API 密钥管理增强**：\n  - 新增 API 密钥（API KEY）管理页面，支持密钥的创建、编辑、删除及动态分页加载。\n  - 新增 API 调用日志页面与控制台，支持调用频率统计与权限配置（ApiKeyPermission）。\n- **智能体与会话体验优化**：\n  - 新增开放授权应用（OpenApp）相关页面，支持应用详情查看与历史会话记录追踪。\n  - 新增会话详情组件（ConversationDetails），优化历史会话列表展示逻辑。\n  - 增强 `ChatInputHome` 的 @ 提及功能，新增 `AtMentionIcon` 并优化弹窗定位逻辑。\n  - 智能体模型设置（AgentModelSetting）支持使用场景过滤，并适配通用型智能体。\n- **系统设置与交互增强**：\n  - 新增“指定时间”定时任务功能，支持精准的时间校验。\n  - 沙盒配置（SandboxModal）支持默认值填充与表单初始值自动设置。\n  - 文件上传新增文件大小校验逻辑（50MB\u002F20MB），提升系统安全性。\n  - 新增通用操作按钮组件（CommonActionButton）与 TooltipIcon 的位置自定义属性。\n\n## 🐛 Bug 修复\n\n- **性能与稳定性**：\n  - 优化首包耗时统计逻辑，确保跳过心跳包并精准传递完整 chunk 数据。\n  - 修复 Electron 隔离环境下对 `NuwaClawBridge` 的非法访问问题。\n- **会话与交互修复**：\n  - 修复文件预览逻辑，确保正确处理文件名并清理文件选择状态。\n  - 修复历史会话中 `agentId` 参数丢失导致的跳转异常。\n  - 修复多页面布局下更多页面标签文本显示不准确的问题。\n- **样式与组件修复**：\n  - 修复移动端 DOCX 预览样式，提升跨端用户体验。\n  - 修复 `XProTable` 查询按钮在特定场景下的点击事件处理异常。\n  - 更新钉钉图标等品牌元素，提升一致性。\n\n## ♻️ 重构\n\n- **布局与导航体系重构**：\n  - 重构动态菜单布局（DynamicMenusLayout），支持父级菜单路径存储与更灵活的菜单映射逻辑。\n  - 统一应用结构路径前缀，重构 `BaseTemplate` 优化底部渐变样式与快捷键响应。\n  - 移除冗余的“更多页面”组件，整合至动态菜单体系中。\n- **代码优化与解耦**：\n  - 提取“复制到剪贴板”为全局通用方法，简化多处组件的重复实现。\n  - 重构数据权限模态框（DataPermissionModal）结构，提升可维护性。\n  - 优化文件树（FileTreeView）与会话信息（ConversationInfo）的文件列表刷新触发机制。\n  - 清理 AntV X6 历史遗留代码与本地化残余，提升核心流转效率。\n\n## 🎨 样式优化\n\n- **UI 质感提升**：\n  - 统一全局表格边框半径、边距及底部样式，引入更多自定义样式变量（Design Tokens）。\n  - 重构智能体标签（Agent Tag）与历史会话列表的自适应布局。\n  - 优化工作间布局（WorkspaceLayout），新增返回按钮功能并微调间距。\n- **术语规范化**：\n  - 持续更新注释与变量名称，确保符合最新的业务语义。\n\n## 📚 文档\n\n- **开发规范更新**：\n  - 更新 AntV X6 v3 版本节点布局与逻辑文档。\n  - 完善 API 密钥权限配置与调用统计的技术方案文档。","2026-04-15T06:16:04",{"id":190,"version":191,"summary_zh":192,"released_at":193},297174,"v1.1.3","## 🐛 Bug 修复\n\n- 修复当工作空间是第一个菜单时，由于退出登录未清除空间信息，导致更换账号再次进入页面后，空间ID不正确的问题；\n- 修复广场查询智能体时未携带智能体子类型（ChatBot），导致查询结果包含了网页应用型智能体的问题；","2026-04-02T08:40:08",{"id":195,"version":196,"summary_zh":197,"released_at":198},297175,"v1.1.2","## ✨ 新功能\n\n- 新增微信机器人 (wechat_ilink) 渠道集成，支持扫码连接与状态轮询\n- 优化微信扫码界面，实现 216x216 常驻虚线交互容器设计\n- 新增扫码确认成功后的 Alert 风险提示，明确同账号覆盖风险\n- 支持在扫码成功后多次重新获取二维码，增强交互的连续性\n- 优化微信扫码交互流程，移除强制选择智能体的顺序限制\n- 增强空间标题显示逻辑，支持根据用户角色判断动态展示标题\n- 更新渠道统计逻辑与平台展示，支持侧边栏计数在微信机器人保存后的实时同步\n- 增强微信扫码连接界面提示信息，提供更清晰的操作引导指引\n\n## 🐛 Bug 修复\n\n- 修复微信扫码弹窗关闭后在途请求未及时清理导致的异步逻辑残留问题\n- 修复微信扫码确认后的 `configData` 配置回填与最终表单提交链路\n- 修复广场 (Square) 分类切换时分页参数残留导致的页码显示异常及数据竞态覆盖问题\n- 修复创建 IM 渠道模态框的关闭行为属性，及弹窗交互细节\n\n## ♻️ 重构\n\n- 重构微信扫码逻辑为独立 `WechatIlinkForm` 组件，实现业务解耦\n- 优化扫码轮询机制为递归串行等待模式 (Sequential Polling)，精准控制生命周期\n- 优化新团队创建组件的路由跳转逻辑，确保路径切换平滑\n\n## 🎨 样式优化\n\n- 新增扫码成功后的绿色确认蒙层与 Check 图标动效反馈\n- 优化微信扫码区域的全局状态布局风格，确保各展示阶段的视觉稳定性","2026-03-27T11:21:24",{"id":200,"version":201,"summary_zh":202,"released_at":203},297176,"v1.1.1","### ✨ 新功能\n\n- **@ 提及功能 (Mention)**\n  - 新增聊天输入框 `@` 提及成员\u002F技能功能，支持快捷唤出提及列表弹窗（MentionPopup）\n  - 新增提及项动态位置计算、高度变化自适应管理及内容搜索筛选\n- **广场与技能 (Square)**\n  - 新增插件信息及导航管理，支持技能卡片点击跳转及参数编码\n  - 新增 SingleAgent 统计项及 defaultTaskAgentId 定制项，优化配置管理\n- **即时通讯管理 (IMChannel)**\n  - 新增支持创建不同类型的即时通讯通道（如企业微信应用）\n  - 新增通道参数验证、输出模式选择，并支持一键“测试连通性”\n- **用户参考功能整合**\n  - 新增远程桌面分享功能，支持生成分享链接和设置过期时间\n  - 新增文件树面板展开\u002F折叠和固定功能，提升交互体验\n  - 新增 VNC 远程桌面预览连接状态显示和自动重连机制\n  - 新增空闲检测功能和警告弹窗，自动断开长时间无操作连接\n  - 新增加载更多历史消息功能，支持会话消息分页查询\n  - 新增任务智能体模式切换、技能变量支持及 SubAgentConfig 配置\n  - 新增文件操作提示框、预览支持更多格式（SVG、JSON、Office 等）\n  - 新增未保存更改检查，防误触操作\n\n### 🐛 Bug 修复\n\n- **视图与兼容性**\n  - 修复了 Markdown 文档预览时可能导致的文本水平溢出显示问题\n  - 修复了 `DynamicMenusLayout` 路径判断，增强对 iframe 路由页面的跳转兼容\n- **状态同步与连接**\n  - 修复了 `Workflow` 数据层同步，确保能够响应并获取到最新的表单 drawer 状态\n  - 修复了 SSE 连接关闭逻辑，确保中止状态不残留并正确记录\n  - 修复了清空会话、会话停止后 requestId 未释放导致文件树不刷新的问题\n- **其他细节**\n  - 修复了导出文件名解码特殊字符及预览组件类型切换时的闪动问题\n  - 修复了任务记录跳转使用错误的空间 ID，以及过滤空消息渲染问题\n\n### ♻️ 重构\n\n- **全局弹窗规范化**：封装 `XModalForm` 并在全局替换 `ModalForm`，统一了必填项星号（*）的后置展示\n- **模块规范化**：统一将 `IMRobot` 重命名为 `IMChannel`，并将相关路由从 `\u002Fim-robot` 规范更新为 `\u002Fim_channel`\n- **逻辑抽离**：抽离自动文件预览逻辑至自定义 Hook，优化 `AgentDetails` 页面加载与状态管理\n- **用户参考重构整合**：重构 AppDev 文件树面和聊天区、重构 SSE 分离工作流连接、优化 v3 版工作流表单合并逻辑\n\n### 🎨 样式优化\n\n- 优化 `AgentDetails` 和 `Chat` 页面加载视觉，新增输入框淡入动画及骨架屏加载样式\n- 优化新增滚动条自动隐藏视觉（仅在悬停时显示），优化空状态组件图标和加载动画\n- 统一提示信息中的称谓为“你”以提升亲和力\n- 将“远程桌面”统一更名为“智能体电脑”\n\n### 📚 文档\n\n- 新增 TiptapVariableInput 组件文档\n- 新增变量引用规则文档\n- 新增试运行逻辑分析文档","2026-03-20T04:08:02",{"id":205,"version":206,"summary_zh":207,"released_at":208},297177,"v1.1.0","# 发布 v1.1.0\n\n基于 v1.0.9 至 main 的变更整理，可直接用于 GitHub\u002FGitLab Release 描述。\n\n---\n\n### ✨ 新功能\n\n- 广场（Square）增强滚动加载与自动填充逻辑，支持更多内容流畅加载。\n- 空间板块（SpaceSection）增强滚动加载与自动填充逻辑，优化长列表浏览体验。\n- 生态 MCP（EcosystemMcp）增强滚动加载与自动填充逻辑，提升生态市场内容加载能力。\n- 知识库原始片段（RawSegmentInfo）增强自动加载与编辑功能，便于文档片段管理。\n- 更多操作菜单（MoreActionsMenu）新增重启功能图标并更新相关常量，便于开发环境快捷操作。\n\n### 🐛 Bug 修复\n\n- 修复空间知识库（SpaceKnowledge）页码更新逻辑并优化文档加载体验。\n- 修复知识库原始片段（RawSegmentInfo）页码更新逻辑以正确加载数据。\n- 修复数据权限弹窗（DataPermissionModal）页码更新逻辑以提升数据加载体验。\n- 修复空间板块（SpaceSection）滚动加载逻辑以正确更新页码。\n- 修复生态 MCP（EcosystemMcp）滚动加载逻辑以正确更新页码。\n\n### ♻️ 重构\n\n- 广场（Square）优化滚动加载逻辑，提升代码可维护性。\n- 菜单列表项、页面预览 iframe、菜单布局（MenuListItem, PagePreviewIframe, MenusLayout）优化组件逻辑与样式。\n- 布局与动态菜单（Layout, DynamicMenusLayout）移除已注释的动态菜单相关代码以简化布局。\n- 动态菜单、空间板块、空间开发、应用项（DynamicMenusLayout, SpaceSection, SpaceDevelop, ApplicationItem）注释掉开发收藏相关逻辑以简化代码。\n\n### 🎨 样式优化\n\n- 空间开发（SpaceDevelop）更新主容器样式以优化响应式布局。\n\n---\n\n**版本**：v1.1.0  \n**基准**：v1.0.9 → main  \n**日期**：2026-03-06\n","2026-03-06T14:25:29",{"id":210,"version":211,"summary_zh":212,"released_at":213},297178,"v1.0.9","### ✨ 新功能\n\n- 新增智能体电脑管理模块，支持多电脑类型选择、连通性测试以及启用\u002F停用\u002F删除等沙盒管控功能。\n- 新增变量引用输入（PromptVariableRef）组件开发，支持光标跟随、智能推荐变量及语法高亮显示。\n- 新增完善的系统级权限控制模块，支持菜单、权限资源、角色及用户组界面的精细化授权与拖拽排序。\n- 新增数据权限管理与全局模型管控能力，实现模型对不同智能体或网页应用的精细化独立分配。\n- 新增工作区动态菜单（DynamicMenusLayout）架构，增强菜单数据处理与动态路径路由加载能力。\n- 新增系统核心仪表盘看板，集成会话统计、知识库、技能与动态趋势图卡片的数据接口。\n- 新增独立的历史会话管理页面，提供完善的数据分页、检索追踪、快速重命名与删除能力。\n- 新增知识库资源文档的纯在线预览能力，提升文件解析与查阅体验。\n- 新增我的电脑管理页面与连接密匙功能，支持代理对话入口和直接沙箱跳转联调。\n\n### 🐛 Bug 修复\n\n- 修复工作流（Workflow V3）并发提交下出现的节点保存状态竞争与修改冲突问题。\n- 修复发送框中变量自动补全（Textarea）或切换光标时导致 `{{` 符号重复插入的问题。\n- 修复移动端或特殊场景下，由于图片加载失败导致组件内容渲染异常的视觉崩溃。\n- 修复聊天及页面开发时状态轮询导致的频繁报错及 SSE\u002FDevLogs 断开重新连接判断失效。\n- 修复系统管理内多个增删改查表单输入溢出及状态重置异常的问题。\n- 修复域名绑定校验逻辑缺失和空间名称存在特殊字符被截断时的展示问题。\n\n### ♻️ 重构\n\n- 重构项目基础数据列表组件，全量迁入自研 `XProTable`，统一分页（如拉齐至 15 或 48 大小）、查询逻辑及滚动固定。\n- 重构菜单资源及鉴权结构（MenuPermission），去除抽屉转而采用标准化 Modal，简化资源层级状态代码。\n- 重构对话视图（ChatView）与滚动监控状态，重写历史消息滚动交互计算，从 localStorage 替换至可控 Session管理。\n- 改进并拆分了用户组（UserGroupManage）、角色等核心表单项代码组织，并去除冗余接口依赖，优化渲染性能。\n- 改进前后端日志调用的参数控制逻辑，彻底抽离日志查询分页与异常兜底流程。\n\n### 🎨 样式优化\n\n- 优化 Markdown 渲染组件和 CodeViewer 布局，新增动态主题适配，调整数字字母错乱的边缘情况并改善折叠面板。\n- 优化系统全局警告视觉交互（如调浅了深红色的警告文字、优化了禁用状态下按钮\u002F计算机选择器的悬浮样式）。\n- 统一样式表布局内边距（如 Dashboard 顶部间隔、ProTable 数据筛选间距、数据权限遮罩层），增强适应性。\n- 优化资源文件树图标展示与悬停反馈，调整多种界面操作的状态文本以避免长信息截断。\n\n### 📚 文档\n\n- 新增 GitLab、Gitee 多代码托管源的平台配置部署说明及远程多源管理实践指导。\n- 更新项目基础自述手册 (README) 并且补充最新的 Nuwax-CLI 构建与版本说明。","2026-03-06T02:51:47",{"id":215,"version":216,"summary_zh":217,"released_at":218},297179,"v1.0.8","### ✨ 新功能\n\n- feat(Chat, PreviewAndDebug): 添加 setIsMoreMessage 用于管理消息加载状态\n- feat(CreateModel): 在新增或编辑模型时，新增最大上下文长度字段\n- feat(historyConversation): 为历史会话页面添加关闭按钮\n\n### 🐛 Bug 修复\n\n- 修复 SSE 连接关闭逻辑，确保连接关闭时正确标记中止状态\n- 修复会话停止逻辑，确保在 requestId 为空时也能停止会话\n- 修复清空会话后对话设置未重置的问题\n- 修复页面切换时 SSE 连接未中断的问题\n- 修复代码规范问题（ESLint）\n\n### ♻️ 重构\n\n- 恢复 v1.0.8-alpha 代码版本\n- 移除 ChatArea 组件中冗余的 handleAddToChat 函数，简化代码结构\n- 重构 SSE 连接逻辑，将工作流与会话的 SSE 连接分离\n\n### 🎨 样式优化\n\n- style(EditAgent): 为提升在微信中的可见性，在 PreviewAndDebug 中注释掉 mask 属性\n- style: 更新 AgentModelSetting 的布局和逻辑\n- style: 更新 SystemTipsWord 的布局\n- 将“远程桌面”统一更名为“智能体电脑”\n\n### 🔧 构建\u002F工具\n\n- 更新 .gitignore 文件，添加 .agent 以排除相关文件\n- 清理测试文件和示例文件","2026-02-03T14:35:56",{"id":220,"version":221,"summary_zh":222,"released_at":223},297180,"v1.0.7","\r\n## ✨ 新功能\r\n\r\n- 新增远程桌面分享功能，支持生成分享链接和设置过期时间\r\n- 新增文件树面板展开\u002F折叠和固定功能，提升用户交互体验\r\n- 新增 VNC 远程桌面预览连接状态显示和自动重连机制\r\n- 新增空闲检测功能和警告弹窗，支持用户长时间无操作时自动断开连接\r\n- 新增加载更多历史消息功能，支持会话消息分页查询\r\n- 新增任务智能体模式切换功能\r\n- 新增文件操作提示框（上传、下载、导出、导入），增强用户反馈\r\n- 新增文件预览支持更多格式（SVG、JSON、Office 文档等）\r\n- 新增子智能体配置功能（SubAgentConfig）\r\n- 新增技能变量支持和工具分类功能\r\n- 新增会话状态更新事件监听，任务状态变化时 UI 及时更新\r\n- 新增未保存更改检查功能，防止用户在未保存的情况下进行重要操作\r\n\r\n## 🐛 Bug 修复\r\n\r\n- 修复 SSE 连接关闭逻辑，确保连接关闭时正确标记中止状态\r\n- 修复会话停止逻辑，确保 requestId 为空时也能停止会话\r\n- 修复清空会话后对话设置未重置问题\r\n- 修复页面切换时 SSE 连接未中断问题\r\n- 修复导出文件名解码问题，支持特殊字符\r\n- 修复文件预览组件类型切换时的闪动问题\r\n- 修复会话结束后文件树刷新逻辑\r\n- 修复任务记录跳转使用错误的空间 ID\r\n- 修复空消息渲染问题，过滤掉空消息\r\n- 修复 Select 组件选项匹配不上时的显示问题\r\n\r\n## ♻️ 重构\r\n\r\n- 重构 AppDev 文件树面板和聊天区域组件结构\r\n- 重构 FileTreeView 组件，优化文件选择逻辑和视图模式切换\r\n- 重构 SSE 连接逻辑，分离工作流与会话的 SSE 连接\r\n- 重构 VncPreview 组件，优化连接检查和重试机制\r\n- 优化工作流 v3 版本的表单值合并逻辑和节点数据获取逻辑\r\n- 优化最近使用和会话记录查询逻辑\r\n- 统一提示信息中的称谓为\"你\"以提升用户亲和力\r\n\r\n## 🎨 样式优化\r\n\r\n- 新增滚动条自动隐藏样式，仅在悬停时显示\r\n- 优化文件树顶部样式和搜索视图高度\r\n- 优化聊天页面布局，支持动态调整左侧宽度\r\n- 优化空状态组件图标和加载动画样式\r\n- 将\"远程桌面\"统一更名为\"智能体电脑\"\r\n\r\n## 📚 文档\r\n\r\n- 新增 TiptapVariableInput 组件文档\r\n- 新增变量引用规则文档\r\n- 新增试运行逻辑分析文档","2026-01-14T08:33:27",{"id":225,"version":226,"summary_zh":227,"released_at":228},297181,"v1.0.6","### ✨ 新功能\n\n- 新增 VNC 远程桌面预览功能，长任务智能体支持远程桌面操作\n- 重构工作流 v3 版本，新增变量聚合节点（VariableAggregation）组件\n- 新增是否支持 Design 设计模式配置开关\n- 增强日志处理逻辑，支持检测最新日志块中的错误\n- 为文件树视图添加加载遮罩层，优化加载状态指示\n- 添加自定义滚动条样式，仅在悬停时显示滚动条\n\n### 🐛 Bug 修复\n\n- 修复智能体编排页同步开场白内容及预置问题列表逻辑\n- 修复插件参数对 Object 和 Array\u003CObject> 类型子级删除逻辑\n- 修复 Design 模式下内容编辑删除 bug\n- 修复 VariableAggregation 目录命名规范（统一大写 V）\n- 修复 nodeItem 组件导入路径问题\n- 修复页面预览 iframe 不必要的页面重载问题\n\n### ♻️ 重构\n\n- 移除不必要的 onConfirmUpdateEventQuestions 属性\n- 优化 nodeItem 样式，简化输入框样式设置\n- 增强 DesignViewer 组件的内容更新和聊天功能\n- 统一跳转 URL 子包处理逻辑\n\n### 📚 文档\n\n- 添加 DesignViewer 设计模式开发指南\n- 添加查找替换规则文档\n- 更新开发指南，添加 Vite 插件预注入说明和常见问题","2026-01-05T07:07:30",{"id":230,"version":231,"summary_zh":232,"released_at":233},297182,"v1.0.5","## ✨ 新功能\n\n新增 DesignViewer 设计模式组件，支持 Tailwind CSS 样式编辑和实时预览\n\n增强 TiptapVariableInput：支持变量输入、Markdown 语法、可编辑变量节点、自定义标签保护\n\n添加项目导出、聊天任务取消、变量建议外部关闭、多行智能样式替换\n\n## 🐛 Bug 修复\n\n修复文件上传\u002F导入加载状态管理、useAppDevServer 支持 devServerUrl 为 null\n\n修复 PagePreviewIframe 文档处理、智能体引导问题、聊天滚动检测逻辑\n\n修复设计模式状态管理，迁移到 appDevDesign 模型\n\n## ♻️ 重构\n\n重构 TiptapVariableInput 实现自包含变量树，移除 VariableInferenceInput\n\n统一变量转换方法到工具库，提取滚动检测到独立 Hook\n\n优化 DesignViewer 模块化，升级 TiptapVariableInput 到 React 18 API\n\n清理调试日志和未使用代码\n\n## ⚡ 性能优化\n\n优化 TiptapVariableInput 光标位置和滚动保持，使用 useCallback 优化 EditAgent","2025-12-08T06:09:03",{"id":235,"version":236,"summary_zh":237,"released_at":238},297183,"v1.0.3","### ✨ 新功能\r\n\r\n- 同步老仓库最新代码，添加微信小程序支持、封面图片上传、MCP 智能体支持\r\n- 新增 TiptapVariableInput 组件，支持 @ 提及和变量自动补全\r\n- 添加项目ID支持、版本更新检查、回到首页悬浮图标\r\n- 重构 useAppDevServer 和 useDevLogs 钩子，使用 umi 的 useRequest 进行轮询\r\n\r\n### 🐛 Bug 修复\r\n\r\n- 修复封面图片源类型导入、图片加载错误处理、AttachFile 组件 mimeType 容错\r\n- 修复 useAppDevServer keepAlive 多项目并发问题\r\n- 修复 PagePreviewIframe 页面刷新逻辑、小程序跳转路径、AppDev 取消任务错误\r\n\r\n### ♻️ 重构\r\n\r\n- 使用枚举替代字符串常量，优化微信小程序消息发送逻辑\r\n- 优化 TiptapVariableInput 和 ExpandTextArea 组件\r\n- 清理 AppDev 调试日志（移除 80+ 条）\r\n\r\n### 🧪 测试\r\n\r\n- 新增 TiptapVariableInputTest 测试页面","2025-11-24T04:33:12",{"id":240,"version":241,"summary_zh":242,"released_at":243},297184,"v1.0.2","# 更新日志\r\n\r\n## [1.0.2] - 2025-11-17\r\n\r\n### 🔧 构建\u002F工具\r\n\r\n- 添加 esbuild 依赖并在配置中实现 dev-monitor.js 的复制与压缩功能\r\n- 更新 dev-monitor.js 版本号至 1.0.2、1.0.3、1.0.4\r\n\r\n### ✨ 新功能\r\n\r\n- 同步老仓库最新代码\r\n- 添加微信小程序支持功能，注入 JS-SDK 并监听 DOM 变化以发送消息\r\n- 添加封面图片上传功能，更新相关样式和逻辑，增强页面编辑和创建功能\r\n- 更新预览组件逻辑，添加封面图片源类型判断，优化截图处理\r\n- 更新 PageCard 组件，替换 icon 属性为 coverImg，优化样式过渡效果，移除不再使用的 PageDevelopCardItem 组件\r\n- MCP 添加智能体支持，更新相关组件和常量，优化图标处理逻辑\r\n- 添加创建智能体功能，更新 Created 组件和服务接口以支持智能体类型\r\n- 添加 streamableHttp 类型支持，更新样式以增强组件可视化效果\r\n- 添加项目ID支持以区分不同项目的最近使用记录，在 ChatArea、ChatInputHome 和 MentionSelector 组件中引入 projectId 属性\r\n\r\n### 🐛 Bug 修复\r\n\r\n- 修复封面图片源类型导入路径，确保正确引用\r\n- 添加图片加载错误处理逻辑，确保组件在图片加载失败时使用默认图片\r\n- 修复 useAppDevServer 中 keepAlive 可能同时运行多个不同 projectId 的问题，引入 useParams 从 URL 获取最新的 projectId，确保同一时间只有当前 URL projectId 的 keepAlive 在运行\r\n- 优化封面图片来源设置逻辑，确保用户未上传图片时不设置来源\r\n- 更新 Created 组件的 checkTag 属性，从 Plugin 修改为 Workflow，以确保正确的组件类型匹配\r\n- 修复 AttachFile 组件中对 mimeType 的容错处理，确保在后端返回空值时不导致错误\r\n- 延迟发送微信小程序消息，确保 DOM 变化监听稳定性\r\n- 添加错误发送防抖逻辑，优化错误消息发送至父窗口的稳定性\r\n- 更新 Created 组件中的 agentItem 标签，将 label 从 '当前空间智能体' 修改为 '全部'，新增 '当前空间智能体' 选项\r\n\r\n### ⚡️ 性能优化\r\n\r\n- 优化微信小程序消息发送逻辑，简化代码结构并增强 DOM 变化监听功能\r\n\r\n### ♻️ 重构\r\n\r\n- 使用枚举替代字符串常量，增强代码可读性和可维护性，添加错误处理逻辑\r\n- 移除同步登录状态功能的实现，简化代码结构\r\n- 将最近使用的文件和数据源存储从 localStorage 更改为 sessionStorage，提高数据的即时性\r\n- 注释掉 setupMutationObserver 函数以简化错误监控逻辑，保留相关逻辑以便未来可能的恢复\r\n- 注释掉资源加载错误处理逻辑，简化错误监控代码\r\n- 重构 useAppDevServer 和 useDevLogs 钩子以使用 umi 的 useRequest 进行轮询，简化定时器管理，优化状态管理，提升代码可读性和维护性\r\n\r\n## [1.0.1] - 2025-11-10\r\n\r\n\u002F\u002F ... existing code ...\r\n\r\n[1.0.0]: https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Freleases\u002Ftag\u002Fv1.0.0\r\n[1.0.1]: https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Freleases\u002Ftag\u002Fv1.0.1\r\n[1.0.2]: https:\u002F\u002Fgithub.com\u002Fnuwax-ai\u002Fnuwax\u002Freleases\u002Ftag\u002Fv1.0.2","2025-11-18T05:54:08",{"id":245,"version":246,"summary_zh":76,"released_at":247},297185,"v1.0.1","2025-11-13T08:46:01"]