2026/7/5

第六个工具:时区时间转换器与脚手架流程测试

这次我做了一个时区时间转换器,重点不只是工具功能本身,也是在验证新加入的 Python 脚手架是否能减少重复建项目时的错误。

第六个工具:时区时间转换器与脚手架流程测试

这次我做的是一个和时间有关的小工具:时区时间转换器。

它的功能并不复杂:选择一个源时区和源时间,然后换算到多个目标时区。比如我在中国时间下午 3 点开会,可以很快看到纽约、伦敦、东京、洛杉矶分别是几点。

但这次真正想验证的,不只是时区换算,而是我刚刚加入的新流程:用 Python 脚本先生成标准项目骨架,再在稳定骨架上开发功能。

为什么要先做脚手架

前几个工具都是我一次次手工创建项目结构。虽然最后都能跑通,但每次都容易漏一些固定细节:

  • Tauri 的 icon.ico
  • release/htmlrelease/win 的复制脚本。
  • Vite 的 base: "./"
  • Windows EXE 隐藏终端窗口的 Rust 配置。
  • README 和工具使用说明。
  • .gitignore.gitattributes、测试目录和 Tauri 配置。

这些内容不是创意,也不是每个工具的核心价值。它们应该由脚本稳定生成。

这次的工具功能

时区时间转换器 v0.1.0 包含这些功能:

  • 选择源时区。
  • 选择源日期和时间。
  • 勾选多个目标城市/时区。
  • 展示目标时区的日期、时间、星期、UTC 偏移和跨日提示。
  • 查看多个目标时区当前时间。
  • 复制转换结果。
  • 导出 TXT 文本。

工具使用浏览器内置的 Intl 能力完成换算,不需要后端服务,也不会上传时间或日程数据。

这次流程的意义

这个工具让我验证了一个更长期的方向:以后开发新工具,不应该再从空文件开始手写基础工程结构,而应该先运行:

$env:PYTHONUTF8='1'; python D:\dev\yuan-tools\scripts\yuan_pipeline.py scaffold-tool --slug timezone-converter --name 时区时间转换器 --port 1425

脚手架生成后,我只需要专注于真正的业务逻辑和界面体验。

这会让后续工具更稳定,也会让我把精力放在“这个工具是否真的好用”上,而不是反复处理项目初始化细节。

发布链接