dsh-later 1.1.0 → 1.3.0

package/lib/types/commands.d.ts

@@ -50,28 +50,60 @@ export type ParsedScheduleSpec = {
     ok: false;
     error: string;
 };
-/** `parseScheduleInput` 的结果：时间目标 + 剩余内容。 */
+/**
+ * `parseScheduleInput` 的结果：时间目标 + 剩余内容。
+ *
+ * `targets` 恒为 1..MAX_OCCURRENCES 个未来时刻：单条写法就是 1 个；
+ * `+1h*3` / `+1h+30m` 这类多次写法给出多个，由命令层展开成同等数量的任务。
+ * `target` 恒等于 `targets[0]`，为既有调用方保留。
+ */
 export type ParsedScheduleInput = {
     ok: true;
-    target: {
-        kind: 'after';
-        afterSeconds: number;
-    } | {
-        kind: 'at';
-        at: {
-            date: string;
-            time: string;
-            time_zone: string;
-        };
-        epoch: number;
-    };
+    target: ResolvedTarget;
+    targets: readonly ResolvedTarget[];
     content: string;
 } | {
     ok: false;
     error: string;
 };
+/** 语法开关（来自 settings.advancedSyntax）。 */
+export interface ScheduleSyntaxOptions {
+    /**
+     * 高级语法（Beta）是否可用。
+     *
+     * `undefined` 与 `true` 都按开启处理——只有显式 `false` 才关闭，
+     * 与 schema 的 `default(true)` 及旧调用方（不传第三参）的行为一致。
+     */
+    readonly advancedSyntax?: boolean;
+}
+/** 关闭高级语法时的统一提示：说清去哪儿开，而不是只说"不支持"。 */
+export declare const ADVANCED_SYNTAX_DISABLED: string;
+/** 一次命令最多展开出的任务条数（`+1h*11`、11 段序列一律拒绝）。 */
+export declare const MAX_OCCURRENCES = 10;
+/**
+ * 多次写法下相邻两次之间的最小间隔（秒）。
+ *
+ * 只约束「多次」：单条 `/later +5s` 是既有合法用法（README 演示与测试都依赖它），
+ * 不因这道地板失效。`every` 记录在宿主侧另有 ≥300s 口径；多次写法走的是
+ * 「展开成 N 条 one-shot」，不经过 `every`，所以这里自带一道 60s 防护，
+ * 免得 `+1s*10` 一行命令把 dock 刷成瀑布。
+ */
+export declare const MIN_OCCURRENCE_INTERVAL_SECONDS = 60;
+/** 目标解析结果（时间 → 具体时刻/时长的落定）。 */
+type ResolvedTarget = {
+    kind: 'after';
+    afterSeconds: number;
+} | {
+    kind: 'at';
+    at: {
+        date: string;
+        time: string;
+        time_zone: string;
+    };
+    epoch: number;
+};
 /**
- * 解析 `/schedule` 的完整输入：开头的时间表达式 + 剩余内容。
+ * 解析 `/schedule` 与 `/later` 的完整输入：开头的时间表达式 + 剩余内容。
  *
  * 支持格式（示例）：
  *  - `+30m` `+1h30m` `+90s` `+1w`
@@ -80,13 +112,22 @@ export type ParsedScheduleInput = {
  *  - `明天 15:32` `后天9点` `大后天 10:00`
  *  - `8月21日 15:32` `08-21 15:32`
  *  - `2026-08-21 15:32` `0821-1532` `20260821-1532`
+ *  - 等间隔重复：`+1h*3` `+30m×2` `两小时后x3次` → t+1h、t+2h、t+3h
+ *  - 链式序列：`+1h+1h+0.5h` → t+1h、t+2h、t+2.5h（梯度催办）
+ *
+ * 多次写法一律展开成 N 条 `after` 一次性任务（不是 1 条 `every`），理由见
+ * {@link expandOccurrences}。上限 `MAX_OCCURRENCES`，多次写法的最小间隔
+ * `MIN_OCCURRENCE_INTERVAL_SECONDS`。
  *
  * `limits` 可选：未传时回落到 `DEFAULT_MAX_PROMPT_CHARS=1000`，错误文案里
  * 的字符数与 settings 实际生效值一致。
  */
-export declare function parseScheduleInput(raw: string, now: number, timeZone: string, limits?: PromptLimits): ParsedScheduleInput;
+export declare function parseScheduleInput(raw: string, now: number, timeZone: string, limits?: PromptLimits, options?: ScheduleSyntaxOptions): ParsedScheduleInput;
 /**
- * 兼容旧签名：解析纯时间描述（不含内容）。
+ * 兼容旧签名：解析纯时间描述（不含内容），**只支持单条**。
+ *
+ * 多次/序列写法会被明确拒绝：本函数的消费方（GUI 单次通道）一次只能落一条记录，
+ * 静默取第一条等于把用户的「3 次」吃掉。
  */
 export declare function parseScheduleSpec(spec: string, now: number, timeZone: string): ParsedScheduleSpec;
 /** 命令工厂：返回三个命令定义。
@@ -100,10 +141,13 @@ export declare function userScheduleCommands(ctx: Context, getSettings?: number
     maxSchedules: number;
     allowLongPrompts?: boolean;
     maxPromptChars?: number;
+    advancedSyntax?: boolean;
 }), onUserChange?: UserChangeNotifier, onUserSteer?: UserSteerHandler): CommandDefinition[];
 /** 注册三个命令，返回统一 disposer。 */
 export declare function registerUserScheduleCommands(ctx: Context, getSettings?: number | (() => number) | (() => {
     maxSchedules: number;
     allowLongPrompts?: boolean;
     maxPromptChars?: number;
+    advancedSyntax?: boolean;
 }), onUserChange?: UserChangeNotifier, onUserSteer?: UserSteerHandler): () => void;
+export {};

package/lib/types/index.d.ts

@@ -45,6 +45,8 @@ export interface SchedulerSettings {
     readonly onUnconfirmed: UserScheduleOnUnconfirmed;
     /** 时钟图标风格（auto / modern / classic）。 */
     readonly clockIconStyle: 'auto' | 'modern' | 'classic';
+    /** 高级语法（Beta）：多次写法是否可用。默认开。 */
+    readonly advancedSyntax: boolean;
 }
 /** 插话投递方式。 */
 export type UserScheduleSteerDelivery = 'followup' | 'steer';

package/lib/types/ownership-store.d.ts

@@ -1,4 +1,23 @@
+import type { FileBlock, ImageBlock } from '@deepseek-ai/dsh-llm';
 import type { UserScheduleDelivery } from './domain.js';
+/**
+ * 随提醒一起延迟发送的附件块（宿主命令准入后的耐久引用，JSON 可序列化）。
+ *
+ * `/later` 声明 `input.attachments` 后，命令框架把 composer 附件做耐久化准入
+ * （图片→内容寻址存储，文件→staged receipt 解析），以这两种块交给 handler。
+ * 块内只持有不透明 `attachmentId` 引用（非路径、非字节），因此可以安全地
+ * 落进 sidecar JSON，到点投递时再拼回 user message 的 content。
+ */
+export type ScheduledAttachment = ImageBlock | FileBlock;
+/**
+ * 校验并收窄任意来源（含磁盘 JSON）的附件块数组。
+ *
+ * sidecar 是本地文件，可能被外部改写或被旧版本写入半成品；而附件块最终会
+ * 拼进**以用户身份代发**的消息 content，故读路径必须视为不可信输入：
+ * 只放行 `{type:'image'|'file', attachment:{attachmentId: string}}` 形状的块，
+ * 其余一律丢弃（不抛错——单块损坏不应让整份 sidecar 不可读）。
+ */
+export declare function sanitizeAttachments(value: unknown): readonly ScheduledAttachment[] | undefined;
 /** 单条所有权记录。 */
 export interface OwnedEntry {
     /** 到点注入形态（/later 为 'user'，其余 'context'）。 */
@@ -15,6 +34,14 @@ export interface OwnedEntry {
      * 若直接当窗口会从 0 重跑；此处保留原 after 间隔供 wire/进度条使用。
      */
     readonly windowSeconds?: number;
+    /**
+     * `/later` 随命令提交的附件（到点代发时拼进消息 content）。
+     *
+     * 为什么不进会话日志：`schedule/change` 荷载被 dsh-schedule 严格解码
+     * （hasExactKeys），追加字段会让整份历史拒读（见 domain.ts 的兼容性说明）；
+     * sidecar 是本插件私有存储，加字段天然向后兼容。
+     */
+    readonly attachments?: readonly ScheduledAttachment[];
 }
 /** 暂停留档（仅 kind==='after'；不进会话日志）。 */
 export interface PausedEntry {
@@ -31,6 +58,8 @@ export interface PausedEntry {
     /** 暂停前的日志 schedule id（审计/关联）。 */
     readonly lastScheduleId: string;
     readonly pausedAt: number;
+    /** 暂停时随条目冻结的附件（resume/插话投递时原样带回）。 */
+    readonly attachments?: readonly ScheduledAttachment[];
 }
 /** 读取某会话的全部所有权记录（缓存优先；返回副本语义，调用方不得变更）。 */
 export declare function allOwnership(sessionId: string): Readonly<Record<string, OwnedEntry>>;
@@ -41,7 +70,7 @@ export declare function getOwnership(sessionId: string, id: string): OwnedEntry
 /** 生成稳定插件 uid（pause/resume 跨日志 id 变更）。 */
 export declare function newTaskUid(): string;
 /** 记录（新增或覆盖）一条所有权；幂等。仅显式传入 `uid` 时写入稳定身份。 */
-export declare function recordOwnership(sessionId: string, id: string, delivery: UserScheduleDelivery, uid?: string, windowSeconds?: number): OwnedEntry;
+export declare function recordOwnership(sessionId: string, id: string, delivery: UserScheduleDelivery, uid?: string, windowSeconds?: number, attachments?: readonly ScheduledAttachment[]): OwnedEntry;
 /** 撤销一条所有权；幂等（不存在时无操作）。 */
 export declare function removeOwnership(sessionId: string, id: string): void;
 /** 按 uid 找当前仍 active 的 schedule id（缺失 undefined）。 */

package/lib/types/presence.d.ts

@@ -23,6 +23,20 @@ export interface PresenceScheduleLike {
     readonly status?: string;
     /** 暂停冻结的剩余秒数；仅在 `status === 'paused'` 时有意义。 */
     readonly remaining_seconds?: number;
+    /** 任务类型。决定进度窗口起点按哪个口径推导（见 {@link windowStartOf}）。 */
+    readonly kind?: string;
+    /** `after` 类型的总倒计时秒数（进度起点 = 触发时刻 − 该值）。 */
+    readonly after_seconds?: number;
+    readonly afterSeconds?: number;
+    /** `every` 类型的周期间隔秒数（进度起点 = 触发时刻 − 该值，即本周期起点）。 */
+    readonly every_seconds?: number;
+    readonly everySeconds?: number;
+    /** 宿主/投影直接给的显式总窗口秒数；给了就优先于按 kind 推导。 */
+    readonly window_seconds?: number;
+    readonly windowSeconds?: number;
+    /** `at` 类型的进度起点（任务创建时刻，ISO）。`at` 没有天然周期，只能用它。 */
+    readonly created_at?: string;
+    readonly createdAt?: number;
 }
 /** 由一组活动任务归纳的 badge 概要。 */
 export interface PresenceSummary {
@@ -32,6 +46,14 @@ export interface PresenceSummary {
     readonly nextAt?: number;
     /** 暂停中的任务数（用于文案区分「已冻结」与「等待发送」）。 */
     readonly pausedCount: number;
+    /**
+     * 进度环起点（epoch ms）：`nextAt` 那条任务的窗口开始时刻。
+     *
+     * **只跟随 `nextAt` 那条**：环表达的是"距离最近一次触发还剩多少"，若取别条
+     * 任务的窗口就与 `nextAt` 对不上了。无从推导时缺省，此时调用方应退回恒定
+     * 整环（{@link progressOf} 返回 `undefined`）。
+     */
+    readonly progressFrom?: number;
 }
 /**
  * 归纳：取最早触发时刻 + 任务数量。
@@ -49,6 +71,16 @@ export interface PresenceSummary {
  * 「已到期」或"下次 X 分后"。
  */
 export declare function summarizeSchedules(schedules: readonly PresenceScheduleLike[] | undefined): PresenceSummary;
+/**
+ * 进度环比例（0–1）：`now` 在 `[progressFrom, nextAt]` 中的位置。
+ *
+ * 返回 `undefined` 表示**无从算起**（缺窗口起点，或窗口已退化），调用方此时应
+ * 退回「恒定整环」的旧表现，而不是画一个 0% 的空环 —— 后者是错误信息：
+ * 0% 是"刚开始"，`undefined` 是"算不出来"。
+ *
+ * 两端夹住：`overdue` 时 `now > nextAt`，环停在满环而不是绕出去。
+ */
+export declare function progressOf(entry: PresenceSummary, now: number): number | undefined;
 /** 由当前时刻判定 badge 状态。 */
 export declare function badgeStateFor(nextAt: number | undefined, now: number): PresenceBadgeState;
 /**

package/lib/types/runtime.d.ts

@@ -158,11 +158,20 @@ export declare class UserScheduleRuntime {
      * 构造注入的消息，按投递形态分流：
      *  - `user`（`/later` 显式请求的延迟发送）：原样内容 + `source.kind='user'`，
      *    让 GUI 呈现为「我」发出的普通气泡（产品取舍：用户明确要求以本人身份）。
-     *    跳过 framing 防护 —— 这是「代发」语义，不是注入。
+     *    跳过 framing 防护 —— 这是「代发」语义，不是注入。随命令提交的附件
+     *    （图片/文件耐久引用，存于 sidecar）按记录顺序拼在文本块之后，
+     *    与用户自己发「文字+图」的消息形状一致。
      *  - `context`（默认）：复用 dsh-schedule 的注入防护 framing + notice 表单，
      *    保持「上下文注入」的可信审计线；多条一次性到期合并为批次 framing（P1-5），
      *    形状与 dsh-schedule 的固定间隔批次一致。
      */
     private buildMessage;
+    /**
+     * 读某条提醒随命令提交的附件（sidecar 权威；无会话 id / 无条目时为空）。
+     *
+     * 只在 `user` 代发路径调用——context 注入通道从未声明接受附件（见 commands.ts），
+     * 不会把图片拼进防护 framing。sidecar 读路径已做块级收窄（sanitizeAttachments）。
+     */
+    private attachmentsOf;
 }
 export {};

package/lib/types/schedule-summary-store.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 定时摘要 store：把 {@link buildScheduleSummary} 的纯计算接到宿主 `sessions`
+ * 服务上，得到一个**可订阅的公共数据源**。
+ *
+ * 为什么需要它（issue #17）：dsh-later 自己的侧栏 badge 与外部插件（如
+ * dsh-group-status）都需要「全会话定时任务摘要」。两条独立通路会各自订阅
+ * `sessions.list`、各自周期 `refresh()`，既浪费 RPC 又容易漂移。本 store 是
+ * **唯一**的数据权威：内部负责列表订阅、状态 tick（scheduled→urgent→overdue）
+ * 与 `session.list` 读 RPC 补时效；外部只读 {@link ScheduleSummaryStore.getSnapshot}
+ * 或订阅变更。
+ *
+ * 跨插件使用方式（消费方声明 `dsh.client.external: ["dsh-later"]` 后）：
+ * ```js
+ * const later = require('dsh-later/client')
+ * const store = later.getScheduleSummaryStore()
+ * ```
+ *
+ * 本模块零 DOM / 零 React 依赖（`document` / `window` 一律经 `globalThis`
+ * 结构化探测），宿主 tsc 与浏览器 esbuild 都能编译，`node --test` 也能直接跑。
+ * @module dsh-later/schedule-summary-store
+ */
+import { type ScheduleSummaryMap, type ScheduleSummarySource } from './schedule-summary.js';
+/** 摘要状态重算周期（本地时钟，零网络）。 */
+export declare const SUMMARY_STATE_TICK_MS = 30000;
+/** `session.list` 重拉周期（读 RPC；仅页面可见时执行）。 */
+export declare const SUMMARY_REFRESH_INTERVAL_MS = 60000;
+/** 宿主 `sessions` 服务的结构子集（只用到列表快照与 refresh）。 */
+export interface ScheduleSummarySessionsLike {
+    /** 会话列表 store（快照 + 变更订阅）。 */
+    readonly list: {
+        getSnapshot(): ScheduleSummarySource;
+        subscribe(listener: () => void): () => void;
+    };
+    /** 重拉会话列表（读 RPC，不写会话日志）。 */
+    refresh(): Promise<unknown>;
+}
+/** 可订阅的定时摘要 store。 */
+export interface ScheduleSummaryStore {
+    /** 当前摘要（引用稳定；内容变化时才换成新对象）。 */
+    getSnapshot(): ScheduleSummaryMap;
+    /** 订阅变更；返回退订函数。 */
+    subscribe(listener: () => void): () => void;
+    /** 立即按最新会话列表快照重算（内容有变化才通知）。 */
+    reload(): void;
+    /** 释放订阅/定时器（宿主卸载时调用）。 */
+    dispose(): void;
+}
+export interface ScheduleSummaryStoreOptions {
+    /** 状态重算周期（毫秒）；缺省 {@link SUMMARY_STATE_TICK_MS}。 */
+    readonly stateTickMs?: number;
+    /** 会话列表重拉周期（毫秒）；缺省 {@link SUMMARY_REFRESH_INTERVAL_MS}。 */
+    readonly refreshIntervalMs?: number;
+    /** 当前时刻注入（单测用）；缺省 `Date.now`。 */
+    readonly now?: () => number;
+    /** 是否允许发起 refresh RPC；缺省「页面可见时允许」。 */
+    readonly canRefresh?: () => boolean;
+    /** 是否自动周期 refresh；缺省 true（单测可关）。 */
+    readonly autoRefresh?: boolean;
+}
+/**
+ * 创建定时摘要 store（宿主 `apply` 内创建一次，全插件共享）。
+ * @param sessions - 宿主 `sessions` 服务。
+ * @param options - 周期/时钟/刷新策略覆盖（单测用）。
+ * @returns 可订阅 store。
+ */
+export declare function createScheduleSummaryStore(sessions: ScheduleSummarySessionsLike, options?: ScheduleSummaryStoreOptions): ScheduleSummaryStore;
+/**
+ * 登记/撤销当前 store（由 dsh-later 自身 `apply` 调用；外部插件不要调用）。
+ * @param store - 生效的 store；undefined 表示撤销。
+ */
+export declare function setActiveScheduleSummaryStore(store: ScheduleSummaryStore | undefined): void;
+/** 读取当前生效的 store；dsh-later 未加载时为 undefined。 */
+export declare function getScheduleSummaryStore(): ScheduleSummaryStore | undefined;
+/** 订阅 store 登记变化（供 React hook 在 store 迟到时仍能重渲染）。 */
+export declare function subscribeScheduleSummaryStore(listener: () => void): () => void;

package/lib/types/schedule-summary.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 定时任务摘要：dsh-later 对外暴露的**公共数据面**（跨会话 / 跨插件）。
+ *
+ * 关键事实（本插件「路线 B」的数据源）：`userSchedules` 是 client-visible 投影，
+ * 宿主在 `session.list` 基线里为**每个**会话携带 projections 块（live 会话走注册
+ * 表现值、冷会话走持久化投影缓存），客户端把它合入
+ * `SessionSummary.projectionValues`。因此**任何**持有 `sessions` 服务的客户端插件
+ * 都能读到全会话的定时任务，本模块只负责把它折叠成稳定形状。
+ *
+ * 契约形状（issue #17）：`Map<SessionId, { count, nextAt, state }>`——即
+ * {@link ScheduleSummaryMap}。dsh-later 通过 `dsh-later/client` 导出
+ * {@link buildScheduleSummary}（纯函数）、`createScheduleSummaryStore`（可订阅
+ * store）与 `useScheduleSummary`（React hook），消费方按需选用。
+ *
+ * 本模块零 DOM / 零 React 依赖：宿主、浏览器与 `node --test` 都能直接跑。
+ * @module dsh-later/schedule-summary
+ */
+import { type PresenceBadgeState, type PresenceScheduleLike, type PresenceSummary } from './presence.js';
+/** `userSchedules` 投影值在 `projectionValues` 里的键名。 */
+export declare const SCHEDULE_PROJECTION_KEY = "userSchedules";
+/**
+ * 一条会话的定时摘要：数量 + 下次触发 + 视觉状态。
+ *
+ * `state` 是**快照时刻**由 {@link badgeStateFor} 判定的结果（`scheduled` /
+ * `urgent` ≤5min / `overdue` 已到期未派发），因此 store 每次重算/定时 tick 都会
+ * 刷新它；暂停项计入 `count`/`pausedCount`，但**不参与** `nextAt`（见 presence 模块
+ * 对暂停语义的说明）。
+ */
+export interface ScheduleSummaryEntry extends PresenceSummary {
+    /** 该会话的 badge 状态（按快照时刻判定）。 */
+    readonly state: PresenceBadgeState;
+}
+/** 会话 id → 该会话的定时摘要（**仅**包含有任务的会话）。 */
+export type ScheduleSummaryMap = ReadonlyMap<string, ScheduleSummaryEntry>;
+/** 摘要所需的最小会话列表快照面（`SessionListState` 的结构子集）。 */
+export interface ScheduleSummarySource {
+    /** 会话 id → 会话行事实（只用到 `projectionValues`）。 */
+    readonly byId: Readonly<Record<string, ScheduleSummaryRowLike | undefined>>;
+}
+/** 会话行事实的结构子集。 */
+export interface ScheduleSummaryRowLike {
+    /** 该会话的投影现值（含 `userSchedules`）。 */
+    readonly projectionValues?: Readonly<Record<string, unknown>>;
+}
+/**
+ * 从 `projectionValues` 里取出任务数组（容错：形状不对一律当作无任务）。
+ * @param projectionValues - 会话行的投影现值集合。
+ * @returns 任务数组；缺失或形状非法时 undefined。
+ */
+export declare function schedulesOfProjection(projectionValues: Readonly<Record<string, unknown>> | undefined): readonly PresenceScheduleLike[] | undefined;
+/**
+ * 全会话归纳：把会话列表快照折叠成 {@link ScheduleSummaryMap}。
+ * @param source - 会话列表快照（`sessions.list.getSnapshot()`）。
+ * @param now - 判定 `state` 的当前时刻（epoch ms）。
+ * @returns 会话 id → 摘要；无任务的会话不出现在 map 里。
+ */
+export declare function buildScheduleSummary(source: ScheduleSummarySource, now: number): ScheduleSummaryMap;
+/**
+ * 两份摘要是否等价（逐条比对五个字段）。store 用它决定是否需要通知订阅者，
+ * 避免每次重算都产生新的 Map 引用导致 React 无谓重渲染。
+ *
+ * `progressFrom` 一并比对：它虽然通常随 `nextAt` 同进同退，但暂停→恢复会让
+ * 同一条任务重新拥有窗口起点，此时 `nextAt` 可能未变而窗口已换 —— 漏比会
+ * 让进度环停在上一个窗口的比例上。
+ * @param a - 旧摘要。
+ * @param b - 新摘要。
+ * @returns 键集合与每条内容都相同时为 true。
+ */
+export declare function sameScheduleSummary(a: ScheduleSummaryMap, b: ScheduleSummaryMap): boolean;
+/** 分组聚合结果（折叠的工作区分组徽标直接用这一份）。 */
+export interface GroupScheduleSummary {
+    /** 组内**有任务**的会话数。 */
+    readonly sessions: number;
+    /** 组内任务总数（含暂停项）。 */
+    readonly count: number;
+    /** 组内暂停项数量。 */
+    readonly pausedCount: number;
+    /** 组内最早触发时刻（epoch ms）；全部暂停或缺省时为 undefined。 */
+    readonly nextAt?: number;
+    /** 组内最高优先级状态（overdue > urgent > scheduled）；无任务时为 undefined。 */
+    readonly state?: PresenceBadgeState;
+}
+/**
+ * 按**分组**聚合摘要：给定组内会话 id，折叠出可直接渲染的分组事实。
+ *
+ * 消费方（如 dsh-group-status 的 `GroupLiveStatus`）只需把组内会话 id 传进来，
+ * 无需理解 `nextAt`/暂停语义。
+ * @param summary - {@link ScheduleSummaryMap}。
+ * @param sessionIds - 组内会话 id（顺序无关；不在摘要里的会被忽略）。
+ * @returns 分组级摘要；组内无任务时 `sessions`/`count` 为 0、`state` 缺省。
+ */
+export declare function summarizeScheduleGroup(summary: ScheduleSummaryMap, sessionIds: Iterable<string>): GroupScheduleSummary;

package/lib/types/user-tools.d.ts

@@ -21,7 +21,7 @@ import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
 import type { ScheduleRecord, ScheduleView } from '@deepseek-ai/dsh-schedule';
 import type { UserScheduleDelivery } from './domain.js';
-import type { PausedEntry } from './ownership-store.js';
+import type { PausedEntry, ScheduledAttachment } from './ownership-store.js';
 /** 单 session 用户任务上限（PRD：防滥用）。 */
 export declare const DEFAULT_MAX_SCHEDULES = 100;
 /**
@@ -195,6 +195,14 @@ export declare function runUserScheduleTransaction<T>(agent: Agent, operation: (
 export interface UserScheduleCreateOptions {
     /** 可信通道显式声明的投递形态；未提供或非 'user' 一律按安全默认 'context'。 */
     readonly trustedDelivery?: UserScheduleDelivery;
+    /**
+     * 可信通道（人类显式输入的 `/later`）随命令提交的附件块。
+     *
+     * 与 `trustedDelivery` 同一道闸门：**只**接受选项传入，原始输入载荷里的
+     * `attachments` 字段不具任何效力——模型工具与 GUI JSON 载荷永远带不进附件，
+     * 防止任何通道夹带未准入的对象拼进代发消息。
+     */
+    readonly attachments?: readonly ScheduledAttachment[];
 }
 /** `user_schedule_create` 核心实现。 */
 export declare function userScheduleCreate(input: unknown, agent: Agent, ctx: Context, maxSchedules?: number, options?: UserScheduleCreateOptions, limits?: PromptLimits): Promise<UserScheduleCreateResult>;

package/lib/user-tools.js

@@ -1,7 +1,7 @@
 import { ScheduleId, ScheduleInputError, foldScheduleEvents, scheduleView, } from '@deepseek-ai/dsh-schedule';
 import { allocateScheduleIdCompat as allocateScheduleId, createAfterRecord as createAfterScheduleRecord, createAtRecord as createAtScheduleRecord, createEveryRecord as createEveryScheduleRecord, toChangePayload, asLegacySchedules, } from './schedule-compat.js';
 import { OWNED_EVENT } from './domain.js';
-import { allOwnership, allPaused, findPausedByScheduleId, findScheduleIdByUid, getOwnership, getPaused, newTaskUid, recordOwnership, recordPaused, removeOwnership, removePaused, } from './ownership-store.js';
+import { allOwnership, allPaused, findPausedByScheduleId, findScheduleIdByUid, getOwnership, getPaused, newTaskUid, recordOwnership, recordPaused, removeOwnership, removePaused, sanitizeAttachments, } from './ownership-store.js';
 import { detectTimeZone } from './time-utils.js';
 import { readInheritedEventCount, readOwnEvents } from './upstream-compat.js';
 /** 单 session 用户任务上限（PRD：防滥用）。 */
@@ -268,6 +268,9 @@ export async function userScheduleCreate(input, agent, ctx, maxSchedules = DEFAU
         return validated;
     // 只认可信通道显式声明的形态；输入载荷中的 delivery 字段不具任何效力。
     const trustedDelivery = options?.trustedDelivery === 'user' ? 'user' : 'context';
+    // 附件同理：仅取选项（可信通道）传入的块，并再过一次收窄（防御纵深——
+    // 命令框架的准入已保证形状，但 options 是跨模块边界，不假设上游不变式）。
+    const trustedAttachments = sanitizeAttachments(options?.attachments);
     return runUserScheduleTransaction(agent, async () => {
         const now = Date.now();
         let folded;
@@ -299,7 +302,7 @@ export async function userScheduleCreate(input, agent, ctx, maxSchedules = DEFAU
         // 所有权写 sidecar（append 之前：投影 fold 在事件到达时按 sidecar 判定归属）。
         // flush 失败则回滚，避免 sidecar 与日志漂移。
         const sessionId = agent.session.header?.id;
-        recordOwnership(sessionId, id, trustedDelivery, newTaskUid(), record.kind === 'after' ? record.afterSeconds : undefined);
+        recordOwnership(sessionId, id, trustedDelivery, newTaskUid(), record.kind === 'after' ? record.afterSeconds : undefined, trustedAttachments);
         try {
             agent.session.append('schedule/change', {
                 version: 1,
@@ -487,7 +490,10 @@ export async function userScheduleEditPrompt(id, newPrompt, agent, ctx, limits =
         const sessionId = agent.session.header?.id;
         const previousEntry = getOwnership(sessionId, scheduleId);
         // 编辑 after 会重置倒计时 → 窗口等于新 afterSeconds，不沿用 resume 旧窗口
-        recordOwnership(sessionId, record.id, delivery, previousEntry?.uid, record.kind === 'after' ? record.afterSeconds : undefined);
+        recordOwnership(sessionId, record.id, delivery, previousEntry?.uid, record.kind === 'after' ? record.afterSeconds : undefined, 
+        // 附件跨「删旧建新」保留：编辑只换文案，随命令提交的图片/文件仍属于这条
+        // 提醒。新 id 无旧条目可回退，必须显式带上。
+        previousEntry?.attachments);
         try {
             agent.session.append('schedule/change', { version: 1, operation: 'delete', id: scheduleId });
             agent.session.append('schedule/change', { version: 1, operation: 'create', schedule: toChangePayload(record) });
@@ -582,6 +588,9 @@ export async function userSchedulePause(id, agent, ctx) {
             ...(windowSeconds !== undefined ? { originalAfterSeconds: windowSeconds } : {}),
             lastScheduleId: scheduleId,
             pausedAt: now,
+            // 附件随条目冻结：pause 会把日志记录删除，留档是暂停项唯一的素材来源，
+            // 不带附件会让「暂停→恢复/插话」静默丢图。
+            ...(ownership?.attachments !== undefined ? { attachments: ownership.attachments } : {}),
         };
         // sidecar 先写（投影 delete 后按 lastScheduleId 挂回 paused 列表）
         recordPaused(sessionId, pausedEntry);
@@ -651,7 +660,7 @@ export async function userScheduleResume(uid, agent, ctx, maxSchedules = DEFAULT
         // removePaused，视图会短暂同时出现「已暂停」+ 新活动行（实测重复行根因）。
         removePaused(sessionId, uid);
         // 保留原 after 窗口：日志 afterSeconds 只是 remaining，进度条需要原窗口才能接着跑
-        recordOwnership(sessionId, record.id, paused.delivery, uid, paused.originalAfterSeconds ?? paused.remainingSeconds);
+        recordOwnership(sessionId, record.id, paused.delivery, uid, paused.originalAfterSeconds ?? paused.remainingSeconds, paused.attachments);
         try {
             agent.session.append('schedule/change', {
                 version: 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-later",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "给 DSH 加上定时发送：输入一句话，到点自动以你的身份送出，关掉网页也准时触发。定时发送 / 定时提醒 / 延迟发送。",
   "icon": "./icon.svg",
   "keywords": [
@@ -16,11 +16,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/WuJiaoJue/dsh-later.git"
+    "url": "git+https://github.com/dsh-plugins/dsh-later.git"
   },
-  "homepage": "https://github.com/WuJiaoJue/dsh-later",
+  "homepage": "https://github.com/dsh-plugins/dsh-later",
   "bugs": {
-    "url": "https://github.com/WuJiaoJue/dsh-later/issues"
+    "url": "https://github.com/dsh-plugins/dsh-later/issues"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -73,6 +73,7 @@
     "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
     "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
     "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.18",