dyao-hippocortex 3.0.1__py3-none-any.whl

dyao_hippocortex-3.0.1.dist-info/METADATA

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: dyao-hippocortex
+Version: 3.0.1
+Summary: 一个模拟人类大脑结构的开源AI桌宠助手
+License-File: LICENSE
+Keywords: ai,brain-simulation,neural-network,assistant,desktop-pet
+Author: Yao Deng
+Author-email: 2250111005@stu.hzcu.edu.cn
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Dist: chardet (>=7.0.0)
+Requires-Dist: diffusers (>=0.20.0)
+Requires-Dist: faiss-cpu (>=1.14.0)
+Requires-Dist: ipykernel (>=7.0.0)
+Requires-Dist: ipython (>=8.0.0)
+Requires-Dist: jieba (>=0.42.0)
+Requires-Dist: langchain (>=0.2.0)
+Requires-Dist: langchain-community (>=0.2.0)
+Requires-Dist: langchain-core (>=0.2.0)
+Requires-Dist: langchain-ollama (>=0.1.0)
+Requires-Dist: langchain-text-splitters (>=0.2.0)
+Requires-Dist: loguru (>=0.7.0)
+Requires-Dist: matplotlib (>=3.8.0)
+Requires-Dist: numpy (>=1.26.0)
+Requires-Dist: pandas (>=2.0.0)
+Requires-Dist: pillow (>=10.0.0)
+Requires-Dist: pydantic (>=2.0.0)
+Requires-Dist: pydantic-settings (>=2.0.0)
+Requires-Dist: pygments (>=2.0.0)
+Requires-Dist: pyqt5 (>=5.15.0)
+Requires-Dist: python-dotenv (>=1.0.0)
+Requires-Dist: scikit-learn (>=1.0.0)
+Requires-Dist: scipy (>=1.11.0)
+Requires-Dist: seaborn (>=0.13.0)
+Requires-Dist: torch (>=2.0.0)
+Requires-Dist: tqdm (>=4.66.0)
+Requires-Dist: transformers (>=4.34.0)
+Project-URL: Repository, https://github.com/a123547879/HippoCortex
+Description-Content-Type: text/markdown
+
+# 🧠 HippoCortex - 类脑AI桌宠助手
+
+一个模拟人类大脑结构的开源AI桌宠助手，拥有自主意识、长期记忆和学习能力。
+
+## ✨ 核心特性
+
+- 🧠 **类脑认知架构**：模拟人脑海马体-皮层分工，多专家分区处理不同类型知识
+- 💾 **长期记忆系统**：支持短期→长期→永久记忆分级，自然遗忘与睡眠巩固
+- ⚡ **赫布学习机制**：遵循"共同激活，连接强化"原则，越用越聪明
+- 🌙 **睡眠记忆巩固**：自动修剪无效突触，强化核心记忆，生成梦境
+- 💬 **主动交互能力**：会主动说话、分享想法、提问，不是被动问答机器
+- 🎨 **图文多模态**：支持图片理解和视觉想象，能"看到"并"想象"画面
+- 📚 **自主学习能力**：会自己读书学习，不断增长知识
+- 📊 **脑状态可视化**：实时显示疲劳度、记忆数、突触连接热力图
+
+## 🚀 快速开始
+
+### 前置要求
+- Python 3.11+
+- [Ollama](https://ollama.com/) 已安装并运行
+
+### 安装
+```bash
+pip install hippocortex
+
+运行
+bash
+运行
+hippocortex
+首次运行
+程序会自动下载所需的 AI 模型：
+gemma3:4b - 大语言模型
+bge-m3 - 向量嵌入模型
+🎮 使用说明
+基本交互
+点击桌宠头像打开聊天窗口
+可以发送文字和图片
+桌宠会根据对话内容学习和记忆
+核心功能
+聊天：自然语言对话，支持上下文理解
+睡眠：点击 "睡眠" 按钮，让 AI 休息并巩固记忆
+学习：AI 会在空闲时自动读书学习
+走神：AI 空闲时会进入走神状态，回忆和联想记忆
+分析：右键菜单可以分析大脑突触连接热力图
+🧠 大脑状态说明
+表格
+状态	说明
+🧠 大脑已唤醒	正常工作状态
+🌙 走神中...	正在回忆和联想记忆
+💬 有话想对你说...	有主动意图要表达
+🌙 睡眠巩固中...	正在睡眠，整理记忆
+❌ 思考失败	遇到错误
+🛠️ 开发
+本地运行
+bash
+运行
+git clone https://github.com/a123547879/HippoCortex.git
+cd HippoCortex
+pip install -r requirements.txt
+cd src
+python MainTest5.py
+项目结构
+plaintext
+hippocortex/
+├── core/              # 核心认知模块
+│   ├── BrainCore.py   # 大脑核心
+│   ├── Hippocampus.py # 海马体
+│   └── Cortex.py      # 大脑皮层
+├── experts/           # 多专家系统
+│   ├── ConceptExpert.py
+│   ├── SpatialExpert.py
+│   ├── AbstractExpert.py
+│   └── VisualExpert.py
+├── services/          # 服务模块
+│   ├── IntentionService.py
+│   ├── MindWanderingService.py
+│   └── BookReadingService.py
+├── ui/                # 用户界面
+│   └── brain_pet_window.py
+└── main.py            # 程序入口

dyao_hippocortex-3.0.1.dist-info/RECORD

@@ -0,0 +1,89 @@
+hippocortex/__init__.py,sha256=9NXi3Dyg7Bcew_7O6r1D6O52U5BeczfJTctLjABm6a4,173
+hippocortex/__main__.py,sha256=2Tw6mLLGOZM-K97fW3ugTIBdpYIEvXiEkTZ6wF4i48k,30
+hippocortex/BookReader.py,sha256=zXXqYctCQ4dpJlXprF4thBrfsNr9o7TJOyU8Cl0DrNY,13482
+hippocortex/brain_core.py,sha256=tpi1rczwWErOxCzXd9Qbz3UPJDcK4CXfm1cHEpCig3M,2127
+hippocortex/brain_interface.py,sha256=AuG1QcRihoPInT77ZpEDkpH5HyqSvjVj4w2wFY1CQlk,7912
+hippocortex/brain_v13_demo/book_batch_summaries.json,sha256=RBNvo1WzZ4oRRq0W9-hknpT7T8If536DEMBg9hyq_4o,2
+hippocortex/brain_v13_demo/conversation_memory.json,sha256=B568G3FPg5xjwdpD94H7RBdhxpNEFY4u1IDfr8NIig0,112
+hippocortex/brain_v13_demo/cortex_entity_index.json,sha256=rdevIsOZApieFxcvr3Sysib6__j2IbFy_I-dQiJOGLE,256
+hippocortex/brain_v13_demo/cortex_state.json,sha256=fzvjL2Fxue-shr-inorqWYGbUyqbTbXmLrFGAkT5C9Y,53
+hippocortex/brain_v13_demo/cross_modal_bridges.pt,sha256=TO-Psmv6pwwFiIepIjVqm5PvSO5dzd7T7EHvz3dtQQo,167860922
+hippocortex/brain_v13_demo/cross_modal_dataset.pt,sha256=YB7BG0prAyjz6GOecY8ccI6nKdZLksh30jy8IAvQICY,1040
+hippocortex/brain_v13_demo/expert_抽象.pt,sha256=DYnlzSRaRE4_sRy0b0-gzwZLwZMt5jUzk1IeGLIPVpw,50346192
+hippocortex/brain_v13_demo/expert_概念.pt,sha256=coxNgEkowvqNUoX1sr8y0swLStGaFck8NtWYeWMLr74,50346192
+hippocortex/brain_v13_demo/expert_空间.pt,sha256=NobzxgxdMTWMoeNfjeETFOXVyHTHO_ywixEOsjlJprg,50346192
+hippocortex/brain_v13_demo/expert_视觉.pt,sha256=CK8LgIQFH5Ff95FlOZbAMB6sotT9KUz1pJ1SaVDXn8Q,50346192
+hippocortex/brain_v13_demo/expert_身份.pt,sha256=5ycEDGEqWMnurDn-B_gB4vD86TdwpA65r9Ov77iULuU,50346192
+hippocortex/brain_v13_demo/hippocampus_router.pt,sha256=RZobMSxHV1NEsVICol42XW1BqdL8URE9ly0gGpIzVDo,1082394
+hippocortex/brain_v13_demo/important_entities.json,sha256=T1PNoYwrqgwDVLtfmj7L5e0Sq02OEbqHPC8RFhICuUU,2
+hippocortex/BrainBenchmark.py,sha256=15XnVQpzlS4EDjk_YJf-wB9TFFlWWFoIQJZcn1ADlpI,14270
+hippocortex/BrainConfig.py,sha256=eVhPA_c-3DUNXLfTQP4tItEExLM3ipZJbBSO9Eci4DY,11161
+hippocortex/ChatThread.py,sha256=LllsT89SQ5YE5BxsXpyI2ApDSsBALT8iHo7EH7Rt8Sc,6317
+hippocortex/Cognitive_system.py,sha256=BcntAkhhvJkjB1L-SPPScM71CclYPkUE7vyECrL1jSw,7921
+hippocortex/CognitiveEnergyField.py,sha256=xnIQsGr9MpSni6FeuuYLtCbIu4B5w9tZFs6JuwW78tc,3667
+hippocortex/ComponentFactory.py,sha256=naE8c2F1-QEtXAT0vMiwD45cW9NkYtiZ-PLREuTXLCY,4525
+hippocortex/Consolidation_loop.py,sha256=gzWN7RxBXv7SBy8GqCDuinQvEkKgklkD3tmL6t9CMrY,23960
+hippocortex/conversation_memory.py,sha256=XB5OJA8pA4B_XRKW9gjH18L7j2KLxZomrgQa6sW3DJ0,15755
+hippocortex/Curiosity.py,sha256=etNJz6L-jiyJw_yRaZwZV-mjVI-ZbCQV-64gsMhJHKw,4537
+hippocortex/Data_models.py,sha256=vnY9ffoEQNIl0LbYmQ34TycslUCyirRN_XT1Xzcq8JM,30422
+hippocortex/DopamineSystem.py,sha256=U_UKzrBOXNDA0t4coCc47Wyl9VuO1FpkpNDmSQnAlYA,15909
+hippocortex/Dreaming_loop.py,sha256=S36Cxu29Vw3EDCSoHOJjKKBl7Q-25viNO99c3iI77tU,19919
+hippocortex/DummyBrain.py,sha256=2dAggt8NAu1EBuEYghWR2AbUo58W7lexW9eNi_UgYu0,8093
+hippocortex/DynamicExpert.py,sha256=dH51xNZOHQFfq8hmmH-hURl9M7BGvJ-IWEPWNtb_8vY,55470
+hippocortex/event_system.py,sha256=0G-J8ZYGg5J4fVbI3SlFXTZ5bmJ00HvIB8mylgLHc8M,4440
+hippocortex/HippocampusRouter.py,sha256=KVXMoA2Fe876QhKhN7fh6o6tOUwURYBn3UxUdZxyZPw,23782
+hippocortex/ILifecycle.py,sha256=jbXw9AJJsjGzb_kcp9yHZ5_--GIP_oxIcf20URPwXfc,940
+hippocortex/imgs/error.png,sha256=AQg7UD6ENEmwZOaysenRQAPj7HuhRFI6FGcnAHDg2ZQ,2255698
+hippocortex/imgs/sit.png,sha256=7nG2DVUwchCuL7uuu7Dn-AlY1A2kqqwQiBP6wGHmaiY,1699219
+hippocortex/imgs/sit2.png,sha256=a-8lw87l3BUGHsNdSbkwR0Cv62RJC_zblaRnJDFXsAI,1611273
+hippocortex/imgs/sleep.png,sha256=I1_xClvwjecL1neb9vVD8adLSXBHzt63dgQGKin69Pw,1862491
+hippocortex/imgs/stand.png,sha256=IxWVj0X4fepgoTAzQdnY7jRPjICq0p8sYWkbXgyna6U,1885469
+hippocortex/imgs/swim.png,sha256=XxV_4qALE1bVrHKDaWf6wY5H4RDN4XckYve5L6b2dgQ,1673683
+hippocortex/imgs/wandering01.png,sha256=Lb9eF17adormSYkKajuwrwsVYNkOhLd682OiV_NyEqY,1654468
+hippocortex/imgs/wandering02.png,sha256=N83foeeh2m51V6VuNkkUDAswXwxUq6TfixZBeTPmNm8,2111221
+hippocortex/imgs/work.png,sha256=G99jOH9p3aQLD7OdXvlOK-4CwNDlvAYjypyp2TD4RuQ,1489410
+hippocortex/LearnableSparseEncoderV2.py,sha256=yE1SAw92lhcML7PcXHli_hLhwS3N7JWbYAzT31PZchE,7127
+hippocortex/Learning_loop.py,sha256=bhCKTa7HNC_VD4nEm43KHNQYwzbPZaWH0dAmmghMJgY,47069
+hippocortex/LLMBrainWrapper.py,sha256=c0_L4jndkow_IgiLTGB7oYeK53GC_ek3EqV9f-z1Bro,20130
+hippocortex/main.py,sha256=4_HvFGPDzfE5yxwkXfZOzQ8BUgTBdpYG1jitqC3rxOg,3311
+hippocortex/MainTest5.py,sha256=4gtaf8kpgVu9Y1aWwl5kuGPu3-WX6aH3Yd13cpOVULU,14292
+hippocortex/Metacognition.py,sha256=Ye6hZ_uIgYjZdEnS7OkzA6Vsk7CU5OVtaDhoBdBaRPE,6395
+hippocortex/Multimodal_gateway.py,sha256=3MkhYXT0Do7DIWo47IMwanKdLhGahtN_aQNYExzf14o,4705
+hippocortex/PerceptionLoop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hippocortex/PerceptionLoop/BookReadingService.py,sha256=zZcuNCnz3dQxbRr1KlyM_K3Db0yyXDi8ewDpv5jmqYM,36695
+hippocortex/PerceptionLoop/CrossModalBridge.py,sha256=52EUTMecXuaHHpVq1mquD1t4CpEVUyqJ1uQLHSE_89Q,18892
+hippocortex/PerceptionLoop/IntentionService.py,sha256=jSVelUd_pOFLHoho-A8UFChGpYIxc7ZNiOoinVBwKvE,14344
+hippocortex/PerceptionLoop/MindWanderingService.py,sha256=v6Ogdb11FImuwCLRwt2eYZBQVC0oPkvQgEwmc30-YXU,12274
+hippocortex/PerceptionLoop/ThinkEngine.py,sha256=H1PU9d289316fYmqltGt3z-rOQfPdeidRoD3pd2f6zE,24000
+hippocortex/PersistentCortex.py,sha256=xsls51NmEonJJonelMgWtE9AGeCf9uBYO7Y4ThQUyYk,57034
+hippocortex/plugin_system.py,sha256=6YlBr1WLw5ComhzXMWWXsNYGH8enu3KS4JrefTB4P3Y,990
+hippocortex/ServiceContainer.py,sha256=3HR2Epjerb58MR2R1Ec98h0Fvf4YxEgOUuAd1eN6z54,4252
+hippocortex/StructureMapper.py,sha256=KKdimLwlCnuHp0lQoy7bckppeMLtV-Ua8mBTS9WCqXE,5864
+hippocortex/SymbolicCore.py,sha256=sj3d299yRdVMpJCB7OoBxmY1wRzIFbwIpjDUndcZVP8,6964
+hippocortex/test.py,sha256=903BJApift3svzqKNnGUKubcXEQQWsZZGjPnkURVM-8,1421
+hippocortex/Thalamus.py,sha256=0h5MfVLPBmLIN-Ox4NlKOtZae3N2EpTg2k4Pv5G81I4,18144
+hippocortex/train_hippocampus.py,sha256=Q3SUnaN5ZLC4B1e3-kCZVIzxUorMKU-NdRu3_ir-yQA,17037
+hippocortex/training_dataset.json,sha256=yArY8Ze8VoNyGEy-w3YS_7TYPsTLHUiTpAUtPd5PHAU,32240
+hippocortex/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hippocortex/ui/brain_pet_window.py,sha256=_hkd0xkeM49C0Z-emy-uXXG6-MaVOL1IYqc_UATjy-0,24256
+hippocortex/ui/sleep_thread.py,sha256=YsOSabYHlUMfV0H2oP0wo5fQ5x7HqtCdOCUBv1gtlZc,1294
+hippocortex/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hippocortex/utils/heatmap_generator.py,sha256=Lbbc-igIUnrZ9EMHrtw7tnfPsLOGbke_eBOW260C2p8,9473
+hippocortex/VAEManager.py,sha256=ZDZpKbtk0cjvhruSRxIjlkxeIVQwm-4GKmP3g92h_JA,10554
+hippocortex/Wrappers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hippocortex/Wrappers/ConsolidationLoopWrapper.py,sha256=irgVNuf1LglEKnNfPvIkxz7vTwvCtBSanLFSkfpw0XM,3048
+hippocortex/Wrappers/CuriosityWrapper.py,sha256=VzuZkGz6sDR_ozOtyS-JZ3ml72ORjLSmJRnJdptQg5I,3577
+hippocortex/Wrappers/DopamineSystemWrapper.py,sha256=QwmuLrFSUem73RnTcBGqNTNewYlFqrHzx16MKWozZWs,3903
+hippocortex/Wrappers/DreamingLoopWrapper.py,sha256=Q6wWCc6KXGZznVQdjzOInNLanzG5EuYDeUVrdWhXPHQ,2504
+hippocortex/Wrappers/HippocampusRouterWrapper.py,sha256=1dc9y_pmEW8quZ1gCpxtomqv2x_yDMvWyURT9iVH2F0,1773
+hippocortex/Wrappers/LearningLoopWrapper.py,sha256=E-e-rQWVWSUlrkI1m3-hwRAH-Law6ZbGG6DIgNzjG9U,4936
+hippocortex/Wrappers/MetacognitionWrapper.py,sha256=vNbyMgyByC8iX15cGhxhcVbV_BfUKyawSKX0SVXqaCE,2991
+hippocortex/Wrappers/PerceptionLoopWrapper.py,sha256=YgJP34U1r8gKWPuxQvzaQxQre0b8oq54cKh7ST9E5_c,5702
+hippocortex/Wrappers/PersistentCortexWrapper.py,sha256=OL7fKLJnJoMiMITjyHD8jR_xyd3yJ3ZeAboA6nfbvag,2817
+hippocortex/Wrappers/SymbolicCoreWrapper.py,sha256=jN_qgCbtGuTMKybYZkbMW6Hr9QRikCJxsK8P_n4Xghk,1872
+hippocortex/Wrappers/ThalamusWrapper.py,sha256=or3l4N-gwx6qNfb98kIJpJQI56Z-HetHIfVB_EyUIcM,2361
+hippocortex/Wrappers/VAEManagerWrapper.py,sha256=c2zB2auWAXp5Mdb5WwYVIvnhYo6TsdmDdK9fS0B1uPQ,1193
+dyao_hippocortex-3.0.1.dist-info/licenses/LICENSE,sha256=8Jb_oCEl09ac7RQniOkH9uGigG9CfpbUsJ0SRpHaXbg,1039
+dyao_hippocortex-3.0.1.dist-info/METADATA,sha256=n_eRTQjEs4d_RznvKtksx8br_9M7-bIN-dTEzLASoHE,4610
+dyao_hippocortex-3.0.1.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+dyao_hippocortex-3.0.1.dist-info/RECORD,,

dyao_hippocortex-3.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.4.1
+Root-Is-Purelib: true
+Tag: py3-none-any

dyao_hippocortex-3.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,4 @@
+Copyright (c) 2026 Yao Deng
+Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in allcopies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.

hippocortex/BookReader.py

@@ -0,0 +1,305 @@
+import os
+import json
+import random
+import chardet
+from typing import Optional, List, Dict, Tuple
+import logging
+from dataclasses import dataclass
+
+logger = logging.getLogger("BookReader")
+
+# 阅读进度配置文件
+PROGRESS_FILE = "book_read_progress.json"
+
+@dataclass
+class BookPage:
+    """强类型书籍页面，与系统整体数据契约保持一致"""
+    book_name: str
+    content: str
+    current_progress: float  # 0.0-1.0
+    is_new_cycle: bool = False  # 是否刚读完一整遍重新开始
+
+class BookReader:
+    def __init__(self, book_dir: str = "./books"):
+        self.book_dir = book_dir
+        self.progress = self._load_progress()
+        self.blacklist: Dict[str, int] = {}  # 书籍黑名单：{书名: 失败次数}
+        self.MAX_FAILURES = 3  # 连续失败3次加入黑名单
+        
+        # ===================== 🔥 新增：阅读配置开关 =====================
+        self.use_paragraph_alignment: bool = True  # 智能段落对齐
+        self.use_weighted_random: bool = True  # 加权随机选书
+        self.auto_encoding_detect: bool = True  # 自动编码检测
+        self.mark_new_cycle: bool = True  # 标记新阅读周期
+        # ==================================================================
+
+        # 自动创建图书文件夹
+        if not os.path.exists(book_dir):
+            os.makedirs(book_dir)
+            logger.info(f"📚 已自动创建图书文件夹: {book_dir}，请放入txt小说")
+
+    def _load_progress(self) -> Dict:
+        """加载阅读进度（空值安全+版本兼容）"""
+        if os.path.exists(PROGRESS_FILE):
+            try:
+                with open(PROGRESS_FILE, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                    # 兼容旧版进度格式（纯字节位置）
+                    cleaned_data = {}
+                    for k, v in data.items():
+                        if isinstance(v, (int, float)):
+                            cleaned_data[k] = {"pos": int(v), "file_size": 0}
+                        else:
+                            cleaned_data[k] = v
+                    return cleaned_data
+            except Exception as e:
+                logger.error(f"阅读进度文件损坏，重新初始化: {e}")
+                return {}
+        return {}
+
+    def _save_progress(self):
+        """保存阅读进度（原子写入，避免文件损坏）"""
+        try:
+            temp_file = PROGRESS_FILE + ".tmp"
+            with open(temp_file, "w", encoding="utf-8") as f:
+                json.dump(self.progress, f, ensure_ascii=False, indent=2)
+            os.replace(temp_file, PROGRESS_FILE)
+        except Exception as e:
+            logger.error(f"保存阅读进度失败: {e}")
+
+    def get_all_books(self) -> List[str]:
+        """获取所有有效txt书籍（过滤空文件和黑名单）"""
+        valid_books = []
+        for f in os.listdir(self.book_dir):
+            if f.endswith(".txt"):
+                file_path = os.path.join(self.book_dir, f)
+                if os.path.getsize(file_path) > 1024:
+                    # 排除连续失败超过阈值的书
+                    if self.blacklist.get(f, 0) < self.MAX_FAILURES:
+                        valid_books.append(f)
+        return valid_books
+
+    def _detect_encoding(self, file_path: str) -> str:
+        """自动检测文件编码（UTF-8/GBK）"""
+        if not self.auto_encoding_detect:
+            return "utf-8"
+        
+        try:
+            with open(file_path, "rb") as f:
+                raw = f.read(10000)  # 读取前10KB检测编码
+            result = chardet.detect(raw)
+            encoding = result["encoding"] or "utf-8"
+            # 统一常见编码名称
+            if encoding.lower() in ["gb2312", "gb18030"]:
+                encoding = "gbk"
+            logger.debug(f"📖 检测到《{os.path.basename(file_path)}》编码: {encoding}")
+            return encoding
+        except Exception as e:
+            logger.debug(f"编码检测失败，使用默认UTF-8: {e}")
+            return "utf-8"
+
+    def read_book_page(self, book_name: str, page_size: int = 600) -> Optional[BookPage]:
+        """
+        分页阅读书籍（终极优化版）
+        ✅ 自动编码检测（UTF-8/GBK）
+        ✅ 智能段落对齐
+        ✅ 文件变化自动重置进度
+        ✅ 读完自动从头开始并标记新周期
+        """
+        book_path = os.path.join(self.book_dir, book_name)
+        if not os.path.exists(book_path):
+            logger.warning(f"书籍不存在: {book_name}")
+            self.blacklist[book_name] = self.blacklist.get(book_name, 0) + 1
+            return None
+
+        # 获取文件大小，用于计算进度和检测文件变化
+        file_size = os.path.getsize(book_path)
+        book_progress = self.progress.get(book_name, {"pos": 0, "file_size": 0})
+        current_pos = book_progress["pos"]
+        saved_file_size = book_progress["file_size"]
+        
+        # 检测到文件内容变化，自动重置进度
+        if saved_file_size != 0 and saved_file_size != file_size:
+            logger.info(f"📖 《{book_name}》文件内容已变化，自动重置阅读进度")
+            current_pos = 0
+
+        is_new_cycle = False
+        try:
+            encoding = self._detect_encoding(book_path)
+            
+            with open(book_path, "rb") as f:
+                f.seek(current_pos)
+                # 多读3字节防止汉字截断，多读100字节用于段落对齐
+                raw_bytes = f.read(page_size + 103)
+                
+                # 读完自动重置进度
+                if not raw_bytes or len(raw_bytes.strip()) == 0:
+                    logger.info(f"📖 《{book_name}》 已读完，自动从头开始阅读")
+                    current_pos = 0
+                    is_new_cycle = True
+                    f.seek(0)
+                    raw_bytes = f.read(page_size + 103)
+                    if not raw_bytes:
+                        return None
+
+                # 修复UTF-8汉字截断
+                valid_end = len(raw_bytes)
+                while valid_end > 0 and (raw_bytes[valid_end-1] & 0xC0) == 0x80:
+                    valid_end -= 1
+
+                # 解码为字符串
+                content = raw_bytes[:valid_end].decode(encoding, errors="replace").strip()
+                
+                # ===================== 🔥 新增：智能段落对齐 =====================
+                if self.use_paragraph_alignment and valid_end < len(raw_bytes):
+                    # 寻找最后一个段落结束符（换行/句号/感叹号/问号）
+                    paragraph_ends = [
+                        content.rfind("\n"),
+                        content.rfind("。"),
+                        content.rfind("！"),
+                        content.rfind("？"),
+                        content.rfind("；")
+                    ]
+                    last_paragraph_end = max(paragraph_ends)
+                    
+                    # 如果找到段落结束符，并且截断位置在页面的后30%，就截断到段落结束
+                    if last_paragraph_end > int(page_size * 0.7):
+                        content = content[:last_paragraph_end + 1].strip()
+                        valid_end = len(raw_bytes[:valid_end].decode(encoding, errors="replace")[:last_paragraph_end + 1].encode(encoding))
+                # ==================================================================
+
+                # 清理乱码和特殊字符
+                import re
+                content = re.sub(r'[�\x00-\x1F\x7F]+', '', content)
+                content = re.sub(r'\n+', '\n', content)  # 合并多余换行
+
+                # 过滤过短的无效内容
+                if len(content) < 20:
+                    logger.debug(f"跳过过短内容: {book_name} 位置:{current_pos}")
+                    new_pos = current_pos + valid_end
+                    self.progress[book_name] = {"pos": new_pos, "file_size": file_size}
+                    self._save_progress()
+                    return self.read_book_page(book_name, page_size)
+                
+                # 更新进度
+                new_pos = current_pos + valid_end
+                self.progress[book_name] = {"pos": new_pos, "file_size": file_size}
+                self._save_progress()
+                
+                # 重置失败计数
+                self.blacklist[book_name] = 0
+                
+                # 计算阅读进度百分比
+                progress_percent = min(1.0, new_pos / file_size) if file_size > 0 else 0.0
+                
+                return BookPage(
+                    book_name=book_name,
+                    content=content,
+                    current_progress=progress_percent,
+                    is_new_cycle=is_new_cycle
+                )
+                
+        except Exception as e:
+            logger.error(f"读取书籍《{book_name}》失败: {e}", exc_info=True)
+            self.blacklist[book_name] = self.blacklist.get(book_name, 0) + 1
+            
+            # 出错时跳过当前位置
+            new_pos = current_pos + page_size
+            self.progress[book_name] = {"pos": new_pos, "file_size": file_size}
+            self._save_progress()
+            
+            # 如果连续失败超过阈值，加入黑名单
+            if self.blacklist[book_name] >= self.MAX_FAILURES:
+                logger.warning(f"📖 《{book_name}》连续失败{self.MAX_FAILURES}次，已加入黑名单")
+            
+            return None
+
+    def random_read(self) -> Optional[Dict]:
+        """
+        随机选一本书阅读一段（加权随机+新周期事件）
+        ✅ 优先读进度少的书
+        ✅ 读完一本书自动生成读完记忆
+        ✅ 兼容原有返回格式
+        """
+        books = self.get_all_books()
+        if not books:
+            logger.info("📚 未找到任何有效书籍")
+            return None
+        
+        # 加权随机选书：进度越少，权重越高
+        if self.use_weighted_random:
+            book_weights = []
+            for book in books:
+                book_progress = self.progress.get(book, {"pos": 0, "file_size": 0})
+                pos = book_progress["pos"]
+                file_size = book_progress["file_size"] or os.path.getsize(os.path.join(self.book_dir, book))
+                progress = pos / file_size if file_size > 0 else 0.0
+                # 权重 = 1 - 进度，进度越少权重越高
+                weight = max(0.1, 1.0 - progress)
+                book_weights.append(weight)
+            
+            # 归一化权重
+            total_weight = sum(book_weights)
+            normalized_weights = [w / total_weight for w in book_weights]
+            
+            # 加权随机选择
+            book = random.choices(books, weights=normalized_weights, k=1)[0]
+        else:
+            # 纯随机选书（原有逻辑）
+            book = random.choice(books)
+        
+        # 读取页面
+        page = self.read_book_page(book)
+        if not page:
+            # 失败时重试其他书
+            for _ in range(2):
+                other_books = [b for b in books if b != book]
+                if not other_books:
+                    break
+                book = random.choice(other_books)
+                page = self.read_book_page(book)
+                if page:
+                    break
+        
+        if not page:
+            logger.warning("📚 所有书籍都无法读取有效内容，请检查txt文件是否正常")
+            return None
+        
+        # 读完一整本书时，生成读完记忆
+        if page.is_new_cycle and self.mark_new_cycle:
+            logger.info(f"🎉 已读完《{page.book_name}》一整遍！")
+            # 这里可以触发事件总线，让大脑生成读完记忆
+            # self.event_bus.emit(Event("BOOK_FINISHED", {"book_name": page.book_name}))
+        
+        # 兼容原有返回格式，上层代码完全不用改
+        return {
+            "book_name": page.book_name,
+            "content": page.content,
+            "progress": page.current_progress,
+            "is_new_cycle": page.is_new_cycle
+        }
+
+    def get_book_progress(self, book_name: str) -> float:
+        """获取指定书籍的阅读进度（0.0-1.0）"""
+        book_path = os.path.join(self.book_dir, book_name)
+        if not os.path.exists(book_path):
+            return 0.0
+        
+        file_size = os.path.getsize(book_path)
+        if file_size == 0:
+            return 0.0
+        
+        book_progress = self.progress.get(book_name, {"pos": 0, "file_size": 0})
+        return min(1.0, book_progress["pos"] / file_size)
+
+    def reset_book_progress(self, book_name: str) -> None:
+        """重置指定书籍的阅读进度"""
+        if book_name in self.progress:
+            del self.progress[book_name]
+            self._save_progress()
+            logger.info(f"📖 已重置《{book_name}》的阅读进度")
+
+    def clear_blacklist(self) -> None:
+        """清空书籍黑名单"""
+        self.blacklist.clear()
+        logger.info("📚 已清空书籍黑名单")