距离 1.5.0 版本正式发布已近一个月，按照当前计划，1.5.1 版本还将经过约一个月的开发周期后正式发布，我们希望通过充足的验证，确保每一项改动都能在真实生产环境中稳定运行。
二次开发的核心原则与基础改造
TypeRenew 始终坚持基于 Typecho 进行现代化二次开发，而非对原有架构进行颠覆性重构。为此，我们确立了两条不可逾越的原则：
- 严格保留 Typecho 原有的接口契约，确保原主题与插件能够在 TypeRenew 上正常运行，所有公开方法的签名与功能均保持不变；
- 严控内核体积，每一行新增代码、每一个引入的依赖，都经过必要性评估，避免为追求"表面现代化"而导致内核臃肿。
基于上述原则，目前我们已完成两项奠定 1.5.1 版本的核心改造。
1、IANA 时区系统的全面升级。
旧版本采用固定 UTC 偏移量的时区处理方式，例如将东八区硬编码为 +28800 秒，这种模式无法识别地区属性，在处理夏令时、历史时区变更等场景时会出现时间失真问题。
我们将系统升级为基于 IANA 时区标识符的体系，通过记录 "Asia/Shanghai" 这类地区标识而非固定偏移量，由系统根据具体时间点动态计算偏移值，完美解决了上述问题。
同时，系统会在启动时自动完成旧配置到新体系的平滑迁移，老用户升级过程完全无感。
2、客户端 IP 获取体系的重构。
获取访客真实 IP 是一个典型的安全与灵活性平衡问题：
- 直接信任 X-Forwarded-For 等转发头存在 IP 伪造风险
- 完全不信任则会导致部署在 CDN 或反向代理后的站点无法获取真实 IP。
为此，我们设计了可配置且默认安全的 IP 获取机制：
系统默认仅信任不可伪造的 REMOTE_ADDR 来源，管理员可根据自身部署架构显式指定需要信任的转发头；对于高安全需求场景，还支持配置可信代理白名单，仅当请求来自白名单内的代理时，系统才会采信对应的转发头信息。
过去一个月的核心开发内容
过去一个月的工作主要围绕前端技术栈升级、移动端体验优化、安全加固、性能优化与历史 Bug 修复五个维度展开。
1、前端技术栈升级，也是本次工作量最大的部分。
即便是最新发布的 Typecho 1.3.0，其后台使用的 jQuery 依旧长期停留在 2014 年发布的 2.1.1-rc2 候选版本，存在安全隐患与兼容性问题，目前我们已经将其升级至官方最新稳定版 3.7.1。
但升级过程并非简单替换文件，jQuery 3.x 移除并修改了大量 API，导致原有的 jQuery UI 1.10.3 与时间选择器插件无法兼容。
为此，我们将 jQuery UI 同步升级至 1.13.3，并摒弃了体积庞大的官方完整版，仅保留项目实际使用的日期选择、滑块、高亮效果等组件进行重新打包，最终体积控制在 79KB 左右，与升级前基本持平。
同时，我们逐一修复了因 API 变更导致的兼容性问题，例如文章预览中 iframe 加载事件的绑定方式、废弃 API 的调用等。
2、完成了手机端排版布局的优化，针对移动端使用场景调整了界面适配逻辑，进一步提升了移动端用户的操作体验。
3、安全方面，对前台输出转义模型进行了系统性梳理，修复了文章作者昵称、评论表单回填值等场景下存在的转义不完整漏洞。
需要特别说明的是，我们并未采用框架底层全局转义的简单方案，因为文章正文与评论内容需要保留合法的 HTML 标签，全局转义会破坏所有现有主题的展示效果。
我们的做法是在每个输出方法中，根据数据的实际使用场景进行精准转义：
- 纯文本字段执行严格转义；
- 允许保留HTML的字段则保持原样。
这种方式既堵住了安全漏洞，又实现了对主题的完全透明，无需修改任何现有调用代码。
4、性能优化方面，重点解决了分类与标签管理中的 N+1 查询问题。
原有的合并、刷新、清理等操作采用循环逐条查询数据库的方式，在标签数量较多时会出现明显的性能下降。
目前已经通过批量化思路重构了相关逻辑，将 "循环内 N 次查询" 改为 "单次批量查询 + 内存处理"，以刷新分类计数操作为例，原逻辑处理 10 个分类需要执行 20 次 SQL，优化后仅需 4 次左右。
整个优化过程完全基于 Typecho 原有查询构造器支持的 WHERE IN 与 GROUP BY 语法实现，所有方法签名保持不变，主题与插件不受任何影响。
5、此外，还修复了一个从 Typecho 1.3.0 版本继承而来的历史 Bug：删除文章后，本应被自动清理的 "孤儿标签" 从未被真正删除。
经排查，问题根源在于清理方法被定义在子类中，而删除文章的逻辑通过父类调用该方法，导致调用静默失败且不产生报错。
我们将清理方法下沉至正确的基类，使两条调用路径均能正常工作，修复后标签表将不再堆积无用的"僵尸数据"。
写在最后
TypeRenew 的现代化进程，本质上是在 "现代化特性" 与" 轻量内核" 之间寻找最佳平衡点的过程，而这个平衡点的确定，离不开广大真实用户的反馈。
如果您在使用过程中遇到问题、有功能方面的建议，或者对我们的某项技术取舍有不同看法，都欢迎与我们联系。
您的每一条反馈，都将成为我们后续开发决策的重要依据。
感谢大家的支持与陪伴，1.5.1 版本，一个月后见。
暂无评论