dsh-clock-context

在 DSH 每次组装运行上下文时加入当前时间与时区,可配置标签、UTC、秒或分钟精度;用于给跨天任务提供时间参照,不是定时任务执行器。

快速判断

安装前先看这几项

配置资料
配置资料完整
配置难度
中等
适合新手
可以尝试
兼容状态
当前版本需要复核
验证状态
源码已审阅,未标记运行实测
本页目录(9)
功能

这个插件能做什么

在 DSH 每次组装运行上下文时加入当前时间与时区,可配置标签、UTC、秒或分钟精度;用于给跨天任务提供时间参照,不是定时任务执行器。

适合谁

需要长期记忆、聊天记录、上下文能力的用户

准备

安装前准备

  • 独立 DSH Profile(必需)使用 rc.1 的独立测试 Profile;固定来源只完成静态审阅,首次加载和卸载由使用者验收。
安装

如何安装 dsh-clock-context

本页命令固定使用 DSH 0.1.1-rc.2,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。

安装到
web Profile
DSH 基线
0.1.1-rc.2
安装来源
GitHub 源码(锁定提交)
固定目标
github:apex-mochen/dsh-clock-context#803a0e5f726d739046bb1098e0ace03aecffa23d

既有插件教程与安装命令的固定 CLI 基线,独立于 npm 默认分发;不代表每个插件已在该版本或新版本运行验证。更新前须逐项审核配置证据。

  1. 01
    检查 Node.js 与 pnpm

    DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且 pnpm 必须已在 PATH 中。先运行:

    环境检查
    node --version && pnpm --version
  2. 02
    安装到 Web Profile

    这条命令会把插件加入 web Profile,并在插件声明 DSH Bundle 时自动加入配置层。

    GitHub 源码(锁定提交)
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:apex-mochen/dsh-clock-context#803a0e5f726d739046bb1098e0ace03aecffa23d
  3. 03
    如遇构建脚本拦截

    GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建;只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yamlallowBuilds,审阅脚本后再重复上一步,不要使用全局放行。

  4. 04
    确认 Bundle 已进入配置

    安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-clock-context或对应 Bundle 层。

    检查配置
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
  5. 05
    启动并完成最小验证

    启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。

    启动 DSH Web
    npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
卸载与回退

测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-clock-context
配置

插件专属配置

独立 Profile 的 cordis.patch.yml
在已有 dsh-clock-context 项的 config 下设置时区和精度,避免重复插入同名插件。

已有 dsh-clock-context 插件项 · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。

复制 已有 dsh-clock-context 插件项 配置
- id: dsh-clock-context
  name: dsh-clock-context
  config:
    timeZone: Asia/Shanghai
    locale: zh-CN
    precision: minute
    includeUtc: true
    includeEpoch: false
    enabled: true

核对配置证据外部链接,在新标签页打开

  1. 按固定 GitHub 提交安装到测试 Profile,检查 Bundle 中存在 dsh-clock-context。
  2. 修改已有插件项的 config 后重启同一 Profile;不要照抄 README 中的 owner 占位命令。
验证

配置检查与成功结果

  1. 01
    间隔一段时间发起两次测试请求,要求引用上下文中的当前时间,并与本机正确时钟对照。

    期望结果:预期 clock:now 对应时间随上下文组装刷新、时区正确;这是待执行验收步骤,不是本站实测结果。

  2. 02
    设置 enabled 为 false 并重启测试 Profile,再检查上下文。

    期望结果:预期不再注入时间文本;若仍存在,检查是否重复加载。

使用

第一次使用建议这样验证

  • 在无敏感内容的测试会话中询问:引用运行上下文提供的当前时间,并指出时区;不要凭历史消息推测。
权限

它可能接触哪些数据和能力

执行本机命令写入本地文件读取本地文件

将系统时间及用户配置的标签、时区说明写入模型运行上下文;本次完整入口未发现文件、网络或子进程调用,安装本身仍执行宿主加载流程。

数据存储:插件入口未自行读写文件;时间上下文可进入 DSH Session 及模型请求,Profile 配置由宿主持久化。

请注意:源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

时间或时区不正确
检查操作系统时钟与有效 IANA timeZone;非法时区会触发格式化回退,不能把原标签当成正确换算。
分钟精度仍频繁变化
保持 includeEpoch 为 false;开启 epoch 时数值仍按秒变化。不保证实际模型缓存命中率。
没有时间文本
核对固定提交入口、Bundle、systemPrompt 服务和 enabled;若 rc.1 加载报错,停止并保留脱敏日志,不提升权限。
卸载后的清理步骤
  1. 停止测试 Profile,从同一 Profile 移除 dsh-clock-context 包,再核对 Bundle 和用户 patch。
  2. 移除自己添加的配置项并重启;卸载不会清除历史 Session 中已保存的时间文本。
深入审计:兼容性、数据流与来源
证据

兼容性与审阅记录

兼容性说明

rc.1 运行兼容性需要复核。已静态对照 DSH 0.1.5-rc.1 的 systemPrompt.context 接口;插件 0.1.0 未在宿主安装运行,peer 仅声明 Cordis ^4.0.1,不能据此宣称所有 DSH 版本兼容。

数据流

本机 Date 与 Intl 时区格式化 → clock:now 动态上下文 → DSH 会话和所配置模型 Provider;插件不单独请求授时或外部 API,时间和配置标签会随模型请求发送。

源码审阅结论

已完整读取入口、Bundle、清单、类型和 MIT 许可证,并对照 rc.1 的动态上下文注册及作用域清理实现。使用含 lib/index.js 的固定 GitHub 提交,npm 查询 404 不生成 npm 命令。无运行实测;非法时区会退回本机日期字符串但标签仍可能保留输入,必须使用有效 IANA 时区;includeEpoch 开启会按秒变化,不保证分钟精度完全稳定。不得承诺模型不再猜时间或缓存命中不受影响。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。

来源快照
GitHub Topic 采集记录
固定提交
803a0e5f726d
许可证
MIT
主要语言
JavaScript
中文资料
有完整中文配置资料