neuro-simulator 0.6.1__tar.gz → 0.6.2__tar.gz

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuro_simulator
-Version: 0.6.1
+Version: 0.6.2
 Summary: Neuro Simulator Server
 Project-URL: Homepage, https://github.com/Moha-Master/neuro-simulator
 Project-URL: Repository, https://github.com/Moha-Master/neuro-simulator
@@ -41,14 +41,14 @@ Description-Content-Type: text/markdown
 
 *本临时README和所有代码均由AI生成*
 
-Neuro Simulator 是一个模拟 Neuro-sama 直播的项目  
-它通过调用 Letta（一个为 LLM 添加自主记忆功能的项目），也可使用自带的有记忆 Agent，配合其他 LLM 服务生成的模拟观众，模拟一场 Neuro-sama 的 Just Chatting 直播  
-它能生成实时的虚拟聊天内容，并通过 TTS 合成语音，提供沉浸式的 Twitch vedal987 频道观看体验  
+Neuro Simulator 是一个模拟 Neuro-sama 直播的项目。  
+它通过使用自带的有记忆 Agent，~~也可调用 Letta（一个为 LLM 添加自主记忆功能的项目）~~，以及相同构造的 Chatbot Agent 作为虚拟观众，模拟一场 Neuro-sama 的 Just Chatting 直播。  
+它能生成实时的虚拟聊天内容，并通过 TTS 合成语音，提供沉浸式的 Twitch vedal987 频道观看体验。  
 
 ## 特性
 
-和其他大佬的类似项目不同，本项目的重点在于尽可能模拟 Neuro-sama 在 Twitch 上的 Tuesday Stream，因此不会有太多的自定义部分  
-后续有低成本低性能方法实现 Evil 音色模仿的时候，可能加入 Evil 的 Just Chatting 乃至各种主题的 Twin Stream
+和其他类似的 AI Vtuber 项目不同，本项目旨在尽可能模拟 Neuro-sama 于 Twitch 上的 Tuesday Stream，因此在 Vtuber 部分不会有太多的自定义部分，也不会考虑引入 Neuro/Evil 以外的 Live2D。  
+后续有低成本低性能方法实现 Evil 音色模仿的时候，可能加入 Evil Neuro。
 
 ### 预览
 
@@ -60,44 +60,44 @@ Neuro Simulator 是一个模拟 Neuro-sama 直播的项目
 
 ### 核心亮点
 
-- **多客户端支持**：支持多个客户端连接，实时广播内容
-- **配置热重载**：通过 Web 控制面板修改和热重载配置
-- **双 Agent 模式**：支持 Letta Agent 和内建 Agent，提供更多自定义选项
-- **Agent 记忆管理**：内建 Agent 支持多种记忆类型（初始化记忆、核心记忆、临时记忆、上下文）
+- **多客户端支持**：支持多个客户端连接，实时广播内容。
+- **配置热重载**：通过 Web 控制面板实时修改和热重载配置。
+- ~~**双 Agent 模式**：支持 Letta Agent 和内建 Agent，提供更多自定义选项~~ 对 Letta Agent 的支持暂时下线，后续有缘再见。
 
 ## 快速开始
 
-1.  **准备外部服务**：确保你拥有必要的 API 密钥，包括 LLM（Gemini/OpenAI）和 Azure TTS；如果使用 Letta，也请注册好相关的 API
-2.  **安装服务端**：
+1.  **准备外部服务**：确保你拥有必要的 API 密钥，包括 LLM（Gemini/OpenAI）和 Azure TTS；~~如果使用 Letta，也请注册好相关的 API 。~~
+2.  **安装服务端**：已上传至 PyPi 作为可用 pip 安装的软件包，你可以用任何一个 pip 安装到全局或 venv 中。
     ```bash
     pip install neuro-simulator
     ```
+    推荐使用 pipx，可以在不更改系统 Python 依赖的情况下直接安装为全局软件。
+
 3.  **运行服务端**：
     ```bash
     neuro
     ```
-    记得填写好配置目录中的 `config.yaml`
-      - 不指定 `--dir` 则自动创建和默认使用 `~/.config/neuro-simulator/` 作为工作目录
-      - 在默认或指定目录及需要的文件不存在时，程序会自动用自带模板复制一份到工作目录下
+    现在无需手动填写 `config.yaml`，程序在启动时会自动创建一份包含默认设置的配置文件，只需在管理面板中填写和为 Agent 分配 API 服务商即可。
+      - 不指定 `--dir, -D` 则自动创建和默认使用 `~/.config/neuro-simulator/` 作为工作目录。
+      - 程序会在工作目录下自动生成文件夹结构，拷贝需要的文件到目录内，保持程序包本体只读。
 
-4.  **安装客户端**：
-    ```bash
-    cd client
-    npm install
-    ```
-5.  **运行客户端**：
-    ```bash
-    npm run dev
-    ```
-6.  **部署控制面板**：
-    ```bash
-    cd dashboard_web
-    python -m http.server 8080
-    ```
+    程序启动后，如果工作正常，会默认在 `http://127.0.0.1:8000` 提供对外服务，你可以在设置中修改这个端口。
+
+4.  **打开管理面板**：现在程序已经内置管理面板，直接在浏览器中打开 `http://127.0.0.1:8000/dashboard/` 即可，内置面板会自动连接到服务端。
+
+    **配置流程**：
+      1. 在管理面板中打开“配置”页面。
+      2. 在“LLM服务商”中添加一个以上的选项。
+      3. 在“TTS服务商”中添加一个以上的 Azure TTS 服务。
+      4. 在“Neuro”中分配一个 LLM 服务商和一个 TTS 服务商。
+      5. 在“Chatbot”中分配一个 LLM 服务商。
+
+5.  **打开客户端**：现在程序已经内置客户端，在浏览器中访问 `<http协议>://<服务端地址>/` 即可。  
+    但是这种方式下自动从哔哩哔哩获取最近回放的功能似乎不工作，需要对哔哩哔哩 API 进行反代。如果你安装了 nodejs，则可以使用 npm 运行开发服务器的方式使用客户端。
 
 更多更复杂或者更简单的使用方式，请参见三个部分的详细文档
 
-## 项目结构
+## 项目结构（稍微过时，待更新）
 
 ```
 Neuro-Simulator/
@@ -117,7 +117,6 @@ Neuro-Simulator/
 
 - [服务端 README](server/README.md)
 - [客户端 README](client/README.md)
-- [控制面板 README](dashboard_web/README.md)
 
 ## 开发计划和已实现功能
 
@@ -141,7 +140,7 @@ Neuro-Simulator/
         - [ ] 模块化热插拔工具
         - [ ] 连接到 MCP 服务器
         - [ ] 兼容 Offical [Neuro SDK](https://github.com/VedalAI/neuro-sdk)
-    - [ ] 拉起和对话 Evil Agent
+    - [ ] 拉起 Evil Agent 并进行对话
   - [ ] Evil Agent 模块，~~卖掉了~~ 待 Neuro Agent 完善、有低成本低性能方法实现 Evil 音色模仿的时候加入
   - [ ] 对 Neuroverse 更多成员的 AI Agent 复现，进而允许 Neuro Agent 向其发送 DM（语音聊天可能不太现实）
   - [x] Chatbot 模块
@@ -150,8 +149,8 @@ Neuro-Simulator/
       - [x] prompt 编辑
       - [x] 调用 Gemini 和 OpenAI API 格式的LLM
       - [x] 基于 Neuro Agent 的上一句内容而做出 Reaction
-      - [ ] ~~在 prompt 中包含直播标题等更多信息~~ 将在更详细的 Chatbot Agent 中实现
-      - [x] ~~实现更长的上下文~~ 将在更详细的 Chatbot Agent 中实现
+      - [ ] ~~在 prompt 中包含直播标题等更多信息~~ 将在更强大的 Chatbot Agent 中实现
+      - [x] ~~实现更长的上下文~~ 将在更强大的 Chatbot Agent 中实现
     - [x] Chatbot Agent
       - [x] 更好的用户名生成逻辑
       - [x] 更长的上下文，包括自身输出和 Neuro Agent 内容
@@ -171,7 +170,7 @@ Neuro-Simulator/
   - [x] TTS 合成和推送
     - [x] Azure TTS
     - [ ] 待定 TTS
-    - [ ] 剔除 Emoji 等特殊字符
+    - [X] 剔除 Emoji 等特殊字符
   - [x] 进行直播和直播环节
     - [x] Just Chatting 单人直播
       - [x] Neuro Stream
@@ -191,8 +190,8 @@ Neuro-Simulator/
     - [x] 直播标题和标签等信息
   - [ ] 在非直播的空闲时间自动获取真实世界中 Neuro 的近期直播内容，更新完善记忆内容（不是微调训练）
   - [ ] 对 Ollama 等本地 LLM 的优化
-  - [ ] 服务端内嵌管理面板
-    - [ ] Web 控制面板
+  - [x] 服务端托管管理面板
+    - [x] Web 控制面板
     - [ ] 使用 PyInquiry 的命令行面板
 - 客户端
   - [ ] 仅包含直播区域的客户端，适用于希望使用 OBS 或其他软件推流画面的用户
@@ -237,6 +236,7 @@ Neuro-Simulator/
     - [ ] 真实的主播首页竖屏模式界面（目前沿用针对竖屏优化过的横屏样式）
     - [ ] 下滑的更多主播信息
     - [ ] 其他次级页面
+  - [x] 服务端托管客户端
   - [ ] 更多客户端（若实现原生客户端则弃用 tauri）
     - [x] 可托管的 Web 静态页面
     - [x] Windows 客户端
@@ -260,7 +260,6 @@ Neuro-Simulator/
       - [x] 对话方式展现
       - [x] 上下文方式展现
       - [x] 实时更新
-      - [x] 更好的界面
       - [ ] 可视化展现 Agent 的详细执行流程
     - [x] 实时日志查看
       - [ ] 按照等级进行日志筛选 
@@ -270,7 +269,6 @@ Neuro-Simulator/
       - [ ] 工具管理取决于服务端开发进度
 - 杂项，有一些可能永远不会实现，有一些可能很快就能完成
   - [ ] 一键启动器和整合包，适用于不需要分开部署的情况，或者面向普通小白用户
-  - [ ] 把三个项目模块整合为一个
   - [ ] 基于静态立绘制作的简易Live2D，能动就行
   - [x] 目前不会考虑语音输入
 

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/README.md

@@ -4,14 +4,14 @@
 
 *本临时README和所有代码均由AI生成*
 
-Neuro Simulator 是一个模拟 Neuro-sama 直播的项目  
-它通过调用 Letta（一个为 LLM 添加自主记忆功能的项目），也可使用自带的有记忆 Agent，配合其他 LLM 服务生成的模拟观众，模拟一场 Neuro-sama 的 Just Chatting 直播  
-它能生成实时的虚拟聊天内容，并通过 TTS 合成语音，提供沉浸式的 Twitch vedal987 频道观看体验  
+Neuro Simulator 是一个模拟 Neuro-sama 直播的项目。  
+它通过使用自带的有记忆 Agent，~~也可调用 Letta（一个为 LLM 添加自主记忆功能的项目）~~，以及相同构造的 Chatbot Agent 作为虚拟观众，模拟一场 Neuro-sama 的 Just Chatting 直播。  
+它能生成实时的虚拟聊天内容，并通过 TTS 合成语音，提供沉浸式的 Twitch vedal987 频道观看体验。  
 
 ## 特性
 
-和其他大佬的类似项目不同，本项目的重点在于尽可能模拟 Neuro-sama 在 Twitch 上的 Tuesday Stream，因此不会有太多的自定义部分  
-后续有低成本低性能方法实现 Evil 音色模仿的时候，可能加入 Evil 的 Just Chatting 乃至各种主题的 Twin Stream
+和其他类似的 AI Vtuber 项目不同，本项目旨在尽可能模拟 Neuro-sama 于 Twitch 上的 Tuesday Stream，因此在 Vtuber 部分不会有太多的自定义部分，也不会考虑引入 Neuro/Evil 以外的 Live2D。  
+后续有低成本低性能方法实现 Evil 音色模仿的时候，可能加入 Evil Neuro。
 
 ### 预览
 
@@ -23,44 +23,44 @@ Neuro Simulator 是一个模拟 Neuro-sama 直播的项目
 
 ### 核心亮点
 
-- **多客户端支持**：支持多个客户端连接，实时广播内容
-- **配置热重载**：通过 Web 控制面板修改和热重载配置
-- **双 Agent 模式**：支持 Letta Agent 和内建 Agent，提供更多自定义选项
-- **Agent 记忆管理**：内建 Agent 支持多种记忆类型（初始化记忆、核心记忆、临时记忆、上下文）
+- **多客户端支持**：支持多个客户端连接，实时广播内容。
+- **配置热重载**：通过 Web 控制面板实时修改和热重载配置。
+- ~~**双 Agent 模式**：支持 Letta Agent 和内建 Agent，提供更多自定义选项~~ 对 Letta Agent 的支持暂时下线，后续有缘再见。
 
 ## 快速开始
 
-1.  **准备外部服务**：确保你拥有必要的 API 密钥，包括 LLM（Gemini/OpenAI）和 Azure TTS；如果使用 Letta，也请注册好相关的 API
-2.  **安装服务端**：
+1.  **准备外部服务**：确保你拥有必要的 API 密钥，包括 LLM（Gemini/OpenAI）和 Azure TTS；~~如果使用 Letta，也请注册好相关的 API 。~~
+2.  **安装服务端**：已上传至 PyPi 作为可用 pip 安装的软件包，你可以用任何一个 pip 安装到全局或 venv 中。
     ```bash
     pip install neuro-simulator
     ```
+    推荐使用 pipx，可以在不更改系统 Python 依赖的情况下直接安装为全局软件。
+
 3.  **运行服务端**：
     ```bash
     neuro
     ```
-    记得填写好配置目录中的 `config.yaml`
-      - 不指定 `--dir` 则自动创建和默认使用 `~/.config/neuro-simulator/` 作为工作目录
-      - 在默认或指定目录及需要的文件不存在时，程序会自动用自带模板复制一份到工作目录下
+    现在无需手动填写 `config.yaml`，程序在启动时会自动创建一份包含默认设置的配置文件，只需在管理面板中填写和为 Agent 分配 API 服务商即可。
+      - 不指定 `--dir, -D` 则自动创建和默认使用 `~/.config/neuro-simulator/` 作为工作目录。
+      - 程序会在工作目录下自动生成文件夹结构，拷贝需要的文件到目录内，保持程序包本体只读。
 
-4.  **安装客户端**：
-    ```bash
-    cd client
-    npm install
-    ```
-5.  **运行客户端**：
-    ```bash
-    npm run dev
-    ```
-6.  **部署控制面板**：
-    ```bash
-    cd dashboard_web
-    python -m http.server 8080
-    ```
+    程序启动后，如果工作正常，会默认在 `http://127.0.0.1:8000` 提供对外服务，你可以在设置中修改这个端口。
+
+4.  **打开管理面板**：现在程序已经内置管理面板，直接在浏览器中打开 `http://127.0.0.1:8000/dashboard/` 即可，内置面板会自动连接到服务端。
+
+    **配置流程**：
+      1. 在管理面板中打开“配置”页面。
+      2. 在“LLM服务商”中添加一个以上的选项。
+      3. 在“TTS服务商”中添加一个以上的 Azure TTS 服务。
+      4. 在“Neuro”中分配一个 LLM 服务商和一个 TTS 服务商。
+      5. 在“Chatbot”中分配一个 LLM 服务商。
+
+5.  **打开客户端**：现在程序已经内置客户端，在浏览器中访问 `<http协议>://<服务端地址>/` 即可。  
+    但是这种方式下自动从哔哩哔哩获取最近回放的功能似乎不工作，需要对哔哩哔哩 API 进行反代。如果你安装了 nodejs，则可以使用 npm 运行开发服务器的方式使用客户端。
 
 更多更复杂或者更简单的使用方式，请参见三个部分的详细文档
 
-## 项目结构
+## 项目结构（稍微过时，待更新）
 
 ```
 Neuro-Simulator/
@@ -80,7 +80,6 @@ Neuro-Simulator/
 
 - [服务端 README](server/README.md)
 - [客户端 README](client/README.md)
-- [控制面板 README](dashboard_web/README.md)
 
 ## 开发计划和已实现功能
 
@@ -104,7 +103,7 @@ Neuro-Simulator/
         - [ ] 模块化热插拔工具
         - [ ] 连接到 MCP 服务器
         - [ ] 兼容 Offical [Neuro SDK](https://github.com/VedalAI/neuro-sdk)
-    - [ ] 拉起和对话 Evil Agent
+    - [ ] 拉起 Evil Agent 并进行对话
   - [ ] Evil Agent 模块，~~卖掉了~~ 待 Neuro Agent 完善、有低成本低性能方法实现 Evil 音色模仿的时候加入
   - [ ] 对 Neuroverse 更多成员的 AI Agent 复现，进而允许 Neuro Agent 向其发送 DM（语音聊天可能不太现实）
   - [x] Chatbot 模块
@@ -113,8 +112,8 @@ Neuro-Simulator/
       - [x] prompt 编辑
       - [x] 调用 Gemini 和 OpenAI API 格式的LLM
       - [x] 基于 Neuro Agent 的上一句内容而做出 Reaction
-      - [ ] ~~在 prompt 中包含直播标题等更多信息~~ 将在更详细的 Chatbot Agent 中实现
-      - [x] ~~实现更长的上下文~~ 将在更详细的 Chatbot Agent 中实现
+      - [ ] ~~在 prompt 中包含直播标题等更多信息~~ 将在更强大的 Chatbot Agent 中实现
+      - [x] ~~实现更长的上下文~~ 将在更强大的 Chatbot Agent 中实现
     - [x] Chatbot Agent
       - [x] 更好的用户名生成逻辑
       - [x] 更长的上下文，包括自身输出和 Neuro Agent 内容
@@ -134,7 +133,7 @@ Neuro-Simulator/
   - [x] TTS 合成和推送
     - [x] Azure TTS
     - [ ] 待定 TTS
-    - [ ] 剔除 Emoji 等特殊字符
+    - [X] 剔除 Emoji 等特殊字符
   - [x] 进行直播和直播环节
     - [x] Just Chatting 单人直播
       - [x] Neuro Stream
@@ -154,8 +153,8 @@ Neuro-Simulator/
     - [x] 直播标题和标签等信息
   - [ ] 在非直播的空闲时间自动获取真实世界中 Neuro 的近期直播内容，更新完善记忆内容（不是微调训练）
   - [ ] 对 Ollama 等本地 LLM 的优化
-  - [ ] 服务端内嵌管理面板
-    - [ ] Web 控制面板
+  - [x] 服务端托管管理面板
+    - [x] Web 控制面板
     - [ ] 使用 PyInquiry 的命令行面板
 - 客户端
   - [ ] 仅包含直播区域的客户端，适用于希望使用 OBS 或其他软件推流画面的用户
@@ -200,6 +199,7 @@ Neuro-Simulator/
     - [ ] 真实的主播首页竖屏模式界面（目前沿用针对竖屏优化过的横屏样式）
     - [ ] 下滑的更多主播信息
     - [ ] 其他次级页面
+  - [x] 服务端托管客户端
   - [ ] 更多客户端（若实现原生客户端则弃用 tauri）
     - [x] 可托管的 Web 静态页面
     - [x] Windows 客户端
@@ -223,7 +223,6 @@ Neuro-Simulator/
       - [x] 对话方式展现
       - [x] 上下文方式展现
       - [x] 实时更新
-      - [x] 更好的界面
       - [ ] 可视化展现 Agent 的详细执行流程
     - [x] 实时日志查看
       - [ ] 按照等级进行日志筛选 
@@ -233,7 +232,6 @@ Neuro-Simulator/
       - [ ] 工具管理取决于服务端开发进度
 - 杂项，有一些可能永远不会实现，有一些可能很快就能完成
   - [ ] 一键启动器和整合包，适用于不需要分开部署的情况，或者面向普通小白用户
-  - [ ] 把三个项目模块整合为一个
   - [ ] 基于静态立绘制作的简易Live2D，能动就行
   - [x] 目前不会考虑语音输入
 

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/client/README.md

@@ -34,9 +34,10 @@ frontend_twitch/
 
 ### 直接使用（无需二次开发）
 
-~~若无需二次开发，可以直接从 `Releases` 下载编译好的文件（仅支持Win/Linux）~~
+若无需二次开发，可以直接在浏览器中打开 `<http协议>://<服务端地址>/` 使用服务端托管的客户端。
+- 每一个客户端页面在浏览器中都是独立运行的，因此如果有多个观众，访问同一个地址即可。
 
-暂未制作Releases，请克隆项目并按下面的方式运行开发版/构建客户端
+如果硬盘空间太大/电脑里垃圾太少/想要自己独立托管客户端对外服务（这是好习惯，避免暴露服务端地址），可以直接从 `Releases` 下载和使用编译好的文件（仅支持Win/Linux/Web托管）
 
 ### 二次开发
 
@@ -117,9 +118,11 @@ npm run preview
 
 设置参数使用浏览器的 `LocalStorage` 进行持久存储
 
+当客户端由服务端托管时，会尝试自动连接到服务端，一般无需设置
+
 ## 哔哩哔哩直播回放
 
-客户端现在支持从哔哩哔哩动态拉取最新的直播回放视频。由于B站的API存在跨域（CORS）问题，需要通过代理来访问。
+客户端现在支持从哔哩哔哩动态拉取最新的直播回放视频。由于B站的 API 相关限制，需要通过代理来访问。
 
 - **Tauri 桌面端**: 客户端已内置反向代理，无需额外配置。
 - **Vite 开发服务器**: 在 `vite.config.ts` 中已经配置了代理，开发时可直接使用。
@@ -146,4 +149,6 @@ location /bilibili-api/ {
 - 确认 `WebSocket` 连接状态
 - 验证配置设置是否正确 
 
-*作为看这篇💩文档的奖励，可以直接使用我部署的 https://neuro.jiahui.cafe 连接到你的服务端，但是不保证始终能用，并且不能修改neuro_start.mp4*
+> 都是些 AI 生成的垃圾话，看看就好
+
+*作为看这篇💩文档的奖励，可以直接使用我部署的 https://neuro.jiahui.cafe 连接到你的服务端，但是不保证始终能用，而且无法修改neuro_start.mp4*

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/client/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "Neuro Simulator Client",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "Neuro Simulator Client",
-      "version": "0.2.11",
+      "version": "0.2.12",
       "dependencies": {
         "@fontsource/inter": "^5.2.6",
         "@tauri-apps/api": "^2.6.0",

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/client/package.json

@@ -1,7 +1,7 @@
 {
   "name": "Neuro Simulator Client",
   "private": true,
-  "version": "0.2.11",
+  "version": "0.2.12",
   "type": "module",
   "scripts": {
     "dev": "vite",

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/client/src-tauri/Cargo.toml

@@ -1,10 +1,10 @@
 [package]
 name = "neuro-simulator"
-version = "0.1.0"
+version = "0.2.11"
 description = "Neuro Simulator Tauri Client"
-authors = ["you"]
-license = ""
-repository = ""
+authors = ["Moha-Master"]
+license = "MIT"
+repository = "https://github.com/Moha-Master/Neuro-Simulator"
 edition = "2021"
 [lib]
 name = "neuro_lib"

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/client/vite.config.ts

@@ -14,8 +14,8 @@ export default defineConfig({
     // 为调试构建生成 sourcemap
     sourcemap: !!process.env.TAURI_DEBUG,
   },
-  // 设置基础路径，使构建后的资源引用正确（当应用部署在子路径如 /client 时）
-  base: './', // 使用相对路径基础，这样在任何子路径下都能正确引用资源
+  // 设置应用的基础路径
+  base: '/',
   // Tauri 需要一个固定的端口来连接前端开发服务器
   server: {
     port: 5173,

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/dashboard/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "neuro-simulator-dashboard",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "neuro-simulator-dashboard",
-      "version": "0.6.0",
+      "version": "0.6.2",
       "dependencies": {
         "@mdi/font": "^7.4.47",
         "pinia": "^3.0.3",

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/dashboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neuro-simulator-dashboard",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "private": true,
   "type": "module",
   "engines": {

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/dashboard/vite.config.ts

@@ -6,6 +6,7 @@ import vueDevTools from 'vite-plugin-vue-devtools'
 
 // https://vite.dev/config/
 export default defineConfig({
+  base: '/dashboard/',
   plugins: [
     vue(),
     vueDevTools(),

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "neuro_simulator"
-version = "0.6.1"
+version = "0.6.2"
 description = "Neuro Simulator Server"
 readme = "README.md"
 authors = [{ name = "Moha-Master", email = "hongkongreporter@outlook.com" }]

{neuro_simulator-0.6.1 → neuro_simulator-0.6.2}/server/README.md

@@ -2,11 +2,11 @@
 
 *本临时README由AI自动生成*
 
-这是 Neuro Simulator 的服务端，负责处理直播逻辑、AI 交互、TTS 合成等核心功能
+这是 Neuro Simulator 的服务端，负责处理直播逻辑、AI 交互、TTS 合成等核心功能。
 
 ## 功能特性
 
-- **动态观众**：调用无状态LLM，动态生成观众聊天内容，支持 Gemini 和 OpenAI API
+- **动态观众**：调用LLM，基于直播内容动态生成 Chat
 - **配置管理**：支持通过 API 动态修改和热重载配置
 - **外部控制**：完全使用外部API端点操控服务端运行
 
@@ -15,7 +15,7 @@
 ``` main
 neuro_simulator/
 ├── __init__.py
-├── cli.py               # 命令行启动脚本
+├── cli.py
 ├── agent/
 │   ├── __init__.py
 │   ├── core.py
@@ -49,7 +49,6 @@ neuro_simulator/
 │   ├── audience.py
 │   ├── audio.py
 │   ├── builtin.py
-│   ├── letta.py
 │   └── stream.py
 └── utils/
     ├── __init__.py
@@ -61,11 +60,10 @@ neuro_simulator/
 ```
 
 ``` workin'dir
-working_dir_example/     # 工作目录结构，请将这个目录重命名和复制到你想要的位置（推荐放到~/.config/neuro-simulator）
+working_dir_example/     # 工作目录结构，供你参考
 ├── assets/              # 媒体文件夹，如缺失会使用自带资源覆盖
 │   └── neuro_start.mp4  # 用来计算Start Soon长度，仅读取时长,请和客户端的视频保持一致
-├── config.yaml          # 由用户手工创建的配置文件
-├── config.yaml.example  # 自动生成的配置文件模板，必须手动重命名和填写
+├── config.yaml          # 系统配置文件，由服务端自动管理，无需手动填写
 └── agents/              # Agent相关文件夹
     ├── memories/        # Agent记忆文件夹
     │   ├── core_memory.json
@@ -85,34 +83,35 @@ working_dir_example/     # 工作目录结构，请将这个目录重命名和
 
 ## 安装与配置
 
-1. 复制一份 `../docs/working_dir_example` 到你想要的位置，作为配置文件目录.
-   - 程序会在未指定 `--dir` 的情况下自动生成一个工作目录，路径为 `~/.config/neuro-simulator/`
-2. 然后进入配置文件目录，复制 `config.yaml.example` 到 `config.yaml`
-3. 编辑 `config.yaml` 文件，填入必要的 API 密钥和配置项：
-   - 如果使用 Letta Agent，需要配置 Letta Token 和 Agent ID
-   - Gemini/OpenAI API Key（用于观众聊天生成和 Agent）
-   - Azure TTS Key 和 Region
+1. 自己找一个最好是空的文件夹作为工作目录。
+   - 程序会在未指定 `--dir, -D` 的情况下自动生成一个工作目录，路径为 `~/.config/neuro-simulator/`。
+2. 启动程序，按照外面那个 README 中的方式完成配置。
 
-可以自行替换 `$dir/assets/neuro_start.mp4` 为其它视频文件，但记得手动替换 client 中的同名文件
+3. 可以自行替换 `$dir/assets/neuro_start.mp4` 为其它视频文件，但记得手动替换 client 中的同名文件。
 
 ### Agent配置
 
-服务端支持两种Agent类型：
-1. **Letta Agent**：需要配置 Letta Cloud 或自托管的 Letta Server
-2. **内建 Agent**：使用服务端自带的 Agent，支持 Gemini 和OpenAI API
+服务端支持两种 Agent 类型：
+~~1. **Letta Agent**：需要配置 Letta Cloud 或自托管的 Letta Server~~ 暂时下线，后会有期。  
+2. **内建 Agent**：使用服务端自带的 Agent，支持 Gemini 和OpenAI API。
 
-在 `config.yaml` 中通过 `agent_type` 字段选择使用的 Agent 类型：
-- `agent_type: "letta"`：使用 Letta Agent
-- `agent_type: "builtin"`：使用内建 Agent
-
-当使用内建Agent时，还需要配置：
-- `agent.agent_provider`：选择"gemini"或"openai"
-- `agent.agent_model`：指定具体的模型名称
+不管用的是什么 Agent，在管理面板中配置和分配好服务商相关就行了。
 
 ### 直接安装方式（无需二次开发）
 
 若无需二次开发，可以直接使用 pip 安装：
 ```bash
+# 直接使用 pip 安装为全局软件：
+pip install neuro-simulator
+```
+
+```bash
+# 系统 Python 环境不宜变动时，建议使用 pipx 安装为全局软件
+pipx install neuro-simulator
+```
+
+```bash
+# 使用 venv 方式安装：
 python3 -m venv venv
 # Windows
 venv/Scripts/pip install neuro-simulator
@@ -132,6 +131,7 @@ venv/Scripts/pip install -e .
 # macOS/Linux
 venv/bin/pip install -e .
 ```
+安装时会自动构建 Dashboard 和 Client，请确保系统安装了 Node.js。
 
 ### 运行服务
 
@@ -142,43 +142,34 @@ neuro
 # 指定工作目录
 neuro -D /path/to/your/config
 
-# 指定主机和端口
+# 指定监听地址和端口
 neuro -H 0.0.0.0 -P 8080
 
 # 组合使用
 neuro -D /path/to/your/config -H 0.0.0.0 -P 8080
 ```
 
-服务默认运行在 `http://127.0.0.1:8000`
+手动指定的监听地址和端口会覆盖配置文件中的设置。
 
-## API 接口
+如果没有指定，服务默认遵循配置文件中的设置，运行在 `http://127.0.0.1:8000`。
 
-服务端的主要管理和控制功能已统一迁移至 WebSocket 接口 `/ws/admin`。原有的 HTTP API 仅保留 `/api/system/health` 用于建立 WS 连接前的健康检查
+## API 接口
 
-- `/ws/admin`: 用于控制面板的管理接口，提供直播控制、配置管理、日志监控、Agent交互等所有功能，详细规范请参阅 `WEBSOCKET_API.md`
-- `/ws/stream`: 客户端使用的直播接口
-- `/api/system/health`: 健康检查接口
-- `/docs`: 自动生成的API文档 (Swagger UI)
+- `/ws/admin`: 用于控制面板的管理接口，提供直播控制、配置管理、日志监控、Agent交互等所有功能，详细规范请参阅 `WEBSOCKET_API.md`。
+- `/ws/stream`: 客户端使用的直播接口。
+- `/api/system/health`: 健康检查接口。
 
 ## 配置说明
 
-配置文件 `config.yaml` 包含以下主要配置项：
-
-- `api_keys` - 各种服务的 API 密钥
-- `stream_metadata` - 直播元数据（标题、分类、标签等）
-- `neuro_behavior` - Neuro 行为设置
-- `audience_simulation` - 观众模拟设置
-- `tts` - TTS 语音合成设置
-- `performance` - 性能相关设置
-- `server` - 服务器设置（主机、端口、CORS 等）
+配置文件 `config.yaml` 现在一般无需手动编辑，所有配置项在管理面板中均可进行可视化配置。
 
 有关配置文件的完整示例，请参阅项目根目录下的 `docs/working_dir_example/` 文件夹
 
 ## 安全说明
 
-1. 通过 `panel_password` 配置项可以设置控制面板访问密码
-2. 敏感配置项（如 API 密钥）不会通过 API 接口暴露
-3. 支持 CORS，仅允许预配置的来源访问
+服务端具有 CORS 配置，仅允许预配置的来源访问。如果莫名其妙地连不上服务端（尤其是在外网环境中），可以检查和更改此项设置。  
+
+**公网部署请务必更改管理密钥**，建议更改端口为非常规端口以避免爆破。咱这个程序只是能用就行的水平，永远不要相信它的安保性能。
 
 ## 故障排除
 
@@ -186,3 +177,7 @@ neuro -D /path/to/your/config -H 0.0.0.0 -P 8080
 - 检查网络连接是否正常
 - 查看日志文件获取错误信息
 - 确保端口未被其他程序占用
+
+> 都是些 AI 生成的垃圾话，看看就好
+
+*作为看这篇💩文档的奖励，如果你需要使用外部面板而不是服务器自托管面板，可以直接使用我部署的 https://dashboard.neuro.jiahui.cafe 连接到你的服务端，但是不保证始终能用，而且请配置好 CORS*