xfgil/dsh-session-clock ↗★ 0

dsh-session-clock

为指定会话注入当前时间及距上次对话的空闲时长。 适合需要让智能体感知精确时间差、实现个性化授时唤醒的场景。

包名
dsh-session-clock
兼容性
待验证
版本
0.1.0
许可证
MIT
最近更新
2026年10月13日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xfgil/dsh-session-clock

配置项

在 profile 的 cordis.patch.yml 里:

- id: session-clock
  name: dsh-session-clock
  config:
    mode: supplement
    timeZone: Asia/Shanghai
    sessions: ['*']
    refreshIntervalMs: 60000
键默认说明
enabledtrue总开关
mode'supplement'supplement = 只补增量;append = 额外给「距上一轮结束多久」;full = 复刻 time-context 三行
timeZone''(进程时区)IANA 时区;非法值会让插件停用并在状态里报错
refreshIntervalMs60000同一会话两次注入的最小间隔(ms);0 = 不节流
sessions['*']授时会话白名单,支持 * 与 /regex/
exceptSessions[]会话黑名单,优先级高于白名单
stateFile''状态文件路径,默认 $DSH_HOME/session-clock/activity.json
minGapSeconds0空闲不足这么多秒就不注入(避免刚说完话又报一次)
includeUserGaptrue输出「距上次用户主动发言」子句
includeGlobalIdletrue输出跨会话指针子句
includeIdleSinceTurnEndtrue输出「距上一轮结束」(supplement 模式下不生效)
includeSessionIdtrue注入行里带会话 id
includeTurnCounttrue注入行里带轮次计数
skipSubagentstrue跳过 origin === 'subagent' 的会话(数量多、生命周期短,省 token)
logInjectiontrue每次注入写一条宿主日志
traceDecisionsfalse每次跳过也写日志(排查用)
quietfalse关闭常规 info 日志