dsh-message-datetime
简体中文 ·
English
每个对话 turn 开始时，向模型上下文注入简短时间戳与跨轮空闲间隔的 dsh 插件（DeepSeek Harness / cordis plugin）。
模型由此始终知道"现在几点、今天星期几、上一轮何时结束、闲置了多久"——日期运算、"今天/明天"语义、跨轮空闲间隔感知、yymmdd 路径命名等不再需要询问用户或猜测。
模型看到什么
每个 turn 的第一个 step，在用户消息之后追加一条单行通知（约 30~50 token，append-only 不破坏 KV cache）：
首轮（无上一轮记录）：
Current time: Tue 2026-09-15 01:04:34 +08:00 (Asia/Shanghai)
后续轮次（自动合并上一轮结束时间与闲置时长）：
Current time: Tue 2026-09-15 01:04:34 +08:00 (Asia/Shanghai) | Last turn ended: Tue 2026-09-15 00:39:34 +08:00 (idle for 25m)
通知在 GUI 中渲染为折叠的 context chip（非用户气泡），折叠行显示去掉秒的摘要与闲置时间（例如 Current time: Tue 2026-09-15 01:04 +08:00 (idle 25m)），点击展开完整文本。
行为规则与设计理念
- 每 turn 恰一条（开场注入）：仅
step === 1 注入；turn 内后续 step（工具调用续步）不重复。
- 保护 DSH 原生分支（Fork）：不在 turn 收尾时向会话末尾追加独立节点，避免破坏 Web UI 中
turn-tail（操作栏）的“最后一条消息”约束，确保每轮的分支功能畅通无阻。
- 开箱即用的跨轮感知：无需模型自己翻阅历史计算耗时，下一轮自动从会话日志解析上一个
turn/end 时间戳，并直接计算友好的空闲间隔（如 <1m、25m、1h 10m、2d 5h）。
- 覆盖所有会话：用户 turn、goal 自动续跑 round、subagent turn 均注入（subagent 无浏览器上下文，最需要时钟）。
- 时区解析链：本 turn 浏览器上报时区（
clientTimeZone，唯一时才采用）→ 配置的 timeZone 回退 → Node 进程时区。无效值静默回退，绝不打断 turn。
- replay 安全：读数为
user/message（plugin-attributed notice），位于 step 窗口内，满足 token-meter replay 约束；机制与官方 @deepseek-ai/dsh-time-context 同源。
配置
- id: message-datetime
name: dsh-message-datetime
config:
timeZone: Asia/Shanghai # 可选：浏览器时区不可用时的回退显示时区（默认进程时区）
与官方 dsh-time-context 的区别
| 维度 | @deepseek-ai/dsh-time-context | dsh-message-datetime |
|---|
| 注入频率 | 每个 eligible step | 每 turn 两条（开场 + 收尾） |
| 单条体量 | 三行（时间 + 时区政策 + elapsed） | 单行 |
| 定位 | 严格时区政策解释（Schedule 场景，opt-in） | 轻量时钟感知 + 跨轮间隔感知（常驻） |
两者不建议同时启用（会双重时间注入）。
安装
dsh plugin --profile web add dsh-message-datetime
安装后无需手动改配置，插件自带的 cordis.patch.yml 自动挂载生效；timeZone 为可选回退项（见上文配置）。
从 GitHub 直装（源码安装，pnpm ≥10 需允许构建脚本）：
dsh plugin --profile web add github:john-walks-slow/dsh-message-datetime
# 首次 add 会被 pnpm 拦截：把 pnpm 提示的包名加入
# ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 后重跑
权限与兼容
- 零权限：无外部服务、无网络请求、无文件系统写入；仅向会话上下文追加两条
user/message 通知
- 依赖：
@deepseek-ai/cordis 4.0.2 / @deepseek-ai/dsh-llm 0.1.2-rc.1（与 dsh 0.1.2-rc.1 锁定版本对齐），Node ≥ 22.5
- 中断安全：任何注入失败均降级为 warn，绝不打断 turn
本地开发
npm install
npm run build # tsc → dist/src
npm test # tsc(含 test) + node --test dist/test/*.test.js
本机 profile 接线（link 方式）：/root/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组加 "dsh-message-datetime"，dependencies 加 "dsh-message-datetime": "link:/root/projects/dsh-message-datetime"，然后 pnpm install。
- 参考实现：
@deepseek-ai/dsh-time-context（/usr/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-time-context）
- 依赖必须显式声明在
dependencies 并本地安装（link 包 ESM 解析坑，见 dev-dsh-plugin 技能）
发新版
改动入库后一条命令完成测试、版本号、打包（npm version 会自动 commit 并打 tag）：
npm run release # patch；较大更新改用：npm version minor 或 major
然后指纹发布并推送：
node ~/.agents/skills/npm-publish/scripts/publish-webauthn.cjs /tmp/dsh-message-datetime-<新版>.tgz
git push --follow-tags
发布后 npm view dsh-message-datetime version 复验。批量发多个包时，在指纹页勾选“5 分钟内同 IP 不再挑战”，一次指纹即可连发。
