安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 中等
- 适合新手
- 可以尝试
- 兼容状态
- 当前版本需要复核
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(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 中实际执行。
- 安装到
webProfile- DSH 基线
0.1.1-rc.2- 安装来源
- GitHub 源码(锁定提交)
- 固定目标
github:apex-mochen/dsh-clock-context#803a0e5f726d739046bb1098e0ace03aecffa23d
既有插件教程与安装命令的固定 CLI 基线,独立于 npm 默认分发;不代表每个插件已在该版本或新版本运行验证。更新前须逐项审核配置证据。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。GitHub 源码(锁定提交)npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:apex-mochen/dsh-clock-context#803a0e5f726d739046bb1098e0ace03aecffa23d - 03如遇构建脚本拦截
GitHub 源码插件可能通过
prepare构建。pnpm 10 及以上会先阻止未授权构建;只把终端明确提示的包名加入该 Profile 的pnpm-workspace.yaml中allowBuilds,审阅脚本后再重复上一步,不要使用全局放行。 - 04确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 dsh-clock-context或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config - 05启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
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。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- id: dsh-clock-context
name: dsh-clock-context
config:
timeZone: Asia/Shanghai
locale: zh-CN
precision: minute
includeUtc: true
includeEpoch: false
enabled: true- 按固定 GitHub 提交安装到测试 Profile,检查 Bundle 中存在 dsh-clock-context。
- 修改已有插件项的 config 后重启同一 Profile;不要照抄 README 中的 owner 占位命令。
配置检查与成功结果
- 01间隔一段时间发起两次测试请求,要求引用上下文中的当前时间,并与本机正确时钟对照。
期望结果:预期 clock:now 对应时间随上下文组装刷新、时区正确;这是待执行验收步骤,不是本站实测结果。
- 02设置 enabled 为 false 并重启测试 Profile,再检查上下文。
期望结果:预期不再注入时间文本;若仍存在,检查是否重复加载。
第一次使用建议这样验证
- 在无敏感内容的测试会话中询问:引用运行上下文提供的当前时间,并指出时区;不要凭历史消息推测。
它可能接触哪些数据和能力
将系统时间及用户配置的标签、时区说明写入模型运行上下文;本次完整入口未发现文件、网络或子进程调用,安装本身仍执行宿主加载流程。
数据存储:插件入口未自行读写文件;时间上下文可进入 DSH Session 及模型请求,Profile 配置由宿主持久化。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- 时间或时区不正确
- 检查操作系统时钟与有效 IANA timeZone;非法时区会触发格式化回退,不能把原标签当成正确换算。
- 分钟精度仍频繁变化
- 保持 includeEpoch 为 false;开启 epoch 时数值仍按秒变化。不保证实际模型缓存命中率。
- 没有时间文本
- 核对固定提交入口、Bundle、systemPrompt 服务和 enabled;若 rc.1 加载报错,停止并保留脱敏日志,不提升权限。
- 停止测试 Profile,从同一 Profile 移除 dsh-clock-context 包,再核对 Bundle 和用户 patch。
- 移除自己添加的配置项并重启;卸载不会清除历史 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
- 中文资料
- 有完整中文配置资料