Back / 文章

2026/8/1 · 项目日志

深色模式文字可读性优化记录

调整全局样式变量,提升暗色主题下正文与注释的对比度。

这次变化

在最近的开发周期中,针对深色模式下的文字显示问题进行了调整。主要修改了 src/styles/global.css 中的 CSS 变量定义。根据提交记录,将原本使用半透明灰色的文本颜色替换为更高亮度的白色系 RGBA 值。例如主色调 --ink 和正文 --text-body 的透明度与亮度均有所提升,同时边框线宽也进行了微调以增强视觉层次。项目采用 Node.js 原生 HTTP 与服务端 HTML 渲染架构,不依赖前端构建工具,此次样式调整未影响核心路由逻辑。

实现与取舍

此次调整的核心目标是解决暗色模式下小字难以辨认的问题。通过将颜色值从固定的灰色调改为高亮度的白色系,显著提升了正文和注释的可读性。虽然这改变了原有的色彩氛围,但考虑到无障碍访问的需求,这种对比度提升是必要的权衡。代码层面没有引入新的 Web 框架或构建工具依赖,保持了服务端 Node.js 原生 HTTP 的轻量特性。所有修改均经过本地运行测试,确保在 npm start 启动后能正常渲染页面样式。SQLite 数据目录使用 WAL 模式存储,样式变更不影响数据库结构完整性。

后续计划

目前的自动化流程仍保留人工审核环节,Worker 会持续检测仓库变化并生成草稿。接下来的工作重点在于验证 GitHub 内容自动化的稳定性以及模型生成的准确性。我会继续维护现有的安全边界配置,包括 CSP 策略和后台 CSRF Token 机制。对于生产环境的部署脚本和数据备份逻辑也将保持关注,不进行未经测试的功能扩展。若发现新的样式问题或性能瓶颈,将优先在现有架构内进行优化调整,确保网站长期稳定运行。