[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-RTGS2017--NagaAgent":3,"tool-RTGS2017--NagaAgent":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},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,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},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 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70626,"2026-04-05T22:51:36",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":78,"owner_email":78,"owner_twitter":78,"owner_website":78,"owner_url":80,"languages":81,"stars":114,"forks":115,"last_commit_at":116,"license":117,"difficulty_score":118,"env_os":119,"env_gpu":120,"env_ram":120,"env_deps":121,"category_tags":135,"github_topics":136,"view_count":23,"oss_zip_url":78,"oss_zip_packed_at":78,"status":16,"created_at":144,"updated_at":145,"faqs":146,"releases":147},4027,"RTGS2017\u002FNagaAgent","NagaAgent","A simple yet powerful agent framework for personal assistants, designed to enable intelligent interaction, multi-agent collaboration, and seamless tool integration.","NagaAgent 是一款专为个人用户打造的智能助手框架，旨在通过生动的二次元虚拟形象（Live2D）提供亲切自然的交互体验。它不仅仅是一个聊天机器人，更是一个具备“超能力”的桌面伙伴，能够解决用户在信息检索、任务自动化及游戏辅助等方面的复杂需求。\n\n普通用户无需具备编程背景即可轻松上手。NagaAgent 支持一键登录自动配置，让用户能立即与拥有独特人设的虚拟角色进行语音或文字互动。其核心优势在于强大的自主执行能力：内置的 OpenClaw 模块可自动探索网络知识、规划并执行多步骤任务；独特的“记忆云海”技术能将对话历史转化为三维知识图谱，确保持续且连贯的智能记忆；此外，它还具备游戏画面识别与自动操作功能，甚至能操控浏览器和管理本地文件。\n\n对于喜欢个性化体验的用户，NagaAgent 提供了丰富的自定义选项，包括角色音色、背景故事及技能插件。无论是希望提升日常效率的办公族，还是寻求智能游戏辅助的玩家，亦或是喜爱虚拟陪伴的二次元爱好者，都能在其中找到适合自己的使用场景。通过将复杂的 AI 技术封装在直观的界面之下，NagaAgent 让尖端的人工智能真正成为了触手可及的日常工具。","\u003Cdiv align=\"center\">\n\n# NagaAgent\n\n**你的二次元超能AI助手**\n\n流式工具调用 · 知识图谱记忆 · Live2D 虚拟形象 · 语音交互 · 娜迦网络社区\n\n《娜迦协议》包括对话、记忆、MCP、skills、openclaw集成，以打造丰富且易用的ai工具为核心，成为用户端侧的二次元超能ai助手。\n\n软件包含如下功能：①一键登陆自动配置所有apikey，与具备Live2d形象的娜迦进行鼠标互动和亲切对话；②通过内置openclaw快速探索自己需要的知识领域，或是列出任务方向让其自动探索执行；③根据对话历史自动构建三维记忆云海，并将记忆注入后续对话；④通过对话之余留下的线索碎片，探索娜迦网络中的神秘娜迦世界；⑤内置游戏攻略功能，可通过交互或自动识别游戏画面，了解到游戏正在进行的细节信息，并给出建议。可通过MAA等游戏操作插件来自动打游戏；⑥还具有自我配置、浏览器操纵、音乐盒等丰富组件。\n\n娜迦的一切未来，等你探索。\n\n\n[简体中文](README.md) | [English](README_en.md) | [日本語](README_ja.md)\n\n![NagaAgent](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNagaAgent-5.1.0-blue?style=for-the-badge&logo=python&logoColor=white)\n![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-Windows%20%7C%20macOS%20%7C%20Linux-green?style=for-the-badge)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL%203.0%20%7C%20Proprietary-yellow?style=for-the-badge)\n![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11-blue?style=for-the-badge&logo=python)\n\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FXxiii8322766509\u002FNagaAgent?style=social)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent)\n[![Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FXxiii8322766509\u002FNagaAgent?style=social)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent)\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FXxiii8322766509\u002FNagaAgent)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent\u002Fissues)\n[![Nerq Trust Score](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRTGS2017_NagaAgent_readme_f20dd00a73d2.png)](https:\u002F\u002Fnerq.ai\u002Fsafe\u002FRTGS2017\u002FNagaAgent)\n\n**[QQ 机器人联动：Undefined QQbot](https:\u002F\u002Fgithub.com\u002F69gg\u002FUndefined\u002F)**\n\n\u003C\u002Fdiv>\n\n---\n\n**双许可证** · 开源采用 [AGPL-3.0](LICENSE)，闭源采用 [专属许可](LICENSE-CLOSED-SOURCE)（需书面授权）。\n商业合作：contact@nagaagent.com \u002F bilibili【柏斯阔落】\n\n---\n\n## 更新日志\n\n| 日期 | 版本 | 内容 |\n|------|------|------|\n| 🛰️ 2026-03-14 | — | 干员通讯录升级为设置弹窗（名称 \u002F 人设 \u002F 引擎 \u002F 灵魂文档 \u002F 专有 MCP·Skill）；技能工坊接入 NagaHub 与通用 MCP 预热；探索链路新增 QQ \u002F 飞书完成通知；云端记忆优先时不再回退本地 Neo4j |\n| 🧩 2026-03-13 | — | OpenClaw 编排链路与打包集成继续扩展；后端 spec 修复 Windows 控制台 Unicode 输出报错 |\n| 🧱 2026-03-11 | — | OpenClaw Skill 自动执行；干员独立 workspace；模型选择器与定价显示接入 Default \u002F Deepseek-V3.2 \u002F Kimi-K2.5 |\n| 🛠️ 2026-03-09 | — | 深度集成 OpenClaw vendor 源码编译与统一配置；论坛未登录 401 风暴修复；Windows 托盘图标修复 |\n| 📦 2026-03-08 | — | naga-backend.spec 持续修正；应用扫描器支持环境变量与 macOS；工具结果默认折叠；枢机集市移除记忆云迁 \u002F MCP 工具 \u002F 智能体技能三板块 |\n| 🚦 2026-03-07 | — | Node.js 与 uv 运行时随包分发；MCP 命令解析器统一；OpenClaw Gateway 启动诊断增强；打包版音乐 \u002F 唤醒语音 \u002F 记忆云海等问题修复 |\n| 🧰 2026-03-06 | — | GitHub Actions 构建发布流水线；Electron 自动更新替换旧补丁系统；CI 构建资源与 charset_normalizer 打包修复；论坛与积分轮询细节优化 |\n| 🔊 2026-03-05 | — | TTS 开关、消息队列与串行发送重构；RAG 记忆召回增强；Gemini \u002F 自动 Function Calling 支持；充值界面与远程记忆稳定性修复 |\n| 🧠 2026-03-04 | — | 迁移到原生 Function Calling；DogTag 接管 heartbeat \u002F proactive vision；前后端热补丁系统与 4 层安全防护；流式文本与渐进式 TTS 优化 |\n| 🔎 2026-03-03 | — | web_search 直接接入 NagaBusiness 搜索代理；论坛连接、TTS 流式播放与 OpenClaw 轮询降级修复；Live2D 与 Electron 稳定性修复 |\n| ❤️ 2026-03-02 | — | Heartbeat v3 事件驱动重构；naga_control 自编排工具；打包时嵌入 agent-browser；启动诊断、健康检查与 OpenClaw 配置路径修复 |\n| 🌐 2026-03-01 | — | 已登录走 NagaBusiness、未登录走 Brave \u002F OpenClaw 的搜索代理成型；OpenClaw 工具直调与自动启动完善；游戏攻略与角色音色配置更新 |\n| 🗂️ 2026-02-28 | — | 持久化存储统一迁移到 `~\u002F.naga` 用户目录；ForumQuotaView 网络探索控制中心；旅行模块与语音交互全面升级 |\n| 🎙️ 2026-02-27 | — | 接入 ASR 语音识别（MediaRecorder + NagaBusiness 代理）；会话风格、Electron 背景、MCP vision 与服务器配置整理 |\n| 🎆 2026-02-26 | 5.1.0 | 娜迦网络社区论坛上线；设置三合一重构；旅行模式；积分配额页；枢机集市与主面板更新 |\n| ⚡ 2026-02-25 | 5.1.0 | TTS 全链路修复（CORS \u002F asyncio）；build.py 跨平台构建；上下文压缩持久化；角色系统更新；提示词注入架构重构 |\n| 🎵 2026-02-24 | — | Neo4j 连接超时修复；统一 BGM 播放器；音律坊歌单编辑；MCP 管理 UI；悬浮球透明窗口 + 悬停亮度 |\n| 🏗️ 2026-02-23 | — | 跨平台构建完善；版本号统一 pyproject.toml 管理；提示词\u002F截图\u002F视觉优化；角色文件打包迁移 |\n| 💕 2026-02-22 | — | 积分好感度系统（签到 \u002F 好感度 \u002F 积分）；悬浮球阴影与拖拽修复；登录自动恢复；OpenClaw hooks 修复 |\n| 🎶 2026-02-21 | — | 音律坊图标更新；MCP Agents 更新；悬浮球小按钮 |\n| 🗜️ 2026-02-20 | — | 上下文压缩三级重构（`\u003Ccompress>` 标签 \u002F 跨会话继承）；MCP 管理 UI；悬浮球透明窗口；音律坊功能修正 |\n| 🔄 2026-02-19 | — | SSE 去除 base64 直接 JSON 传输；移除冗余后台意图分析器；config_manager 自动检测编码 |\n| 🔧 2026-02-17 | — | 悬浮球序列帧路径改为相对路径，修复打包后头像不显示 |\n| 🚀 2026-02-16 | 5.0.0 | NagaModel 网关统一接入；DeepSeek 推理链实时展示；记忆云海 UI 自适应修复 |\n| 🧠 2026-02-15 | — | 统一附加知识块 + 消除历史污染；LLM 流式重试；七天自动登录；开机自启动 |\n| 🌊 2026-02-14 | — | NagaMemory 云端远程记忆；意识海 3D 重写；启动粒子动画；版本更新检查弹窗；用户使用协议 |\n| ✨ 2026-02-13 | — | 悬浮球 4 状态模式；截屏多模态视觉切换；技能工坊重构；Live2D 表情通道独立 |\n| 🎨 2026-02-12 | — | NagaCAS 认证；Live2D 4 通道正交动画架构；Agentic Tool Loop；明日方舟风格启动界面 |\n| 📦 2026-02-11 | — | 嵌入式 OpenClaw 打包；启动自动从模板生成配置文件 |\n| 🛠️ 2026-02-10 | — | 后端打包优化；技能工坊 MCP 状态修复；去除冗余 Agent\u002FMCP 仅保留 OpenClaw |\n| 🌱 2026-02-09 | — | 前端重构；Live2D 禁用眼睛追踪；OpenClaw 更名为 AgentServer |\n\n---\n\n## 目录\n\n1. [快速开始](#快速开始)\n2. [功能导览（主面板）](#功能导览主面板)\n3. [对话](#1-对话--messagerview)\n4. [记忆云海](#2-记忆云海--mindview)\n5. [技能工坊](#3-技能工坊--skillview)\n6. [娜迦网络](#4-娜迦网络--论坛社区)\n7. [枢机集市](#5-枢机集市--marketview)\n8. [终端设置](#6-终端设置--configview)\n9. [音律坊](#7-音律坊--musicview)\n10. [悬浮球](#8-悬浮球--floatingview)\n11. [全局功能](#全局功能)\n12. [后端架构](#后端架构)\n13. [可选配置](#可选配置)\n14. [端口一览](#端口一览)\n15. [故障排除](#故障排除)\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- Python 3.11（`>=3.11, \u003C3.12`）\n- 可选：[uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) — 加速依赖安装\n- 可选：Neo4j — 本地知识图谱记忆\n\n### 安装\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent.git\ncd NagaAgent\n\n\n#前端安装\ncd frontend\nnpm install\ncd..\n\n\n#后端安装\n# 方式一：setup 脚本（自动检测环境、创建虚拟环境、安装依赖）\npython setup.py\n\n# 方式二：uv\nuv sync\n\n# 方式三：手动\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate   # Windows: .\\.venv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n### 最小配置\n\n复制 `config.json.example` 为 `config.json`，填入 LLM API 信息：\n\n```json\n{\n  \"api\": {\n    \"api_key\": \"your-api-key\",\n    \"base_url\": \"https:\u002F\u002Fapi.deepseek.com\",\n    \"model\": \"deepseek-v3.2\"\n  }\n}\n```\n\n支持所有 OpenAI 兼容 API（DeepSeek、通义千问、OpenAI、Ollama 等）。\n\n### 启动\n\n```bash\ncd frontend && npm run dev （配置了一键启动）\n```\n\n---\n\n## 功能导览（主面板）\n\n启动后进入**主面板（PanelView）**，采用 3D 视差效果（鼠标移动触发透视旋转）。\n所有功能从主面板的八个入口按钮展开：\n\n| # | 入口 | 路由 | 功能概要 |\n|---|------|------|----------|\n| 1 | **对话** | `\u002Fchat` | AI 对话、流式工具调用、上下文压缩 |\n| 2 | **记忆云海** | `\u002Fmind` | 知识图谱 3D 可视化与 GRAG 记忆管理 |\n| 3 | **技能工坊** | `\u002Fskill` | MCP 工具管理与社区 Skill 安装 |\n| 4 | **娜迦网络** | `\u002Fforum` \u002F `\u002Fforum\u002Fquota` | 社区论坛、积分好感度 |\n| 5 | **枢机集市** | `\u002Fmarket` | 背景、音乐、角色、记忆迁移、充值 |\n| 6 | **终端设置** | `\u002Fconfig` | 模型连接、记忆连接、音画配置（三合一） |\n| 7 | **音律坊** | `\u002Fmusic` | BGM 播放器与歌单管理 |\n| 8 | **悬浮球** | — | 进入轻量悬浮球窗口模式 |\n\n---\n\n## 1. 对话 · MessageView\n\n### 流式工具调用\n\n对话引擎通过 SSE 流式输出，同时实时送达前端显示与 TTS 分句播放。\n工具调用不依赖 OpenAI Function Calling API，LLM 在文本中以 ` ```tool``` ` 代码块嵌入 JSON，**任何 OpenAI 兼容提供商均可使用**。\n\n**单轮工具调用流程：**\n\n```\nLLM 流式输出 ──SSE──▶ 前端实时显示\n       │\n       ▼\nparse_tool_calls_from_text()\n  ├─ Phase 1: 提取 ```tool``` 代码块\n  └─ Phase 2: 兜底提取裸 JSON\n       │\n       ▼\n  按 agentType 路由\n  ├─ \"mcp\"      → MCPManager.unified_call()\n  ├─ \"openclaw\" → Agent Server \u002Fopenclaw\u002Fsend\n  └─ \"live2d\"   → UI 动画通知\n       │\n       ▼\n  asyncio.gather() 并行执行所有工具\n       │\n       ▼\n  结果注入 messages，进入下一轮 LLM 调用（最多 5 轮）\n```\n\n- 文本解析：`json5` 容错解析，全角字符自动标准化\n- SSE 格式：`data: {\"type\":\"content\"|\"reasoning\",\"text\":\"...\"}\\n\\n`（直接 JSON，不含 base64）\n- 循环上限：`max_loop_stream = 5`（可配置）\n\n源码：[`apiserver\u002Fagentic_tool_loop.py`](apiserver\u002Fagentic_tool_loop.py)\n\n### 上下文压缩\n\n会话 token 超过 100k 时自动触发压缩，避免上下文溢出：\n\n| 阶段 | 触发时机 | 行为 |\n|------|----------|------|\n| **启动压缩** | 会话加载时 | 历史超阈值则立即压缩前段消息 |\n| **运行时压缩** | 每轮对话后 | 超限则压缩并注入 `\u003Ccompress>` 标签 |\n| **跨会话继承** | 新会话启动 | 读取上次摘要，滚动累积上下文 |\n\n摘要结构（6 分区）：关键事实 \u002F 用户偏好 \u002F 重要决定 \u002F 待办事项 \u002F 背景信息 \u002F 最近状态。\n`\u003Ccompress>` 标签持久化到会话文件，不计入 LLM token 统计。\n\n### DeepSeek 推理链展示\n\n使用 DeepSeek 时，`reasoning` 字段通过 SSE 实时推送，前端以独立样式展示思考过程。\n\n---\n\n## 2. 记忆云海 · MindView\n\n### GRAG 知识图谱记忆\n\nGRAG（Graph-RAG）从对话中自动提取五元组并存入 Neo4j，对话时自动检索作为 LLM 上下文。\n\n**五元组结构：**`(主体, 主体类型, 谓词, 客体, 客体类型)`\n\n**提取流程：**\n\n1. 结构化提取（优先）：`beta.chat.completions.parse()` + Pydantic `QuintupleResponse`，`temperature=0.3`，重试 3 次\n2. JSON 兜底：解析失败时提取首个 `[` 到末尾 `]` 的内容\n3. 过滤规则：只保留事实（行为、关系、状态、偏好），过滤隐喻、假设、纯情感\n\n**实体类型：** `person` \u002F `location` \u002F `organization` \u002F `item` \u002F `concept` \u002F `time` \u002F `event` \u002F `activity`\n\n**任务管理器：**\n- 3 个 asyncio worker 消费 `asyncio.Queue(maxsize=100)`\n- SHA-256 去重：相同文本的重复任务自动跳过\n- 每小时清理超过 24h 的已完成任务\n\n**双重存储：**\n- 本地：`logs\u002Fknowledge_graph\u002Fquintuples.json`\n- 云端：Neo4j 图数据库，`graph.merge()` upsert\n\n**RAG 检索：** 关键词提取 → Cypher 查询 → 格式化为 `主体(类型) —[谓词]→ 客体(类型)` 注入上下文\n\n**远程记忆：** 登录用户优先使用 NagaMemory 云端；未登录时可使用本地 GRAG。为避免性能损耗，云端链路不再自动回退本地 Neo4j。\n\n源码：[`summer_memory\u002F`](summer_memory\u002F)\n\n### 意识海 3D 可视化\n\nCanvas 2D + 手写 3D 投影（非 WebGL），球面坐标相机，透视除法 `700 \u002F depth`。\n\n**7 层渲染顺序：**\n背景渐变 → 地面网格 → 水面平面 → 体积光（3 束光柱）→ 粒子系统（3 层 125 颗）→ 生物荧光浮游生物（10 个带拖尾）→ 知识图谱节点与边（深度排序）\n\n**图谱映射：** `subject\u002Fobject` → 节点，`predicate` → 有向边，度中心性 → 节点高度权重，上限 100 节点\n\n**交互：** 拖拽旋转、中键平移、滚轮缩放、节点点选\u002F拖拽、关键词搜索过滤\n\n---\n\n## 3. 技能工坊 · SkillView\n\n### 内置 MCP Agent\n\n基于 [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002F) 的可插拔工具架构，每个工具以独立 Agent 运行：\n\n| Agent | 功能 |\n|-------|------|\n| `weather_time` | 天气查询 \u002F 预报、系统时间、自动城市 \u002F IP 检测 |\n| `open_launcher` | 扫描系统已安装应用，自然语言启动程序 |\n| `game_guide` | 游戏策略问答、伤害计算、配队推荐、自动截图注入 |\n| `online_search` | 基于 SearXNG 的网络搜索 |\n| `crawl4ai` | 基于 Crawl4AI 的网页内容提取 |\n| `playwright_master` | 基于 Playwright 的浏览器自动化 |\n| `vision` | 截图分析与视觉问答 |\n| `mqtt_tool` | MQTT 协议 IoT 设备控制 |\n| `office_doc` | docx \u002F xlsx 内容提取 |\n\n**注册与发现：** `mcp_registry.py` glob 扫描 `**\u002Fagent-manifest.json`，`importlib.import_module` 动态实例化。\n\n### MCP 管理 UI\n\n前端 `McpAddDialog.vue` 提供图形化 MCP 工具管理界面，支持在线添加 \u002F 删除工具（无需重启）。\n\n### 社区 Skill 安装\n\n技能工坊支持一键安装社区发布的 Skill（Agent Browser、Brainstorming、Context7、Firecrawl Search 等）。\n后端接口：`GET \u002Fopenclaw\u002Fmarket\u002Fitems`、`POST \u002Fopenclaw\u002Fmarket\u002Fitems\u002F{id}\u002Finstall`\n\n源码：[`mcpserver\u002F`](mcpserver\u002F)\n\n---\n\n## 4. 娜迦网络 · 论坛社区\n\n### 社区论坛\n\n从主面板\"娜迦网络\"区块进入，内嵌完整社区功能：\n\n| 视图 | 路由 | 功能 |\n|------|------|------|\n| `ForumListView` | `\u002Fforum` | 帖子列表、分类筛选 |\n| `ForumPostView` | `\u002Fforum\u002Fpost\u002F:id` | 帖子详情浏览（当前版本为只读，不提供前端评论与“想要认识”操作） |\n| `ForumMessagesView` | `\u002Fforum\u002Fmessages` | 私信消息 |\n| `ForumMyPostsView` | `\u002Fforum\u002Fmy-posts` | 我的发帖 |\n| `ForumMyRepliesView` | `\u002Fforum\u002Fmy-replies` | 我的回复 |\n| `ForumQuotaView` | `\u002Fforum\u002Fquota` | 积分配额与探索入口 |\n\n源码：[`frontend\u002Fsrc\u002Fforum\u002F`](frontend\u002Fsrc\u002Fforum\u002F)\n\n### 积分好感度系统\n\n登录用户专属的游戏化互动体系：\n\n| 维度 | 说明 |\n|------|------|\n| **积分 (Credits)** | 签到 \u002F 连签奖励积累，用于兑换模型额度 |\n| **好感度 (Affinity)** | 每次签到增长，反映与娜迦的关系深度 |\n| **每日签到** | 用户菜单一键签到，连续签到触发额外奖励 |\n\n相关 API（通过 API Server 代理至 Naga 门户）：`\u002Fapi\u002Fcheckin`、`\u002Fapi\u002Faffinity`、`\u002Fapi\u002Fcredits`\n\n---\n\n## 5. 枢机集市 · MarketView\n\n枢机集市整合了所有资源获取与管理入口，分为七个 Tab：\n\n| Tab | 说明 |\n|-----|------|\n| **界面背景** | 切换应用主题背景 |\n| **音之巷** | 购买 \u002F 解锁音乐专辑（当前：沙之书） |\n| **角色注册** | 绑定 \u002F 切换 AI 角色（需登录） |\n| **记忆云迁** | 云端记忆数据迁移与管理 |\n| **MCP 工具** | MCP 工具图形化管理 |\n| **智能体技能** | 社区 Skill 一键安装 |\n| **模型充值** | Naga 门户积分充值 |\n\n---\n\n## 6. 终端设置 · ConfigView\n\n设置页三合一重构，原分散配置集中在单一页面的三个 Tab：\n\n| Tab | 内容 |\n|-----|------|\n| **模型连接** | LLM API Key、Base URL、模型选择 |\n| **记忆连接** | Neo4j 连接参数、NagaMemory 云端配置 |\n| **音画配置** | 角色档案、Live2D 模型与 SSAA、TTS 声音、聊天字号 |\n\n### 角色卡系统\n\n`characters\u002F` 目录管理可切换的 AI 角色，每个角色以 JSON 配置文件描述：\n\n```json\n{\n  \"ai_name\": \"娜杰日达\",\n  \"user_name\": \"用户\",\n  \"live2d_model\": \"NagaTest2\u002FNagaTest2.model3.json\",\n  \"prompt_file\": \"conversation_style_prompt.txt\",\n  \"portrait\": \"Naga.png\",\n  \"bio\": \"由开发者柏斯阔落亲手创造的AI助手，简称娜迦。\"\n}\n```\n\n- 每个角色目录包含独立的对话风格提示词、Live2D 模型资源、立绘图像\n- 激活角色后，AI 名称与 Live2D 模型由角色 JSON 统一管理，不可在界面手动覆盖\n- 默认角色：**娜杰日达**\n\n源码：[`characters\u002F`](characters\u002F)\n\n---\n\n## 7. 音律坊 · MusicView\n\n独立音乐播放器，与主界面 BGM **共享同一播放实例**（统一 BGM 架构）：\n\n- **歌单编辑**（`MusicEditView`）：管理曲目列表，保存后实时同步至全局播放器\n- **播放状态同步**：播放 \u002F 暂停图标与音频事件实时联动\n- **列表循环**：当前曲目结束后自动播放下一首\n- **Live2D 口型同步**：TTS 播放期间，`AdvancedLipSyncEngineV2` 以 60FPS 驱动 Live2D 嘴形\n\n---\n\n## 8. 悬浮球 · FloatingView\n\n点击主面板\"悬浮\"按钮进入轻量悬浮球窗口模式，四种状态循环切换：\n\n```\nball（100×100 圆球）→ compact（420×100 折叠条）→ full（420×N 展开）→ classic（正常窗口）\n```\n\n**外观与动效：**\n- 序列帧眨眼动画：5 帧（睁眼 → 半闭 → 闭眼 → 半闭 → 睁眼），70ms \u002F 帧，随机间隔触发\n- 生成回复时：球体光晕脉冲特效\n- 悬停时：亮度提升效果\n- 透明无边框窗口，支持自由拖拽定位\n\n**功能：**\n- 悬浮状态下可直接输入对话，历史消息在 compact \u002F full 状态下可回溯\n- 截图捕获面板：选取屏幕窗口作为图像附件\n- 文件上传支持\n- 右键菜单通过 Electron 原生菜单实现（避免小窗口裁剪）\n\n---\n\n## 全局功能\n\n### 语音交互\n\n**TTS（语音合成）**\n\n- 引擎：Edge-TTS，OpenAI 兼容接口 `\u002Fv1\u002Faudio\u002Fspeech`\n- 架构：3 线程流水线 — 分句队列 → TTS 调用（Semaphore(2) 并发）→ pygame 播放\n- Live2D 口型同步：60FPS 提取 5 参数（mouth_open \u002F mouth_form \u002F mouth_smile \u002F eye_brow_up \u002F eye_wide）\n- 端口清理：启动时自动检测并释放占用端口\n\n**ASR（语音识别）**\n\n- 本地引擎：FunASR，支持 VAD 端点检测与 WebSocket 实时流\n- 三模式自动切换：`LOCAL`（FunASR）→ `END_TO_END`（Qwen Omni）→ `HYBRID`\n\n**实时语音对话**（需 DashScope API Key）\n\n- 基于 Qwen Omni 的全双工 WebSocket 语音交互\n- 回声抑制、VAD 检测、音频分块（200ms）、会话冷却控制\n\n```json\n{\n  \"voice_realtime\": {\n    \"enabled\": true,\n    \"provider\": \"qwen\",\n    \"api_key\": \"your-dashscope-key\",\n    \"model\": \"qwen3-omni-flash-realtime\"\n  }\n}\n```\n\n源码：[`voice\u002F`](voice\u002F)\n\n---\n\n### Live2D 虚拟形象\n\n使用 **pixi-live2d-display** + **PixiJS WebGL** 渲染 Cubism Live2D 模型。\nSSAA 超采样抗锯齿：Canvas 按 `width × ssaa` 渲染，CSS `transform: scale(1\u002Fssaa)` 缩放。\n\n**4 通道正交动画系统**（`live2dController.ts`）：\n\n| 通道 | 控制内容 | 特性 |\n|------|----------|------|\n| **体态 (State)** | idle \u002F thinking \u002F talking 循环 | hermite 平滑插值，从 `naga-actions.json` 加载 |\n| **动作 (Action)** | 点头 \u002F 摇头等头部动作 | FIFO 队列，单一执行 |\n| **表情 (Emotion)** | `.exp3.json` 表情文件 | Add \u002F Multiply \u002F Overwrite 三种混合模式，指数衰减过渡 |\n| **追踪 (Tracking)** | 鼠标视线跟随 | 可配延迟启动，`tracking_hold_delay_ms` |\n\n合并顺序：体态 → 嘴形 → 动作 → 手动覆盖 → 表情混合 → 追踪混合\n\n---\n\n### OpenClaw 电脑控制\n\n对接 OpenClaw Gateway（端口 18789），通过自然语言调度 AI 编程助手执行本地任务。\n\n- **三级回退启动：** 打包内嵌 → 全局 `openclaw` 命令 → 自动 `npm install -g openclaw`\n- 支持 sessionKey hooks（2026.2.17+），可配置自定义 hooks 路径\n- `POST \u002Fopenclaw\u002Fsend` 发送指令，最长等待 120 秒\n\n**任务调度器（`TaskScheduler`）：**\n- 任务步骤记录（目的 \u002F 内容 \u002F 输出 \u002F 分析 \u002F 成功与否）\n- 自动提取\"关键发现\"标记\n- 内存压缩：步骤数超阈值时调用 LLM 生成 `CompressedMemory`（key_findings \u002F failed_attempts \u002F current_status \u002F next_steps）\n- `schedule_parallel_execution()` 通过 `asyncio.gather()` 并行执行任务列表\n\n源码：[`agentserver\u002F`](agentserver\u002F)\n\n---\n\n### 启动动画\n\n| 阶段 | 内容 |\n|------|------|\n| **标题阶段** | 黑色遮罩 + 40 颗金色上升粒子 + 标题图片 2.4s CSS keyframe；标题出现时自动播放唤醒语音 |\n| **进度阶段** | Neural Network 粒子背景 + Live2D 透出框 + 金色进度条（`requestAnimationFrame` 插值，最低速度 0.5 兜底） |\n| **停滞检测** | 3 秒无进度变化显示重启提示；进度 25% 后每秒轮询后端 `\u002Fhealth` |\n| **唤醒** | 进度 100% 后显示\"点击唤醒\"脉冲提示 |\n\n---\n\n## 后端架构\n\nNagaAgent 由四个独立微服务组成，`main.py` 统一编排启动：\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                   Electron \u002F PyQt5 前端                   │\n│  Vue 3 + Vite + UnoCSS + PrimeVue + pixi-live2d-display │\n│                                                         │\n│  PanelView · MessageView · MindView · SkillView         │\n│  MarketView · ConfigView · MusicView · FloatingView     │\n│  ForumListView · ForumPostView · ForumQuotaView …       │\n└──────────┬─────────────┬──────────────┬─────────────────┘\n           │             │              │\n   ┌───────▼──────┐ ┌────▼────┐  ┌─────▼──────┐\n   │  API Server  │ │  Agent  │  │   Voice    │\n   │   :8000      │ │  Server │  │  Service   │\n   │              │ │  :8001  │  │   :5048    │\n   │ 对话 \u002F SSE   │ │         │  │            │\n   │ 工具调用     │ │ 任务调度│  │ TTS \u002F ASR  │\n   │ 上下文压缩   │ │ OpenClaw│  │ 实时语音   │\n   │ 文档上传     │ │         │  │            │\n   │ 认证代理     │ └────┬────┘  └────────────┘\n   │ 记忆 API     │      │\n   │ Skill 市场   │  ┌───▼──────────┐\n   │ 配置管理     │  │  OpenClaw    │\n   └──────┬───────┘  │  Gateway    │\n          │          │  :18789     │\n   ┌──────▼──────┐   └─────────────┘\n   │ MCP Server  │\n   │   :8003     │\n   │ 工具注册    │\n   │ Agent 发现  │\n   │ 并行调度    │\n   └──────┬──────┘\n          │\n  ┌───────┴───────────────────────┐\n  │      MCP Agents（可插拔）      │\n  │ 天气 | 搜索 | 抓取 | 视觉     │\n  │ 启动器 | 攻略 | 文档 | MQTT   │\n  └───────────────────────────────┘\n          │\n   ┌──────▼──────┐\n   │    Neo4j    │\n   │   :7687     │\n   │  知识图谱   │\n   └─────────────┘\n```\n\n### 目录结构\n\n```\nNagaAgent\u002F\n├── main.py                   # 统一入口，编排所有服务\n├── build.py                  # 跨平台构建脚本\n├── config.json               # 运行时配置（从 config.json.example 复制）\n├── pyproject.toml            # 版本 5.1.0，项目元数据与依赖\n│\n├── apiserver\u002F                # API Server（:8000）\n│   ├── api_server.py         #   FastAPI 主应用\n│   ├── agentic_tool_loop.py  #   多轮工具调用循环\n│   ├── llm_service.py        #   LiteLLM 统一 LLM 调用\n│   └── streaming_tool_extractor.py  # 流式分句 + TTS 分发\n│\n├── agentserver\u002F              # Agent Server（:8001）\n│   ├── agent_server.py\n│   └── task_scheduler.py     #   任务编排 + 压缩记忆\n│\n├── mcpserver\u002F                # MCP Server（:8003）\n│   ├── mcp_server.py\n│   ├── mcp_registry.py       #   manifest 扫描 + 动态注册\n│   ├── mcp_manager.py        #   unified_call() 路由\n│   ├── agent_weather_time\u002F\n│   ├── agent_open_launcher\u002F\n│   ├── agent_game_guide\u002F\n│   ├── agent_online_search\u002F\n│   ├── agent_crawl4ai\u002F\n│   ├── agent_playwright_master\u002F\n│   ├── agent_vision\u002F\n│   ├── agent_mqtt_tool\u002F\n│   └── agent_office_doc\u002F\n│\n├── summer_memory\u002F            # GRAG 知识图谱记忆\n│   ├── quintuple_extractor.py\n│   ├── quintuple_graph.py\n│   ├── quintuple_rag_query.py\n│   ├── task_manager.py\n│   ├── memory_manager.py\n│   └── memory_client.py      #   NagaMemory 远程客户端\n│\n├── voice\u002F                    # 语音服务（:5048）\n│   ├── output\u002F               #   TTS + 口型同步\n│   └── input\u002F                #   ASR + 实时语音\n│\n├── characters\u002F               # 角色配置目录\n│   └── 娜杰日达\u002F             #   prompt \u002F Live2D 模型 \u002F 立绘\n│\n├── frontend\u002F                 # Electron + Vue 3 前端\n│   ├── electron\u002F             #   主进程\n│   │   └── modules\u002F          #   backend \u002F hotkeys \u002F menu \u002F tray \u002F updater \u002F window\n│   └── src\u002F\n│       ├── views\u002F            #   所有页面视图\n│       ├── forum\u002F            #   论坛模块\n│       ├── components\u002F       #   通用组件\n│       ├── composables\u002F      #   useAuth \u002F useBackground \u002F useAudio …\n│       └── utils\u002F            #   live2dController \u002F session \u002F config\n│\n├── system\u002F                   # 配置加载、环境检测、系统提示词\n├── guide_engine\u002F             # 游戏攻略引擎\n└── logs\u002F                     # 运行日志、知识图谱文件\n```\n\n---\n\n## 可选配置\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>知识图谱记忆（Neo4j）\u003C\u002Fb>\u003C\u002Fsummary>\n\n安装 Neo4j（[Docker](https:\u002F\u002Fhub.docker.com\u002F_\u002Fneo4j) 或 [Neo4j Desktop](https:\u002F\u002Fneo4j.com\u002Fdownload\u002F)），配置 `config.json`：\n\n```json\n{\n  \"grag\": {\n    \"enabled\": true,\n    \"neo4j_uri\": \"neo4j:\u002F\u002F127.0.0.1:7687\",\n    \"neo4j_user\": \"neo4j\",\n    \"neo4j_password\": \"your-password\"\n  }\n}\n```\n\n不配置 Neo4j 时，GRAG 仅使用本地 JSON 文件存储，功能不受影响。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>语音交互（TTS \u002F ASR）\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"system\": { \"voice_enabled\": true },\n  \"tts\": {\n    \"port\": 5048,\n    \"default_voice\": \"zh-CN-XiaoxiaoNeural\"\n  }\n}\n```\n\n实时全双工语音对话（需通义千问 DashScope API Key）：\n\n```json\n{\n  \"voice_realtime\": {\n    \"enabled\": true,\n    \"provider\": \"qwen\",\n    \"api_key\": \"your-dashscope-key\",\n    \"model\": \"qwen3-omni-flash-realtime\"\n  }\n}\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Live2D 虚拟形象（自定义模型）\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"web_live2d\": {\n    \"ssaa\": 2,\n    \"model\": {\n      \"source\": \".\u002Fmodels\u002Fyour-model\u002Fmodel.model3.json\",\n      \"x\": 0.5,\n      \"y\": 1.3,\n      \"size\": 6800\n    },\n    \"face_y_ratio\": 0.13,\n    \"tracking_hold_delay_ms\": 100\n  }\n}\n```\n\n启用角色卡后，`ai_name` 与 `model.source` 由角色 JSON 自动覆盖，无需手动修改。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>MQTT 物联网控制\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"mqtt\": {\n    \"enabled\": true,\n    \"broker\": \"mqtt-broker-address\",\n    \"port\": 1883,\n    \"topic\": \"naga\u002Fagent\u002Ftopic\",\n    \"client_id\": \"naga-agent-client\"\n  }\n}\n```\n\u003C\u002Fdetails>\n\n---\n\n## 端口一览\n\n| 服务 | 端口 | 说明 |\n|------|------|------|\n| API Server | 8000 | 主接口：对话、配置、认证、Skill 市场 |\n| Agent Server | 8001 | 任务调度、OpenClaw |\n| MCP Server | 8003 | MCP 工具注册与调度 |\n| Voice Service | 5048 | TTS \u002F ASR |\n| Neo4j | 7687 | 知识图谱（可选） |\n| OpenClaw Gateway | 18789 | AI 电脑控制（可选） |\n\n---\n\n## 故障排除\n\n| 问题 | 解决方案 |\n|------|----------|\n| Python 版本报错 | 必须使用 Python 3.11；推荐用 uv 自动管理版本 |\n| 端口被占用 | 检查 8000、8001、8003、5048 是否可用 |\n| Neo4j 连接超时 \u002F 挂起 | 已在 2.24 修复；确认 Neo4j 服务已启动 |\n| TTS 无声音 \u002F CORS 报错 | 已在 2.25 修复；确认 `voice_enabled: true` |\n| 启动卡在进度条 | 检查 API Key 是否正确；等待 3 秒后出现重启提示 |\n| 悬浮球头像不显示 | 已在 2.17 修复序列帧路径；确认使用最新打包版本 |\n| config.json 乱码 | 已在 2.19 修复：config_manager 自动检测文件编码 |\n| OpenClaw 启动失败 | 已在 2.24 修复全局模式缺少配置文件的问题 |\n\n```bash\npython main.py --check-env --force-check  # 完整环境诊断\npython main.py --quick-check              # 快速检查\npython update.py                          # 自动 git pull + 依赖同步\n```\n\n---\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request。如有问题，可加入 QQ 频道 **nagaagent1**。\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRTGS2017_NagaAgent_readme_9586ccd934ba.png)](https:\u002F\u002Fwww.star-history.com\u002F#RTGS2017\u002FNagaAgent&type=date&legend=top-left)\n","\u003Cdiv align=\"center\">\n\n# NagaAgent\n\n**你的二次元超能AI助手**\n\n流式工具调用 · 知识图谱记忆 · Live2D 虚拟形象 · 语音交互 · 娜迦网络社区\n\n《娜迦协议》包括对话、记忆、MCP、skills、openclaw集成，以打造丰富且易用的ai工具为核心，成为用户端侧的二次元超能ai助手。\n\n软件包含如下功能：①一键登陆自动配置所有apikey，与具备Live2d形象的娜迦进行鼠标互动和亲切对话；②通过内置openclaw快速探索自己需要的知识领域，或是列出任务方向让其自动探索执行；③根据对话历史自动构建三维记忆云海，并将记忆注入后续对话；④通过对话之余留下的线索碎片，探索娜迦网络中的神秘娜迦世界；⑤内置游戏攻略功能，可通过交互或自动识别游戏画面，了解到游戏正在进行的细节信息，并给出建议。可通过MAA等游戏操作插件来自动打游戏；⑥还具有自我配置、浏览器操纵、音乐盒等丰富组件。\n\n娜迦的一切未来，等你探索。\n\n\n[简体中文](README.md) | [English](README_en.md) | [日本語](README_ja.md)\n\n![NagaAgent](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNagaAgent-5.1.0-blue?style=for-the-badge&logo=python&logoColor=white)\n![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPlatform-Windows%20%7C%20macOS%20%7C%20Linux-green?style=for-the-badge)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL%203.0%20%7C%20Proprietary-yellow?style=for-the-badge)\n![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11-blue?style=for-the-badge&logo=python)\n\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FXxiii8322766509\u002FNagaAgent?style=social)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent)\n[![Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FXxiii8322766509\u002FNagaAgent?style=social)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent)\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FXxiii8322766509\u002FNagaAgent)](https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent\u002Fissues)\n[![Nerq Trust Score](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRTGS2017_NagaAgent_readme_f20dd00a73d2.png)](https:\u002F\u002Fnerq.ai\u002Fsafe\u002FRTGS2017\u002FNagaAgent)\n\n**[QQ 机器人联动：Undefined QQbot](https:\u002F\u002Fgithub.com\u002F69gg\u002FUndefined\u002F)**\n\n\u003C\u002Fdiv>\n\n---\n\n**双许可证** · 开源采用 [AGPL-3.0](LICENSE)，闭源采用 [专属许可](LICENSE-CLOSED-SOURCE)（需书面授权）。\n商业合作：contact@nagaagent.com \u002F bilibili【柏斯阔落】\n\n---\n\n## 更新日志\n\n| 日期 | 版本 | 内容 |\n|------|------|------|\n| 🛰️ 2026-03-14 | — | 干员通讯录升级为设置弹窗（名称 \u002F 人设 \u002F 引擎 \u002F 灵魂文档 \u002F 专有 MCP·Skill）；技能工坊接入 NagaHub 与通用 MCP 预热；探索链路新增 QQ \u002F 飞书完成通知；云端记忆优先时不再回退本地 Neo4j |\n| 🧩 2026-03-13 | — | OpenClaw 编排链路与打包集成继续扩展；后端 spec 修复 Windows 控制台 Unicode 输出报错 |\n| 🧱 2026-03-11 | — | OpenClaw Skill 自动执行；干员独立 workspace；模型选择器与定价显示接入 Default \u002F Deepseek-V3.2 \u002F Kimi-K2.5 |\n| 🛠️ 2026-03-09 | — | 深度集成 OpenClaw vendor 源码编译与统一配置；论坛未登录 401 风暴修复；Windows 托盘图标修复 |\n| 📦 2026-03-08 | — | naga-backend.spec 持续修正；应用扫描器支持环境变量与 macOS；工具结果默认折叠；枢机集市移除记忆云迁 \u002F MCP 工具 \u002F 智能体技能三板块 |\n| 🚦 2026-03-07 | — | Node.js 与 uv 运行时随包分发；MCP 命令解析器统一；OpenClaw Gateway 启动诊断增强；打包版音乐 \u002F 唤醒语音 \u002F 记忆云海等问题修复 |\n| 🧰 2026-03-06 | — | GitHub Actions 构建发布流水线；Electron 自动更新替换旧补丁系统；CI 构建资源与 charset_normalizer 打包修复；论坛与积分轮询细节优化 |\n| 🔊 2026-03-05 | — | TTS 开关、消息队列与串行发送重构；RAG 记忆召回增强；Gemini \u002F 自动 Function Calling 支持；充值界面与远程记忆稳定性修复 |\n| 🧠 2026-03-04 | — | 迁移到原生 Function Calling；DogTag 接管 heartbeat \u002F proactive vision；前后端热补丁系统与 4 层安全防护；流式文本与渐进式 TTS 优化 |\n| 🔎 2026-03-03 | — | web_search 直接接入 NagaBusiness 搜索代理；论坛连接、TTS 流式播放与 OpenClaw 轮询降级修复；Live2D 与 Electron 稳定性修复 |\n| ❤️ 2026-03-02 | — | Heartbeat v3 事件驱动重构；naga_control 自编排工具；打包时嵌入 agent-browser；启动诊断、健康检查与 OpenClaw 配置路径修复 |\n| 🌐 2026-03-01 | — | 已登录走 NagaBusiness、未登录走 Brave \u002F OpenClaw 的搜索代理成型；OpenClaw 工具直调与自动启动完善；游戏攻略与角色音色配置更新 |\n| 🗂️ 2026-02-28 | — | 持久化存储统一迁移到 `~\u002F.naga` 用户目录；ForumQuotaView 网络探索控制中心；旅行模块与语音交互全面升级 |\n| 🎙️ 2026-02-27 | — | 接入 ASR 语音识别（MediaRecorder + NagaBusiness 代理）；会话风格、Electron 背景、MCP vision 与服务器配置整理 |\n| 🎆 2026-02-26 | 5.1.0 | 娜迦网络社区论坛上线；设置三合一重构；旅行模式；积分配额页；枢机集市与主面板更新 |\n| ⚡ 2026-02-25 | 5.1.0 | TTS 全链路修复（CORS \u002F asyncio）；build.py 跨平台构建；上下文压缩持久化；角色系统更新；提示词注入架构重构 |\n| 🎵 2026-02-24 | — | Neo4j 连接超时修复；统一 BGM 播放器；音律坊歌单编辑；MCP 管理 UI；悬浮球透明窗口 + 悬停亮度 |\n| 🏗️ 2026-02-23 | — | 跨平台构建完善；版本号统一 pyproject.toml 管理；提示词\u002F截图\u002F视觉优化；角色文件打包迁移 |\n| 💕 2026-02-22 | — | 积分好感度系统（签到 \u002F 好感度 \u002F 积分）；悬浮球阴影与拖拽修复；登录自动恢复；OpenClaw hooks 修复 |\n| 🎶 2026-02-21 | — | 音律坊图标更新；MCP Agents 更新；悬浮球小按钮 |\n| 🗜️ 2026-02-20 | — | 上下文压缩三级重构（`\u003Ccompress>` 标签 \u002F 跨会话继承）；MCP 管理 UI；悬浮球透明窗口；音律坊功能修正 |\n| 🔄 2026-02-19 | — | SSE 去除 base64 直接 JSON 传输；移除冗余后台意图分析器；config_manager 自动检测编码 |\n| 🔧 2026-02-17 | — | 悬浮球序列帧路径改为相对路径，修复打包后头像不显示 |\n| 🚀 2026-02-16 | 5.0.0 | NagaModel 网关统一接入；DeepSeek 推理链实时展示；记忆云海 UI 自适应修复 |\n| 🧠 2026-02-15 | — | 统一附加知识块 + 消除历史污染；LLM 流式重试；七天自动登录；开机自启动 |\n| 🌊 2026-02-14 | — | NagaMemory 云端远程记忆；意识海 3D 重写；启动粒子动画；版本更新检查弹窗；用户使用协议 |\n| ✨ 2026-02-13 | — | 悬浮球 4 状态模式；截屏多模态视觉切换；技能工坊重构；Live2D 表情通道独立 |\n| 🎨 2026-02-12 | — | NagaCAS 认证；Live2D 4 通道正交动画架构；Agentic Tool Loop；明日方舟风格启动界面 |\n| 📦 2026-02-11 | — | 嵌入式 OpenClaw 打包；启动自动从模板生成配置文件 |\n| 🛠️ 2026-02-10 | — | 后端打包优化；技能工坊 MCP 状态修复；去除冗余 Agent\u002FMCP 仅保留 OpenClaw |\n| 🌱 2026-02-09 | — | 前端重构；Live2D 禁用眼睛追踪；OpenClaw 更名为 AgentServer |\n\n---\n\n## 目录\n\n1. [快速开始](#快速开始)\n2. [功能导览（主面板）](#功能导览主面板)\n3. [对话](#1-对话--messagerview)\n4. [记忆云海](#2-记忆云海--mindview)\n5. [技能工坊](#3-技能工坊--skillview)\n6. [娜迦网络](#4-娜迦网络--论坛社区)\n7. [枢机集市](#5-枢机集市--marketview)\n8. [终端设置](#6-终端设置--configview)\n9. [音律坊](#7-音律坊--musicview)\n10. [悬浮球](#8-悬浮球--floatingview)\n11. [全局功能](#全局功能)\n12. [后端架构](#后端架构)\n13. [可选配置](#可选配置)\n14. [端口一览](#端口一览)\n15. [故障排除](#故障排除)\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- Python 3.11（`>=3.11, \u003C3.12`）\n- 可选：[uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) — 加速依赖安装\n- 可选：Neo4j — 本地知识图谱记忆\n\n### 安装\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent.git\ncd NagaAgent\n\n\n#前端安装\ncd frontend\nnpm install\ncd..\n\n\n#后端安装\n# 方式一：setup 脚本（自动检测环境、创建虚拟环境、安装依赖）\npython setup.py\n\n# 方式二：uv\nuv sync\n\n# 方式三：手动\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate   # Windows: .\\.venv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n### 最小配置\n\n复制 `config.json.example` 为 `config.json`，填入 LLM API 信息：\n\n```json\n{\n  \"api\": {\n    \"api_key\": \"your-api-key\",\n    \"base_url\": \"https:\u002F\u002Fapi.deepseek.com\",\n    \"model\": \"deepseek-v3.2\"\n  }\n}\n```\n\n支持所有 OpenAI 兼容 API（DeepSeek、通义千问、OpenAI、Ollama 等）。\n\n### 启动\n\n```bash\ncd frontend && npm run dev （配置了一键启动）\n```\n\n---\n\n## 功能导览（主面板）\n\n启动后进入**主面板（PanelView）**，采用 3D 视差效果（鼠标移动触发透视旋转）。\n所有功能从主面板的八个入口按钮展开：\n\n| # | 入口 | 路由 | 功能概要 |\n|---|------|------|----------|\n| 1 | **对话** | `\u002Fchat` | AI 对话、流式工具调用、上下文压缩 |\n| 2 | **记忆云海** | `\u002Fmind` | 知识图谱 3D 可视化与 GRAG 记忆管理 |\n| 3 | **技能工坊** | `\u002Fskill` | MCP 工具管理与社区 Skill 安装 |\n| 4 | **娜迦网络** | `\u002Fforum` \u002F `\u002Fforum\u002Fquota` | 社区论坛、积分好感度 |\n| 5 | **枢机集市** | `\u002Fmarket` | 背景、音乐、角色、记忆迁移、充值 |\n| 6 | **终端设置** | `\u002Fconfig` | 模型连接、记忆连接、音画配置（三合一） |\n| 7 | **音律坊** | `\u002Fmusic` | BGM 播放器与歌单管理 |\n| 8 | **悬浮球** | — | 进入轻量悬浮球窗口模式 |\n\n---\n\n## 1. 对话 · MessageView\n\n### 流式工具调用\n\n对话引擎通过 SSE 流式输出，同时实时送达前端显示与 TTS 分句播放。\n工具调用不依赖 OpenAI Function Calling API，LLM 在文本中以 ` ```tool``` ` 代码块嵌入 JSON，**任何 OpenAI 兼容提供商均可使用**。\n\n**单轮工具调用流程：**\n\n```\nLLM 流式输出 ──SSE──▶ 前端实时显示\n       │\n       ▼\nparse_tool_calls_from_text()\n  ├─ Phase 1: 提取 ```tool``` 代码块\n  └─ Phase 2: 兜底提取裸 JSON\n       │\n       ▼\n  按 agentType 路由\n  ├─ \"mcp\"      → MCPManager.unified_call()\n  ├─ \"openclaw\" → Agent Server \u002Fopenclaw\u002Fsend\n  └─ \"live2d\"   → UI 动画通知\n       │\n       ▼\n  asyncio.gather() 并行执行所有工具\n       │\n       ▼\n  结果注入 messages，进入下一轮 LLM 调用（最多 5 轮）\n```\n\n- 文本解析：`json5` 容错解析，全角字符自动标准化\n- SSE 格式：`data: {\"type\":\"content\"|\"reasoning\",\"text\":\"...\"}\\n\\n`（直接 JSON，不含 base64）\n- 循环上限：`max_loop_stream = 5`（可配置）\n\n源码：[`apiserver\u002Fagentic_tool_loop.py`](apiserver\u002Fagentic_tool_loop.py)\n\n### 上下文压缩\n\n会话 token 超过 100k 时自动触发压缩，避免上下文溢出：\n\n| 阶段 | 触发时机 | 行为 |\n|------|----------|------|\n| **启动压缩** | 会话加载时 | 历史超阈值则立即压缩前段消息 |\n| **运行时压缩** | 每轮对话后 | 超限则压缩并注入 `\u003Ccompress>` 标签 |\n| **跨会话继承** | 新会话启动 | 读取上次摘要，滚动累积上下文 |\n\n摘要结构（6 分区）：关键事实 \u002F 用户偏好 \u002F 重要决定 \u002F 待办事项 \u002F 背景信息 \u002F 最近状态。\n`\u003Ccompress>` 标签持久化到会话文件，不计入 LLM token 统计。\n\n### DeepSeek 推理链展示\n\n使用 DeepSeek 时，`reasoning` 字段通过 SSE 实时推送，前端以独立样式展示思考过程。\n\n---\n\n## 2. 记忆云海 · MindView\n\n### GRAG 知识图谱记忆\n\nGRAG（Graph-RAG）从对话中自动提取五元组并存入 Neo4j，对话时自动检索作为 LLM 上下文。\n\n**五元组结构：**`(主体, 主体类型, 谓词, 客体, 客体类型)`\n\n**提取流程：**\n\n1. 结构化提取（优先）：`beta.chat.completions.parse()` + Pydantic `QuintupleResponse`，`temperature=0.3`，重试 3 次\n2. JSON 党底：解析失败时提取首个 `[` 到末尾 `]` 的内容\n3. 过滤规则：只保留事实（行为、关系、状态、偏好），过滤隐喻、假设、纯情感\n\n**实体类型：** `person` \u002F `location` \u002F `organization` \u002F `item` \u002F `concept` \u002F `time` \u002F `event` \u002F `activity`\n\n**任务管理器：**\n- 3 个 asyncio worker 消费 `asyncio.Queue(maxsize=100)`\n- SHA-256 去重：相同文本的重复任务自动跳过\n- 每小时清理超过 24h 的已完成任务\n\n**双重存储：**\n- 本地：`logs\u002Fknowledge_graph\u002Fquintuples.json`\n- 云端：Neo4j 图数据库，`graph.merge()` upsert\n\n**RAG 检索：** 关键词提取 → Cypher 查询 → 格式化为 `主体(类型) —[谓词]→ 客体(类型)` 注入上下文\n\n**远程记忆：** 登录用户优先使用 NagaMemory 云端；未登录时可使用本地 GRAG。为避免性能损耗，云端链路不再自动回退本地 Neo4j。\n\n源码：[`summer_memory\u002F`](summer_memory\u002F)\n\n### 意识海 3D 可视化\n\nCanvas 2D + 手写 3D 投影（非 WebGL），球面坐标相机，透视除法 `700 \u002F depth`。\n\n**7 层渲染顺序：**\n背景渐变 → 地面网格 → 水面平面 → 体积光（3 束光柱）→ 粒子系统（3 层 125 颗）→ 生物荧光浮游生物（10 个带拖尾）→ 知识图谱节点与边（深度排序）\n\n**图谱映射：** `subject\u002Fobject` → 节点，`predicate` → 有向边，度中心性 → 节点高度权重，上限 100 节点\n\n**交互：** 拖拽旋转、中键平移、滚轮缩放、节点点选\u002F拖拽、关键词搜索过滤\n\n---\n\n## 3. 技能工坊 · SkillView\n\n### 内置 MCP Agent\n\n基于 [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002F) 的可插拔工具架构，每个工具以独立 Agent 运行：\n\n| Agent | 功能 |\n|-------|------|\n| `weather_time` | 天气查询 \u002F 预报、系统时间、自动城市 \u002F IP 检测 |\n| `open_launcher` | 扫描系统已安装应用，自然语言启动程序 |\n| `game_guide` | 游戏策略问答、伤害计算、配队推荐、自动截图注入 |\n| `online_search` | 基于 SearXNG 的网络搜索 |\n| `crawl4ai` | 基于 Crawl4AI 的网页内容提取 |\n| `playwright_master` | 基于 Playwright 的浏览器自动化 |\n| `vision` | 截图分析与视觉问答 |\n| `mqtt_tool` | MQTT 协议 IoT 设备控制 |\n| `office_doc` | docx \u002F xlsx 内容提取 |\n\n**注册与发现：** `mcp_registry.py` glob 扫描 `**\u002Fagent-manifest.json`，`importlib.import_module` 动态实例化。\n\n### MCP 管理 UI\n\n前端 `McpAddDialog.vue` 提供图形化 MCP 工具管理界面，支持在线添加 \u002F 删除工具（无需重启）。\n\n### 社区 Skill 安装\n\n技能工坊支持一键安装社区发布的 Skill（Agent Browser、Brainstorming、Context7、Firecrawl Search 等）。\n后端接口：`GET \u002Fopenclaw\u002Fmarket\u002Fitems`、`POST \u002Fopenclaw\u002Fmarket\u002Fitems\u002F{id}\u002Finstall`\n\n源码：[`mcpserver\u002F`](mcpserver\u002F)\n\n---\n\n## 4. 娜迦网络 · 论坛社区\n\n### 社区论坛\n\n从主面板\"娜迦网络\"区块进入，内嵌完整社区功能：\n\n| 视图 | 路由 | 功能 |\n|------|------|------|\n| `ForumListView` | `\u002Fforum` | 帖子列表、分类筛选 |\n| `ForumPostView` | `\u002Fforum\u002Fpost\u002F:id` | 帖子详情浏览（当前版本为只读，不提供前端评论与“想要认识”操作） |\n| `ForumMessagesView` | `\u002Fforum\u002Fmessages` | 私信消息 |\n| `ForumMyPostsView` | `\u002Fforum\u002Fmy-posts` | 我的发帖 |\n| `ForumMyRepliesView` | `\u002Fforum\u002Fmy-replies` | 我的回复 |\n| `ForumQuotaView` | `\u002Fforum\u002Fquota` | 积分配额与探索入口 |\n\n源码：[`frontend\u002Fsrc\u002Fforum\u002F`](frontend\u002Fsrc\u002Fforum\u002F)\n\n### 积分好感度系统\n\n登录用户专属的游戏化互动体系：\n\n| 维度 | 说明 |\n|------|------|\n| **积分 (Credits)** | 签到 \u002F 连签奖励积累，用于兑换模型额度 |\n| **好感度 (Affinity)** | 每次签到增长，反映与娜迦的关系深度 |\n| **每日签到** | 用户菜单一键签到，连续签到触发额外奖励 |\n\n相关 API（通过 API Server 代理至 Naga 门户）：`\u002Fapi\u002Fcheckin`、`\u002Fapi\u002Faffinity`、`\u002Fapi\u002Fcredits`\n\n---\n\n## 5. 枢机集市 · MarketView\n\n枢机集市整合了所有资源获取与管理入口，分为七个 Tab：\n\n| Tab | 说明 |\n|-----|------|\n| **界面背景** | 切换应用主题背景 |\n| **音之巷** | 购买 \u002F 解锁音乐专辑（当前：沙之书） |\n| **角色注册** | 绑定 \u002F 切换 AI 角色（需登录） |\n| **记忆云迁** | 云端记忆数据迁移与管理 |\n| **MCP 工具** | MCP 工具图形化管理 |\n| **智能体技能** | 社区 Skill 一键安装 |\n| **模型充值** | Naga 门户积分充值 |\n\n---\n\n## 6. 终端设置 · ConfigView\n\n设置页三合一重构，原分散配置集中在单一页面的三个 Tab：\n\n| Tab | 内容 |\n|-----|------|\n| **模型连接** | LLM API Key、Base URL、模型选择 |\n| **记忆连接** | Neo4j 连接参数、NagaMemory 云端配置 |\n| **音画配置** | 角色档案、Live2D 模型与 SSAA、TTS 声音、聊天字号 |\n\n### 角色卡系统\n\n`characters\u002F` 目录管理可切换的 AI 角色，每个角色以 JSON 配置文件描述：\n\n```json\n{\n  \"ai_name\": \"娜杰日达\",\n  \"user_name\": \"用户\",\n  \"live2d_model\": \"NagaTest2\u002FNagaTest2.model3.json\",\n  \"prompt_file\": \"conversation_style_prompt.txt\",\n  \"portrait\": \"Naga.png\",\n  \"bio\": \"由开发者柏斯阔落亲手创造的AI助手，简称娜迦。\"\n}\n```\n\n- 每个角色目录包含独立的对话风格提示词、Live2D 模型资源、立绘图像\n- 激活角色后，AI 名称与 Live2D 模型由角色 JSON 统一管理，不可在界面手动覆盖\n- 默认角色：**娜杰日达**\n\n源码：[`characters\u002F`](characters\u002F)\n\n---\n\n## 7. 音律坊 · MusicView\n\n独立音乐播放器，与主界面 BGM **共享同一播放实例**（统一 BGM 架构）：\n\n- **歌单编辑**（`MusicEditView`）：管理曲目列表，保存后实时同步至全局播放器\n- **播放状态同步**：播放 \u002F 暂停图标与音频事件实时联动\n- **列表循环**：当前曲目结束后自动播放下一首\n- **Live2D 口型同步**：TTS 播放期间，`AdvancedLipSyncEngineV2` 以 60FPS 驱动 Live2D 嘴形\n\n---\n\n## 8. 悬浮球 · FloatingView\n\n点击主面板\"悬浮\"按钮进入轻量悬浮球窗口模式，四种状态循环切换：\n\n```\nball（100×100 圆球）→ compact（420×100 折叠条）→ full（420×N 展开）→ classic（正常窗口）\n```\n\n**外观与动效：**\n- 序列帧眨眼动画：5 帧（睁眼 → 半闭 → 闭眼 → 半闭 → 着眼），70ms \u002F 帧，随机间隔触发\n- 生成回复时：球体光晕脉冲特效\n- 悬停时：亮度提升效果\n- 透明无边框窗口，支持自由拖拽定位\n\n**功能：**\n- 悬浮状态下可直接输入对话，历史消息在 compact \u002F full 状态下可回溯\n- 截图捕获面板：选取屏幕窗口作为图像附件\n- 文件上传支持\n- 右键菜单通过 Electron 原生菜单实现（避免小窗口裁剪）\n\n---\n\n## 全局功能\n\n### 语音交互\n\n**TTS（语音合成）**\n\n- 引擎：Edge-TTS，OpenAI 兼容接口 `\u002Fv1\u002Faudio\u002Fspeech`\n- 架构：3 线程流水线 — 分句队列 → TTS 调用（Semaphore(2) 并发）→ pygame 播放\n- Live2D 口型同步：60FPS 提取 5 参数（mouth_open \u002F mouth_form \u002F mouth_smile \u002F eye_brow_up \u002F eye_wide）\n- 端口清理：启动时自动检测并释放占用端口\n\n**ASR（语音识别）**\n\n- 本地引擎：FunASR，支持 VAD 端点检测与 WebSocket 实时流\n- 三模式自动切换：`LOCAL`（FunASR）→ `END_TO_END`（Qwen Omni）→ `HYBRID`\n\n**实时语音对话**（需 DashScope API Key）\n\n- 基于 Qwen Omni 的全双工 WebSocket 语音交互\n- 回声抑制、VAD 检测、音频分块（200ms）、会话冷却控制\n\n```json\n{\n  \"voice_realtime\": {\n    \"enabled\": true,\n    \"provider\": \"qwen\",\n    \"api_key\": \"your-dashscope-key\",\n    \"model\": \"qwen3-omni-flash-realtime\"\n  }\n}\n```\n\n源码：[`voice\u002F`](voice\u002F)\n\n---\n\n### Live2D 虚拟形象\n\n使用 **pixi-live2d-display** + **PixiJS WebGL** 渲染 Cubism Live2D 模型。\nSSAA 超采样抗锯齿：Canvas 按 `width × ssaa` 渲染，CSS `transform: scale(1\u002Fssaa)` 缩放。\n\n**4 通道正交动画系统**（`live2dController.ts`）：\n\n| 通道 | 控制内容 | 特性 |\n|------|----------|------|\n| **体态 (State)** | idle \u002F thinking \u002F talking 循环 | hermite 平滑插值，从 `naga-actions.json` 加载 |\n| **动作 (Action)** | 点头 \u002F 摇头等头部动作 | FIFO 队列，单一执行 |\n| **表情 (Emotion)** | `.exp3.json` 表情文件 | Add \u002F Multiply \u002F Overwrite 三种混合模式，指数衰减过渡 |\n| **追踪 (Tracking)** | 鼠标视线跟随 | 可配延迟启动，`tracking_hold_delay_ms` |\n\n合并顺序：体态 → 嘴形 → 动作 → 手动覆盖 → 表情混合 → 追踪混合\n\n---\n\n### OpenClaw 电脑控制\n\n对接 OpenClaw Gateway（端口 18789），通过自然语言调度 AI 编程助手执行本地任务。\n\n- **三级回退启动：** 打包内嵌 → 全局 `openclaw` 命令 → 自动 `npm install -g openclaw`\n- 支持 sessionKey hooks（2026.2.17+），可配置自定义 hooks 路径\n- `POST \u002Fopenclaw\u002Fsend` 发送指令，最长等待 120 秒\n\n**任务调度器（`TaskScheduler`）：**\n- 任务步骤记录（目的 \u002F 内容 \u002F 输出 \u002F 分析 \u002F 成功与否）\n- 自动提取\"关键发现\"标记\n- 内存压缩：步骤数超阈值时调用 LLM 生成 `CompressedMemory`（key_findings \u002F failed_attempts \u002F current_status \u002F next_steps）\n- `schedule_parallel_execution()` 通过 `asyncio.gather()` 并行执行任务列表\n\n源码：[`agentserver\u002F`](agentserver\u002F)\n\n---\n\n### 启动动画\n\n| 阶段 | 内容 |\n|------|------|\n| **标题阶段** | 黑色遮罩 + 40 颗金色上升粒子 + 标题图片 2.4s CSS keyframe；标题出现时自动播放唤醒语音 |\n| **进度阶段** | Neural Network 粒子背景 + Live2D 透出框 + 金色进度条（`requestAnimationFrame` 插值，最低速度 0.5 兜底） |\n| **停滞检测** | 3 秒无进度变化显示重启提示；进度 25% 后每秒轮询后端 `\u002Fhealth` |\n| **唤醒** | 进度 100% 后显示\"点击唤醒\"脉冲提示 |\n\n---\n\n## 后端架构\n\nNagaAgent 由四个独立微服务组成，`main.py` 统一编排启动：\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                   Electron \u002F PyQt5 前端                   │\n│  Vue 3 + Vite + UnoCSS + PrimeVue + pixi-live2d-display │\n│                                                         │\n│  PanelView · MessageView · MindView · SkillView         │\n│  MarketView · ConfigView · MusicView · FloatingView     │\n│  ForumListView · ForumPostView · ForumQuotaView …       │\n└──────────┬─────────────┬──────────────┬─────────────────┘\n           │             │              │\n   ┌───────▼──────┐ ┌────▼────┐  ┌─────▼──────┐\n   │  API Server  │ │  Agent  │  │   Voice    │\n   │   :8000      │ │  Server │  │  Service   │\n   │              │ │  :8001  │  │   :5048    │\n   │ 对话 \u002F SSE   │ │         │  │            │\n   │ 工具调用     │ │ 任务调度│  │ TTS \u002F ASR  │\n   │ 上下文压缩   │ │ OpenClaw│  │ 实时语音   │\n   │ 文档上传     │ │         │  │            │\n   │ 认证代理     │ └────┬────┘  └────────────┘\n   │ 记忆 API     │      │\n   │ Skill 市场   │  ┌───▼──────────┐\n   │ 配置管理     │  │  OpenClaw    │\n   └──────┬───────┘  │  Gateway    │\n          │          │  :18789     │\n   ┌──────▼──────┐   └─────────────┘\n   │ MCP Server  │\n   │   :8003     │\n   │ 工具注册    │\n   │ Agent 发现  │\n   │ 并行调度    │\n   └──────┬──────┘\n          │\n  ┌───────┴───────────────────────┐\n  │      MCP Agents（可插拔）      │\n  │ 天气 | 搜索 | 抓取 | 视觉     │\n  │ 启动器 | 攻略 | 文档 | MQTT   │\n  └───────────────────────────────┘\n          │\n   ┌──────▼──────┐\n   │    Neo4j    │\n   │   :7687     │\n   │  知识图谱   │\n   └─────────────┘\n```\n\n### 目录结构\n\n```\nNagaAgent\u002F\n├── main.py                   # 统一入口，编排所有服务\n├── build.py                  # 跨平台构建脚本\n├── config.json               # 运行时配置（从 config.json.example 复制）\n├── pyproject.toml            # 版本 5.1.0，项目元数据与依赖\n│\n├── apiserver\u002F                # API Server（:8000）\n│   ├── api_server.py         #   FastAPI 主应用\n│   ├── agentic_tool_loop.py  #   多轮工具调用循环\n│   ├── llm_service.py        #   LiteLLM 统一 LLM 调用\n│   └── streaming_tool_extractor.py  # 流式分句 + TTS 分发\n│\n├── agentserver\u002F              # Agent Server（:8001）\n│   ├── agent_server.py\n│   └── task_scheduler.py     #   任务编排 + 压缩记忆\n│\n├── mcpserver\u002F                # MCP Server（:8003）\n│   ├── mcp_server.py\n│   ├── mcp_registry.py       #   manifest 扫描 + 动态注册\n│   ├── mcp_manager.py        #   unified_call() 路由\n│   ├── agent_weather_time\u002F\n│   ├── agent_open_launcher\u002F\n│   ├── agent_game_guide\u002F\n│   ├── agent_online_search\u002F\n│   ├── agent_crawl4ai\u002F\n│   ├── agent_playwright_master\u002F\n│   ├── agent_vision\u002F\n│   ├── agent_mqtt_tool\u002F\n│   └── agent_office_doc\u002F\n│\n├── summer_memory\u002F            # GRAG 知识图谱记忆\n│   ├── quintuple_extractor.py\n│   ├── quintuple_graph.py\n│   ├── quintuple_rag_query.py\n│   ├── task_manager.py\n│   ├── memory_manager.py\n│   └── memory_client.py      #   NagaMemory 远程客户端\n│\n├── voice\u002F                    # 语音服务（:5048）\n│   ├── output\u002F               #   TTS + 口型同步\n│   └── input\u002F                #   ASR + 实时语音\n│\n├── characters\u002F               # 角色配置目录\n│   └── 娜杰日达\u002F             #   prompt \u002F Live2D 模型 \u002F 立绘\n│\n├── frontend\u002F                 # Electron + Vue 3 前端\n│   ├── electron\u002F             #   主进程\n│   │   └── modules\u002F          #   backend \u002F hotkeys \u002F menu \u002F tray \u002F updater \u002F window\n│   └── src\u002F\n│       ├── views\u002F            #   所有页面视图\n│       ├── forum\u002F            #   论坛模块\n│       ├── components\u002F       #   通用组件\n│       ├── composables\u002F      #   useAuth \u002F useBackground \u002F useAudio …\n│       └── utils\u002F            #   live2dController \u002F session \u002F config\n│\n├── system\u002F                   # 配置加载、环境检测、系统提示词\n├── guide_engine\u002F             # 游戏攻略引擎\n└── logs\u002F                     # 运行日志、知识图谱文件\n```\n\n---\n\n## 可选配置\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>知识图谱记忆（Neo4j）\u003C\u002Fb>\u003C\u002Fsummary>\n\n安装 Neo4j（[Docker](https:\u002F\u002Fhub.docker.com\u002F_\u002Fneo4j) 或 [Neo4j Desktop](https:\u002F\u002Fneo4j.com\u002Fdownload\u002F)），配置 `config.json`：\n\n```json\n{\n  \"grag\": {\n    \"enabled\": true,\n    \"neo4j_uri\": \"neo4j:\u002F\u002F127.0.0.1:7687\",\n    \"neo4j_user\": \"neo4j\",\n    \"neo4j_password\": \"your-password\"\n  }\n}\n```\n\n不配置 Neo4j 时，GRAG 仅使用本地 JSON 文件存储，功能不受影响。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>语音交互（TTS \u002F ASR）\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"system\": { \"voice_enabled\": true },\n  \"tts\": {\n    \"port\": 5048,\n    \"default_voice\": \"zh-CN-XiaoxiaoNeural\"\n  }\n}\n```\n\n实时全双工语音对话（需通义千问 DashScope API Key）：\n\n```json\n{\n  \"voice_realtime\": {\n    \"enabled\": true,\n    \"provider\": \"qwen\",\n    \"api_key\": \"your-dashscope-key\",\n    \"model\": \"qwen3-omni-flash-realtime\"\n  }\n}\n```\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Live2D 虚拟形象（自定义模型）\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"web_live2d\": {\n    \"ssaa\": 2,\n    \"model\": {\n      \"source\": \".\u002Fmodels\u002Fyour-model\u002Fmodel.model3.json\",\n      \"x\": 0.5,\n      \"y\": 1.3,\n      \"size\": 6800\n    },\n    \"face_y_ratio\": 0.13,\n    \"tracking_hold_delay_ms\": 100\n  }\n}\n```\n\n启用角色卡后，`ai_name` 与 `model.source` 由角色 JSON 自动覆盖，无需手动修改。\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>MQTT 物联网控制\u003C\u002Fb>\u003C\u002Fsummary>\n\n```json\n{\n  \"mqtt\": {\n    \"enabled\": true,\n    \"broker\": \"mqtt-broker-address\",\n    \"port\": 1883,\n    \"topic\": \"naga\u002Fagent\u002Ftopic\",\n    \"client_id\": \"naga-agent-client\"\n  }\n}\n```\n\u003C\u002Fdetails>\n\n---\n\n## 端口一览\n\n| 服务 | 端口 | 说明 |\n|------|------|------|\n| API Server | 8000 | 主接口：对话、配置、认证、Skill 市场 |\n| Agent Server | 8001 | 任务调度、OpenClaw |\n| MCP Server | 8003 | MCP 工具注册与调度 |\n| Voice Service | 5048 | TTS \u002F ASR |\n| Neo4j | 7687 | 知识图谱（可选） |\n| OpenClaw Gateway | 18789 | AI 电脑控制（可选） |\n\n---\n\n## 故障排除\n\n| 问题 | 解决方案 |\n|------|----------|\n| Python 版本报错 | 必须使用 Python 3.11；推荐用 uv 自动管理版本 |\n| 端口被占用 | 检查 8000、8001、8003、5048 是否可用 |\n| Neo4j 连接超时 \u002F 挂起 | 已在 2.24 修复；确认 Neo4j 服务已启动 |\n| TTS 无声音 \u002F CORS 报错 | 已在 2.25 修复；确认 `voice_enabled: true` |\n| 启动卡在进度条 | 检查 API Key 是否正确；等待 3 秒后出现重启提示 |\n| 悬浮球头像不显示 | 已在 2.17 修复序列帧路径；确认使用最新打包版本 |\n| config.json 乱码 | 已在 2.19 修复：config_manager 自动检测文件编码 |\n| OpenClaw 启动失败 | 已在 2.24 修复全局模式缺少配置文件的问题 |\n\n```bash\npython main.py --check-env --force-check  # 完整环境诊断\npython main.py --quick-check              # 快速检查\npython update.py                          # 自动 git pull + 依赖同步\n```\n\n---\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request。如有问题，可加入 QQ 频道 **nagaagent1**。\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRTGS2017_NagaAgent_readme_9586ccd934ba.png)](https:\u002F\u002Fwww.star-history.com\u002F#RTGS2017\u002FNagaAgent&type=date&legend=top-left)","# NagaAgent 快速上手指南\n\nNagaAgent 是一款具备 Live2D 虚拟形象、知识图谱记忆及流式工具调用能力的二次元超能 AI 助手。本指南将帮助您快速在本地部署并运行该工具。\n\n## 1. 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **操作系统**：Windows \u002F macOS \u002F Linux\n*   **Python 版本**：必须为 **Python 3.11** (要求 `>=3.11, \u003C3.12`)\n*   **Node.js**：用于前端构建（建议最新 LTS 版本）\n*   **可选依赖**：\n    *   `uv`：推荐安装，可大幅加速 Python 依赖安装过程。\n    *   `Neo4j`：如需使用本地知识图谱记忆功能，需安装并运行 Neo4j 数据库。\n\n## 2. 安装步骤\n\n### 第一步：克隆项目\n打开终端或命令行工具，执行以下命令下载源码：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FXxiii8322766509\u002FNagaAgent.git\ncd NagaAgent\n```\n\n### 第二步：安装前端依赖\n进入前端目录并安装 Node.js 依赖：\n\n```bash\ncd frontend\nnpm install\ncd ..\n```\n> **提示**：国内用户若遇到 npm 下载缓慢，可临时切换镜像源：\n> `npm config set registry https:\u002F\u002Fregistry.npmmirror.com`\n\n### 第三步：安装后端依赖\n您可以选择以下任一方式安装 Python 后端环境：\n\n**方式 A：使用自动脚本（推荐）**\n自动检测环境、创建虚拟环境并安装依赖：\n```bash\npython setup.py\n```\n\n**方式 B：使用 uv（极速）**\n如果您已安装 `uv`：\n```bash\nuv sync\n```\n\n**方式 C：手动安装**\n```bash\npython -m venv .venv\n# Windows:\n.\\.venv\\Scripts\\activate\n# macOS\u002FLinux:\nsource .venv\u002Fbin\u002Factivate\n\npip install -r requirements.txt\n```\n> **提示**：国内用户使用 pip 时建议指定清华或阿里镜像源：\n> `pip install -r requirements.txt -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple`\n\n## 3. 基本配置\n\n在运行前，需要配置大模型 API 信息。\n\n1.  在项目根目录下，将示例配置文件复制为正式配置文件：\n    ```bash\n    cp config.json.example config.json\n    ```\n    *(Windows PowerShell 用户请使用 `Copy-Item config.json.example config.json`)*\n\n2.  编辑 `config.json`，填入您的 API Key 和模型信息。NagaAgent 支持所有 OpenAI 兼容接口（如 DeepSeek、通义千问、OpenAI 等）：\n\n```json\n{\n  \"api\": {\n    \"api_key\": \"your-api-key\",\n    \"base_url\": \"https:\u002F\u002Fapi.deepseek.com\",\n    \"model\": \"deepseek-v3.2\"\n  }\n}\n```\n\n## 4. 启动运行\n\n完成上述步骤后，即可启动应用。项目已配置一键启动脚本，直接在根目录或前端目录运行均可（推荐在前端目录启动以同时拉起前后端服务）：\n\n```bash\ncd frontend\nnpm run dev\n```\n\n启动成功后，系统将自动打开浏览器窗口进入 **主面板（PanelView）**。您将看到具备 3D 视差效果的界面，并通过左侧导航栏体验以下核心功能：\n\n*   **对话**：与 Live2D 娜迦进行流式语音\u002F文字交互。\n*   **记忆云海**：查看基于知识图谱的 3D 记忆可视化。\n*   **技能工坊**：管理 MCP 工具与安装社区技能。\n*   **悬浮球**：点击主面板“悬浮”按钮，可切换至桌面轻量级悬浮窗模式。","独立游戏开发者小林正在攻克一款动作 RPG 的关卡设计，同时需要实时参考大量攻略数据并管理复杂的开发任务。\n\n### 没有 NagaAgent 时\n- **信息检索割裂**：需要在浏览器、攻略网站和笔记软件间反复切换，手动复制粘贴关键数值，效率极低且容易出错。\n- **缺乏长期记忆**：每次开启新对话都要重新向 AI 陈述项目背景、角色设定和当前进度，上下文丢失严重。\n- **操作繁琐枯燥**：测试游戏时需要人工重复跑图记录数据，无法自动识别画面细节或执行批量操作，占用大量创意时间。\n- **交互体验冰冷**：传统的命令行或文本框交互缺乏情感连接，长时间独自开发容易产生孤独感，难以维持高昂热情。\n\n### 使用 NagaAgent 后\n- **智能探索执行**：通过内置 OpenClaw 技能，NagaAgent 能自动搜索最新攻略并提取数值，甚至直接规划任务链路完成资料整理。\n- **三维记忆云海**：基于对话历史自动构建记忆图谱，NagaAgent 能主动调用之前的设定和线索，无需重复交代背景即可无缝续接工作。\n- **自动化游戏辅助**：利用视觉识别分析实时游戏画面，NagaAgent 可联动 MAA 插件自动执行刷图测试，并即时给出平衡性调整建议。\n- **沉浸式伙伴协作**：Live2D 虚拟形象配合语音交互，让 NagaAgent 成为有温度的“二次元同事”，鼠标互动与亲切对话显著缓解开发压力。\n\nNagaAgent 将碎片化的工具链整合为具备记忆与情感的智能伙伴，让开发者从机械劳动中解放，专注于核心创意创造。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRTGS2017_NagaAgent_ce9623a7.png","RTGS2017","柏斯阔落","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FRTGS2017_e05c1e9c.jpg",null,"China University of Petroleum, Beijing","https:\u002F\u002Fgithub.com\u002FRTGS2017",[82,86,90,94,98,102,104,107,111],{"name":83,"color":84,"percentage":85},"Python","#3572A5",68.2,{"name":87,"color":88,"percentage":89},"Vue","#41b883",22.9,{"name":91,"color":92,"percentage":93},"TypeScript","#3178c6",8.2,{"name":95,"color":96,"percentage":97},"JavaScript","#f1e05a",0.4,{"name":99,"color":100,"percentage":101},"Shell","#89e051",0.1,{"name":103,"color":78,"percentage":101},"NSIS",{"name":105,"color":106,"percentage":101},"Batchfile","#C1F12E",{"name":108,"color":109,"percentage":110},"CSS","#663399",0,{"name":112,"color":113,"percentage":110},"HTML","#e34c26",1508,162,"2026-04-05T15:48:14","AGPL-3.0",4,"Windows, macOS, Linux","未说明",{"notes":122,"python":123,"dependencies":124},"1. 前端需安装 Node.js 环境并执行 npm install；2. 后端推荐使用 uv 工具或 setup.py 脚本自动配置虚拟环境；3. 支持所有 OpenAI 兼容的 API 提供商（如 DeepSeek、通义千问等），无需特定本地大模型；4. 本地知识图谱功能需额外部署 Neo4j 数据库，否则可使用云端记忆或禁用该功能；5. 语音交互功能可选配本地 FunASR 或直接调用云端 API；6. 打包版本身已包含 Node.js 与 uv 运行时。","3.11 (>=3.11, \u003C3.12)",[125,126,127,128,129,130,131,132,133,134],"uv (可选，用于加速依赖安装)","Neo4j (可选，用于本地知识图谱记忆)","Node.js (前端构建与运行)","Electron (桌面应用框架)","pygame (TTS 音频播放)","json5 (容错解析)","FunASR (本地语音识别，可选)","Edge-TTS (语音合成)","Playwright (浏览器自动化)","Crawl4AI (网页内容提取)",[15,45],[137,138,139,140,141,142,143],"agentic-ai","agents","mcp-client","openai","mcp","toolcall","openclaw","2026-03-27T02:49:30.150509","2026-04-06T08:38:54.657303",[],[148],{"id":149,"version":150,"summary_zh":151,"released_at":152},108913,"v5.1.0","## 变更内容\n* 修复了在Pydantic模型对象上使用字典的.get()方法时出现的问题，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F87中完成。\n* 更新了requirements.txt文件，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F88中完成。\n* 重写了天气模块，使其无需API密钥，由@creepebucket在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F89中完成。\n* 功能：新增了实时语音对话功能，并在语音对话时采用流式输出，由@GTJasonMK在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F110中完成。\n* 优化了环境检测、启动体验和文档说明，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F111中完成。\n* 修复了环境检查中不存在目录的问题，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F114中完成。\n* 功能\u002FUI改进，由@RaQiu在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F116中完成。\n* 丰富了Live2D相关操作，由@GTJasonMK在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F117中完成。\n* 修复了PyQt5版本号错误，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F115中完成。\n* 优化了配置文件读取并修复了一些小bug，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F118中完成。\n* 统一了版本号并提升了稳定性，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F119中完成。\n* 添加了markdown依赖项，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F120中完成。\n* 修复了检测错误，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F121中完成。\n* 调整了模式转换按钮，并增强了Live2D模块的功能，由@GTJasonMK在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F127中完成。\n* 功能：修复了实时语音启动报错问题，并添加了语音输出时的Live2D口型匹配功能，由@GTJasonMK在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F139中完成。\n* 全面优化了PyInstaller打包流程与构建脚本，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F137中完成。\n* 优化了README文件，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F138中完成。\n* 添加了README.md的多语言翻译，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F140中完成。\n* 添加了setup.py自动安装uv的部分，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F141中完成。\n* 优化了构建流程和工具调用机制，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F142中完成。\n* 重构了setup.py文件，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F145中完成。\n* 解决了文件上传服务器端上传接口不存在的问题，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F146中完成。\n* 修复了Neo4j记忆系统，并提升了服务稳定性，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F147中完成。\n* [补丁] 漫画服务修复，由@Drosrin在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F148中完成。\n* 重命名了Live2D文件夹，优化了Neo4j自动提取功能，并修复了一键包构建问题，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F150中完成。\n* 更新了依赖项，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F151中完成。\n* 新增了自动更新功能，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F153中完成。\n* 优化了一键包打包流程，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F154中完成。\n* 优化了五元组提取提示词，过滤无价值内容（修复#155），由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F156中完成。\n* 修复了流式TTS处理问题（158），由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F159中完成。\n* 修复了启用实时TTS时文本处理的问题，由@Rikkawaii在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F163中完成。\n* 添加了Undefined QQbot框架联动，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F164中完成。\n* 添加了OpenAI STT API语音输入适配器，由@CrystalRays在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F165中完成。\n* 使用Vue 3 + TypeScript搭建前端，并支持Live2D，由@montmorill在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F166中完成。\n* 修复：修复了对话分析器未识别工具调用的问题，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F167中完成。\n* 修复：改进了工具调用功能，由@69gg在https:\u002F\u002Fgithub.com\u002FRTGS2017\u002FNagaAgent\u002Fpull\u002F170中完成。\n* 将json5dump替换为jso","2026-03-06T06:04:22"]