从 行到 个文件，我只做了一件事

2026年7月19日我决定彻底重写冷旭帆的代码。过去的 core.py 已膨胀至512行，功能交叉、维护成本高。每次想加一个小功能，都得在同一文件里翻遍多处，几乎是“扫雷”式开发。

痛点这方面，单文件导致 修改成本高、测试困难、协作障碍、复用性差。这不是一次性的改动，而是长期迭代的瓶颈。

一、单文件的困境

• 情绪管理
• 状态标签维护
• 时间流逝模拟
• 事实与情景记忆存储
• 动作前缀与 System Prompt 建立
• AI 调用与回复解析
• 身份感知处理
• 保存/加载状态函数

一行代码要实现这些职责，代表着任何细微改动都可能触发连锁反应。

二、重构主要原则

1️⃣ 数据与逻辑分离

角色数据全部搬到独立目录，逻辑代码只处理流程和调用。

2️⃣ 单功能单文件

每个模块只负责一件事：perception.py。memory.py,identity.py,等等。修改时只需打开对应文件，无需全局搜索。话说回来，

3️⃣ 对话流程独立启动器

: Flask/FastAPI 启动；: 对话流程编排。其实，切换框架仅改启动脚本即可。

三、逐层拆分过程

说到第一层。基础设施

• : 日志程序，可单测。
• : 时间工具，无业务依赖。
• : 持久化接口，支持多种存储后端。

第二层这方面，主要引擎 拆分为五大模块：

def get_emotion_state: ...
def advance_time: ...

class MemoryManager:
def add_fact: ...
def decay: ...

class IdentityState:
def update_trust: ...

def generate_action: ...

def build_prompt: {...}

def run_dialogue: {...}

从第三层来看。角色数据 所有可变内容放在 JSON / YAML 文件中：

至于**效果**，添加或修改任何角色信息，只需编辑对应 JSON，无需触碰逻辑代码。

第四层这方面。API适配器 多网站容错路由：

• 阿里云百炼 qwen‑plus   
• 智谱 GLM‑Flash   
• DeepSeek V3   
• Ollama 本地模型   
• 硅基流动   
• 'Router' 按顺序尝试，每个请求记录完整日志，自动跳过失败或超时模型。

**编码坑**：PowerShell 写入 Python 时破坏 UTF‑8 导致 System Prompt 中文乱码，导致模型无法识别触发词 “哥哥”。说到方法，使用纯 Python 脚本生成配置文件。保持 UTF‑8 编码完整。

四、重构前后对比表格

痛点

• 高修改成本以前每改一点就要翻遍整个512行；其实，现在改一个 JSON 就能完成。
• 测试难度原来无法单元测试情绪程序；拆分后每个模块可独立 unit test。
• 协作瓶颈多人同时工作会冲突；其实，拆分后各自负责不同文件，冲突最小化。
• 未来 新增天气感知只需一个新模块 + 数据条目；按理说，不破坏现有逻辑，-->
• 持续集成CI pipeline 可以针对各子模块执行快速验证，提高发布频率。-->

五、收获与思考

“能跑” vs “能改”

之前项目稳定运行，却天天“祈祷不崩”。重构后可以安全地调整任何模块，因为耦合已降到最低。

白皮书也被重构

把项目白皮书拆成卡片式文档——每张卡片记录一种规则或数据更新场景。更新进度仅需改一行，不再在三万字中搜索。老实说，

架构并非一次性设计

留有预置接口和随时可 的数据目录。让未来增添新功能仅需要填充空白，而不需要 大规模拆解。其实，

对“过度设计”的坦诚说明

30个文件对原型项目显得繁琐。但冷旭帆不是一次性产物，而是长期迭代目标。投入一定架构复杂度是值得的。若项目规模极小且功能固定，可以保留较少文件。

六、接下来计划

1. 语义检索集成将 ChromaDB 与情景记忆结合，实现根据使用者输入自动检索相关历史。老实说，
2. 自动化测试覆盖为每个主要模块编写 unit + integration tests。实现持续集成，按理说，
3. 多语言支持通过 prompt_builder 把语言映射抽象化。以支持多语种对话，
4. 性能调整剥离耗时的 AI 调用包装，将异步请求整合到 dialogue_engine 中。

- 陆银 • 冷旭帆体验地址： 与冷旭帆对话 - 项目仓库： - 系列文章 & 白皮书：