0 Fork 0

Files

T

ZiyaZhang 912e5bafa1 refactor(schedule-bundle): give the Schedule rows the usual per-row switches

The bundle no longer declares `dsh.bundle.rowSwitches`, so its page offers a
switch per row while it is on, as every other bundle does. The README records
that the three rows work only together, and the Agent Note records the
rejected lock.

2026-09-25 07:50:15 -07:00

5.2 KiB

Raw Blame History

Agent Note: Schedule 作为按需开启的可选 bundle

Status: implemented

English | 中文

Problem

Schedule 会给每个活跃根 Agent 的请求增加四个工具 schema，并在每个符合条件的步骤追加一条持久时钟消息，因此随发行版交付的 Web 组合不能默认挂载它。使用随发行版 Web profile 的人仍需要产品界面上的开关来打开它；profile patch 层或 --patch overlay 都是这个人无法触及的配置文件。

Decision

packages/bundle/web-app/cordis.patch.yml 不含 time-context、schedule 与 ui-schedule 中的任何一行，因此随发行版交付的 Web 组合不提供任何定时能力：没有 schedule_* 工具、没有 Session 提醒目录、没有自动化任务页面，也没有逐步时钟读数。

@deepseek-ai/dsh-experimental-schedule-bundle（packages/experimental/schedule-bundle/）在其 cordis.patch.yml 中插入这三行并依赖它们的包，与其他可选 bundle 插入各自随附的行相同。packages/boot/app-boot/src/profile.ts 的 OPTIONAL_BUNDLES 列出该包，apps/cli 将其声明为运行时依赖，因此每次安装都随包携带且默认关闭。实验性能力作为可选 bundle 的决策负责 OPTIONAL_BUNDLES 的约定，以及 Web 插件管理页在“官方”分组中渲染的本地化 icon 与 meta.title / meta.description 元数据。

启用该 bundle 会插入 time-context（每个步骤的时钟读数，包含采样瞬时、附加到当前开放请求的浏览器时区，以及自前一条模型可见消息以来的经过时长）、schedule（持久提醒，以及每个活跃根 Agent 上的 schedule_create、schedule_list、schedule_update 与 schedule_delete）与 ui-schedule（Session 提醒目录与自动化任务页面）。该 bundle 把 time-context 与 schedule 一起携带，因为提醒请求给出的是挂钟时间目标：采样瞬时正是让模型把“明天九点”这类请求转换成带偏移量的 at 值的依据。持久记录、投递与管理操作由 Schedule 子系统负责；该 bundle 向其加入这些行的组合由 Web bundle 负责。禁用该 bundle 会恢复随发行版交付的组合，schedule 行不存在期间 Host 不再调度；已存储的任务记录保留在 Schedule domain 中。

Alternatives considered

默认发布 Schedule。 那样每个 Web 会话都要在每个请求头中带上四个工具 schema，并在每个符合条件的步骤追加一条持久 user 消息，从不创建提醒的对话也要承担这两项成本。这种安排还让该能力在产品界面上没有关闭开关。

保留一个 --patch overlay 文件。 overlay 是启动时的参数，而不是产品界面上的开关，因此使用随发行版 web profile 的人无法触及它。通过它的 insert 列表重新声明这些条目并不能覆盖它们：applyEntryPatches 追加该列表时不对 id 去重，而 Loader 会把组合出的列表按 id 收敛为一个条目、最后一个声明生效，因此该 overlay 会替换 Web Bundle 的条目，而不是给它们设值。

把这三行以 disabled: true 留在 Web 组合中，用按 id 定位的 patch 打开。 这样 bundle 只是给已有的行设值，但插件管理器只列出 bundle 插入的行，因此该 bundle 的页面显示不含任何组件，需要为被覆盖的行另建一条列出路径；而其他可选 bundle 都插入各自的行。某个 profile 若也声明了其中某个 id，处理方式与任何其他 bundle 相同：Loader 保留最后一份声明。

把这三行锁定在 bundle 开关上。 让插件管理器拒绝逐行开关的 bundle 清单字段，会给插件管理器增加一个只有这个 bundle 使用的概念。该 bundle 的页面像其他所有 bundle 一样为每行提供开关，由 bundle README 说明这三行只能一起工作。

Consequences

默认的 dsh web 会话不带 Schedule 工具 schema、Session 提醒目录、自动化任务页面与逐步时钟读数。需要它们的安装可从插件管理页启用该可选 bundle，或把该包列进 profile 的 dsh.profile.bundles。
启用后的安装会给每个活跃根 Agent 增加四个工具 schema，并在每个符合条件的步骤追加一条持久时钟消息；该读数对模型可见且持久，因此它与其他 user 消息一样参与回放、压缩，并出现在导出的 Session 日志中。
插件管理页在该 bundle 下列出这三行，显示各自包的 locale/*.json 声明的标题、它们的状态，并在 bundle 打开时为每行提供开关；关掉其中一行会让 Schedule 缺少这一部分。
未选中该 bundle 时，按 id 定位这三行之一的 profile 补丁或 --patch overlay 匹配不到任何条目，加载器会为它报告 patch: entry <id> not found 警告；选中该 bundle 即可取代按 id 打开这些行。
该开关只涉及配置：src/index.ts 是空模块，运行时内容由 patch 承载，包本身不拥有可变的运行时状态，因此不发布不变量伴随模块。

5.2 KiB Raw Blame History Unescape Escape