dsh-tool-time 使用指南

为 DSH Agent 提供纯函数时间工具：严格 ISO 解析、IANA 时区转换、UTC 日历加减与固定时长差，零依赖不弹进程。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit#path:packages/dsh-tool-time

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

这个插件会起 bash 进程跑 date 命令吗？

不会。插件全部逻辑由 Node 内置 Date 与 Intl.DateTimeFormat 实现，纯函数、零进程，性能稳定且不依赖 GNU/BSD date 的差异。

时区转换和"加一天"是按哪个时区算的？

转换（convert）按 IANA 时区展示墙钟；日历加减（add）始终按 UTC 运算，timezone 字段只影响结果里的 local/formatted 显示字段，不会影响实际加减后的 instant。

支持自然语言日期如"next week"或"下周三"吗？

不支持。只能接受严格 ISO 8601 子集（YYYY-MM-DD 或带时分秒/偏移），RFC 2822 和自然语言一律拒绝，避免歧义和模型心算误差。

年份范围有限制吗？

输入和计算结果年份都必须在 1000 到 9999 之间；1000 之前 JavaScript Date 有 1900+ 映射的历史坑，超过 9999 则偏移计算与 Intl era 会失真。

diff 能输出"几个月""几年"吗？

不能。diff 只输出固定时长（毫秒/秒/分/时/天/周），因为月和年无法从毫秒唯一推导；如果需要日历月差请用 add 加减后再减。

安装到 web profile 后 dsh run 也能用吗？

不能直接用。web 与 headless 是两个独立 profile，需要分别安装；dsh run 默认走 headless profile，记得用 --profile headless 也加一次。

卸载会改 dsh 本体或我的 API Key 吗？

不会。插件卸载只移除工具注册，不动 dsh 安装、凭据、provider 配置；同理重装 dsh 也不会自动回带本插件。

执行超时怎么办？

工具声明的超时时间是 1 秒。四个 action 都是本地纯函数，正常毫秒级完成；如果真触发 timeoutMs 几乎一定是 Node ICU 数据异常或系统时钟异常，需要重启环境。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则