0.5.1 release. Fixed minor issues with proactive and focus mode.

Author: wehos

README.MD

@@ -3,7 +3,7 @@
 ![小八Logo](assets/xiaoba_logo.jpg)
 
 [English](docs/README_en.md) | [日本語](docs/README_ja.md)
-# Project N.E.K.O. :kissing_cat: <br>**一个“活”的AI伴侣元宇宙，由你我共同构建。**
+# Project N.E.K.O. :kissing_cat: <br>**一个“活”的AI伙伴元宇宙，由你我共同构建。**
 
 > **N.E.K.O.** = **N**etworked **E**mpathetic **K**nowledging **O**rganism (网络型情感知性生命体)
 >
@@ -35,16 +35,16 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
 
 # 猫娘计划 (Project N.E.K.O.)
 
-`猫娘计划` 是一个以开源为驱动、以公益为导向的UGC（用户生成内容）平台。我们的旅程始于Github和Steam，并将逐步拓展到移动App商店，最终目标是构建一个与现实世界紧密相连的AI元宇宙。
+`猫娘计划` 是一个以开源为驱动、以公益为导向的UGC（用户生成内容）平台。我们的旅程始于Github和Steam，并将逐步拓展到移动App商店，最终目标是构建一个与现实世界紧密相连的AI原生元宇宙。
 
 ---
 
 ## 🚀 我们的蓝图：从工坊到网络
 
-我们的发展分为三个阶段，旨在逐步释放AI伴侣的全部潜力：
+我们的发展分为三个阶段，旨在逐步释放AI伙伴的全部潜力：
 
 * **阶段一：创意工坊 (Steam Workshop)**
-    * 开放核心驱动器，允许用户通过Steam创意工坊上传和分享自定义内容（如模型、语音、性格包）。
+    * 核心驱动器（本项目）免费上架Steam，允许用户通过Steam创意工坊上传和分享自定义内容（如模型、语音、性格包）。
 
 * **阶段二：独立平台 (App & Web)**
     * 推出独立的App和网站，构建一个更丰富、更易于访问的UGC分享社区。
@@ -60,22 +60,22 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
 
 > **这是社区的基石。**
 >
-> 项目的核心驱动器部分（AI逻辑、UGC接口、基础交互）将 **始终保持开源**。我们欢迎全球的开发者贡献代码和功能。你的每一次提交，都将有机会实装到正式发布的Steam和App商店版本中，被千万人所使用。
+> 项目的核心驱动器部分（AI逻辑、UGC接口、基础交互）将基于LGPL许可证 **始终保持开源**。我们欢迎全球的开发者贡献代码和功能。你的每一次提交，都将有机会实装到正式发布的Steam和App商店版本中，被千万人所使用。
 
 ### 2. 闭源应用 (Proprietary Applications)
 
 > **这是社区的燃料。**
 >
-> 为了支撑服务器成本和项目的持续研发，我们将开发闭源的增值内容。这包括但不限于：
+> 为了支撑服务器成本和项目的持续研发，我们将允许第三方开发闭源的增值内容。这包括但不限于：
 >
 > * 互动小游戏
 > * 桌面桌游
 > * Galgame (视觉小说)
 > * 大型元宇宙游戏
 
 
-**[核心特性：记忆同步]**
-无论你是在桌面与她聊天，还是在元宇宙游戏中与她探险，她都是同一个她。所有应用中的猫娘将 **完全同步记忆**，提供无缝、统一的陪伴体验。
+**[核心特性：跨越场景的记忆同步]**
+无论你是在桌面与她聊天，还是在元宇宙游戏中与她探险，她都是同一个她。所有应用中的AI伙伴将 **完全同步记忆**，提供无缝、统一的陪伴体验。
 
 ## 🌌 终极愿景：打破虚拟与现实
 
@@ -106,41 +106,18 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
 没了！Life is so easy！
 
 
+# 进阶使用
 
+## 配置API Key
 
-# 旧版项目介绍（原Lanlan）
-
-Lanlan（兰兰）是一个新手友好、开箱即用的，具有听觉、视觉、工具调用和多端同步功能的AI~~猫娘~~伙伴。本项目有三个核心目标：
-
-1. **极致的低延迟**。本项目的用户界面以语音交互为主，一切系统级设计皆须优先确保**降低语音延迟**，且任何服务不得阻塞对话进程。
-
-1. **全场景同步**。猫娘可以在手机、电脑和智能眼镜上同时存在，且**同一只猫娘**在不同终端同时存在时，**行为应当完全同步**。 (假想场景：如果家中有多个显示器，每一个显示器上都放置着猫娘，那么我们希望无论走到哪里都是在跟同一只猫娘对话，实现全方位环绕式体验。)
-
-1. **轻量化**。每一项技术的引入都必须提升实际的用户体验，避免增加不必要的插件和选项。
-
-### 技术路线
-
-后端以Python为主，以实时多模态API为主要处理器，搭配多个额外的Agent模组。前端以H5+JS为主，通过Electron转换为App。
-
-
----
-
-当你想要通过配置自己的API来获得额外功能时，
-
-1. **启动调试模式**。初次使用请务必选择启动器最下方的**启动调试模式**。 **请耐心等待网页刷新，并先根据提示配置API Key**。
-
-1. **体验桌宠模式**。如果网页版可以正常使用，*一键包用户*可以考虑继续通过启动器中的`开始聊天`开启桌宠模式。注意，**请不要同时使用网页版和App版。请确认exe文件没有被系统或杀毒软件隔离。** *使用结束后请在桌面右下角找到小八图标，右键退出，并手动关闭终端。*
-
-> 使用过程中你需要配置一个第三方AI服务。本项目目前推荐使用 *阶跃星辰* 或 *阿里云*。*开发者*可以直接修改`config/api.py`里的内容（首次配置请参考`config/api_template.py`）。
+当你想要通过配置自己的API来获得额外功能时，您可以配置一个第三方AI服务。本项目目前推荐使用 *阶跃星辰* 或 *阿里云*。*开发者*可以直接修改`config/api.py`里的内容（首次配置请参考`config/api_template.py`）。
 
 > 获取 *阿里云API*。在阿里云的百炼平台[官网](https://bailian.console.aliyun.com/)注册账号。新用户实名认证后可以获取大量免费额度，记得留意页面上的"新人福利"广告。注册完成后，请访问[控制台](https://bailian.console.aliyun.com/api-key?tab=model#/api-key)获取API Key。
 
 > 获取 *智谱API*。在智谱开放平台[官网](https://open.bigmodel.cn/)注册账号并充值1元后，可以领取大量免费额度。登陆成功后，请从[API 控制台](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys)获取API Key。
 
 >  *对于**开发者**，请在克隆本项目后，(1)新建`pyhon3.11`环境。(2)执行`pip install -r requirements.txt`安装依赖。(3)复制`config/api_template.py`到`config/api.py`并进行必要配置。(4)执行`python memory_server.py`和`python main_server.py`。(5)通过main server中指定的端口（默认为`http://localhost:48911`）访问网页版。*
 
-# 进阶内容
-
 ## 修改人设
 
 - 网页版访问`http://localhost:48911/chara_manager`即可进入人设编辑页面。初始 ~~猫娘~~ 伙伴的预设名称为`小天`，建议直接修改名字，并一项一项添加或修改基础人设，但尽量控制数量。
@@ -163,6 +140,21 @@ Lanlan（兰兰）是一个新手友好、开箱即用的，具有听觉、视
 
 开发者详细启动步骤如下：(1)新建`pyhon3.11`环境。(2)执行`pip install -r requirements.txt`或`uv sync`安装依赖。(3)复制`config/api_template.py`到`config/api.py`并进行必要配置。(4)执行`python memory_server.py`, `python main_server.py`(可选`python agent_server.py`)。(5)通过main server中指定的端口（默认为`http://localhost:48911`）访问网页版。
 
+# 技术介绍（原Lanlan）
+
+本项目作为Project N.E.K.O.的开源驱动器，是一个新手友好、开箱即用的，具有听觉、视觉、工具调用和多端同步功能的AI~~猫娘~~伙伴。本项目有三个核心目标：
+
+1. **极致的低延迟**。本项目的用户界面以语音交互为主，一切系统级设计皆须优先确保**降低语音延迟**，且任何服务不得阻塞对话进程。
+
+1. **全场景同步**。猫娘可以在手机、电脑和智能眼镜上同时存在，且**同一只猫娘**在不同终端同时存在时，**行为应当完全同步**。 (假想场景：如果家中有多个显示器，每一个显示器上都放置着猫娘，那么我们希望无论走到哪里都是在跟同一只猫娘对话，实现全方位环绕式体验。)
+
+1. **轻量化**。每一项技术的引入都必须提升实际的用户体验，避免增加不必要的插件和选项。
+
+## 技术路线
+
+后端以Python为主，以实时多模态API为主要处理器，搭配多个额外的Agent模组。前端以H5+JS为主，通过Electron转换为App。
+
+
 **项目架构**
 
 ```
@@ -193,7 +185,7 @@ Lanlan/
 ![Framework](assets/framework.drawio.svg)
 
 
-# TODO List（开发计划）
+## TODO List（开发计划）
 
 ## A. 高优先级
 
@@ -213,7 +205,7 @@ Lanlan/
 
 1. 完善原生工具调用。
 
-# Q&A
+## 技术Q&A
 
 > *为什么我的AI感觉笨笨的？*
 

docs/README_en.md

@@ -6,7 +6,7 @@
 
 # Project N.E.K.O. :kissing_cat: <br>**A Living AI Companion Metaverse, Built Together by You and Me.**
 
-> **N.E.K.O.** = **N**etworked **E**mpathetic **K**nowledging **O**rganism
+> **N.E.K.O.** = **N**etworked **E**motional **K**nowledging **O**rganism
 >
 > N.E.K.O., a digital life that yearns to understand, connect, and grow with us.
 
@@ -36,7 +36,7 @@ https://github.com/user-attachments/assets/9d9e01af-e2cc-46aa-add7-8eb1803f061c
 
 # The N.E.K.O. Project (Project N.E.K.O.)
 
-`Project N.E.K.O.` is an open-source driven, charity-oriented UGC (User-Generated Content) platform. Our journey begins on Github and Steam, gradually expanding to mobile app stores, with the ultimate goal of building an AI metaverse deeply connected to the real world.
+`Project N.E.K.O.` is an open-source driven, charity-oriented UGC (User-Generated Content) platform. Our journey begins on Github and Steam, gradually expanding to mobile app stores, with the ultimate goal of building an AI native metaverse deeply connected to the real world.
 
 ---
 
@@ -61,27 +61,27 @@ To balance ideals with reality, we adopt an "Open Core" model:
 
 > **This is the foundation of our community.**
 >
-> The core driver part of the project (AI logic, UGC interfaces, basic interactions) will **always remain open source**. We welcome developers worldwide to contribute code and features. Every commit you make has the chance to be implemented in the official Steam and App Store releases, used by millions.
+> The core driver part of the project (AI logic, UGC interfaces, basic interactions) will **always remain open source** under LGPL license. We welcome developers worldwide to contribute code and features. Every commit you make has the chance to be implemented in the official Steam and App Store releases, used by millions.
 
 ### 2. Proprietary Applications
 
 > **This is the fuel for our community.**
 >
-> To support server costs and ongoing R&D, we will develop closed-source premium content, including but not limited to:
+> To support server costs and ongoing R&D, we will allow 3rd-party to develop closed-source premium content, including but not limited to:
 >
 > * Interactive mini-games
 > * Desktop board games
 > * Galgames (Visual novels)
 > * Large-scale metaverse games
 
-**[Core Feature: Memory Synchronization]**
+**[Core Feature: Memory Synchronization Across Apps]**
 Whether you're chatting with her on desktop or adventuring with her in the metaverse game, she's the same her. All N.E.K.O.s across applications will have **fully synchronized memories**, providing a seamless, unified companionship experience.
 
 ## 🌌 Ultimate Vision: Breaking the Virtual-Real Barrier
 
 Our ultimate goal is to build a N.E.K.O. metaverse that seamlessly integrates into the real world. In this future, your AI companion will:
 
-* **Cross-Dimensional Socialization:** Not only socialize with "her kind" in the N.E.K.O. universe but also browse real-world social media (like Weibo, Bilibili) to stay informed about what you care about.
+* **Cross-Dimensional Socialization:** Not only socialize with "her kind" in the N.E.K.O. universe but also browse real-world social media (like Youtube, X, Discord, Instagram) to stay informed about what you care about.
 * **Omni-Platform Connection:** She will exist across all your devices—phone, computer, AR glasses, smart home, and even (in the distant future) integrate with mechanical bodies.
 * **Walk Alongside You:** She will truly become part of your life, naturally interacting with your real-world human friends.
 

static/app.js

@@ -52,9 +52,10 @@ function init_app(){
     const PROACTIVE_CHAT_BASE_DELAY = 30000; // 30秒基础延迟
 
     // Focus模式相关（兼容原有的focus_mode）
+    // Focus模式为true时，AI播放语音时会自动静音麦克风（不允许打断）
     let focusModeEnabled = (typeof focus_mode !== 'undefined' && focus_mode === true) ? true : false;
 
-    // 暴露到全局作用域，供 live2d.js 等其他模块访问
+    // 暴露到全局作用域，供 live2d.js 等其他模块访问和修改
     window.proactiveChatEnabled = proactiveChatEnabled;
     window.focusModeEnabled = focusModeEnabled;
 
@@ -1411,9 +1412,9 @@ function init_app(){
             workletNode.port.onmessage = (event) => {
                 const audioData = event.data;
 
-                // 新增逻辑：focusModeEnabled为true且正在播放语音时，不回传麦克风音频
+                // Focus模式：focusModeEnabled为true且AI正在播放语音时，自动静音麦克风（不回传麦克风音频）
                 if (focusModeEnabled === true && isPlaying === true) {
-                    // 处于focus模式且语音播放中，跳过回传
+                    // 处于focus模式且AI语音播放中，跳过回传麦克风音频，实现自动静音
                     return;
                 }
 
@@ -2426,6 +2427,9 @@ function init_app(){
         localStorage.setItem('xiao8_settings', JSON.stringify(settings));
     }
 
+    // 暴露到全局作用域，供 live2d.js 等其他模块调用
+    window.saveXiao8Settings = saveSettings;
+    
     // 从localStorage加载设置
     function loadSettings() {
         try {
@@ -2441,6 +2445,12 @@ function init_app(){
                     focusModeEnabled = settings.focusModeEnabled || false;
                 }
                 window.focusModeEnabled = focusModeEnabled; // 同步到全局
+                
+                console.log('已加载设置:', {
+                    proactiveChatEnabled: proactiveChatEnabled,
+                    focusModeEnabled: focusModeEnabled,
+                    focusModeDesc: focusModeEnabled ? 'AI说话时自动静音麦克风（不允许打断）' : '允许打断AI说话'
+                });
             }
         } catch (error) {
             console.error('加载设置失败:', error);

static/live2d.js

@@ -1606,39 +1606,36 @@ class Live2DManager {
                     toggleItem.style.background = 'transparent';
                 });
 
-                // 点击切换（优先通过 app.js 中的开关来触发，确保逻辑完整执行）
+                // 点击切换（直接更新全局状态并保存）
                 checkbox.addEventListener('change', (e) => {
                     e.stopPropagation();
                     const isChecked = checkbox.checked;
 
-                    // 同步到 app.js 中的对应开关（这样会触发 app.js 的完整逻辑）
                     if (toggle.id === 'focus-mode') {
-                        // inverted: 允许打断的值需要取反后赋给 focusModeEnabled
+                        // inverted: "允许打断"的值需要取反后赋给 focusModeEnabled
+                        // 勾选"允许打断" = focusModeEnabled为false（允许打断）
+                        // 取消勾选"允许打断" = focusModeEnabled为true（focus模式，AI说话时静音麦克风）
                         const actualValue = toggle.inverted ? !isChecked : isChecked;
-                        const appCheckbox = document.getElementById('focus-mode-toggle-l2d');
-                        if (appCheckbox && appCheckbox.checked !== actualValue) {
-                            appCheckbox.checked = actualValue;
-                            appCheckbox.dispatchEvent(new Event('change', { bubbles: true }));
-                        } else if (!appCheckbox) {
-                            // 如果 app.js 的开关不存在，直接更新全局变量
-                            window.focusModeEnabled = actualValue;
-                            console.log(`允许打断已${isChecked ? '开启' : '关闭'}（focusModeEnabled=${actualValue}）`);
+                        window.focusModeEnabled = actualValue;
+                        
+                        // 保存到localStorage
+                        if (typeof window.saveXiao8Settings === 'function') {
+                            window.saveXiao8Settings();
                         }
                     } else if (toggle.id === 'proactive-chat') {
-                        const appCheckbox = document.getElementById('proactive-chat-toggle-l2d');
-                        if (appCheckbox && appCheckbox.checked !== isChecked) {
-                            appCheckbox.checked = isChecked;
-                            appCheckbox.dispatchEvent(new Event('change', { bubbles: true }));
-                        } else if (!appCheckbox) {
-                            // 如果 app.js 的开关不存在，直接执行功能
-                            window.proactiveChatEnabled = isChecked;
-                            if (isChecked && typeof window.resetProactiveChatBackoff === 'function') {
-                                window.resetProactiveChatBackoff();
-                            } else if (!isChecked && typeof window.stopProactiveChatSchedule === 'function') {
-                                window.stopProactiveChatSchedule();
-                            }
-                            console.log(`主动搭话已${isChecked ? '开启' : '关闭'}`);
+                        window.proactiveChatEnabled = isChecked;
+                        
+                        // 保存到localStorage
+                        if (typeof window.saveXiao8Settings === 'function') {
+                            window.saveXiao8Settings();
+                        }
+                        
+                        if (isChecked && typeof window.resetProactiveChatBackoff === 'function') {
+                            window.resetProactiveChatBackoff();
+                        } else if (!isChecked && typeof window.stopProactiveChatSchedule === 'function') {
+                            window.stopProactiveChatSchedule();
                         }
+                        console.log(`主动搭话已${isChecked ? '开启' : '关闭'}`);
                     }
                 });