前言¶

在 DeepSeek Harness（DSH）里接模型做对话或任务型智能体时，模型本身往往不知道「此刻」是几点、星期几、属于早中晚哪一段。用户说「下午五点见」，模型却回「夜深了早点睡」，本质是时间语境缺失，不是模型能力不够。

常见做法是往 system prompt 里手写当前时间，或让模型调用联网搜索——前者要自行维护刷新逻辑，后者既慢又未必对准用户本地时区。维护者 huhuai-ni 在 GitHub 发布的 dsh-clock 走另一条路：以 DSH 插件形式注册本地时钟工具，模型在需要时调用，读的是运行 DSH 进程所在环境的本地时间与时段，并附带口吻提示。社区目录 skillhub.cn 将其归类为「联网工具」；就插件自述而言，无配置、无依赖、无网络请求，能力完全来自本地时间计算。

这是什么¶

dsh-clock 是 DSH 生态里的轻量插件（package.json 版本 0.1.0，MIT 许可）。一句话定位：让 AI 知道现在几点——时间、星期、时段、该用什么口吻。

它通过 Cordis patch（cordis.patch.yml）向 Harness 暴露三个工具，供模型在生成回复前查询时间，避免把下午当成深夜、把工作日当成周末等常识性错位。

核心功能¶

README 中说明的三个工具如下。

clock_now 的返回里包含 hint 字段，是给模型的口吻建议，例如：早上宜说「早」而非「晚安」；下午避免「夜深了」「早点睡」；深夜可简短关心是否要休息。插件不替模型写死话术，只提供结构化事实与提示，由模型自行选用。

clock_until、clock_diff 用于相对时间表达——倒计时、间隔计算——与 clock_now 的「此刻快照」互补。

安装与启用¶

官方安装命令如下（来自 GitHub README，勿自行拼接 github:owner/repo 形式）：

dsh plugin --profile desktop add dsh-clock

说明：

1. 命令中的 --profile desktop 与 README 示例一致；若你使用其他 DSH profile，需按本机 DSH 文档调整 profile 名。
2. 插件声明 Node.js >= 22（见 package.json 的 engines）。
3. 无配置文件、无额外 npm 依赖；安装后通过 patch 注册工具，无需再填 API Key 或时区项（时区取自运行环境的系统设置，输出中会体现如 Asia/Shanghai、+08:00）。

典型用法与输出¶

模型在对话中按需调用 clock_now 即可。README 给出的 JSON 示例结构如下（字段含义以仓库文档为准）：

{
  "local": "2026-10-25 17:14:19",
  "weekday": "星期五",
  "period": "傍晚",
  "timezone": "Asia/Shanghai",
  "utc_offset": "+08:00",
  "day_progress": "72%",
  "minutes_left_today": 406,
  "hint": "傍晚。快到饭点了。"
}

典型流程可以是：用户提到「一会儿」「今晚」「还有多久到某点」→ 模型先调 clock_now 或 clock_until / clock_diff → 再组织回复。具体是否调用、调用哪一个，由模型与 Harness 的工具策略决定；插件侧只保证工具返回一致、可解析。

适用场景与注意¶

适合谁

• 在 DSH 上做桌面或本地助手，希望减少「时间幻觉」和不当问候的智能体开发者。
• 需要在回复里引用「今天星期几」「距离某时刻还有多久」而不想每次手动注入时间的场景。

务必注意

1. DSH 插件在 当前 dsh 进程的权限与环境 下运行；本地时间、时区、hint 均依赖该环境。安装前建议阅读 源码与 LICENSE，确认符合你的安全与合规要求。
2. 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，DSH 理念是「一切皆插件」；本文事实以 GitHub 仓库 README 为准。
3. 插件不发起网络请求，不能替代需要「全球统一 UTC 时钟服务」或「用户显式指定非本地时区」的复杂日程系统；跨时区协作仍需在业务层约定时区或额外工具。

结尾¶

dsh-clock 用三个本地时钟工具补上模型缺失的「现在几点」上下文，并用 hint 降低早中晚口吻错配的概率。安装一条命令、零配置即可试用。

• 目录页：https://www.skillhub.cn/plugins/huhuai-ni/dsh-clock
• 源码与说明：https://github.com/huhuai-ni/dsh-clock