temporal-cortex-datetime

⏱️ 离线自然语言时间解析与DST感知计算

本地离线的时间处理工具集,支持自然语言解析、时区转换、DST感知计算,无需网络与凭证,Rust二进制运行安全可靠。

收藏
3.7k
安装
1.5k
版本
0.7.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Temporal Cortex Datetime 是一套专为 MCP 生态设计的离线时间处理工具集,通过 5 个原子化工具覆盖完整的时序操作需求:

1. `get_temporal_context` — 会话启动必调,获取当前 UTC/本地时间、IANA时区、DST状态、ISO周次等完整上下文
2. `resolve_datetime` — 将 60+ 种自然语言表达式(如 "next Tuesday at 2pm"、"third Friday of March")解析为标准 RFC 3339 格式

3. `convert_timezone` — 带 DST 智能处理的时区转换

4. `compute_duration` — 计算两个时间戳间的精确时长(天/小时/分钟/秒)

5. `adjust_timestamp` — DST 感知的时间偏移,跨夏令时切换保持 wall-clock 时间一致

显著优点

完全离线运行:Rust 编译的二进制通过 npm 一次性分发,安装后零网络访问、零文件写入、零凭证依赖。Docker 模式更可启用 --network=none 实现操作系统级网络隔离。

安全可审计:构建流程完全开源(GitHub Actions 交叉编译),每个版本发布独立 SHA256 校验和,安装脚本内置哈希校验(不匹配则终止执行),支持用户独立验证。

DST 精确处理:区别于简单的偏移量计算,工具内置 IANA 时区数据库,能正确处理全球各地区的夏令时切换边界(如 spring-forward 时 +1d 保持 23:00 不变)。

自然语言解析:支持相对时间、周期边界、序数星期等复杂表达式,降低用户输入门槛。

潜在局限

  • Node.js 依赖:首次安装需 npx/Node.js 18+ 或 Docker,对纯浏览器环境不友好
  • 无持续同步:依赖系统时钟,长期运行的会话需周期性重调 get_temporal_context
  • 仅处理公历:不支持农历、伊斯兰历等其他历法
  • 配置文件单一:仅读取 ~/.config/temporal-cortex/config.json,无多配置文件切换机制

适合人群

  • 隐私敏感用户(零云端交互、零遥测)
  • 跨时区协作团队(自然语言转标准时间戳)
  • 自动化工作流开发者(可靠的 DST 计算避免会议时间错误)
  • 安全审计环境(可 Docker 隔离、可源码审计)

常规风险

| 风险类别 | 说明 |
|---------|------|
| 供应链攻击 | npm 包下载阶段存在中间人风险,建议通过独立校验 GitHub Release 的 SHA256SUMS.txt 验证 |
| 时区数据过期 | 内置 IANA 数据库需随版本更新,旧版本可能无法处理新宣布的 DST 变更 |
| 解析歧义 | 自然语言如 "next week" 存在主观解释差异,工具依赖预设 WEEK_START 配置 |
| 容器逃逸 | Docker 模式建议配合 seccomp/apparmor 使用,尽管二进制本身无特权操作 |

temporal-cortex-datetime 内容

references文件夹
手动下载zip · 4.6 kB
DATETIME-TOOLS.mdtext/markdown
请选择文件