Release v3.0.2

v3.0.2 (2026-08-13)

总结 / Summary

本版本修复了日志记录中的堆栈跟踪遗漏以及 API 错误响应中的内部信息泄露，改用更可靠的异常日志方式，并让启动脚本强制拉取最新镜像。文档方面补充了运行时日志访问说明、基于 Python 3.14 与 PEP 758 的语法指南更新，以及更新器的健康检查与更新后同步说明。此外完成了 Sakura 相关的反思记录、知识提取与记忆整合。

This release fixes missing tracebacks in logging and internal detail leakage in API error responses, adopts more reliable exception logging, and forces pulling latest images on service startup. Documentation adds guidance on accessing runtime logs, updates Python syntax guidelines to align with the 3.14 baseline and PEP 758, and covers updater health verification and post-update synchronization. It also includes Sakura-related reflections, knowledge extraction, and memory consolidation.

中文更新日志

问题修复

• 用户配置中将 logger.error 替换为 logger.exception，以正确记录堆栈跟踪
• 安全模块改用 loguru 异常日志记录，替代 exc_info=True
• 从 API 错误响应中隐藏内部错误详情
• 启动脚本在服务启动时强制拉取最新镜像

文档更新

• 记录应用运行时日志的访问方式
• 更新 Python 语法指南，使其基于 3.14 基线并符合 PEP 758
• 在更新器文档中要求手动健康检查
• 在更新器文档中补充更新后同步说明

其他变更

• 为 PR #487、#488、#491、#492 及 Issue #489、#490 添加反思记录
• 从反思中提取结构化知识
• 整合记忆（reflection #5、#10）
• 合并拉取请求 #488（堆栈跟踪暴露热修复）
• 合并拉取请求 #487（更新器文档热修复）

English Changelog

Bug Fixes

• Replace logger.error with logger.exception in user-config to properly log tracebacks
• Replace exc_info=True with loguru exception logging in security module
• Hide internal error details from API error responses
• Force pull latest images on service startup in start.sh

Documentation

• Document how to access application runtime logs
• Update Python syntax guidelines to align with the 3.14 baseline and PEP 758
• Require manual health verification in updater documentation
• Document post-update synchronization in updater documentation

Other Changes

• Add reflections for PRs #487, #488, #491, #492 and Issues #489, #490
• Extract structured knowledge from reflections
• Consolidate memory (reflections #5 and #10)
• Merge pull request #488 (hotfix for stack trace exposure)
• Merge pull request #487 (hotfix for updater documentation)