v0.1.8

dsh-clock-tools 0.1.8 — 发行说明

• 状态：已发布（GitHub Releases，2026-10-25）
• 包：dsh-clock-tools-0.1.8.zip
• 大小：17,848 bytes
• SHA-256：f862f940640693c1d64828e0a386a97dc8c3c83d7330b232cdfd0854c1890bee

0.1.8 变更

新增可关闭的「时间规则」注入，默认开启。这是本版唯一的代码变更：

• 通过 ctx.systemPrompt.context() 注入三条固定规则（一行标题 + 3 条 bullet），不产生 user 消息，不作为对话消息出现在历史里。
• 关闭优先级：Profile patch 的 config.injectTimeRules: false 最高；其次是 ~/.dsh/clock-context/config.json 里的 {"injectTimeRules": false}；两者都没有时默认注入。
• 配置文件不存在、不是合法 JSON、字段不是布尔值时，一律当作「未配置」并回退默认开启。
• 开关在 DSH 启动、插件加载时读取，改完需要完全退出 DSH 再启动。
• 三条规则保持与 README 一致：报时间/写时间戳前先查 task_clock、不推算；HH:MM 截断不四舍五入；跨度不等于工时，有断档分段说。

文档与测试：

• 新增 2 个单元测试（默认注入、关闭优先级 + 坏文件回退），测试总数 16 → 18。
• README 新增「时间规则注入（默认开启）」章节；更新「让 Agent 真的用起来」「Token 与系统开销」「隐私与数据」「已知限制」「测试」「版本信息」。
• 版本号升至 0.1.8。

文件清单（7）

dsh-clock-tools/
├── LICENSE
├── README.md
├── cordis.patch.yml
├── index.js
├── package.json
└── locale/
    ├── en.json
    └── zh.json

验证

• 源目录与 repo 一致校验通过（7 个文件，忽略 CRLF）。
• 单元测试 18 个全部通过（node --test，mock ctx）。
• 0.1.8 未做新的真实会话实测：注入开启/关闭两条路径由单元测试覆盖。

安装

需要 DSH 0.2.1-rc.2 或附近版本；Profile 级；安装后完全退出 DSH 再启动。

1. 解压 ZIP
2. 插件页面 → 添加插件
3. 选择解压出来的 dsh-clock-tools 目录（不是 ZIP 文件）
4. 安装 → 立即启用
5. 完全退出 DSH，再启动

卸载：插件页面 Remove（流程未实测）；任务记录 ~/.dsh/clock-context/tasks.json 不会删除。

v0.1.7

dsh-clock-tools 0.1.7 — 发行说明

• 状态：已发布（GitHub Releases，2026-10-25）
• 包：dsh-clock-tools-0.1.7.zip
• 大小：16,218 bytes
• SHA-256：8f9aae6d72f59fe6cb69040124d612ffe0d26f0171bf8affc5f0f9b6665ce9f0

0.1.7 变更

本次只改文档，index.js 无变化：

• README 新增「让 Agent 真的用起来」章节：三条时间规则（报时间先查、写进文件的时间戳同样要查、查到原样用），并说明要写进项目的 AGENTS.md。
• 安装节末尾补充一句指引，指向该章节。
• 已知限制第 4 条补充交叉引用：插件无法强制 Agent 调用 now，可行补法是写进 AGENTS.md。
• 更新工具 Schema 的 Token 实测数据（schema 1,927 字符，约 480 tokens / 请求，按 4 字符/token 估算）。
• 版本号升至 0.1.7。

文件清单（7）

dsh-clock-tools/
├── LICENSE
├── README.md
├── cordis.patch.yml
├── index.js
├── package.json
└── locale/
    ├── en.json
    └── zh.json

验证

• 源目录与 repo 一致校验通过（7 个文件，忽略 CRLF）。
• 单元测试沿用 0.1.6 的 16 个，代码未改动。
• 0.1.7 未做新的会话实测（纯文档变更）。

安装

需要 DSH 0.2.1-rc.2 或附近版本；Profile 级；安装后完全退出 DSH 再启动。

1. 解压 ZIP
2. 插件页面 → 添加插件
3. 选择解压出来的 dsh-clock-tools 目录（不是 ZIP 文件）
4. 安装 → 立即启用
5. 完全退出 DSH，再启动

卸载：插件页面 Remove（流程未实测）；任务记录 ~/.dsh/clock-context/tasks.json 不会删除。

v0.1.6 — 报时间前必须查

0.1.6 — 报时间前必须查，且不许加工

变化

task_clock 描述补全 now 的完整规则：

1. 说当前时间或做「几点了」判断前调 now，用最新结果；不从旧消息、快照、估计、耗时推断；不复用旧结果。
2. 查询后有长时间工具调用或明显延迟，报时间前再查一次。
3. 默认报 HH:MM，截断秒数、不四舍五入；问秒就给秒。
4. 任务耗时用 task_clock 的测量值，不要为了报耗时才调 now。

README 已知限制：插件不能强制 Agent 调用 now，描述只是提示，真正强制需要宿主层。

验证

• 单元测试 16/16
• schema 校验通过
• 仅描述文本变化，计时逻辑未动

资产

• dsh-clock-tools-0.1.6.zip（15,991 bytes）
• SHA-256: d70bcf9a50c25835dcff7bef4855f98aed3d4e9d72e22142b5432dc7d0c0b258

v0.1.5 — 重启电脑后续算

0.1.5 — 重启电脑后续算（前后精确，只估关机空档）

变化

• 分段计时改为 accumulatedMs + 计时基准，修正跨重启公式的重复计时
• 跨 DSH 重启：accumulatedMs + (processStartUptime - baseUptime)×1000 + (nowMono - processStartMono)
• 跨系统重启：accumulatedMs + (processStartWall - baseWall) + (nowMono - processStartMono)，标 resumed-gap
• 有 running 任务时每 10 秒做一次本地检查点（不调模型、不产生 Token）
• Linux 启动周期识别：读 /proc/sys/kernel/random/boot_id，读不到回退墙钟推断
• 修复：同进程 wallJump 误把总累计耗时当本段比较；跨重启类型未保留

验证

• 单元测试 16/16
• 真实重启电脑（2026-10-24）：check 显示 Elapsed: 3m 8s (resumed, gap estimated)，finish 显示 Actual: 3m 9s (resumed, gap estimated)；实际经历 3m10s，差 1 秒
• 只重启 DSH：0.1.4 实测 resumed
• 未测：任务管理器强杀、崩溃、系统时间前拨/回拨、睡眠/休眠、Linux / macOS

资产

• dsh-clock-tools-0.1.5.zip（15,623 bytes）
• SHA-256: 3e88e4b4c23693fec6850a14f6cd52bfba97a5079eafd1f8622dea132ae33433

v0.1.4 — 跨重启续计时

0.1.4 — 跨重启续计时

DSH 重启后，不再必然退回墙钟估算。

变化

• 任务记录新增 startedUptime / startedBootWall / lastSeenUptime / lastSeenMono / lastSeenBootId
• 仅重启 DSH（系统未重启）：用 os.uptime() 桥接空档，状态 resumed，标注 (resumed, uptime-bridged)
• 系统重启 / 墙钟被改到无法确认：退回墙钟估算，标注 (estimated)，不假装精确
• 每次调用更新 lastSeen，异常退出（强杀/崩溃）时兜底，最多丢几秒
• 修复：跨进程 markSeen 覆盖旧锚点，导致 check 之后 finish 失效

验证

• 单元测试 13/13（新增跨进程桥接、系统重启退回、墙钟被改保守降级）
• 真实跨重启（DSH 0.2.1-rc.2）：正常关闭 → 约 30 秒后重开 → check 显示 Elapsed: 1m 6s (resumed, uptime-bridged)；finish 保持 Actual: 1m 10s (resumed, uptime-bridged)
• 未测：任务管理器强杀、崩溃恢复、Windows 重启后恢复旧任务、系统时间前拨/回拨、睡眠/休眠

资产

• dsh-clock-tools-0.1.4.zip（13,923 bytes）
• SHA-256: 58fba9f879320459e13e5385354be5a27b24f1ef614fa8232511e3aaaee63a00

v0.1.3

0.1.3

• list: running tasks now use the monotonic clock (same basis as check/now); restart/wall-jump/unknown are labeled
• finish: Variance is marked (estimated) when timing continuity is not continuous
• tool description trimmed (~8%) while keeping the rules: query now instead of guessing, host-measured elapsed, restart may be estimated/unknown, no auto start/cancel
• docs: known limitations grouped by behavior / trust / test-cost

Tests: 10/10. now verified in Standard sessions only; Cordis/Minimal/PTC not re-tested for now.

v0.1.2

0.1.2

• docs: remove pre-release wording, link repo/releases
• index.js header lists all five actions
• plugin description in Chinese for zh locale
• no logic changes; task_clock now/start/check/finish/list unchanged

v0.1.1

dsh-clock-tools 0.1.1

• task_clock now: current local time and time zone (use it instead of guessing)
• start/check/finish/list: host-measured task timing
• Standard tested; Cordis/Minimal/PTC four actions tested on 0.1.0

Install: dsh plugin --profile add ""