Tianyi Cui
a7a5be1703
Run the dsh-archive-agent-notes audit over every active Agent Note on current master, judging each record by whether its rationale still guides work rather than by size or age. - Archive 453 implemented bilingual triplets (417,882 English words): completed UI chrome, narrow adapters, closed bug fixes, implementation walkthroughs whose package READMEs, docs pages, generators, or successor notes now carry the useful behavior, and 51 records fully superseded by a later active note. Keep 201 implemented notes whose ownership rules, negative guarantees, durable or wire semantics, security rules, reintroduction conditions, or still-tempting rejected alternatives remain useful. - Reject 7 proposals whose premise is gone or whose work shipped in amended form under other records; delete 2 rejected notes that no longer prevent a plausible mistake. - Retarget every remaining inbound link to the archived path, and repair active prose that named an archived record as the owner of a live fact: parenthetical citations drop, ownership sentences redirect to the README, docs page, or active note that states the fact, and history citations say so. Chinese files link the English archived path because the pairing gate treats the frozen tree as outside the bilingual corpus. - Seal 1,359 new frozen artifacts; existing seals are unchanged and outbound links from archived notes are neither inspected nor repaired. - Regenerate docs/config-catalog.md after the hook-bridge comment edits shifted two source line numbers.
7.5 KiB
description, kind
| description | kind |
|---|---|
| 可选的按步骤时钟上下文，包含当前时间、浏览器时区与经过时长，供启用或调优本插件的用户与维护者阅读。 | package-reference |
@deepseek-ai/dsh-time-context
English | 中文
概述
dsh-time-context 给模型一只时钟：在符合条件的步骤上，它追加一条持久、带来源的读数，包含当前时间、附加到当前开放请求的浏览器时区，以及自前一条模型可见消息以来的经过时长。它帮助模型按用户的浏览器时区解释未明确限定时区的日期与时间；时区来源混杂或缺失时，它告诉模型去询问。本插件需主动启用：默认组合不启用它，Schedule Web overlay 会挂载它。正的 refreshIntervalMs 会减少读数累积的频率；省略或设为 0 时，每个符合条件的步骤都会注入。
目录
使用本包
当模型需要按用户所在时区解释未限定的日期与时间，且请求本地浏览器时区可用或已配置的回退值可接受时，挂载此插件。每次注入都是持久历史中额外的一条 user 角色消息；当按步骤读数超出对话需要时，用 refreshIntervalMs 调度。
模型能得到什么
每条注入读数包含三行：带数字偏移与 IANA 时区、形如 ISO 的时间戳，该请求的浏览器时区策略，以及以紧凑整秒单位表示的经过时长。第 1 步从最新一条先前模型可见消息起测量；后续步骤从同一轮次中前一个 time-context 事件起测量。缺少基线时报告 unavailable，挂钟时间倒退时把经过时长钳制为零。
配置
最小挂载无需任何配置。正的 refreshIntervalMs 会抑制距最近一次注入不足该毫秒数的注入；省略或设为 0 时，每个信号尚未中止且将进入步骤的合格 pre-step 都会注入。
- name: '@deepseek-ai/dsh-time-context'
config:
timeZone: Asia/Shanghai
| 字段 | 默认值 | 含义 |
|---|---|---|
timeZone |
进程时区 | 当前开放轮次没有唯一浏览器时区时的显示回退时区 |
refreshIntervalMs |
0（每个合格步骤） |
同一会话中两次持久注入之间的最小毫秒数 |
生成的配置目录是每个受支持字段及其 JSDoc 的穷尽式真源。
选择时区
当当前开放轮次只包含一个经 Host 校验的浏览器时区时，时间戳按该请求本地时区格式化。浏览器来源信息缺失或混杂时，配置的 timeZone 格式化显示；省略它则在插件加载时解析一次 Node 进程时区，每个显式回退值都经 Intl.DateTimeFormat 校验。解析后的指令告诉模型按所选时区解释未限定的日期与时间；来源信息混杂或不可用时，则要求用户澄清。
理解实现
实现细节——点击展开
本节解释插件的设计；可观察行为见使用本包。
设计理念
插件前置注册一个 agent/pre-step 监听器，先委托下游，需要注入且下游决策进入步骤时追加一条带来源的 UserMessage。每个读数都使用确切的快照来源 { kind: 'plugin', plugin: 'time-context', form: 'snapshot', sections: [{ name: 'time-context', text }] }，不变式伴生插件会校验该形状，根据原始 user-rpc 消息重新派生当前轮次的浏览器策略，并检查时间戳时区与经过时长基线。
源码地图
| 文件 | 职责 |
|---|---|
src/index.ts |
插件入口：pre-step 监听器、到期调度、读数组合 |
src/request-zone.ts |
从开放轮次 user-rpc 来源派生浏览器时区策略 |
src/timestamp.ts |
Intl.DateTimeFormat 创建与时间戳格式化 |
src/invariant.ts |
快照约定的不变式伴生插件 |
主要流程
需要注入时，插件采样挂钟时间，从开放轮次的 user-rpc 消息派生浏览器时区策略，解析显示时区（请求本地或回退），并渲染三行读数。正数间隔调度会扫描原始持久会话事件，查找最新一条归因于插件的消息——包括被压缩（compaction）遮蔽的读数——因此调度无需进程本地缓存也能在恢复后存续。读数记录的是已进入的步骤，不是已完成或已传输的请求；后续准备失败时，该读数可能留在历史中。
进一步探索
包级约定不够用时阅读以下页面。它们从设计决策进入挂载本插件的组合与穷尽式配置。
- Schedule 用户指南——挂载本插件的官方配置路径。
- context 组地图——相邻的请求上下文包。
- 生成的配置目录——每个受支持配置字段及其源声明。
模型体验
准备期时间上下文
模型看到的内容
每条注入消息包含三行。<timestamp> 是带数字偏移和 IANA 时区、形如 ISO 的时间戳；持续时间使用紧凑的整秒单位。
第一步
Time sampled while preparing turn <turn>, step 1: <timestamp>
Browser time zone for this request: <iana-zone-or-mixed-or-unavailable-policy>.
Elapsed since the preceding model-visible message: <duration-or-unavailable>.
后续步骤
Time sampled while preparing turn <turn>, step <step>: <timestamp>
Browser time zone for this request: <iana-zone-or-mixed-or-unavailable-policy>.
Elapsed since the preceding step context: <duration-or-unavailable>.
Token 影响
每个读数都会累积，直到压缩将其遮蔽。正数间隔会减少新增读数；省略或设为 0 时，每次合格的准备尝试都会添加一条。
KV Cache 影响
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
已知限制与延期工作
这些限制说明时钟上下文何时不合适。它们是当前包约束。
- 仅限提示词来源信息：浏览器时区上下文用于指导自然语言解释，但不会悄然填入另一工具所要求的时区字段。
- 混合轮次会询问：如果同一个开放轮次包含来自不同浏览器时区的提示词，模型会收到要求澄清的指令，而不会猜测哪个时区拥有未限定的时间。
- 回退值不代表用户权威：浏览器来源信息缺失或混杂时，配置或进程时区用于格式化时钟，但面向模型的策略仍要求澄清。
- 整秒显示：时间戳与持续时间省略亚秒精度，尽管持久事件时间保留毫秒。
- 压缩之间的历史成本：省略或设为
0时，每次合格尝试都会保留一条读数；正数间隔可以降低但无法消除该成本，也可能使后续请求缺少新鲜的浏览器时区指导。
开发备注
维护者的工作上下文——点击展开
无。