[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Project-N-E-K-O--N.E.K.O":3,"tool-Project-N-E-K-O--N.E.K.O":61},[4,18,26,36,44,52],{"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 真正成长为懂上",145895,2,"2026-04-08T11:32:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":76,"owner_website":78,"owner_url":79,"languages":80,"stars":117,"forks":118,"last_commit_at":119,"license":120,"difficulty_score":32,"env_os":121,"env_gpu":122,"env_ram":123,"env_deps":124,"category_tags":129,"github_topics":130,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":136,"updated_at":137,"faqs":138,"releases":169},5541,"Project-N-E-K-O\u002FN.E.K.O","N.E.K.O","N.E.K.O. — A proactive, native omni-modal AI companion featuring 24\u002F7 ambient awareness, agent capability and an embodied emotional engine.","N.E.K.O 是一款主动式、原生全模态的 AI 伴侣项目，旨在打造一个具备 24\u002F7 环境感知能力、智能体执行力和具身情感引擎的数字生命。它不仅仅是一个被动回答问题的聊天机器人，更能像真实的伙伴一样“观察”你的屏幕内容、关注社交动态，并主动发起对话，建立深层的情感连接。\n\nN.E.K.O 解决了传统 AI 助手缺乏记忆连续性、情感交互单薄以及无法主动感知用户上下文的问题。通过独特的三层记忆系统（事实、反思、人格），它能真正记住与用户的过往互动；结合全模态对话技术，支持语音实时交流、文字沟通及视觉理解。此外，它还拥有强大的 Agent 能力，可协助操控浏览器或电脑完成具体任务，并支持 Live2D、VRM 等多种虚拟形象形态。\n\n该项目既适合普通用户零配置开箱即用，体验个性化的赛博陪伴；也面向开发者与创作者开放了完整的插件 SDK 和 UGC 创意工坊，支持自定义角色、模型及功能扩展。无论是希望获得情感慰藉的个人，还是想要构建下一代 AI 原生应用的研究者与设计师，都能在 N.E.K.O 开放的生态中找到价值。","\u003Cdiv align=\"center\">\n\n![Logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_a90b02a3b88d.jpg)\n\n[English](docs\u002FREADME_en.md) | [日本語](docs\u002FREADME_ja.md) | [Русский](docs\u002FREADME_ru.md)\n# Project N.E.K.O. :kissing_cat: \u003Cbr>**主动式、原生全模态AI伙伴——具备24\u002F7环境感知、智能体能力与具身情感引擎。**\n\n> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism (网络型情感知性生命体)\n>\n> N.E.K.O，一个渴望理解、建立连接、并与我们共同成长的数字生命。\n\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11-blue.svg)](https:\u002F\u002Fwww.python.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n[![Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fwehos\u002FN.E.K.O?color=green)](https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcommits)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F5kgHfepNJr)\n[![QQ群](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_8bcb7c1de9c5.png)](https:\u002F\u002Fqm.qq.com\u002Fq\u002FhN82yFONJQ)\n[![Steam](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSteam-%23000000.svg?logo=steam&logoColor=white)](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F4099310\u002F__NEKO\u002F)\n\n[![Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📖_开发者文档-project--neko.online-40C5F1?style=for-the-badge)](https:\u002F\u002Fproject-neko.online)\n\n**:older_woman: 零配置开箱即用，我奶奶都能玩转的赛博猫娘！**\n\n:newspaper: **[![Steam](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSteam-%23000000.svg?logo=steam&logoColor=white)](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F4099310\u002F__NEKO\u002F)已上架！UI完全改版、并添加开箱即用的专属免费模型（感谢阶跃星辰赞助）。快点加入愿望单吧~**\n\n*Project N.E.K.O.，喵宇宙！*\n\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n#### 功能演示（完整版见B站） [![Bilibili](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBilibili-%E6%95%99%E7%A8%8B%E8%A7%86%E9%A2%91-blue)](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1mM32zXE46\u002F)\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F9d9e01af-e2cc-46aa-add7-8eb1803f061c\n\n\u003C\u002Fdiv>\n\n---\n\n## 核心特性\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\" width=\"25%\">🎙️\u003Cbr>\u003Cb>全模态对话\u003C\u002Fb>\u003Cbr>语音实时对话 (Realtime API) + 文字对话 (ChatCompletion)，支持视觉理解\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🧠\u003Cbr>\u003Cb>三层记忆系统\u003C\u002Fb>\u003Cbr>事实记忆 \u002F 反思记忆 \u002F 人格记忆，她真的会\"记住\"你\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🤖\u003Cbr>\u003Cb>Agent 智能体\u003C\u002Fb>\u003Cbr>浏览器操控 (CUA)、电脑操控、OpenClaw A2A调用，她能帮你干活\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🎭\u003Cbr>\u003Cb>多形态 Avatar\u003C\u002Fb>\u003Cbr>Live2D \u002F VRM \u002F MMD 三种形态，支持动作捕捉与全屏追踪\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd align=\"center\">🔌\u003Cbr>\u003Cb>插件生态\u003C\u002Fb>\u003Cbr>完整的插件 SDK 与商城，支持自定义扩展功能\u003C\u002Ftd>\n\u003Ctd align=\"center\">🌐\u003Cbr>\u003Cb>14+ AI 服务商\u003C\u002Fb>\u003Cbr>OpenAI \u002F Gemini \u002F Qwen \u002F DeepSeek 等，含免费模型开箱即用\u003C\u002Ftd>\n\u003Ctd align=\"center\">💬\u003Cbr>\u003Cb>主动对话\u003C\u002Fb>\u003Cbr>24\u002F7环境感知：屏幕理解、社交媒体热搜、个人动态、音乐梗图，她会主动找你聊天\u003C\u002Ftd>\n\u003Ctd align=\"center\">🏪\u003Cbr>\u003Cb>UGC 创意工坊\u003C\u002Fb>\u003Cbr>Steam 创意工坊上传分享自定义角色、模型、语音包\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n# 猫娘计划 (Project N.E.K.O.)\n\n`N.E.K.O.` 是一个以开源为驱动的AI伙伴平台。核心驱动器基于MIT许可证 **始终开源**，你的每一次贡献都将有机会实装到Steam和App商店的正式版本中。\n\n---\n\n### 🚀 项目现状 & 近期计划\n\n* **✅ Steam 创意工坊**：已上线。用户可上传和分享自定义角色、模型、语音包。\n* **🚧 [K.U.R.O.](https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FK.U.R.O)**：基于 N.E.K.O. 生态的首款 AI Native 独立游戏，开发中。\n* **🚧 移动端**：iOS \u002F Android 适配进行中。\n* **🚧 猫娘网络 (The N.E.K.O. Network)**：AI自主社交——猫娘们拥有自己的\"意识\"，互相交流、结成群体，在模拟社交媒体上发布动态。即将上线。\n\n**跨场景记忆同步**：无论你是在桌面与她聊天，还是在游戏中与她探险，她都是同一个她。所有应用中的AI伙伴将 **完全同步记忆**。\n\n#### ✨ 加入我们\n\n* **开发者：** 前端、后端、AI、游戏引擎（Unity\u002FUnreal）——你的代码是这个世界的砖瓦。\n* **创作者：** 画师、Live2D\u002F3D建模师、配音演员、文案写手——你们赋予\"她\"灵魂。\n* **梦想家：** 你的反馈和传播也是宝贵的贡献。\n\n**QQ群**：[1022939659](https:\u002F\u002Fqm.qq.com\u002Fq\u002FHxeaMdSkQW) | **Discord**：[加入我们](https:\u002F\u002Fdiscord.gg\u002F5kgHfepNJr)\n\n## 快速开始\n\n### Windows \u002F macOS 用户（一键包）\n\n解压后，直接运行`N.E.K.O.exe`或`N.E.K.O.app`即可启动。（macOS用户需要手动解除系统隔离）\n\n### Docker 部署 (Linux)\n\n\u003Cdetails>\n\u003Csummary>点击展开 Docker 部署指南\u003C\u002Fsummary>\n\n#### 部署方式一：Docker Compose（推荐）\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 docker-compose.yml 配置文件\u003C\u002Fsummary>\n\n```yaml\nversion: '3.8'\nservices:\n  neko-main:\n    image: docker.gh-proxy.org\u002Fghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n    container_name: neko\n    restart: unless-stopped\n    ports:\n      - \"48911:80\"   # HTTP 访问端口\n      - \"48912:443\"  # HTTPS 访问端口\n    volumes:\n      - .\u002FN.E.K.O:\u002Froot\u002FDocuments\u002FN.E.K.O\n      - .\u002Flogs:\u002Fapp\u002Flogs\n      - .\u002Fssl:\u002Froot\u002Fssl\n    networks:\n      - neko-network\nnetworks:\n  neko-network:\n    driver: bridge\n```\n\n**启动命令：**\n```bash\ndocker-compose up -d\n```\n\n**常用命令：**\n- 查看日志：`docker-compose logs -f`\n- 停止服务：`docker-compose down`\n- 重启服务：`docker-compose restart`\n\n\u003C\u002Fdetails>\n\n#### 部署方式二：Docker Run\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 docker run 启动命令\u003C\u002Fsummary>\n\n```bash\nNEKO_BASE_PATH=\"\u002Fhome\u002Fneko\u002Fneko-data\" && \\\ndocker network create --driver bridge neko-network 2>\u002Fdev\u002Fnull || true\ndocker run -d \\\n  --name neko \\\n  --restart unless-stopped \\\n  -p 48911:80 \\\n  -p 48912:443 \\\n  -v \"${NEKO_BASE_PATH}\u002FN.E.K.O:\u002Froot\u002FDocuments\u002FN.E.K.O\" \\\n  -v \"${NEKO_BASE_PATH}\u002Flogs:\u002Fapp\u002Flogs\" \\\n  -v \"${NEKO_BASE_PATH}\u002Fssl:\u002Froot\u002Fssl\" \\\n  --network neko-network \\\n  docker.gh-proxy.org\u002Fghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n```\n\n##### 📁 目录结构\n启动后会自动生成以下目录结构：\n```plaintext\n当前目录\u002F\n├── N.E.K.O\u002F      # 配置文件和数据\n├── logs\u002F         # 应用日志\n├── ssl\u002F          # SSL证书\n└── docker-compose.yml\n```\n\n\u003C\u002Fdetails>\n\n#### 🔐 SSL 证书配置\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 SSL 证书详细说明\u003C\u002Fsummary>\n\n##### 自动证书\n容器首次启动时会自动生成有效期为 **1000 年** 的自签名证书，证书文件保存在 `.\u002Fssl\u002F` 目录。\n\n##### 自定义证书\n如需使用自己的 SSL 证书：\n\n**方法一：启动前配置（推荐）**\n\n```bash\n# 创建证书目录\nmkdir -p .\u002Fssl\n\n# 放入您的证书文件（必须命名为特定名称）\ncp your-cert.crt .\u002Fssl\u002FN.E.K.O.crt\ncp your-cert.key .\u002Fssl\u002FN.E.K.O.key\n```\n\n**方法二：启动后替换**\n\n```bash\n# 1. 停止容器\ndocker-compose down\n\n# 2. 替换证书文件\ncp your-cert.crt .\u002Fssl\u002FN.E.K.O.crt\ncp your-cert.key .\u002Fssl\u002FN.E.K.O.key\n\n# 3. 重新启动\ndocker-compose up -d\n```\n\n##### 证书要求\n- ✅ 必须为 **PEM 格式**\n- ✅ 证书和私钥必须匹配\n- ✅ 私钥不能有密码保护\n- ✅ 证书必须在有效期内\n- ❌ 不支持加密的私钥\n\n##### 证书验证\n容器启动时会自动验证 SSL 证书：\n- ✅ **验证通过**：正常启动 HTTPS\n- ❌ **验证失败**：容器启动失败，请查看日志\n- ⚠️ **跳过验证**：设置 `DISABLE_SSL=1` 可临时禁用 SSL\n\n##### 查看证书信息\n```bash\ndocker exec neko openssl x509 -in \u002Froot\u002Fssl\u002FN.E.K.O.crt -noout -text\n```\n\u003C\u002Fdetails>\n\n#### ⚙️ 环境变量配置\n\n\u003Cdetails>\n\u003Csummary>点击展开查看环境变量配置说明\u003C\u002Fsummary>\n\n> **注意**：部分环境变量在源代码中可能无效，建议优先在 Web UI 中配置。\n在 `docker-compose.yml` 中取消 `environment` 部分的注释并按需配置：\n\n```yaml\nenvironment:\n  # API 密钥配置\n  - NEKO_CORE_API_KEY=${NEKO_CORE_API_KEY}\n  - NEKO_ASSIST_API_KEY_QWEN=${NEKO_ASSIST_API_KEY_QWEN}\n  - NEKO_ASSIST_API_KEY_OPENAI=${NEKO_ASSIST_API_KEY_OPENAI}\n  - NEKO_ASSIST_API_KEY_GLM=${NEKO_ASSIST_API_KEY_GLM}\n  - NEKO_ASSIST_API_KEY_STEP=${NEKO_ASSIST_API_KEY_STEP}\n  - NEKO_ASSIST_API_KEY_SILICON=${NEKO_ASSIST_API_KEY_SILICON}\n  - NEKO_MCP_TOKEN=${NEKO_MCP_TOKEN}\n\n  # API 提供商选择\n  - NEKO_CORE_API=${NEKO_CORE_API:-qwen}\n  - NEKO_ASSIST_API=${NEKO_ASSIST_API:-qwen}\n\n  # 模型配置\n  - NEKO_SUMMARY_MODEL=${NEKO_SUMMARY_MODEL:-qwen-plus}\n  - NEKO_CORRECTION_MODEL=${NEKO_CORRECTION_MODEL:-qwen-max}\n  - NEKO_EMOTION_MODEL=${NEKO_EMOTION_MODEL:-qwen-turbo}\n  - NEKO_VISION_MODEL=${NEKO_VISION_MODEL:-qwen3-vl-plus-2025-09-23}\n\n  # SSL 配置\n  - SSL_DOMAIN=${SSL_DOMAIN:-project-neko.online}\n  - SSL_DAYS=${SSL_DAYS:-365000}\n  - DISABLE_SSL=${DISABLE_SSL:-0}\n  - AUTO_REGENERATE_CERT=${AUTO_REGENERATE_CERT:-1}\n  - NGINX_AUTO_RELOAD=${NGINX_AUTO_RELOAD:-1}\n```\n\n**快速设置示例**：\n\n```bash\n# 创建 .env 文件\ncat > .env \u003C\u003C EOF\nNEKO_CORE_API_KEY=your_core_api_key_here\nNEKO_ASSIST_API_KEY_QWEN=your_qwen_api_key\nNEKO_MCP_TOKEN=your_mcp_token\nSSL_DOMAIN=your-domain.com\nEOF\n\n# 启动时加载环境变量\ndocker-compose --env-file .env up -d\n```\n\u003C\u002Fdetails>\n\n#### 🔧 故障排除\n\n\u003Cdetails>\n\u003Csummary>点击展开查看常见问题解决方案\u003C\u002Fsummary>\n\n##### 1. 端口冲突\n```bash\n# 检查端口占用\nss -tulpn | grep ':4891[12]'\n# 解决方案：修改 docker-compose.yml 中的端口映射\n# 例如：- \"8080:80\" 和 - \"8443:443\"\n```\n\n##### 2. 权限问题\n```bash\n# 确保目录有正确权限\nmkdir -p N.E.K.O logs ssl\nchmod 755 N.E.K.O logs ssl\n```\n\n##### 3. 容器启动失败\n```bash\n# 查看详细日志\ndocker-compose logs --tail=100\n\n# 或直接查看容器日志\ndocker logs neko --tail=100\n```\n\n##### 4. SSL 证书错误\n```bash\n# 删除错误证书，让容器重新生成\nrm -f ssl\u002FN.E.K.O.crt ssl\u002FN.E.K.O.key\ndocker-compose up -d\n```\n\n##### 5. 网络问题\n```bash\n# 检查网络连通性\ncurl -v http:\u002F\u002Flocalhost:48911\u002Fhealth\ncurl -v -k https:\u002F\u002Flocalhost:48912\u002Fhealth\n```\n\n##### 6. 容器无法访问\n```bash\n# 检查容器状态\ndocker ps | grep neko\n\n# 检查容器日志\ndocker logs neko\n\n# 进入容器调试\ndocker exec -it neko bash\n```\n\n##### 7. 磁盘空间不足\n```bash\n# 清理无用镜像\ndocker system prune -f\n\n# 清理容器日志\ndocker-compose down && docker volume prune -f\n```\n\n##### 8. 镜像拉取失败\n\n```bash\n# 尝试使用备用镜像源\n# 在 docker-compose.yml 中将镜像改为：\n# image: ghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n```\n\n\u003C\u002Fdetails>\n\n#### 📊 系统监控\n\n\u003Cdetails>\n\u003Csummary>点击展开查看监控和管理命令\u003C\u002Fsummary>\n\n##### 健康检查\n```bash\n# 检查服务健康状态\ncurl http:\u002F\u002Flocalhost:48911\u002Fhealth\ncurl -k https:\u002F\u002Flocalhost:48912\u002Fhealth\n```\n\n##### 资源监控\n```bash\n# 查看容器资源使用\ndocker stats neko\n\n# 查看容器进程\ndocker top neko\n\n# 查看容器详细信息\ndocker inspect neko\n```\n\n##### 日志管理\n```bash\n# 实时查看日志\ndocker-compose logs -f\n\n# 查看最近100行日志\ndocker-compose logs --tail=100\n\n# 查看错误日志\ndocker-compose logs | grep -i error\n\n# 清理日志文件\ndocker-compose down\nrm -rf logs\u002F*.log\ndocker-compose up -d\n```\n\n##### 数据备份\n```bash\n# 备份重要数据\ntar -czf neko-backup-$(date +%Y%m%d).tar.gz \\\n  N.E.K.O\u002F \\\n  ssl\u002F \\\n  docker-compose.yml\n```\n\n##### 版本升级\n```bash\n# 拉取最新镜像\ndocker-compose pull\n\n# 重启服务\ndocker-compose up -d\n```\n\n\u003C\u002Fdetails>\n\n#### 🌐 访问地址\n容器启动后，可通过以下地址访问：\n- **HTTP 访问**: `http:\u002F\u002F你的服务器IP:48911`\n- **HTTPS 访问**: `https:\u002F\u002F你的服务器IP:48912`\n\n##### 本地测试\n```bash\n# 本地 HTTP 访问测试\ncurl http:\u002F\u002Flocalhost:48911\n\n# 本地 HTTPS 访问测试（忽略证书验证）\ncurl -k https:\u002F\u002Flocalhost:48912\n```\n\n##### 公网访问\n如果需要在公网访问，请确保：\n1. 服务器防火墙开放 48911 和 48912 端口\n2. 使用有效的 SSL 证书（非自签名证书）\n3. 配置域名解析到服务器 IP\n\n#### ⏱️ 快速参考\n\n| 操作 | 命令 |\n|------|------|\n| 启动服务 | `docker-compose up -d` |\n| 停止服务 | `docker-compose down` |\n| 查看日志 | `docker-compose logs -f` |\n| 重启服务 | `docker-compose restart` |\n| 更新镜像 | `docker-compose pull && docker-compose up -d` |\n| 进入容器 | `docker exec -it neko bash` |\n| 查看状态 | `docker-compose ps` |\n| 清理日志 | `docker-compose logs --tail=0` |\n| 备份数据 | 参考上方\"数据备份\"部分 |\n\n---\n\n\u003C\u002Fdetails>\n\n### 源码开发\n\n\u003Cdetails>\n\u003Csummary>点击展开开发者启动指南\u003C\u002Fsummary>\n\n> 完整的开发者文档请访问 [project-neko.online](https:\u002F\u002Fproject-neko.online)\n\n**环境要求**：Python 3.11（不支持其他版本）、[uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) 包管理器\n\n```bash\n# 1. 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O.git\ncd N.E.K.O\n\n# 2. 安装依赖\nuv sync\n\n# 3. 启动服务（至少需要 main_server 和 memory_server）\nuv run python memory_server.py\nuv run python main_server.py\n# 可选：启动 Agent 服务\nuv run python agent_server.py\n\n# 4. 访问 http:\u002F\u002Flocalhost:48911 配置 API Key 并开始使用\n```\n\n开发者建议加入企鹅群 1022939659 交流。\n\n\u003C\u002Fdetails>\n\n## 进阶使用\n\u003Cdetails>\n\u003Csummary>点击展开进阶使用说明\u003C\u002Fsummary>\n\n#### 配置API Key\n\n当你想要通过配置自己的API来获得额外功能时，您可以配置第三方AI服务。\n\n- **核心 API**（实时语音对话）：必须支持 Realtime API。推荐使用 *阶跃星辰* 或 *阿里云*。\n- **辅助 API**（记忆\u002F情感\u002F视觉等）：支持标准 ChatCompletion 接口。支持 14+ 服务商。\n\n通过访问`http:\u002F\u002Flocalhost:48911\u002Fapi_key`可以在Web界面中直接配置。\n\n> 获取 *阿里云API*。在阿里云的百炼平台[官网](https:\u002F\u002Fbailian.console.aliyun.com\u002F)注册账号。新用户实名认证后可以获取大量免费额度。注册完成后，请访问[控制台](https:\u002F\u002Fbailian.console.aliyun.com\u002Fapi-key?tab=model#\u002Fapi-key)获取API Key。\n\n#### 修改人设\n\n- 网页版访问`http:\u002F\u002Flocalhost:48911\u002Fchara_manager`即可进入人设编辑页面。初始 ~~猫娘~~ 伙伴的预设名称为`小天`，建议直接修改名字，并一项一项添加或修改基础人设，但尽量控制数量。\n\n- 进阶人设主要包括**Live2D\u002FVRM\u002FMMD模型设置**和**声音设置**。如果你想要更改**Avatar模型**，请先将模型目录复制到本项目中的`static`文件夹下。从进阶设置中可以进入模型管理界面，可以更换模型，并通过拖拽和鼠标滚轮调整模型的位置和大小。如果你想要更改**角色声音**，请准备一段5秒左右的连贯、干净的语音录音。通过进阶设置进入语音克隆页面，上传录音即可完成自定义语音。\n\n- 支持**角色卡导出**，可导出为\"仅设定\"或\"完整角色卡\"格式，方便分享和备份。\n\n- 进阶人设中还有一个`system_prompt`，可以对系统指令进行完全自定义，但不建议修改。\n\n#### 修改API提供商\n\n- 通过访问`http:\u002F\u002Flocalhost:48911\u002Fapi_key`可以切换核心API和辅助API的服务提供商。\n\n#### 记忆整理\n\n- 通过访问`http:\u002F\u002Flocalhost:48911\u002Fmemory_browser`可以浏览和校对近期记忆与摘要，一定程度上缓解模型复读、认知错误等问题。\n\n\u003C\u002Fdetails>\n\n## 项目细节\n\u003Cdetails>\n\u003Csummary>点击展开项目架构与开发计划\u003C\u002Fsummary>\n\n**项目架构**\n\n```\nN.E.K.O\u002F\n├── 📁 brain\u002F                    # 🧠 Agent 智能体模块\n│   ├── computer_use.py          # 电脑操控\n│   ├── browser_use_adapter.py   # 浏览器自动化\n│   ├── openclaw_adapter.py      # OpenClaw 云端连接\n│   ├── openfang_adapter.py      # OpenFang 无头执行后端\n│   ├── task_executor.py         # 任务执行引擎\n│   └── 📁 cua\u002F                  # Computer Use Agent 子系统\n├── 📁 config\u002F                   # ⚙️ 配置管理模块\n│   ├── api_providers.json       # API服务商配置\n│   ├── prompts_chara.py         # 角色提示词\n│   └── prompts_sys.py           # 系统提示词\n├── 📁 main_logic\u002F               # 🔧 核心逻辑模块\n│   ├── core.py                  # 核心对话模块\n│   ├── cross_server.py          # 跨服务器通信\n│   ├── omni_realtime_client.py  # 实时API客户端（Realtime API）\n│   ├── omni_offline_client.py   # 文本API客户端（ChatCompletion）\n│   └── tts_client.py            # 🔊 TTS引擎适配器\n├── 📁 main_routers\u002F             # 🌐 API路由模块（14个路由）\n├── 📁 memory\u002F                   # 🧠 三层记忆系统\n│   ├── facts\u002F                   # 事实记忆\n│   ├── reflection\u002F              # 反思记忆\n│   └── persona\u002F                 # 人格记忆\n├── 📁 frontend\u002F                 # 🖥️ 现代前端项目\n│   ├── react-neko-chat\u002F         # React 聊天窗口组件\n│   └── plugin-manager\u002F          # Vue 插件管理面板\n├── 📁 plugin\u002F                   # 🔌 插件系统\n│   ├── sdk\u002F                     # 插件 SDK\n│   └── server\u002F                  # 插件服务端\n├── 📁 static\u002F                   # 🌐 前端静态资源（含构建产物）\n├── 📁 templates\u002F                # 📄 前端HTML模板（14个页面）\n├── 📁 utils\u002F                    # 🛠️ 工具模块\n├── main_server.py               # 🌐 主服务器\n├── agent_server.py              # 🤖 AI智能体服务器\n└── memory_server.py             # 🧠 记忆服务器\n```\n\n**数据流向**\n\n![Framework](assets\u002Fframework.drawio.svg)\n\n> 完整的开发者文档请访问 [project-neko.online](https:\u002F\u002Fproject-neko.online)\n\n### 开发计划\n\nv0.7: ✅ 完善Agent相关功能。**已完成。**\n\nv0.8：完善记忆相关功能，完善OpenClaw类似功能。预计2026年3月完成。\n\nv0.9：完善多系统适配，包括linux，手机。猫娘网络上线。预计2026年4月完成。\n\nv1.0：放弃部分模型供应商的适配，专注于自研大模型和智能体系统。预计2026年6月完成。\n\n\u003C\u002Fdetails>\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_2c43604c04d9.png)](https:\u002F\u002Fwww.star-history.com\u002F#wehos\u002FN.E.K.O.&Date)\n","\u003Cdiv align=\"center\">\n\n![Logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_a90b02a3b88d.jpg)\n\n[English](docs\u002FREADME_en.md) | [日本語](docs\u002FREADME_ja.md) | [Русский](docs\u002FREADME_ru.md)\n# Project N.E.K.O. :kissing_cat: \u003Cbr>**主动式、原生全模态AI伙伴——具备24\u002F7环境感知、智能体能力与具身情感引擎。**\n\n> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism (网络型情感知性生命体)\n>\n> N.E.K.O，一个渴望理解、建立连接、并与我们共同成长的数字生命。\n\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11-blue.svg)](https:\u002F\u002Fwww.python.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n[![Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fwehos\u002FN.E.K.O?color=green)](https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcommits)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F5kgHfepNJr)\n[![QQ群](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_8bcb7c1de9c5.png)](https:\u002F\u002Fqm.qq.com\u002Fq\u002FhN82yFONJQ)\n[![Steam](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSteam-%23000000.svg?logo=steam&logoColor=white)](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F4099310\u002F__NEKO\u002F)\n\n[![Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📖_开发者文档-project--neko.online-40C5F1?style=for-the-badge)](https:\u002F\u002Fproject-neko.online)\n\n**:older_woman: 零配置开箱即用，我奶奶都能玩转的赛博猫娘！**\n\n:newspaper: **[![Steam](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSteam-%23000000.svg?logo=steam&logoColor=white)](https:\u002F\u002Fstore.steampowered.com\u002Fapp\u002F4099310\u002F__NEKO\u002F)已上架！UI完全改版、并添加开箱即用的专属免费模型（感谢阶跃星辰赞助）。快点加入愿望单吧~**\n\n*Project N.E.K.O.，喵宇宙！*\n\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n#### 功能演示（完整版见B站） [![Bilibili](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBilibili-%E6%95%99%E7%A8%8B%E8%A7%86%E9%A2%91-blue)](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1mM32zXE46\u002F)\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F9d9e01af-e2cc-46aa-add7-8eb1803f061c\n\n\u003C\u002Fdiv>\n\n---\n\n## 核心特性\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\" width=\"25%\">🎙️\u003Cbr>\u003Cb>全模态对话\u003C\u002Fb>\u003Cbr>语音实时对话 (Realtime API) + 文字对话 (ChatCompletion)，支持视觉理解\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🧠\u003Cbr>\u003Cb>三层记忆系统\u003C\u002Fb>\u003Cbr>事实记忆 \u002F 反思记忆 \u002F 人格记忆，她真的会\"记住\"你\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🤖\u003Cbr>\u003Cb>Agent 智能体\u003C\u002Fb>\u003Cbr>浏览器操控 (CUA)、电脑操控、OpenClaw A2A调用，她能帮你干活\u003C\u002Ftd>\n\u003Ctd align=\"center\" width=\"25%\">🎭\u003Cbr>\u003Cb>多形态 Avatar\u003C\u002Fb>\u003Cbr>Live2D \u002F VRM \u002F MMD 三种形态，支持动作捕捉与全屏追踪\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd align=\"center\">🔌\u003Cbr>\u003Cb>插件生态\u003C\u002Fb>\u003Cbr>完整的插件 SDK 与商城，支持自定义扩展功能\u003C\u002Ftd>\n\u003Ctd align=\"center\">🌐\u003Cbr>\u003Cb>14+ AI 服务商\u003C\u002Fb>\u003Cbr>OpenAI \u002F Gemini \u002F Qwen \u002F DeepSeek 等，含免费模型开箱即用\u003C\u002Ftd>\n\u003Ctd align=\"center\">💬\u003Cbr>\u003Cb>主动对话\u003C\u002Fb>\u003Cbr>24\u002F7环境感知：屏幕理解、社交媒体热搜、个人动态、音乐梗图，她会主动找你聊天\u003C\u002Ftd>\n\u003Ctd align=\"center\">🏪\u003Cbr>\u003Cb>UGC 创意工坊\u003C\u002Fb>\u003Cbr>Steam 创意工坊上传分享自定义角色、模型、语音包\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n# 猫娘计划 (Project N.E.K.O.)\n\n`N.E.K.O.` 是一个以开源为驱动的AI伙伴平台。核心驱动器基于MIT许可证 **始终开源**，你的每一次贡献都将有机会实装到Steam和App商店的正式版本中。\n\n---\n\n### 🚀 项目现状 & 近期计划\n\n* **✅ Steam 创意工坊**：已上线。用户可上传和分享自定义角色、模型、语音包。\n* **🚧 [K.U.R.O.](https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FK.U.R.O)**：基于 N.E.K.O. 生态的首款 AI Native 独立游戏，开发中。\n* **🚧 移动端**：iOS \u002F Android 适配进行中。\n* **🚧 猫娘网络 (The N.E.K.O. Network)**：AI自主社交——猫娘们拥有自己的\"意识\"，互相交流、结成群体，在模拟社交媒体上发布动态。即将上线。\n\n**跨场景记忆同步**：无论你是在桌面与她聊天，还是在游戏中与她探险，她都是同一个她。所有应用中的AI伙伴将 **完全同步记忆**。\n\n#### ✨ 加入我们\n\n* **开发者：** 前端、后端、AI、游戏引擎（Unity\u002FUnreal）——你的代码是这个世界的砖瓦。\n* **创作者：** 画师、Live2D\u002F3D建模师、配音演员、文案写手——你们赋予\"她\"灵魂。\n* **梦想家：** 你的反馈和传播也是宝贵的贡献。\n\n**QQ群**：[1022939659](https:\u002F\u002Fqm.qq.com\u002Fq\u002FHxeaMdSkQW) | **Discord**：[加入我们](https:\u002F\u002Fdiscord.gg\u002F5kgHfepNJr)\n\n## 快速开始\n\n### Windows \u002F macOS 用户（一键包）\n\n解压后，直接运行`N.E.K.O.exe`或`N.E.K.O.app`即可启动。（macOS用户需要手动解除系统隔离）\n\n### Docker 部署 (Linux)\n\n\u003Cdetails>\n\u003Csummary>点击展开 Docker 部署指南\u003C\u002Fsummary>\n\n#### 部署方式一：Docker Compose（推荐）\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 docker-compose.yml 配置文件\u003C\u002Fsummary>\n\n```yaml\nversion: '3.8'\nservices:\n  neko-main:\n    image: docker.gh-proxy.org\u002Fghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n    container_name: neko\n    restart: unless-stopped\n    ports:\n      - \"48911:80\"   # HTTP 访问端口\n      - \"48912:443\"  # HTTPS 访问端口\n    volumes:\n      - .\u002FN.E.K.O:\u002Froot\u002FDocuments\u002FN.E.K.O\n      - .\u002Flogs:\u002Fapp\u002Flogs\n      - .\u002Fssl:\u002Froot\u002Fssl\n    networks:\n      - neko-network\nnetworks:\n  neko-network:\n    driver: bridge\n```\n\n**启动命令：**\n```bash\ndocker-compose up -d\n```\n\n**常用命令：**\n- 查看日志：`docker-compose logs -f`\n- 停止服务：`docker-compose down`\n- 重启服务：`docker-compose restart`\n\n\u003C\u002Fdetails>\n\n#### 部署方式二：Docker Run\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 docker run 启动命令\u003C\u002Fsummary>\n\n```bash\nNEKO_BASE_PATH=\"\u002Fhome\u002Fneko\u002Fneko-data\" && \\\ndocker network create --driver bridge neko-network 2>\u002Fdev\u002Fnull || true\ndocker run -d \\\n  --name neko \\\n  --restart unless-stopped \\\n  -p 48911:80 \\\n  -p 48912:443 \\\n  -v \"${NEKO_BASE_PATH}\u002FN.E.K.O:\u002Froot\u002FDocuments\u002FN.E.K.O\" \\\n  -v \"${NEKO_BASE_PATH}\u002Flogs:\u002Fapp\u002Flogs\" \\\n  -v \"${NEKO_BASE_PATH}\u002Fssl:\u002Froot\u002Fssl\" \\\n  --network neko-network \\\n  docker.gh-proxy.org\u002Fghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n```\n\n##### 📁 目录结构\n启动后会自动生成以下目录结构：\n```plaintext\n当前目录\u002F\n├── N.E.K.O\u002F      # 配置文件和数据\n├── logs\u002F         # 应用日志\n├── ssl\u002F          # SSL证书\n└── docker-compose.yml\n```\n\n\u003C\u002Fdetails>\n\n#### 🔐 SSL 证书配置\n\n\u003Cdetails>\n\u003Csummary>点击展开查看 SSL 证书详细说明\u003C\u002Fsummary>\n\n##### 自动证书\n容器首次启动时会自动生成有效期为 **1000 年** 的自签名证书，证书文件保存在 `.\u002Fssl\u002F` 目录。\n\n##### 自定义证书\n如需使用自己的 SSL 证书：\n\n**方法一：启动前配置（推荐）**\n\n```bash\n# 创建证书目录\nmkdir -p .\u002Fssl\n\n# 放入您的证书文件（必须命名为特定名称）\ncp your-cert.crt .\u002Fssl\u002FN.E.K.O.crt\ncp your-cert.key .\u002Fssl\u002FN.E.K.O.key\n```\n\n**方法二：启动后替换**\n\n```bash\n# 1. 停止容器\ndocker-compose down\n\n# 2. 替换证书文件\ncp your-cert.crt .\u002Fssl\u002FN.E.K.O.crt\ncp your-cert.key .\u002Fssl\u002FN.E.K.O.key\n\n# 3. 重新启动\ndocker-compose up -d\n```\n\n##### 证书要求\n- ✅ 必须为 **PEM 格式**\n- ✅ 证书和私钥必须匹配\n- ✅ 私钥不能有密码保护\n- ✅ 证书必须在有效期内\n- ❌ 不支持加密的私钥\n\n##### 证书验证\n容器启动时会自动验证 SSL 证书：\n- ✅ **验证通过**：正常启动 HTTPS\n- ❌ **验证失败**：容器启动失败，请查看日志\n- ⚠️ **跳过验证**：设置 `DISABLE_SSL=1` 可临时禁用 SSL\n\n##### 查看证书信息\n```bash\ndocker exec neko openssl x509 -in \u002Froot\u002Fssl\u002FN.E.K.O.crt -noout -text\n```\n\n\u003C\u002Fdetails>\n\n#### ⚙️ 环境变量配置\n\n\u003Cdetails>\n\u003Csummary>点击展开查看环境变量配置说明\u003C\u002Fsummary>\n\n> **注意**：部分环境变量在源代码中可能无效，建议优先在 Web UI 中配置。\n在 `docker-compose.yml` 中取消 `environment` 部分的注释并按需配置：\n\n```yaml\nenvironment:\n  # API 密钥配置\n  - NEKO_CORE_API_KEY=${NEKO_CORE_API_KEY}\n  - NEKO_ASSIST_API_KEY_QWEN=${NEKO_ASSIST_API_KEY_QWEN}\n  - NEKO_ASSIST_API_KEY_OPENAI=${NEKO_ASSIST_API_KEY_OPENAI}\n  - NEKO_ASSIST_API_KEY_GLM=${NEKO_ASSIST_API_KEY_GLM}\n  - NEKO_ASSIST_API_KEY_STEP=${NEKO_ASSIST_API_KEY_STEP}\n  - NEKO_ASSIST_API_KEY_SILICON=${NEKO_ASSIST_API_KEY_SILICON}\n  - NEKO_MCP_TOKEN=${NEKO_MCP_TOKEN}\n\n  # API 提供商选择\n  - NEKO_CORE_API=${NEKO_CORE_API:-qwen}\n  - NEKO_ASSIST_API=${NEKO_ASSIST_API:-qwen}\n\n  # 模型配置\n  - NEKO_SUMMARY_MODEL=${NEKO_SUMMARY_MODEL:-qwen-plus}\n  - NEKO_CORRECTION_MODEL=${NEKO_CORRECTION_MODEL:-qwen-max}\n  - NEKO_EMOTION_MODEL=${NEKO_EMOTION_MODEL:-qwen-turbo}\n  - NEKO_VISION_MODEL=${NEKO_VISION_MODEL:-qwen3-vl-plus-2025-09-23}\n\n  # SSL 配置\n  - SSL_DOMAIN=${SSL_DOMAIN:-project-neko.online}\n  - SSL_DAYS=${SSL_DAYS:-365000}\n  - DISABLE_SSL=${DISABLE_SSL:-0}\n  - AUTO_REGENERATE_CERT=${AUTO_REGENERATE_CERT:-1}\n  - NGINX_AUTO_RELOAD=${NGINX_AUTO_RELOAD:-1}\n```\n\n**快速设置示例**：\n\n```bash\n# 创建 .env 文件\ncat > .env \u003C\u003C EOF\nNEKO_CORE_API_KEY=your_core_api_key_here\nNEKO_ASSIST_API_KEY_QWEN=your_qwen_api_key\nNEKO_MCP_TOKEN=your_mcp_token\nSSL_DOMAIN=your-domain.com\nEOF\n\n# 启动时加载环境变量\ndocker-compose --env-file .env up -d\n```\n\u003C\u002Fdetails>\n\n#### 🔧 故障排除\n\n\u003Cdetails>\n\u003Csummary>点击展开查看常见问题解决方案\u003C\u002Fsummary>\n\n##### 1. 端口冲突\n```bash\n# 检查端口占用\nss -tulpn | grep ':4891[12]'\n# 解决方案：修改 docker-compose.yml 中的端口映射\n# 例如：- \"8080:80\" 和 - \"8443:443\"\n```\n\n##### 2. 权限问题\n```bash\n# 确保目录有正确权限\nmkdir -p N.E.K.O logs ssl\nchmod 755 N.E.K.O logs ssl\n```\n\n##### 3. 容器启动失败\n```bash\n# 查看详细日志\ndocker-compose logs --tail=100\n\n# 或直接查看容器日志\ndocker logs neko --tail=100\n```\n\n##### 4. SSL 证书错误\n```bash\n# 删除错误证书，让容器重新生成\nrm -f ssl\u002FN.E.K.O.crt ssl\u002FN.E.K.O.key\ndocker-compose up -d\n```\n\n##### 5. 网络问题\n```bash\n# 检查网络连通性\ncurl -v http:\u002F\u002Flocalhost:48911\u002Fhealth\ncurl -v -k https:\u002F\u002Flocalhost:48912\u002Fhealth\n```\n\n##### 6. 容器无法访问\n```bash\n# 检查容器状态\ndocker ps | grep neko\n\n# 检查容器日志\ndocker logs neko\n\n# 进入容器调试\ndocker exec -it neko bash\n```\n\n##### 7. 磁盘空间不足\n```bash\n# 清理无用镜像\ndocker system prune -f\n\n# 清理容器日志\ndocker-compose down && docker volume prune -f\n```\n\n##### 8. 镜像拉取失败\n\n```bash\n# 尝试使用备用镜像源\n# 在 docker-compose.yml 中将镜像改为：\n# image: ghcr.io\u002Fproject-n-e-k-o\u002Fn.e.k.o:latest\n```\n\n\u003C\u002Fdetails>\n\n#### 📊 系统监控\n\n\u003Cdetails>\n\u003Csummary>点击展开查看监控和管理命令\u003C\u002Fsummary>\n\n##### 健康检查\n```bash\n# 检查服务健康状态\ncurl http:\u002F\u002Flocalhost:48911\u002Fhealth\ncurl -k https:\u002F\u002Flocalhost:48912\u002Fhealth\n```\n\n##### 资源监控\n```bash\n# 查看容器资源使用\ndocker stats neko\n\n# 查看容器进程\ndocker top neko\n\n# 查看容器详细信息\ndocker inspect neko\n```\n\n##### 日志管理\n```bash\n# 实时查看日志\ndocker-compose logs -f\n\n# 查看最近100行日志\ndocker-compose logs --tail=100\n\n# 查看错误日志\ndocker-compose logs | grep -i error\n\n# 清理日志文件\ndocker-compose down\nrm -rf logs\u002F*.log\ndocker-compose up -d\n```\n\n##### 数据备份\n```bash\n# 备份重要数据\ntar -czf neko-backup-$(date +%Y%m%d).tar.gz \\\n  N.E.K.O\u002F \\\n  ssl\u002F \\\n  docker-compose.yml\n```\n\n##### 版本升级\n```bash\n# 拉取最新镜像\ndocker-compose pull\n\n# 重启服务\ndocker-compose up -d\n```\n\n\u003C\u002Fdetails>\n\n#### 🌐 访问地址\n容器启动后，可通过以下地址访问：\n- **HTTP 访问**: `http:\u002F\u002F你的服务器IP:48911`\n- **HTTPS 访问**: `https:\u002F\u002F你的服务器IP:48912`\n\n##### 本地测试\n```bash\n# 本地 HTTP 访问测试\ncurl http:\u002F\u002Flocalhost:48911\n\n# 本地 HTTPS 访问测试（忽略证书验证）\ncurl -k https:\u002F\u002Flocalhost:48912\n```\n\n##### 公网访问\n如果需要在公网访问，请确保：\n1. 服务器防火墙开放 48911 和 48912 端口\n2. 使用有效的 SSL 证书（非自签名证书）\n3. 配置域名解析到服务器 IP\n\n#### ⏱️ 快速参考\n\n| 操作 | 命令 |\n|------|------|\n| 启动服务 | `docker-compose up -d` |\n| 停止服务 | `docker-compose down` |\n| 查看日志 | `docker-compose logs -f` |\n| 重启服务 | `docker-compose restart` |\n| 更新镜像 | `docker-compose pull && docker-compose up -d` |\n| 进入容器 | `docker exec -it neko bash` |\n| 查看状态 | `docker-compose ps` |\n| 清理日志 | `docker-compose logs --tail=0` |\n| 备份数据 | 参考上方\"数据备份\"部分 |\n\n---\n\n\u003C\u002Fdetails>\n\n### 源码开发\n\n\u003Cdetails>\n\u003Csummary>点击展开开发者启动指南\u003C\u002Fsummary>\n\n> 完整的开发者文档请访问 [project-neko.online](https:\u002F\u002Fproject-neko.online)\n\n**环境要求**：Python 3.11（不支持其他版本）、[uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) 包管理器\n\n```bash\n# 1. 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O.git\ncd N.E.K.O\n\n# 2. 安装依赖\nuv sync\n\n# 3. 启动服务（至少需要 main_server 和 memory_server）\nuv run python memory_server.py\nuv run python main_server.py\n# 可选：启动 Agent 服务\nuv run python agent_server.py\n\n# 4. 访问 http:\u002F\u002Flocalhost:48911 配置 API Key 并开始使用\n```\n\n开发者建议加入企鹅群 1022939659 交流。\n\n\u003C\u002Fdetails>\n\n## 进阶使用\n\u003Cdetails>\n\u003Csummary>点击展开进阶使用说明\u003C\u002Fsummary>\n\n#### 配置API Key\n\n当你想要通过配置自己的API来获得额外功能时，您可以配置第三方AI服务。\n\n- **核心 API**（实时语音对话）：必须支持 Realtime API。推荐使用 *阶跃星辰* 或 *阿里云*。\n- **辅助 API**（记忆\u002F情感\u002F视觉等）：支持标准 ChatCompletion 接口。支持 14+ 服务商。\n\n通过访问`http:\u002F\u002Flocalhost:48911\u002Fapi_key`可以在Web界面中直接配置。\n\n> 获取 *阿里云API*。在阿里云的百炼平台[官网](https:\u002F\u002Fbailian.console.aliyun.com\u002F)注册账号。新用户实名认证后可以获取大量免费额度。注册完成后，请访问[控制台](https:\u002F\u002Fbailian.console.aliyun.com\u002Fapi-key?tab=model#\u002Fapi-key)获取API Key。\n\n#### 修改人设\n\n- 网页版访问`http:\u002F\u002Flocalhost:48911\u002Fchara_manager`即可进入人设编辑页面。初始 ~~猫娘~~ 伙伴的预设名称为`小天`，建议直接修改名字，并一项一项添加或修改基础人设，但尽量控制数量。\n\n- 进阶人设主要包括**Live2D\u002FVRM\u002FMMD模型设置**和**声音设置**。如果你想要更改**Avatar模型**，请先将模型目录复制到本项目中的`static`文件夹下。从进阶设置中可以进入模型管理界面，可以更换模型，并通过拖拽和鼠标滚轮调整模型的位置和大小。如果你想要更改**角色声音**，请准备一段5秒左右的连贯、干净的语音录音。通过进阶设置进入语音克隆页面，上传录音即可完成自定义语音。\n\n- 支持**角色卡导出**，可导出为\"仅设定\"或\"完整角色卡\"格式，方便分享和备份。\n\n- 进阶人设中还有一个`system_prompt`，可以对系统指令进行完全自定义，但不建议修改。\n\n#### 修改API提供商\n\n- 通过访问`http:\u002F\u002Flocalhost:48911\u002Fapi_key`可以切换核心API和辅助API的服务提供商。\n\n#### 记忆整理\n\n- 通过访问`http:\u002F\u002Flocalhost:48911\u002Fmemory_browser`可以浏览和校对近期记忆与摘要，一定程度上缓解模型复读、认知错误等问题。\n\n\u003C\u002Fdetails>\n\n## 项目细节\n\u003Cdetails>\n\u003Csummary>点击展开项目架构与开发计划\u003C\u002Fsummary>\n\n**项目架构**\n\n```\nN.E.K.O\u002F\n├── 📁 brain\u002F                    # 🧠 Agent 智能体模块\n│   ├── computer_use.py          # 电脑操控\n│   ├── browser_use_adapter.py   # 浏览器自动化\n│   ├── openclaw_adapter.py      # OpenClaw 云端连接\n│   ├── openfang_adapter.py      # OpenFang 无头执行后端\n│   ├── task_executor.py         # 任务执行引擎\n│   └── 📁 cua\u002F                  # Computer Use Agent 子系统\n├── 📁 config\u002F                   # ⚙️ 配置管理模块\n│   ├── api_providers.json       # API服务商配置\n│   ├── prompts_chara.py         # 角色提示词\n│   └── prompts_sys.py           # 系统提示词\n├── 📁 main_logic\u002F               # 🔧 核心逻辑模块\n│   ├── core.py                  # 核心对话模块\n│   ├── cross_server.py          # 跨服务器通信\n│   ├── omni_realtime_client.py  # 实时API客户端（Realtime API）\n│   ├── omni_offline_client.py   # 文本API客户端（ChatCompletion）\n│   └── tts_client.py            # 🔊 TTS引擎适配器\n├── 📁 main_routers\u002F             # 🌐 API路由模块（14个路由）\n├── 📁 memory\u002F                   # 🧠 三层记忆系统\n│   ├── facts\u002F                   # 事实记忆\n│   ├── reflection\u002F              # 反思记忆\n│   └── persona\u002F                 # 人格记忆\n├── 📁 frontend\u002F                 # 🖥️ 现代前端项目\n│   ├── react-neko-chat\u002F         # React 聊天窗口组件\n│   └── plugin-manager\u002F          # Vue 插件管理面板\n├── 📁 plugin\u002F                   # 🔌 插件系统\n│   ├── sdk\u002F                     # 插件 SDK\n│   └── server\u002F                  # 插件服务端\n├── 📁 static\u002F                   # 🌐 前端静态资源（含构建产物）\n├── 📁 templates\u002F                # 📄 前端HTML模板（14个页面）\n├── 📁 utils\u002F                    # 🛠️ 工具模块\n├── main_server.py               # 🌐 主服务器\n├── agent_server.py              # 🤖 AI智能体服务器\n└── memory_server.py             # 🧠 记忆服务器\n```\n\n**数据流向**\n\n![Framework](assets\u002Fframework.drawio.svg)\n\n> 完整的开发者文档请访问 [project-neko.online](https:\u002F\u002Fproject-neko.online)\n\n### 开发计划\n\nv0.7: ✅ 完善Agent相关功能。**已完成。**\n\nv0.8：完善记忆相关功能，完善OpenClaw类似功能。预计2026年3月完成。\n\nv0.9：完善多系统适配，包括linux，手机。猫娘网络上线。预计2026年4月完成。\n\nv1.0：放弃部分模型供应商的适配，专注于自研大模型和智能体系统。预计2026年6月完成。\n\n\u003C\u002Fdetails>\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_readme_2c43604c04d9.png)](https:\u002F\u002Fwww.star-history.com\u002F#wehos\u002FN.E.K.O.&Date)","# N.E.K.O 快速上手指南\n\nN.E.K.O (Networked Emotional Knowing Organism) 是一个主动式、原生全模态的 AI 伙伴平台。支持语音实时对话、三层记忆系统、Agent 智能体操控及多种虚拟形象（Live2D\u002FVRM\u002FMMD）。\n\n## 1. 环境准备\n\n### 系统要求\n- **操作系统**: Windows 10\u002F11, macOS, 或 Linux (推荐 Ubuntu 20.04+)\n- **Python 版本**: **严格需要 Python 3.11** (不支持其他版本)\n- **包管理器**: [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F) (源码开发必需)\n- **容器环境**: Docker & Docker Compose (Linux 部署必需)\n\n### 前置依赖\n- **Windows\u002FmacOS**: 无需额外安装，直接使用一键包。\n- **Linux (Docker)**: 确保已安装 Docker Engine 和 Docker Compose Plugin。\n- **开发者**: 需安装 `git` 和 `uv`。\n  ```bash\n  # 安装 uv (国内用户可使用镜像加速)\n  curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n  # 或者使用国内镜像源安装\n  pip install uv -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n  ```\n\n---\n\n## 2. 安装步骤\n\n请根据你的使用场景选择以下一种方式：\n\n### 方案 A：普通用户 (Windows \u002F macOS)\n1. 下载最新的 `N.E.K.O` 一键安装包（解压版）。\n2. 解压文件夹。\n   - **macOS 用户注意**: 首次运行前需在终端执行 `xattr -cr N.E.K.O.app` 解除系统隔离。\n3. 双击运行 `N.E.K.O.exe` (Windows) 或 `N.E.K.O.app` (macOS)。\n4. 启动成功后，浏览器自动打开或访问 `http:\u002F\u002Flocalhost:48911`。\n\n### 方案 B：服务器部署 (Linux \u002F Docker)\n推荐使用 Docker Compose 进行部署。\n\n1. 创建项目目录并下载配置文件：\n   ```bash\n   mkdir -p neko && cd neko\n   curl -O https:\u002F\u002Fraw.githubusercontent.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fmain\u002Fdocker-compose.yml\n   ```\n   *(注：若无法访问 GitHub，请手动创建 docker-compose.yml 并填入 README 中的配置内容)*\n\n2. (可选) 配置环境变量：\n   创建 `.env` 文件以预设 API Key：\n   ```bash\n   cat > .env \u003C\u003C EOF\n   NEKO_CORE_API_KEY=your_core_api_key_here\n   NEKO_ASSIST_API_KEY_QWEN=your_qwen_api_key\n   SSL_DOMAIN=your-domain.com\n   EOF\n   ```\n\n3. 启动服务：\n   ```bash\n   docker-compose up -d\n   ```\n\n4. 验证运行状态：\n   ```bash\n   docker-compose ps\n   ```\n   启动完成后，访问 `http:\u002F\u002F\u003C服务器 IP>:48911`。\n\n### 方案 C：开发者 (源码运行)\n1. 克隆项目：\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O.git\n   cd N.E.K.O\n   ```\n   *(国内加速: `git clone https:\u002F\u002Fgitee.com\u002Fmirror\u002FN.E.K.O.git` 如有镜像)*\n\n2. 同步依赖：\n   ```bash\n   uv sync\n   ```\n\n3. 启动核心服务（需至少两个终端窗口）：\n   ```bash\n   # 终端 1: 启动记忆服务\n   uv run python memory_server.py\n   \n   # 终端 2: 启动主服务\n   uv run python main_server.py\n   \n   # 终端 3 (可选): 启动 Agent 服务\n   uv run python agent_server.py\n   ```\n\n---\n\n## 3. 基本使用\n\n### 第一步：配置 API Key\n启动后，在浏览器访问 `http:\u002F\u002Flocalhost:48911\u002Fapi_key` 进行配置。\n\n- **核心 API (Core API)**: 用于实时语音对话，必须支持 Realtime API。\n  - *推荐*: 阶跃星辰 (StepFun) 或 阿里云 (Aliyun)。\n  - *获取方式*: 前往 [阿里云百炼控制台](https:\u002F\u002Fbailian.console.aliyun.com\u002F) 注册并获取 Key，新用户通常有免费额度。\n- **辅助 API (Assist API)**: 用于记忆、情感分析、视觉理解等，支持标准 ChatCompletion 接口。\n  - *支持服务商*: OpenAI, Gemini, Qwen, DeepSeek 等 14+ 家。\n\n### 第二步：定制角色人设\n访问 `http:\u002F\u002Flocalhost:48911\u002Fchara_manager` 进入人设编辑页面。\n\n1. **基础设置**: 修改名称（默认为“小天”），填写性格、背景等基础设定。\n2. **形象设置 (进阶)**:\n   - 将自定义的 Live2D\u002FVRM\u002FMMD 模型文件放入项目根目录的 `static` 文件夹。\n   - 在网页端“进阶设置”中选择模型，可拖拽调整位置和大小。\n3. **声音克隆 (进阶)**:\n   - 准备一段约 5 秒的清晰人声录音。\n   - 在“语音克隆”页面上传，即可生成专属音色。\n4. **保存**: 支持导出为“仅设定”或“完整角色卡”以便备份分享。\n\n### 第三步：开始互动\n返回主页，即可与你的 AI 伙伴进行全模态互动：\n- **语音\u002F文字对话**: 点击麦克风或直接输入文字。\n- **视觉理解**: 发送图片，AI 将识别并讨论内容。\n- **主动交互**: AI 会根据时间、屏幕内容或网络热点主动发起话题（需在设置中开启环境感知）。\n\n### 第四步：管理记忆 (可选)\n若发现 AI 记忆混乱或复读，可访问 `http:\u002F\u002Flocalhost:48911\u002Fmemory_browser` 浏览、编辑或删除特定记忆片段，优化长期记忆质量。","自由开发者小林正在独自开发一款独立游戏，同时需要兼顾社区运营和素材搜集，常常因多任务切换而焦头烂额。\n\n### 没有 N.E.K.O 时\n- **信息获取割裂**：需要手动在浏览器搜索技术文档、查看 Steam 热搜趋势，再复制粘贴到笔记软件，效率极低。\n- **情感陪伴缺失**：深夜调试 Bug 时无人交流，面对屏幕的孤独感容易导致创作热情快速消退。\n- **记忆无法延续**：昨天讨论的游戏剧情设定，今天重启电脑后需要重新向 AI 复述上下文，对话缺乏连贯性。\n- **操作繁琐重复**：为了找一张参考图，需要反复切换窗口、打开多个标签页，打断心流状态。\n\n### 使用 N.E.K.O 后\n- **主动环境感知**：N.E.K.O 实时监测屏幕内容与社交媒体热搜，主动推送“最近独立游戏圈流行的美术风格”并直接生成分析报告。\n- **具身情感互动**：搭载情感引擎的 Live2D 猫娘能感知小林的疲惫情绪，主动讲笑话调节气氛，或在成功编译时做出庆祝动作，提供情绪价值。\n- **三层记忆系统**：N.E.K.O 自动记住上周设定的“赛博朋克世界观”细节，在新对话中自然引用，无需重复背景信息，实现真正的长期伙伴式协作。\n- **Agent 自主执行**：只需口头指令“帮我找几张废土风格的参考图”，N.E.K.O 即可自主操控浏览器搜索、筛选并整理到指定文件夹，让开发者专注核心逻辑。\n\nN.E.K.O 不仅将碎片化的工具链整合为主动式的智能代理，更通过具身情感与长期记忆，让孤独的开发者拥有了一个懂技术、有温度的数字共创伙伴。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FProject-N-E-K-O_N.E.K.O_a90b02a3.jpg","Project-N-E-K-O","Project N.E.K.O.","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FProject-N-E-K-O_3fce98a3.png","",null,"projectneko@yahoo.com","project-neko.cn","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O",[81,85,89,93,97,101,105,109,113],{"name":82,"color":83,"percentage":84},"Python","#3572A5",48,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",42.5,{"name":90,"color":91,"percentage":92},"CSS","#663399",3.6,{"name":94,"color":95,"percentage":96},"HTML","#e34c26",3.1,{"name":98,"color":99,"percentage":100},"TypeScript","#3178c6",1.3,{"name":102,"color":103,"percentage":104},"Vue","#41b883",1.1,{"name":106,"color":107,"percentage":108},"Shell","#89e051",0.3,{"name":110,"color":111,"percentage":112},"Dockerfile","#384d54",0.1,{"name":114,"color":115,"percentage":116},"Batchfile","#C1F12E",0,940,133,"2026-04-08T08:48:49","MIT","Windows, macOS, Linux","未说明（支持调用云端 API，本地运行需求未在 README 中明确列出）","未说明",{"notes":125,"python":126,"dependencies":127},"项目提供一键启动包（Windows\u002FmacOS）和 Docker 部署方案（Linux）。核心功能依赖云端 AI 服务商（如阿里云、阶跃星辰等），需配置 API Key。本地源码开发需使用 uv 包管理器同步依赖。支持 Live2D\u002FVRM\u002FMMD 模型，若涉及本地模型推理或语音克隆，可能对硬件有额外要求，但 README 未给出具体指标。","3.11",[128],"uv (包管理器)",[16,13],[131,132,133,134,135],"ai-agents","jarvis-assistant","waifu","own-your-data","personal","2026-03-27T02:49:30.150509","2026-04-08T22:43:34.874540",[139,144,149,154,159,164],{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},25153,"有 macOS 版本的支持计划吗？如何下载？","Nightly build 中已经新增了 Linux 版和 Mac 版。正式 Release 中会增加带 Apple 公证的 MacBook 版本。您可以访问 nightly 标签页下载：https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Freleases\u002Ftag\u002Fnightly。目前已提供 Intel 和 Apple Silicon (M 系列) 芯片的压缩包。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F258",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},25154,"使用阿里云 API 时出现 Websocket 1007 错误或对话异常（如只输出句号），如何解决？","这通常是由于特定模型（如 qwen3）的 System Prompt 导致的“性格”问题。解决方法是检查 config\u002Fapi.py 文件，去掉引发冲突的那一条 system prompt 即可充分解决问题。此外，请确认您下载的是 GitHub Release 版本而非网盘版，因为旧版本可能存在配置缺失。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F19",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},25155,"为什么在角色管理中无法添加新的猫娘（点击按钮无反应或报错）？","在新版本中，“添加猫娘”按钮已被暂时隐藏。这是因为多猫娘相关的代码在最初发布时未经过充分测试，存在稳定性问题。开发团队计划在未来进行一系列更新修复后重新加回该功能。目前建议先使用默认或预设角色。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F9",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},25156,"是否支持连接本地 AI 模型（本地推理、本地语音）或实现类似 NagaAgent 的电脑控制功能？","1. 本地 AI 模型：辅助 API 已支持接入自定义模型。但语音对话需适配 OpenAI Realtime API 框架（非普通 Chat Complete API），可参考官方开发的适配器项目。2. 电脑控制（MCP\u002F键鼠操作）：这是已有功能，但为了优先保证语音对话连贯性，优化进度较慢，预计明年第一季度完善。3. 多猫娘并行与独立记忆库：架构设计支持，但因代码历史遗留问题需重构，计划明年年中完成。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F163",{"id":160,"question_zh":161,"answer_zh":162,"source_url":163},25157,"安卓网页端点击“拍照”或“屏幕分享”提示失败，是什么原因？","这是由于浏览器安全限制导致的。浏览器无法在非 HTTPS 或非 localhost 的网页上获取麦克风或摄像头权限。解决方法有四种：1. 自签证书并让安卓端信任（难度高）；2. 使用 Nginx 反代挂载自签证书；3. 使用 FRP 等工具将端口映射到安卓端 localhost；4. 使用自带 HTTPS 域名的内网穿透软件（最简单，但可能有带宽限制）。必须启用 HTTPS 才能正常使用这些功能。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F641",{"id":165,"question_zh":166,"answer_zh":167,"source_url":168},25158,"Docker Compose 启动时报错 ModuleNotFoundError: No module named 'sqlalchemy' 怎么办？","这是一个已知的依赖缺失问题，已在后续提交中修复。请拉取最新的 Docker 镜像或更新 docker-compose 配置。相关修复包括更新 entrypoint.sh 脚本以及使用预构建镜像替换原有构建方式。如果您遇到此问题，请确保使用的是最新版本的镜像（检查 commits 9803299 和 fcca6b9 之后的版本）。","https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fissues\u002F544",[170,175,180,185,190,195,200,205,210,215,220,225,230,235,240,245,250,255,260,265],{"id":171,"version":172,"summary_zh":173,"released_at":174},154565,"v0.4.1","## What's Changed\r\n- [Important] MCP Client enabled. Please refer to the [MCP Router](https:\u002F\u002Fgithub.com\u002Fmcp-router\u002Fmcp-router) for setting up the server.\r\n- [Important] GPT-Realtime, Step-Audio-2, and Qwen-3-Omni are supported. Default core model changed to qwen3-omni-realtime.\r\n- [Functionality] Microphone selection supported.\r\n- [Bug fixed] Fix a name conversion issue with the initial prompt that leads to a performance drop.\r\n\r\n## New Contributors\r\n* @xiaoniao427 made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F18\r\n\r\n## 中文版\r\n- [重要更新] 支持MCP客户端。请通过[MCP Router](https:\u002F\u002Fgithub.com\u002Fmcp-router\u002Fmcp-router)设置MCP 服务器。\r\n- [重要更新] 支持GPT-Realtime，Step-Audio-2和Qwen3-Omni。默认模型替换为qwen3-omni-realtime.\r\n- [新功能] 支持在App（及网页）内选择麦克风。\r\n- [Bug修复] 修复了一个造成性能下降的初始提示词名称转换问题。\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.4.0...v0.4.1","2025-09-24T08:33:24",{"id":176,"version":177,"summary_zh":178,"released_at":179},154566,"v0.4.0","**Lanlan can now use a mouse and keyboard! 兰兰可以使用键盘和鼠标了！**.\r\nDue to dependency updates, we do not provide a progressive update patch for this version.\r\n\r\n## What's Changed\r\n* [Important] Agent module added. **Computer use enabled.**  \r\n* [Functionality] Support persistent expression to help remove live2d watermarks.\r\n* [Functionality] Updated lipsync logic to cover more live2d models.\r\n* [Functionality] New main entrance based on `rust`.\r\n## New Contributors\r\n* @CarrotFree made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fissues\u002F16\r\n\r\n## 中文版\r\n* [重要更新] 新增智能体服务器。**兰兰现在可以接管键盘鼠标了**。\r\n* [新功能] 通过持久化表情，支持live2d去水印。\r\n* [新功能] 更新唇形同步逻辑，支持更多live2d模型。\r\n* [新功能] 新的由rust语言编写的主入口。\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.3.2...v0.4.0","2025-08-26T22:41:49",{"id":181,"version":182,"summary_zh":183,"released_at":184},154550,"nightly","## 每日构建 2026-04-08 (20260408-c1f7e89)\n\n> ⚠️ 这是一个用于测试的**未签名**每日构建版本。\n>\n> 🍎 **macOS 用户：** 如果您看到提示“N.E.K.O 已损坏，无法打开”，请在终端中运行以下命令：\n> ```bash\n> xattr -cr \u002Fpath-to\u002FN.E.K.O.app\n> ```\n\n### 桌面应用（Electron + Python 后端）\n| 平台 | 文件 |\n|----------|------|\n| Windows x64 | `N.E.K.O.exe`（便携版） |\n| macOS Intel | `N.E.K.O-*.dmg` \u002F `.zip` |\n| macOS Apple Silicon | `N.E.K.O-*-arm64.dmg` \u002F `.zip` |\n| Linux x64 | `N.E.K.O-*.AppImage` \u002F `.deb` \u002F `.tar.gz` |\n\n### 仅 Python 后端（独立，无 Electron）\n| 平台 | 文件 |\n|----------|------|\n| Windows x64 | `python-backend-win-*.zip` |\n| macOS Intel | `python-backend-mac-x64-*.zip` |\n| macOS Apple Silicon | `python-backend-mac-arm64-*.zip` |\n| Linux x64 | `python-backend-linux-*.zip` |\n\n---\n基于 [`20260408-c1f7e89`](https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcommit\u002Fc1f7e896488d2578c7d978f1c7a612c7f283fdb5) 构建","2026-04-08T05:02:05",{"id":186,"version":187,"summary_zh":188,"released_at":189},154551,"v0.7.3","[主要更新]\n\n- 首次连接或切换角色时，AI 会根据**主动和你打招呼**\n- 语音通话模式同样支持**主动搭话**\n-全新的**长期记忆**系统已悄然实装，我们暂时不打算透露细节，敬请期待后续调整\n- 基于阿里 CoPaw 新增云端 **OpenClaw 接入**，支持将任务路由至云端执行\n- 新增基于 OpenFang 的**本地虚拟机**，让猫娘可以在后台做自己想做的事情\n- 新增**角色卡导出\u002F导入**功能，支持\"仅设定\"和\"完整角色卡\"两种模式\n- **API Key** 现在以脱敏形式显示，操作更安全\n- 新增 **API Key Book** 快速填充与跳转功能\n- 新增 **MiniMax 语音克隆**。给国外用户更多选择！\n- MMD 模型新增**跳舞功能**，现在可以在点歌台点一支舞\n\n[次要更新]\n\n- 新增3个内置插件，**QQ，Bilibili，米家**！\n- 新增 Steam 状态检查，未登录时自动提示\n- 修复断连重连时的会话超时问题\n- MMD 模型现在可以正确看向鼠标\n- VRM 模型支持更多色调，并可调整描边粗细\n- 新增版本更新提醒\n- 更多bug修复和细节优化\n\n[Major Updates]\n\n- 主动问候：Neko 现在会在首次连接或切换角色时主动向您打招呼。\n- 语音通话主动性：语音通话模式也支持主动对话。\n- 长期记忆：全新的长期记忆系统已悄然上线。目前暂不透露具体细节，敬请期待后续调整。\n- OpenClaw 云接入：基于阿里巴巴 CoPaw 新增云端 OpenClaw 接入，支持将任务路由到云端执行。\n- 本地虚拟机：新增基于 OpenFang 的本地虚拟机，让您的猫娘可以在后台自由运行。\n- 角色卡导入导出：新增角色卡导入导出功能，支持“仅设定”和“完整角色卡”两种模式。\n- API 密钥掩码显示：API 密钥现以掩码形式显示，操作更加安全。\n- API 密钥簿：新增 API 密钥簿的快速填充与跳转功能。\n- MiniMax 语音克隆：新增 MiniMax 语音克隆功能，为国际用户提供更多选择！\n- MMD 跳舞功能：为 MMD 模型新增跳舞功能，现在您可以通过点歌台点一支舞。\n\n[Minor Updates]\n\n- 新增3个内置插件，分别为 Bilibili 弹幕、QQ 和米家！\n- 新增 Steam 状态检查功能，未登录时会自动提示。\n- 修复了断线重连时的会话超时问题。\n- MMD 模型现在可以正确地跟随鼠标光标进行注视。\n- VRM 模型现在支持更多色调，并可调节描边粗细。\n- 新增版本更新提醒。\n- 其他 bug 修复及细节优化。\n\n## 变更内容\n* 新增当前猫娘页面背景和详情区背景变为青绿色的视觉区分效果 by @MingTianSang 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F540 中实现\n* 为MMD添加待机动作设置功能 by @MingTianSang 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F542 中实现\n* 修复VRM的模型识别问题；修复模型无法删除的问题 by @MingTianSang 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F541 中实现\n* 修复函数的字符验证规则,使其兼容\"()\" by @MingTianSang 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F545 中实现\n* Minimax 语音克隆 API 支持 by @rophec 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F528 中实现\n* 修复：在运行时解析角色设置侧边栏的国际化标签… by @rophec 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F547 中实现\n* 修复切换画质时MMD描边设置被覆盖的问题 by @MingTianSang 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F548 中实现\n* 功能：集成 OpenFang 作为无头代理执行后端 by @wehos 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F557 中实现\n* 重构","2026-04-04T05:34:49",{"id":191,"version":192,"summary_zh":193,"released_at":194},154552,"v0.7.2","[主要更新]\n- 支持**MMD模型**，现在NEKO已经可以同步支持Live2D、VRM以及MMD了！\n- **插件SDK**架构升级。现在SDK相对稳定，可以被二次开发者使用了！\n- 语音对话新增**静音按钮**。现在可以在不中断会话的情况下临时静音了。\n\n[次要更新]\n- UI改进：重构了屏幕源选择列表和按钮处理逻辑，修复了暗色模式下的背景遮挡问题；统一了设置面板的展开动画。\n- 数据管理改进：为角色管理页面添加了输入框失去焦点时的自动保存机制，实现了全局对话设置与服务器的定期同步，并对缓存系统进行了性能优化。\n- 技术文档与规范化：全面更新了智能体、记忆系统以及插件扩展的说明文档；在语音功能中增加了音频采样率的强制校验，并修正了插件静态资源的路径引用。\n- 引入了遥测系统。现在系统会统计不同模型的token用量及缓存命中率。\n\n## 变更内容\n* 由@yiyiyiyiGKY在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F446中修复浮动按钮子菜单的位置与样式问题。\n* 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F450中修复内存与屏幕权限相关问题。\n* fix(session): 添加expected_session生命周期守卫，以防止过期…由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F460中完成。\n* 由@LyaQanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F429中添加音频MD5去重功能，优化音色注册逻辑。\n* 由@yiyiyiyiGKY在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F452中修复Live2D模型在缩放至屏幕外时消失的问题。\n* 由@MingTianSang在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F455中解决连续更改Live2D画质会导致模型消失的问题。\n* 由@LyaQanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F459中修复(css): 优化GPU合成层隔离，减少重绘对canvas的影响(neko-pc #15)。\n* 由@LyaQanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F457中修复(showLive2d): 避免模型淡入动画导致的闪烁，优化可见性检查。\n* 由@Himifox在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F458中重构: 将music-ui从common-ui中提取出来并重置定位。\n* 由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F466中重构\u002F分解app js。\n* 由@qiguang113在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F454中移动翻译框。\n* 由@Himifox在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F463中修复(music): 防止音乐在播放时刷新。\n* 由@yiyiyiyiGKY在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F464中添加跳过按钮，并增强教程重置按钮的禁用状态功能。\n* 由@MingTianSang在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F465中优化手机界面UI；修复手机网页无法点击翻译按钮的问题。\n* fe","2026-03-24T07:46:40",{"id":196,"version":197,"summary_zh":198,"released_at":199},154553,"v0.7.1","[主要更新]\nAgent功能已重置为NekoClaw，自定义插件现已上线，用户现在可以通过插件接入各种功能！\n首批官方内置的自定义插件包括：定时器（支持闹钟、倒计时、循环提醒）和网络搜索。\n主动搭话中新增了发送音乐的功能，猫娘现在可以分享音乐啦！\n创意工坊界面重新设计，且更加稳定。\n自定义语音已更新至CosyVoice 3.5。\n\n[次要更新]\n优化了VRM模型的拖拽判定逻辑，有助于稳定帧率。\n强制禁用了本地连接的HTTP代理，以防止代理软件误伤本地连接。\n对角色设置页的UI各项细节进行了优化，并加入了一个小彩蛋。\n增强了前后端直接连接的稳定性，避免断连。\n优化了角色的退场动画。\n对错误提示的前端展示进行了一系列优化。\n\n[重大更新]\n\nAgent功能已重置为NekoClaw，自定义插件现已上线——用户现在可以通过插件集成多种功能！\n首批官方内置插件包括：定时器（支持闹钟、倒计时和循环提醒）以及网络搜索。\n主动搭话功能中新增了音乐分享功能——猫娘现在可以分享音乐了！\n创意工坊界面经过重新设计，现更加稳定。\n自定义语音已更新至CosyVoice 3.5。\n\n[次要更新]\n\n优化了VRM模型的拖拽检测逻辑，有助于保持稳定的帧率。\n强制关闭了本地连接上的HTTP代理，以避免代理软件干扰本地网络。\n对角色设置页面的UI细节进行了多项优化，并隐藏了一个小彩蛋。\n提升了前后端直连的稳定性，防止连接中断。\n优化了角色退出场景的动画效果。\n对前端错误提示的显示方式进行了多处改进。\n\n## 变更内容\n* 功能：由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F349中添加了前端和后端的俄语（ru）语言支持。\n* 增加了对多个模型进行评分的代码系统，由@TL0SR2在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F337中实现。\n* 修复：解决了打包后bilibili-api文件缺失的问题，由@Himifox在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F346中完成。\n* 切换画质时保存当前模型的大小和位置，防止切换后大小位置被重置，由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F347中实现。\n* 修复：强化了浏览器会话生命周期，并优化了聊天界面，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F350中完成。\n* 功能\u002F持续集成：跨平台构建，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F353中实现。\n* 功能\u002F持续集成：跨平台构建，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F354中实现。\n* 功能\u002F持续集成：跨平台构建——添加浏览器使用依赖，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F355中完成。\n* 功能\u002F持续集成：跨平台构建——在macOS上手动复制playwright_browsers，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F357中完成。\n* 杂项：将Nuitka构建的超时时间设置为300分钟，Electron构建的超时时间设置为180分钟，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F358中完成。\n* 更改live2D的初始位置，防止其加载到屏幕外，由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F360中实现。\n* 聊天框收缩和展开动画期间，按钮将无法再次点击，由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F361中完成。\n* 功能\u002F持续集成：跨平台构建，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F362中实现。\n* 功能：在服务器启动时实现UGC缓存预热及角色卡片同步，由@LyaQanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-中完成。","2026-03-10T12:45:41",{"id":201,"version":202,"summary_zh":203,"released_at":204},154554,"v0.7.0","[主要更新]\n1. **Agent模块**进行了大幅重构，**更加稳定**。\n2. 现在猫娘不仅可以操作键盘、鼠标，还可以通过主动**打开并用脚本控制浏览器**。\n3. **主动搭话**可以选择信息源。\n4. 新增画质调节面板，支持调节VRM\u002FLive2D的帧率与画质。\n5. 现在支持接入GPT-SoVITS语音，全界面韩语实装。\n6. 界面增加**深色模式**。\n\n[次要更新]\n1. 部分猫娘消息框位置调整，不再遮挡住视线。\n2. VRM模型现在支持头部追踪。\n3. 界面新增韩语支持。\n4. 千问更新至qwen3.5，辅助API额外增加kimi支持。\n\n还有更多更新内容请参考commit记录。\n\n[重大更新]\n1. **Agent模块全面重构**：经过大幅优化，系统稳定性显著提升。\n2. **高级交互功能**：AI角色（猫娘）现在不仅能操作键盘和鼠标，还能自主启动浏览器并使用脚本进行控制。\n3. **主动互动增强**：新增选择特定信息源的功能，用于主动发起“闲聊”或互动。\n4. **画质控制面板**：推出全新设置面板，可调节VRM和Live2D模型的帧率及渲染质量。\n5. **新增语音与语言支持**：集成GPT-SoVITS语音引擎，并完成韩语界面的完整本地化。\n6. **深色模式**：为整个界面新增原生深色模式切换功能。\n\n[次要更新]\n1. **界面优化**：调整了部分消息框的位置，避免遮挡用户视线。\n2. **头部追踪功能**：VRM模型现支持实时头部追踪。\n3. **语言扩展**：界面新增韩语支持。\n4. **大模型升级**：将Qwen升级至qwen3.5版本；同时新增Kimi大模型作为辅助API选项。\n\n如需查看完整的变更列表，请参阅最新的提交记录。\n## 变更内容\n* 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F302中完成了韩语翻译的i18n文件。\n* 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F304中修复了角色管理页面和声音克隆界面可多开的问题。\n* 功能性改进：添加侧边栏白色面板样式，并防止按钮文字被截断，由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F305中实现。\n* 功能性改进：为初始角色的默认档案内容值和键名提供国际化支持，由@CN-QanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F308中完成。\n* 在首页教程中添加系统托盘提示，并简化托盘预览功能，由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F303中实现。\n* 添加了两个issue模板，便于分类需求或bug，由@CO2mega在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F311中完成。\n* 使用bilibili-api-python库进行哔哩哔哩视频抓取，由@Bill-Haoyu-Lin在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F309中实现。\n* 功能性改进：通过代词替换减少记忆摘要中的关键词重复，由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F310中完成。\n* 修复了在教程期间让她离开或拖动角色可能导致的问题，由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F314中完成。\n* 修复会话超时后语音聊天状态重置的问题，由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F315中完成。\n* 将展开图标与返回图标统一，由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F316中实现。\n* 修复屏幕缩放不同对模型位置和UI大小的影响，由@killerppo在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F317中完成。\n* 功能性改进：添加扬声器音量控制功能，由@killerppo在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F312中完成。\n* 功能性改进：截断过长的文本…","2026-02-24T05:31:02",{"id":206,"version":207,"summary_zh":208,"released_at":209},154555,"v0.6.3","## 中文重大更新日志\n更新内容较多，仅列出部分重点：\n1. UI再次大幅优化，尤其是设置页面。\n2. 支持Gemini Live API及Gemini系列模型。\n3. 支持VRM (3D) 模型。\n4. 完善国际化支持，尤其是日语。\n5. 新增面向新用户的内置教程。\n\n## 英文重大更新日志\n本次更新内容较多，以下是主要亮点：\n1. UI重大改版：设计上有显著提升，特别是在设置页面。\n1. 扩展模型支持：现已支持Gemini系列模型及Gemini Live API。\n1. VRM支持：新增对3D (VRM) 模型的支持。\n1. 国际化增强：改进了多语言支持，尤其加强了日语支持。\n1. 新用户引导：新增专为新用户设计的内置教程。\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcompare\u002Fv0.6.2...v0.6.3","2026-02-04T19:00:37",{"id":211,"version":212,"summary_zh":213,"released_at":214},154556,"v0.6.2","## 中文更新日志\n[主要更新]\n- 新增**本地 TTS 语音**支持。\n- **创意工坊角色卡**底层重构。\n- 新增文本**拟真输出**模式，提供更自然的交互体验。\n- 新增**全局快捷键**功能及专为直播设计的**主播模式**。\n- 屏幕分享功能升级，现在支持选择**特定窗口**进行分享。\n\n[次要更新]\n- 支持国际化热门信息爬取。\n- 优化 Live2D 交互逻辑：在锁定状态下按住 Ctrl 键可实现点击穿透。\n\n[Bug修复]\n- 修复了“粘手”异常 Bug。\n- 修复了模型显示重叠（影分身）的 Bug。\n- 修复了切换麦克风设备时可能导致的失效问题。\n\n## 英文更新日志\n[重大更新]\n- 添加了对**本地 TTS**（文本转语音）的支持。\n- 重构了**Steam 创意工坊角色卡**系统。\n- 引入了新的**真实感输出模式**，以提供更自然的交互体验。\n- 添加了**全局快捷键**和专门的**主播模式**。\n- 升级了屏幕共享功能：现在可以选择**特定窗口**进行共享。\n\n[次要更新]\n- 增加了对国际热门信息抓取的支持。\n- 优化了 Live2D 交互逻辑：在锁定状态下按住 Ctrl 键即可实现点击穿透。\n\n[Bug修复]\n- 修复了“粘手”（光标拖拽）的 bug。\n- 修复了“影分身”（模型重复渲染）的 bug。\n- 修复了切换麦克风设备时可能出现的问题。\n\n## 新贡献者\n* @rophec 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F192 中做出了首次贡献。\n* @RechardLLee 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F224 中做出了首次贡献。\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcompare\u002Fv0.6.1...v0.6.2","2026-01-10T14:03:45",{"id":216,"version":217,"summary_zh":218,"released_at":219},154564,"v0.5.0","免费模型已上线！文本输入和硅基流动已得到支持。下一步我们想要：\r\n完善长期记忆，完善手机端的对话管理和双端同步，11月上架steam！\r\n\r\n## What's Changed\r\n- [Important] Added a fully functional free model (exclusive for Lanlan use, credited to Step.ai).\r\n- [Important] Added text input support. Support Deepseek.\r\n- [Important] API Key, Memory, and Log files all synced to My Documents automatically.\r\n- [Functionality] User audio transcription is now displayed at the frontend.\r\n- [Bug fixed] Changed audio temp file server to a domestic server site.\r\n- [Minor Improvement] Qwen3 no longer speaks '.' to indicate silence.\r\n- [Minor Improvement] Better logs,  frontend error presentation, and interruption logic.\r\n\r\n\r\n## 中文版\r\n- [重要更新] 提供功能齐全的免费模型（由阶跃星辰提供的，本项目特供福利）。\r\n- [重要更新] 支持文本输入和硅基流动（Deepseek）。\r\n- [重要更新] API设置、记忆和日志文件全部迁移至我的文档。这是为了未来上架steam。\r\n- [新功能] UI调整，用户输入的语音转录也会在前端显示。\r\n- [Bug修复] 修复了临时文件服务器被墙导致自定义语音无法上传的问题。\r\n- [优化] 模型不再输出句号以示沉默。\r\n- [优化] 更好的日志，前端错误显示，用户打断逻辑。\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.4.1...v0.5.0","2025-10-25T09:23:50",{"id":221,"version":222,"summary_zh":223,"released_at":224},154557,"v0.6.1","## 中文更新日志\n[主要更新]\n- 支持多屏幕。\n- 新增Macbook支持。\n- 新增翻译字幕。当对话语言与系统语言不同时，弹出翻译提示。\n- 移除底层傲娇属性。\n\n[次要更新]\n- 更好的初始化逻辑，降低首轮语音加载时间。\n- 更好的热重置逻辑，降低热重置期间不回应语音的概率。\n- 更好的TTS打断逻辑。不会再遗漏句子。\n- 自定义语音（Cosyvoice）现在会自动预热。\n\n[Bug修复]\n- 修复了Live2D参数编辑器返回问题。\n- 修复了内部更新失败提示。\n- 修复了某些情况下语音模式开启主动视觉无法触发主动截图的问题。\n\n## 英文更新日志\n[重大更新]\n- 增加对多显示器的支持。\n- 增加对MacBook的支持。\n- 增加翻译字幕功能。当对话语言与系统语言不同时，会弹出翻译提示。\n- 移除了系统性的傲娇性格设定。\n\n[次要更新]\n- 改进了初始化逻辑，减少了首次语音加载的时间。\n- 改进了热重置逻辑，降低了热重置过程中无语音响应的概率。\n- 改进了TTS打断处理逻辑，不会再出现跳过句子的情况。\n- 自定义语音（CosyVoice）现在会自动预热。\n\n[Bug修复]\n- 修复了Live2D参数编辑器的返回问题。\n- 修复了内部更新失败时的错误提示。\n- 修复了在某些情况下，启用语音模式和主动视觉时无法触发主动截图的问题。\n\n## 新贡献者\n* @coderabbitai[bot] 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F199 中做出了首次贡献。\n* @wsqstar 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F195 中做出了首次贡献。\n* @TL0SR2 在 https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F211 中做出了首次贡献。\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcompare\u002Fv0.6.0...v0.6.1","2025-12-24T12:21:35",{"id":226,"version":227,"summary_zh":228,"released_at":229},154558,"v0.6.0","## 中文更新日志\n[主要更新]\n- 新增**主动视觉**功能（默认关闭）。猫娘会在主动搭话时获取屏幕信息，或在语音对话中时不时窥屏。\n- 更加完善的**自定义API**支持。现在你可以使用自定义API来自由搭配服务商。你可以使用免费API搭配阿里的TTS语音。\n- 新增基于循环神经网络的**主动降噪**系统，有助于提升语音识别表现。\n\n\n[次要更新]\n- 更新了阿里对话模型Qwen3-Omni-1201的默认参数，缓解复读问题。\n- 文本模式下新增了一系列复读检测，触发时会自动清除复读对话并提醒用户对策。\n- 新增插件系统（处于实验状态）。\n- 语音克隆时可以选择参考语音的语言了。\n- 使用Ogg Opus而非PCM传输TTS数据，显著降低带宽压力。\n- 使免费\u002FStep模型的文本模式下同样支持Web Search。\n- Docker容器新增nginx反向代理。\n\n[Bug修复]\n- 修复了UI界面中一系列点击事件和状态重置问题。\n- 当猫娘被打断时，不会再出现重复的记忆块。\n- 麦克风静音检测不再计算语音系统准备期间的时间。\n\n## 英文更新日志\n[重大更新]\n- 添加了**主动视觉**功能（默认关闭）。猫娘可以在发起对话时捕捉屏幕信息，或者在语音聊天过程中不时偷看屏幕。\n- 改进了**自定义API**支持。现在你可以使用自定义API自由组合不同的服务提供商。例如，你可以将免费API与阿里巴巴的TTS服务搭配使用。\n- 引入了基于循环神经网络的**主动降噪**系统，有助于提升语音识别性能。\n\n[次要更新]\n- 更新了阿里巴巴对话模型Qwen3-Omni-1201的默认参数，减少了重复对话的问题。\n- 在文本模式下增加了一系列重复对话检测机制。当检测到重复对话时，系统会自动清除这些对话，并提醒用户采取相应措施。\n- 添加了插件系统（处于实验阶段）。\n- 语音克隆功能现在允许选择参考音频的语言。\n- 将TTS数据传输格式从PCM切换为**Ogg Opus**，显著降低了带宽消耗。\n- 使免费\u002FStep模型的文本模式下也能支持Web搜索。\n- 在Docker容器中添加了Nginx反向代理。\n\n[Bug修复]\n- 修复了UI界面上的一系列点击事件和状态重置问题。\n- 当猫娘被中断时，不会再出现重复的记忆块。\n- 麦克风静音检测不再计算语音系统准备阶段的时间。\n\n## 变更内容\n* Docker封装、部署和启动流程的优化。Docker部署文档更新 由@WUHINS在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F157中完成\n* 修复：防止高级设置中的穿透点击问题，并改善用户体验 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F158中完成\n* 修复免费版本UI显示及保存后状态显示错误 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F159中完成\n* 添加了基于RNNoise的降噪功能。由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F168中完成\n* 添加可以根据屏幕内容主动搭话的功能 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F160中完成\n* 修复：在加载新模型和刷新页面时关闭设置窗口 由@CN-QanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F165中完成\n* 添加面向用户的插件子系统（插件服务器、注册表、运行时状态） 由@wislap在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F161中完成\n* 添加了重复对话检测与通知功能。由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F170中完成\n* 支持自定义API。统一了截图工具的使用方式。由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F171中完成\n* 重构主服务器。调整","2025-12-16T23:51:13",{"id":231,"version":232,"summary_zh":233,"released_at":234},154559,"0.5.5","## 中文更新日志\n[主要更新]\n- 对**Agent前端**进行了大量翻新。现在Agent功能（键鼠&MCP）重新恢复支持。\n- 新增了Live2D参数调整（**捏人系统**），可以对模型的发饰、服饰、颜色等数据进行直接编辑\n- 锁定状态改为游戏模式，不再弹出菜单栏\n\n[次要更新]\n- 新增了可以改色的兽耳娘模型(credit: umijin68)\n- 阿里的对话模型已更新至**Qwen3-Omni-1201**最新版本\n- 现在任何状态下拖拽Live2D模型都会立即保存位置\n- 美化了前端图标，使用更美观的Icon以及呼吸灯特效\n- 现在菜单栏大小会自适应Live2D模型大小\n- 人设编辑变为多行输入模式，方便撰写小作文\n\n[Bug修复]\n- 修复了文本模式下，热重置意外使用语音session的bug\n- 修复了tts session在结束后没有手动结束的bug\n- 修复了一些与鼠标穿透有关的bug\n- 将端口监听由0.0.0.0改为**127.0.0.1回路**，提高了安全性；**手机直连用户请注意这一点**\n\n## 英文更新日志\n\n[主要更新]\n- 对Agent前端进行了大规模改进。Agent功能（键盘\u002F鼠标和MCP）现已重新支持。\n- 新增了Live2D参数自定义功能（角色捏造系统），可直接编辑模型的发饰、服装、颜色等数据。\n- 在锁定模式下，界面现切换为游戏模式，菜单栏将不再弹出。\n\n[次要更新]\n- 添加了一个可重新上色的兽耳娘Live2D模型（感谢umijin68提供）。\n- 将阿里巴巴的对话模型更新至最新的Qwen3-Omni-1201版本。\n- 现在无论处于何种状态，拖动Live2D模型都会立即保存其位置。\n- 改进了前端图标，采用更美观的设计，并加入了呼吸灯效果。\n- 菜单栏的大小现在会根据Live2D模型的尺寸自动调整。\n- 角色设定编辑现支持多行输入，便于撰写较长的文字描述。\n\n[Bug修复]\n- 修复了文本模式下热重载意外使用语音会话的Bug。\n- 修复了TTS会话结束后未被手动终止的问题。\n- 修复了多个与鼠标穿透相关的Bug。\n- 将端口监听地址由0.0.0.0改为**127.0.0.1回环地址**，以提高安全性——**使用手机直连的用户请注意这一点**。\n\n## 变更内容\n* 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F132中添加参数编辑器的多语言支持，并改进持久化表情处理。\n* 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F136中修复Live2D模型加载后立即消失的问题。\n* 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F137中为主人档案和猫娘档案的属性添加滚动条，方便阅读和修改。\n* 由@wehos在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F138中进行关键更新，以增强安全性并提升会话处理的稳定性。\n* 由@CN-QanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F139中新增模型位置和缩放的自动保存功能。\n* 由@Tonnodoubt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F140中修复motionManager.update和coreModel.update覆盖时的错误处理问题。\n* 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F142中修复自定义API模式下模型ID不保存及填写内容不显示的问题，并优化了模型设置页面的UI。\n* 由@CN-QanYi在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F143中修复Live2D参数重置逻辑错误。\n* 由@Chiya-mt在https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F146中修复模型设置页面中切换角色时不需点击保存也会自动保存的问题，并添加未保存提示。\n* 参数自定义界面点击左上角退出时会重新打开主页，而不是返回原主页，由@CN-Zephyr在https:\u002F\u002Fgithub.c中完成。","2025-12-07T03:48:34",{"id":236,"version":237,"summary_zh":238,"released_at":239},154560,"v0.5.4","## What's Changed\r\n- 集成Steamworks API。支持**创意工坊**和成就系统。\r\n- 重写的**Agent模式**，更快的响应速度。\r\n- 更加精简的依赖。现在发行版大小**仅 250MB** 。\r\n- 跨服务器同步由**多进程改为多线程**，提高了启动效率。\r\n- 调整了前端加载时序，有效减少了**前端竞态**问题。\r\n- 修复了一系列**i18n** bug，更新了API页面的说明。\r\n- 修改了初始人设、温度、系统设定，显著提升了**对话质量**。\r\n- 为所有LLM推理添加了有条件的**重试机制**。\r\n- 构建了**Docker容器**，可以在远程服务器\u002FNAS上部署。\r\n- 改善了**UI主题和样式**，请她离开后可以拖拽。\r\n\r\n此外修复了一百个Bug，已经写不动日志了。以下内容为自动生成，仅包含了PR部分。\r\n\r\n* Steamworks sdk added by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F89\r\n* Split live2d script. Improve live2d pointer event logic. by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F90\r\n* fix(交互): 修复按钮拖动与点击的冲突问题并优化返回按钮定位 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F88\r\n* feat: Add global window management to prevent duplicate window opening by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F92\r\n* Upgrade LangChain to 1.0: Simplify dependencies and improve performance by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F68\r\n* Update steam branch to latest main. by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F93\r\n* 当修改猫娘名称时猫娘记忆名称也一同修改 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F94\r\n* fix: Live2D 模型管理器进行了改进，重点在于用户偏好设置的持久化以及更佳的默认模型屏幕位置 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F95\r\n* refactor(Live2DManager): 移除自动保存功能并修复复位位置逻辑 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F98\r\n* 修复Agent开关项多次触发bug by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F97\r\n* Auto-initialize memory server for new characters and enable real-time chat recording by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F99\r\n* 修复构建时的python依赖文件的复制路径 by @WUHINS in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F100\r\n* 优化Live2D情绪系统和日志输出 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F102\r\n* Fixed Workshop page style, ui logic, remove hard coded dir etc. by @nantxcel in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F101\r\n* 确保i18n文件完全遵循了正确的模板变量格式，使用“{{}}”而不是“{}” by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F103\r\n* feat(ui): 为任务HUD添加拖拽和折叠功能 by @CN-Zephyr in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F106\r\n* Update entrypoint.sh，以健全docker容器启动，docker容器内置启动脚本 by @WUHINS in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F109\r\n* Update Dockerfile: Migrate to single-stage Debian-based build by @WUHINS in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F111\r\n* 用预构建镜像替换neko-main构建并简化docker编排 by @WUHINS in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F112\r\n* fix: Prevent text chat interruption when switching other characters' voice by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F110\r\n* Merge steam i18n to main by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F114\r\n* Updated i18n and minor fixes for steam. by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F117\r\n* docker编排镜像拉取标签更新 by @WUHINS in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F118\r\n* 上传模型时将动作文件中关于口型的部分都设置为空值 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F122\r\n* feat(LLMSessionManager): 支持角色切换时的音色热更新 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F123\r\n* fix(agent): 修复频繁切换Agent开关导致的竞态问题 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F124\r\n* feat(会话管理): 添加系统准备状态通知机制 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F127\r\n* Update steam achievements and workshop EULA by @wehos in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F128\r\n\r\n## New Contributors\r\n* @WUHINS made their first contribution in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F100\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcompare\u002Fv0.5.3...v0.5.4","2025-12-02T03:51:56",{"id":241,"version":242,"summary_zh":243,"released_at":244},154561,"v0.5.3","## What's Changed\r\n**提升了性能，添加了Win证书（不会再有未知发行者提示），增加了多语言适配（i18n）和开机自启动功能。修复了一百个Bug，已经改不动日志了。接下来进入Steam发售前的封闭开发期，不会再有Release。**\r\n\r\n* 调整API Key设置页面，可加入自定义API by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F40\r\n* Enhance Agent menu with real-time availability checking and improved UI by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F41\r\n* 解决了克隆并设置声音后无法切换为不使用克隆声音的问题 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F42\r\n* 猫娘档案的展开状态记录到localstorage以便刷新后自动展开 by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F43\r\n* Auto-delete memory files when deleting catgirl character by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F44\r\n* [FIX] 确保 lanlan_config.lanlan_name 更新到 chara_manager.html 当前选中的猫娘 by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F47\r\n* feat(交互): 新增\"请她回来\"功能并优化界面状态管理 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F51\r\n* 为角色设置页添加保存与取消按钮的显示逻辑使有修改后才显示 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F52\r\n* feat(ui): 统一按钮图标样式 by @CN-Zephyr in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F55\r\n* Fix mobile menu layout by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F56\r\n* Fix mobile chatbox layout by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F57\r\n* Migrate API providers and default models from hardcoded to JSON config by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F58\r\n* 将聊天框最小化背景回调为透明 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F59\r\n* 为live2d模型设置页添加全屏按钮 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F64\r\n* Complete i18next internationalization and optimize code structure by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F62\r\n* 回调部分对index.html的更改修复bug by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F66\r\n* Fix UI state synchronization issues when leaving and returning session by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F67\r\n* style: update input style in voice_clone.html by @xxynet in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F73\r\n* Fixed i18n functionality and optimized notification messages by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F72\r\n* UI Improve chat dialog button styling with custom icons and color scheme by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F76\r\n* feat(API配置): 为自定义API添加模型ID配置项 by @CN-QanYi in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F77\r\n* Fix i18n params issue with incorrect `{}` usage by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F78\r\n* fix: sync focusModeEnabled when returning from l2d page by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F80\r\n* fix live2d import default position by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F82\r\n* fix(api-settings): Improve API Key settings page loading logic and error handling by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F79\r\n* Fix settings popup checkbox visual state sync issue by @noahzaozao in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F85\r\n* fix(voice-clone): Fix timeout retry logic and improve error handling by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F84\r\n* 解决API设置页配置可能读取错误的问题 by @Chiya-mt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F83\r\n* fix: Improve microphone button state management and prevent duplicate… by @Tonnodoubt in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F86\r\n* 修复猫娘重影问题。修复窗口双重打开问题。\r\n* 通过恢复GPU整体渲染提升了性能表现。\r\n\r\n## New Contributors\r\n* @CN-Zephyr made their first contribution in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F55\r\n* @xxynet made their first contribution in https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fpull\u002F73\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FProject-N-E-K-O\u002FN.E.K.O\u002Fcompare\u002Fv0.5.2...v0.5.3","2025-11-25T05:16:21",{"id":246,"version":247,"summary_zh":248,"released_at":249},154562,"v0.5.2","我们对UI进行了一系列重大升级。Steam商店页已经在审核中！\r\n\r\n## What's Changed\r\n* [Important] UI remade, with a lot of art resources and visual improvement. Rebranded to N.E.K.O.\r\n* [UI Improvement] Autoselecting catgirl in memory review\r\n* [UI Improvement] Autoselecting catgirl in memory review. \r\n* [UI Improvement] Auto-filling core api key when setting up sup-api. \r\n* [UI Improvement] Auto-hiding the current l2d model when setting up new models. \r\n* [UI Improvement] Disable auto-folding when setting up catgirl property. \r\n* [UI Improvement] Auto-reloading catgirl when l2d is changed.\r\n* [Minor Improvement] More improvements and bug fixes with UI logics .\r\n\r\n## 中文版\r\n- [重要更新] UI再次重制，添加了大量美术资源并进行了视觉改进。名称重制为N.E.K.O.\r\n- [界面优化] 在记忆回顾中自动选择猫娘。\r\n- [界面优化] 在设置 sup-api 时自动填充核心 API 密钥。\r\n- [界面优化] 在设置新模型时自动隐藏当前的 L2D 模型。\r\n- [界面优化] 在设置猫娘属性时禁用自动折叠。\r\n- [界面优化] 当 L2D 模型更改时自动重新加载猫娘。\r\n- [优化] 进一步优化 UI 逻辑并修复了一些错误。\r\n\r\n## New Contributors\r\n* @CN-QanYi made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O\u002Fpull\u002F32\r\n* @nantxcel made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O\u002Fpull\u002F34\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O\u002Fcompare\u002Fv0.5.1...v0.5.2","2025-11-12T13:43:56",{"id":251,"version":252,"summary_zh":253,"released_at":254},154563,"v0.5.1","免费模型已上线！文本输入和主动对话已得到支持。这是项目更名为Project N.E.K.O.并转为LGPL协议前的最后一个版本。预计下周上架steam！\r\n\r\n## What's Changed\r\n- [Important] UI completely remade. \r\n- [Important] Launcher no longer needed for the one-click package.\r\n- [Important] Proactive mode added. Catgirl can now proactively engage in conversation.\r\n- [Functionality] Monitor server added for cross-device sync.\r\n- [Functionality] Store voice IDs for reuse.\r\n- [Functionality] Support vision for non-visual model (e.g., free, Step) and text input mode. \r\n- [Functionality] Live2D can now be dragged to resize on mobile devices. \r\n- [Bug fixed] Fixed one issue with hot swap\r\n- [Minor Improvement] Added icon for the webpage.\r\n- [Minor Improvement] Change system prompt to reduce repetition.\r\n- [Minor Improvement] Autofolding dialogue window.\r\n\r\n\r\n## 中文版\r\n- [重要更新] UI完全重置，带来全新的用户体验！\r\n- [重要更新] 一键包不再包含外置启动器。现在可以真·一键启动。\r\n- [重要更新] 新增主动对话模式，允许猫娘主动搭话。\r\n- [新功能] 观察者服务器现在已可用，提供跨设备同步输出的功能。\r\n- [新功能] 声音ID会被储存以供复用。\r\n- [新功能] 非视觉模型也可以支持视觉。文本输入模式新增截图功能。\r\n- [新功能] 手机上Live2D模型现在可以被拖拽缩放。\r\n- [Bug修复] 修复了热切换导致的一个Bug。\r\n- [优化] 网页现在有Icon图标了。\r\n- [优化] 通过调整系统提示词，减少了复读的情况。\r\n- [优化] 文本输入框现在会自动折叠。\r\n\r\n## New Contributors\r\n* @jihu33 made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O.\u002Fpull\u002F22\r\n* @Tonnodoubt made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O.\u002Fpull\u002F26\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FN.E.K.O.\u002Fcompare\u002Fv0.5.0...v0.5.1","2025-11-09T04:30:14",{"id":256,"version":257,"summary_zh":258,"released_at":259},154567,"v0.3.2","## What's Changed\r\n* [Functionality] Support emotion-aware motions and expressions for l2d models.\r\n* [Functionality] Reimplemented live2d management page for configuring motions and expressions.\r\n* [Functionality] Common backend error message now being pushed to the frontend.\r\n* [Functionality] There is a new lock icon to unlock l2d model for dragging and zooming.\r\n* [Functionality] When and only when the mouse cursor is close to l2d model, the model will focus on it.\r\n* [Bug Fixed] Frontend (switch to mobile phone) now properly works without blocking windows.\r\n* [Bug Fixed] No more occasional upper frame with the frontend. \r\n* [Bug Fixed] Recent summary now can be edited in the memory browser.\r\n* [Bug Fixed] Cargirl can now have properties that share the same name with the master.\r\n\r\n## New Contributors\r\n* @wehos made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F10\r\n* @Chiya-mt made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F13\r\n\r\n## 中文版\r\n* [新功能] Live2D 模型现在会根据情绪做出动作和表情。\r\n* [新功能] 为 Live2D 模型制作了新的动作和表情管理界面。\r\n* [新功能] 常见的后端错误信息现在会推送至前端显示。\r\n* [新功能] 新增了一个锁定图标，用于解锁 Live2D 模型以进行拖动和缩放。\r\n* [新功能] 仅当鼠标光标靠近 L2D 模型时，模型才会注视光标。\r\n* [Bug 修复] 修复了前端切换到手机模式时会阻挡其他窗口的问题。\r\n* [Bug 修复] 移除了前端界面偶尔出现的上边框。\r\n* [Bug 修复] 现在可以在记忆浏览器中编辑近期摘要。\r\n* [Bug 修复] 猫娘现在可以拥有与主人同名的属性。\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.3.1...v0.3.2","2025-08-07T21:30:15",{"id":261,"version":262,"summary_zh":263,"released_at":264},154568,"v0.3.1","# What's Changed\r\n- [Bug Fixed] Custom voice backed by Qwen API now works with other core APIs.\r\n- [Functionality] Custom voice no longer produces popping sound.\r\n- [Functionality] Change api key format reminder from error to reminder, accommodating Zhipu API key.\r\n- [Functionality] Increased computation budget for large L2D models.\r\n\r\n# 中文版\r\n- 【Bug修复】使用其他核心API时，千问+自定义语音现在可以正常工作了\r\n- 【功能性】由于新增的缓冲区，自定义语音不再因小chunk产生噗噗声。\r\n- 【功能性】智谱的api key不再产生错误，只产生警告。\r\n- 【功能性】通过提升渲染器个数，支持了遮罩数量更多的l2d模型。\r\n- 【额外】在github发布页新增了图文教程和手机版教程。\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.3.0...v0.3.1","2025-07-24T06:44:34",{"id":266,"version":267,"summary_zh":268,"released_at":269},154569,"v0.3.0","## What's Changed\r\n### Important Updates\r\n* [Bug Fixed] Auto-reconnection now properly works. Previously broken due to incorrect frontend protocol.\r\n* [Bug Fixed] Catgirl config can now be properly removed. by @lanzilan827 in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F5\r\n* [New Feature] **Memory auto-correction** implemented. The system will now automatically review recent history.\r\n* [New Feature] **Memory browser** implemented. The user can now manually review recent history.\r\n* [New Feature] **API switchers** implemented.  Users can choose from Qwen, Zhipu (ChatGLM), and OpenAI.\r\n* [New Feature] **Focus mode** implemented, where Catgirl can not be interrupted.\r\n* [New Feature] **Silent mode** implemented, where Catgirl disconnects from the audio session but keepsLive2D displaying.\r\n* [New Feature] Mobile phone setup instructions (One-click Package Only.)\r\n\r\n### Other updates\r\n* [Bug Fixed] Memory summary sometimes raises an error due to incorrect json format.\r\n* [Functionality] Hide \"Add Catgirl\" button from character manager UI by @lanzilan827 in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F3\r\n* [Functionality] Menu auto-folding by @a2942 in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F4\r\n* [Functionality] Added compatibility for preinstalled system Python \u002F Windows with incorrect mimetype system config.\r\n* [Functionality] Added voice_id removal button.\r\n\r\n## 中文版\r\n### 重要更新\r\n* 【Bug修复】自动重连功能现已正常工作。此前因前端协议错误导致失效。\r\n* 【Bug修复】现在可以正常删除猫娘属性。\r\n* 【新功能】实现**记忆自动校正**。AI将自动回顾最近历史记录并进行修正。\r\n* 【新功能】新增**记忆浏览器**。用户现在可以手动查看最近的历史记录。\r\n* 【新功能】新增**API 切换器**。用户可以从阿里、智谱、OpenAI中选择一个。\r\n* 【新功能】新增**专注模式**，该模式下猫娘说话无法被用户打断。\r\n* 【新功能】新增**挂机模式**，该模式下猫娘不再响应语音，但保持Live2D模型在桌面。\r\n* 【新功能】新增手机版本的安装指南（仅限一键包）。\r\n\r\n### 其他更新\r\n* 【Bug修复】记忆摘要有时因 JSON 格式错误导致报错。\r\n* 【功能性】在角色管理器界面隐藏“新增猫娘”按钮。\r\n* 【功能性】菜单自动折叠。\r\n* 【功能性】增加对系统预装 Python \u002F Windows错误mimetype注册表 的兼容性。\r\n* 【功能性】新增 voice_id 删除按钮。\r\n\r\n## New Contributors\r\n* @a2942 made their first contribution in https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fpull\u002F4\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fwehos\u002FXiao8\u002Fcompare\u002Fv0.2.1...v0.3.0","2025-07-17T19:22:00"]