deepseekplugins

DeepSeek Harness 插件

dsh-when

DSH 插件：自然语言相对时间 → ISO 解析工具（when），零依赖。（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
ZhijiangTang/dsh-when
最近更新
2026年8月16日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/ZhijiangTang/dsh-when
插件名：dsh-when
作者：ZhijiangTang

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-when

DSH 插件：把中文自然语言相对时间短语解析成 ISO 时间戳，注册一个 when 工具。纯 ESM、零依赖、无构建。

安装

dsh plugin --profile <name> add file:./plugins/dsh-when
# 或 npm 发布后：dsh plugin --profile <name> add dsh-when

安装后组合层挂载 when 工具（when 层 id）。

工具：when

参数：

参数类型必填说明
textstring是自然语言时间短语，如 明天 9 点、2 小时后、下周一 9 点、18:30 或 ISO 8601
tzstring否IANA 时区名（如 Asia/Shanghai、UTC），默认本地时区；无效时区返回规范错误
nowstring否ISO 8601 基准时间，默认当前时间

返回规范值：{ ok, text, iso, local, relativeSeconds, matchedPattern, errors }

  • iso：UTC ISO 8601 字符串（带 Z）。
  • local：目标时区本地 ISO 字符串（带 ±HH:MM 偏移）。
  • relativeSeconds：目标时刻相对 now 的秒数（目标 − now，可为负）。
  • matchedPattern：命中的模式名（day-offset / duration / weekday / clock-time / iso）。
  • 失败时 ok:false，iso/local/relativeSeconds/matchedPattern 为 null，errors 给出原因。

支持短语表

| 模式名 | 短语 | 说明 | |---|---|---| | day-offset | 今天 / 明天 / 后天 [HH:MM\|HH点\|上午\|下午\|中午\|晚上] | 上午=9 点、下午=15 点、中午=12 点、晚上=20 点；缺时间默认 9 点 | | duration | N 分钟后 / 小时后 / 天后 / 周后 | N = 阿拉伯数字或中文数字「一到十」 | | weekday | 下周X / 周X [HH:MM\|HH点] | 本周已过的周 X 自动取下周；缺时间默认 9 点 | | clock-time | HH:MM | 纯时刻 = 今天该时刻，已过则明天 | | iso | ISO 8601 | 2026-08-16T09:00:00、2026-08-16T09:00Z、带 ±HH:MM 偏移、或纯日期（按 00:00 解释） |

「fail-fast 不猜语义」原则

本工具只解析明确支持的短语。任何无法识别的输入（例如 随便什么、明天上午9点 这种超出短语表的组合）都会返回 ok:false，并在 errors 中给出完整支持列表提示——绝不根据模糊语义“猜”一个时间，避免给下游（调度、提醒）埋下错误时间的隐患。

与 dsh-cron-parse 配套场景

  • dsh-cron-parse 解析 cron 表达式（结构化、周期性规则）并预览未来运行时刻。
  • dsh-when 解析一次性自然语言相对时间（“明天 9 点”“2 小时后”）得到具体时刻。
  • 两者互补：cron 表达周期性计划，when 表达单次时刻；when 的产物（ISO 时刻）可直接作为 dsh-scheduler 之类调度插件的一次性触发点。

自检

挂载时自动执行 4 条自检（明天 9 点 / 2 小时后 / 下周一 9 点 / 不支持短语），证据行输出到日志，前缀 [dsh-when]。

局限

  • 仅支持上表列出的短语形态，不支持“半小时后”“上午 9 点 30 分”等组合或口语化表述（fail-fast）。
  • ISO 无时区信息时按 tz（默认本地）墙钟解释；带 Z/偏移时按绝对时刻透传。
  • 夏令时切换瞬间的歧义/重复墙钟时刻按定点迭代的某一侧解释（与 dsh-cron-parse 一致）。

License

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类