Y Yuan Tools
2026/7/6

第九个工具：日期天数计算器，从真实搜索需求出发做一个小工具

记录日期天数计算器的需求分析、SEO 关键词拆解、功能实现和全链路脚本化验证过程。

第九个工具：日期天数计算器，从真实搜索需求出发做一个小工具

这次我没有只从“做一个日期计算工具”这个功能名出发，而是先看用户真正会遇到的场景：考试还有多少天、合同什么时候到期、项目截止前还剩几个工作日、纪念日已经过去多久、两个日期之间到底相隔多少天。

这些问题看起来都很小，但用户真正烦的是不想手动翻日历，也不确定“今天算不算一天”。如果再加上工作日、周末、节假日排除，手算就更容易出错。所以这个工具的目标很明确：打开页面，填日期，马上得到可以信任的结果。

配图建议：放一张日期天数计算器的桌面宽屏截图，突出自然日、工作日、倒计时三个结果区域。

这次的 SEO 关键词

我把这个工具的核心关键词定为：

  • 日期计算器
  • 天数计算器
  • 时间差计算器
  • 两个日期之间多少天
  • 倒计时计算器

这些词背后对应的是同一个需求族：用户想快速得到一个日期差结果，并且希望规则清楚。工具页面和在线使用页都围绕这些关键词写标题、描述和页面文案，但不堆砌关键词，而是把它们放在真实功能里。

功能取舍

v0.1.0 做了四类能力：

  • 两个日期之间相差多少天。
  • 从今天到目标日期的倒计时。
  • 工作日计算，默认排除周六和周日。
  • 自定义节假日排除，以及精确到分钟的时间差。

我没有内置每年的法定节假日，因为节假日和调休规则会变化。一个旧的内置表反而容易误导用户。现在的方案是让用户粘贴实际要排除的日期，这对合同、考试、公司假期和项目排期都更稳。

脚本化流程的收益

这次继续使用 D:\dev\yuan-tools\scripts\yuan_pipeline.py 作为唯一自动化入口。流程里真正省心的地方是：脚手架、UTF-8 检查、测试、Web 构建、Windows EXE 打包、Release 资产整理、站点同步和站点体检都由脚本接管。

实际验证中，validate-tool 一次性跑完：

  • UTF-8 检查。
  • npm install。
  • npm run test。
  • npm run build。
  • npm run release:web。
  • npm run release:win。
  • 发布目录预检。

第一次 Tauri/Rust 编译依然是最慢的步骤，但这是工具链的正常成本。后续同类项目如果复用缓存，会快很多。

发布结果

这次工具已经完成 v0.1.0 发布：

上线后，用户可以通过 Yuan Tools 网站访问：

这次流程里比较值得记录的是：功能实现并不复杂，真正需要长期优化的是“每次都能稳定发布”的链路。脚本化以后，我可以把更多精力放在需求判断、SEO 入口和工具体验上，而不是每次重复检查目录、复制静态包和手动核对资源路径。